解决 "There's an issue with the selected model" 错误的完整手册
1. 错误信息
There's an issue with the selected model (mimo-v2.5-pro). It may not exist or you may not have access to it. Run /model to pick a different model.
这是使用小米 MiMo 模型作为第三方 API 接入 Claude Code 时最常见的报错。该错误表面上看起来像是"模型不存在"或"没有访问权限",但实际上绝大多数情况下是协议兼容性问题,而非真正的认证失败。
API Error: 400 {"error":{"code":"400","message":"Param Incorrect", "param":"The reasoning_content in the thinking mode must be passed back to the API."}} API Error: 400 messages[1].role must be either 'user' or 'assistant', but got 'system'
2. 根因分析
综合社区反馈和官方 Issue 追踪,该错误主要由以下几个层面的不兼容导致:
| 原因 | 触发条件 | 影响范围 |
|---|---|---|
| 实验性 Beta 协议 高 |
Claude Code V2.1.154+ 引入了 Claude Opus 4.8 的"自适应思考"特性,向请求中添加了 MiMo 不认识的 Beta Headers | 所有使用 MiMo 的 Claude Code 用户 |
| Thinking Content 回传 高 |
多轮对话中,Claude Code 将包含 reasoning_content 的 Assistant 消息历史回传给上游,MiMo 要求该字段必须正确回传但代理层未处理 |
多轮对话/Tool Call 后必现 |
| System 角色不支持 中 |
Claude Code 新消息格式包含 system 角色,MiMo 转发层无法识别 |
特定对话轮次 |
| 图片历史导致模型切换失败 中 |
在 mimo-v2.5 下读取图片后切换到 mimo-v2.5-pro |
图片相关会话 |
| SGP 代理端点不稳定 低 |
小米新加坡代理端点间歇性不可达 | 间歇性,重试即恢复 |
| 上下文超限 低 |
Token 超出模型上下文窗口上限,但被误报为"模型不存在" | 长对话场景 |
3. 解决方案一:屏蔽实验性 Beta(最常用)
方法 A:设置环境变量
在启动 Claude Code 前,在终端执行:
# macOS / Linux export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 export CLAUDE_CODE_SIMPLE=1 # Windows (CMD) set CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 set CLAUDE_CODE_SIMPLE=1 # Windows (PowerShell) $env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1" $env:CLAUDE_CODE_SIMPLE="1"
方法 B:写入 settings.json(持久化)
编辑 ~/.claude/settings.json(macOS/Linux)或用户目录下的 .claude\settings.json(Windows):
{ "env": { "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1", "CLAUDE_CODE_SIMPLE": "1", "ANTHROPIC_BASE_URL": "https://token-plan-cn.xiaomimimo.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "tp-你的API_KEY", "ANTHROPIC_MODEL": "mimo-v2.5-pro", "ANTHROPIC_DEFAULT_SONNET_MODEL": "mimo-v2.5-pro", "ANTHROPIC_DEFAULT_OPUS_MODEL": "mimo-v2.5-pro", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mimo-v2.5-pro" } }
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1— 禁用所有实验性 Beta HeadersCLAUDE_CODE_SIMPLE=1— 启用简单模式,使用最基础的对话协议ANTHROPIC_BASE_URL— 按量付费用https://api.xiaomimimo.com/anthropic,Token Plan 用https://token-plan-cn.xiaomimimo.com/anthropicANTHROPIC_AUTH_TOKEN— 按量付费为sk-xxxxx,Token Plan 为tp-xxxxx
4. 解决方案二:关闭 Thinking 模式
如果你使用了 effort high 或 effort max,Claude Code 会启用 Thinking 模式,这会导致 reasoning_content 在多轮对话中无法被正确回传,最终触发 400 错误。
API Error: 400 Param Incorrect The reasoning_content in the thinking mode must be passed back to the API.
解决方法:
- 启动 Claude Code 时不要使用
--effort high或--effort max - 在对话中执行
/config→ 选择模型 → 将 effort 设置为 low 或 medium - 如果使用 CC Switch 代理工具,确保其配置中启用了
stripThinking选项(CC Switch v3.14.1+ 已支持)
<thinking> / <redacted_thinking>)写入消息历史。MiMo 的 Anthropic 兼容层不完全支持这些 blocks 的 round-trip,导致多轮后上游返回 400。社区 CC Switch 项目已在 Issue #2789 中对此进行了修复。5. 解决方案三:避免在读取图片后切换模型
There's an issue with the selected model (mimo-v2.5-pro[1m][1m]). It may not exist or you may not have access to it. Run --model to pick a different model.
这是一个已确认的 Claude Code 插件 Bug(Issue #62487):在 mimo-v2.5 模型下使用 Read 工具读取图片后,再用 /model 命令切换到 mimo-v2.5-pro,新模型将完全无法响应。
解决方法:
- 方案 A:在开始对话前就选定
mimo-v2.5-pro,不要在会话中途切换模型 - 方案 B:切换模型前先
/clear清空对话历史,然后再切换 - 方案 C:如果必须切换,在切换后开启一个全新的对话
6. 解决方案四:检查上下文长度是否超限
值得注意的是,上下文窗口超限时 Claude Code 有时会报出误导性的"模型不存在"错误(Issue #58252)。
排查方法:
- 在 Claude Code 中执行
/status查看当前 Token 使用情况 - 如果 Token 使用率接近 100%,说明是上下文超限
- 尝试
/clear清空历史,或使用/compact压缩上下文
mimo-v2.5-pro[1m] 作为模型名称启用扩展上下文容量。配置后执行 /context 命令验证是否生效。7. 解决方案五:修正模型名称
部分用户报告使用 mimo-v2.5-pro[1m] 时会出现 "Param Incorrect" 错误。如果遇到问题,尝试以下变体:
| 模型名称 | 说明 | 推荐场景 |
|---|---|---|
mimo-v2.5-pro |
标准版,1M 上下文 | 日常对话,代码编写 |
mimo-v2.5-pro[1m] |
扩展版,1M 上下文 | 大文件分析,长文档处理 |
mimo-v2.5 |
轻量版,处理图片/音视频 | 多模态任务 |
如果在图片/多模态场景下 mimo-v2.5-pro 报错,尝试切换到 mimo-v2.5。
8. 解决方案六:更新 CC Switch(如使用代理)
如果你使用 CC Switch 作为代理工具,请确保使用最新版本。
CC Switch 针对 MiMo 的兼容性问题已发布的修复:
- #2789 — 为非 Anthropic provider 启用 thinking blocks 剥离,支持 mimo-v2.5-pro
- #2952 — 修复 reasoning_content 在多轮对话中的 round-trip 问题
- #2837 — 修复 400 错误
# 查看当前版本 cc-switch --version # 更新(根据你安装的版本) brew upgrade cc-switch # Homebrew
9. 解决方案七:检查 API Key 与端点
虽然该错误大多数情况下不是认证问题,但排除配置错误总是第一步。
核对清单:
- 确认
ANTHROPIC_BASE_URL指向正确的端点(见下方表格) - 确认
ANTHROPIC_AUTH_TOKEN格式正确且未过期 - 确认没有残留的 Anthropic 官方环境变量(官方 Key 与 MiMo Key 会冲突)
- 清理旧环境变量:
unset ANTHROPIC_AUTH_TOKEN或检查~/.claude/settings.json
| 订阅方式 | BASE_URL | API Key 格式 |
|---|---|---|
| 按量付费 | https://api.xiaomimimo.com/anthropic |
sk-xxxxx |
| Token Plan(中国节点) | https://token-plan-cn.xiaomimimo.com/anthropic |
tp-xxxxx |
| Token Plan(新加坡节点) | https://token-plan-sgp.xiaomimimo.com/anthropic |
tp-xxxxx |
unset ANTHROPIC_AUTH_TOKEN
10. 解决方案八:回退 Claude Code 版本
如果以上方案均无效,可以考虑回退 Claude Code 到兼容版本。
根据社区反馈,Claude Code V2.1.153 与 MiMo 的兼容性最佳。V2.1.154 及之后版本引入了更多实验性特性,可能加剧兼容问题。
# 查看当前版本 claude --version # 回退到 V2.1.153 npm install -g @anthropic-ai/claude-code@2.1.153 # 验证 claude --version
11. 快速排查清单
遇到问题时,按以下顺序排查:
| # | 检查项 | 命令/操作 | 优先级 |
|---|---|---|---|
| 1 | 添加 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 |
export ... 或 settings.json |
最高 |
| 2 | 添加 CLAUDE_CODE_SIMPLE=1 |
同上 | 最高 |
| 3 | 清除冲突的 Anthropic 官方环境变量 | unset ANTHROPIC_AUTH_TOKEN |
最高 |
| 4 | 关闭 Thinking 模式(effort low/medium) | /config |
高 |
| 5 | 检查上下文是否超限 | /status |
高 |
| 6 | 确认 API Key 和 BASE_URL 正确 | 检查 settings.json | 高 |
| 7 | 更新 CC Switch 到最新版 | brew upgrade cc-switch |
中 |
| 8 | 避免在图片后切换模型 | 切换前先 /clear |
中 |
| 9 | 回退 Claude Code 版本 | npm install -g ...@2.1.153 |
备选 |