Claude Code错误There's an issue with the selected model (mimo-v2.5-pro)解决方案

解决 "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(最常用)

推荐方案 — 这是社区验证后最有效、最常用的解决方案。核心原理是通过环境变量屏蔽 Claude Code 向第三方 API 发送的实验性 Beta Headers,强制其使用标准协议。

方法 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 Headers
  • CLAUDE_CODE_SIMPLE=1 — 启用简单模式,使用最基础的对话协议
  • ANTHROPIC_BASE_URL — 按量付费用 https://api.xiaomimimo.com/anthropic,Token Plan 用 https://token-plan-cn.xiaomimimo.com/anthropic
  • ANTHROPIC_AUTH_TOKEN — 按量付费为 sk-xxxxx,Token Plan 为 tp-xxxxx

4. 解决方案二:关闭 Thinking 模式

如果你使用了 effort higheffort 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.

解决方法:

  1. 启动 Claude Code 时不要使用 --effort high--effort max
  2. 在对话中执行 /config → 选择模型 → 将 effort 设置为 lowmedium
  3. 如果使用 CC Switch 代理工具,确保其配置中启用了 stripThinking 选项(CC Switch v3.14.1+ 已支持)
技术背景:Claude Code 在高 effort 模式下会将 Thinking 相关的 blocks(<thinking> / <redacted_thinking>)写入消息历史。MiMo 的 Anthropic 兼容层不完全支持这些 blocks 的 round-trip,导致多轮后上游返回 400。社区 CC Switch 项目已在 Issue #2789 中对此进行了修复。

5. 解决方案三:避免在读取图片后切换模型

已知 Bug:
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,新模型将完全无法响应。

解决方法:

  1. 方案 A:在开始对话前就选定 mimo-v2.5-pro,不要在会话中途切换模型
  2. 方案 B:切换模型前先 /clear 清空对话历史,然后再切换
  3. 方案 C:如果必须切换,在切换后开启一个全新的对话
原因:Claude Code 在处理包含图片的多模态消息历史时,向不同模型传递的协议格式存在差异。切换模型后,旧模型的消息历史与新模型的 API 协议不兼容,导致上游拒绝请求。

6. 解决方案四:检查上下文长度是否超限

值得注意的是,上下文窗口超限时 Claude Code 有时会报出误导性的"模型不存在"错误(Issue #58252)。

排查方法:

  1. 在 Claude Code 中执行 /status 查看当前 Token 使用情况
  2. 如果 Token 使用率接近 100%,说明是上下文超限
  3. 尝试 /clear 清空历史,或使用 /compact 压缩上下文
提示:对于支持 1M 上下文的 MiMo 模型,可以使用 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 与端点

虽然该错误大多数情况下不是认证问题,但排除配置错误总是第一步。

核对清单:

  1. 确认 ANTHROPIC_BASE_URL 指向正确的端点(见下方表格)
  2. 确认 ANTHROPIC_AUTH_TOKEN 格式正确且未过期
  3. 确认没有残留的 Anthropic 官方环境变量(官方 Key 与 MiMo Key 会冲突)
  4. 清理旧环境变量: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
重要:在配置 MiMo 之前,务必清除 Anthropic 官方的环境变量,否则会导致 API 冲突:
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
注意事项:回退版本意味着你会失去 Claude Code 新版本的特性和修复。这应该作为最后的备选方案,优先尝试方案一至方案七。

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 备选