Claude Code 升级致小米 Mimo 报错,社区已给出配置修复方案

近日,随着 Anthropic 旗下 AI 编程工具 Claude Code 更新至 V2.1.154 版本,大量使用小米 Mimo 模型作为 API 底座的开发者遭遇了兼容性报错。错误提示信息显示:“API Error: 400 messages[1].role must be either ‘user’ or ‘assistant’, but got ‘system’”。经技术社区排查,该问题的核心原因在于 Claude Code 本次更新引入了针对 Claude Opus 4.8 的“自适应思考”等实验性特性,改变了消息传递的格式要求,导致尚未完全适配新协议的第三方 Mimo 接口在处理 `system` 角色时验证失败。针对此问题,开发者们已验证了一套有效的临时配置修复方案:用户需在 Claude Code 的环境配置文件中,增加 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` 和 `CLAUDE_CODE_SIMPLE` 两个环境变量,并将其值均设为“1”。同时,需确保 `ANTHROPIC_BASE_URL` 指向小米 Mimo 接口,并将模型参数指定为“mimo-v2.5-pro”。通过屏蔽客户端的实验性功能并强制回归简单对话模式,可成功绕过该兼容性障碍。目前,除了修改配置外,受影响用户也可以选择暂时回退 Claude Code 版本以恢复使用。

事件分析

从技术架构视角分析,此次故障本质上是 AI 客户端迭代速度与第三方模型适配速率脱节的典型表现。Anthropic 的 Claude Code 客户端在 V2.1.154 版本中激进地启用了针对原生 Opus 4.8 模型优化的上下文处理机制,对 API 消息体中的角色定义进行了更严格的校验。而小米 Mimo 作为一个基于 Anthropic 协议的第三方转发层,其内核更新存在滞后性,无法即时响应客户端底层协议的微调。社区提出的修复方案——通过禁用实验性功能(`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`)和启用简单模式(`CLAUDE_CODE_SIMPLE`),实际上是强制客户端进行“协议降级”,使其通讯行为向后兼容旧版 API 标准。这表明在缺乏统一强制性行业标准的情况下,非原生 AI 工具链的稳定性极易受到上游版本变更的影响,未来此类因协议割裂导致的调试成本可能成为常态。

💡 核心观点:AI 工具链的激进迭代与第三方模型适配滞后产生的冲突已成常态,强制降级协议虽能解燃眉之急,但唯有加速底层标准化才能根治此类生态割裂问题。

原文链接:Linux.do

C code80.ai · AI 编码 API 聚合 Claude / GPT 多模型统一接入,稳定不限速,按量计费,几行配置接入 Claude Code。 了解一下 ›

抢沙发

评论前必须登录!

立即登录   注册