Claude Code 报 There's an issue with the selected model（404 模型不存在）怎么解决

同一个问题的其他写法

• API Error: 404 {"type":"error","error":{"type":"not_found_error","message":"Unknown model \"opus 4.6\". Did you mean \"claude-opus-4-6\"? Model IDs use hyphens, e.g. claude-opus-4-6 (not \"opus 4.6\"). Full list: https://www.ccsub.net/api/v1/models | 未知模型 ..."}}
• unexpected status 404 Not Found: <!DOCTYPE html><html lang="zh">...

这个报错有两种完全不同的来源

Claude Code 收到 404 时，通常会显示成 There's an issue with the selected model (...)，Claude Code 的 GitHub 上也有不少人反馈：网关地址本身返回 404 时，同样会被报成型号问题。所以 404 可能来自两个地方，要先分清：

1. 型号名不认识：请求到了 CCSub，但 model 标识不在支持列表里。CCSub 会返回 JSON 格式的 not_found_error，message 里写着 Unknown model "..."，并尽量猜一个最接近的正确名字，后面附上完整列表的地址。
2. 地址写错了：请求根本没有落到接口上，服务器返回的是网站的 404 页面（一整页 HTML）。这时不管换哪个型号都会报错，Claude Code 也会把它当成型号问题提示你。

区分方法很简单：如果换了好几个型号都报错，基本就是第 2 种。用下面的命令看一下返回的是 JSON 还是 HTML：

curl -sS -X POST https://www.ccsub.net/v1/messages -o /dev/null -w '%{http_code} %{content_type}\n'

正确的地址会返回 401 application/json（没带 Key 所以 401，说明接口存在）；如果你把自己配置里的地址代进去，返回 404 text/html，就是地址写错了。

型号名写错的常见形式

• 用了空格或点号：opus 4.6、claude-opus-4.6。CCSub 的 Claude 系列 model 标识统一用短横线，例如 claude-opus-4-6、claude-sonnet-4-6。
• 写了还不存在的版本号，例如 claude-opus-6。
• 从别的平台复制过来的名字带了平台前缀或自定义后缀。
• 完全不是型号名，例如 pro、chat gpt 4o。CCSub 近 30 天的 404 日志里这类写法都出现过。

全部可用的 model 标识可以直接打开 https://www.ccsub.net/api/v1/models 查看，返回的每一项 id 都可以原样填进配置；也可以看网站上的 型号列表。

Claude Code 从哪里决定用哪个型号

按照 Claude Code 官方文档，型号可能来自以下几处，改了一处没生效时要逐个检查：

• 会话里的 /model 和启动参数 --model，优先级最高；
• 环境变量 ANTHROPIC_MODEL，会覆盖 settings 文件里的 model；
• ~/.claude/settings.json 或项目 .claude/settings.json 里的 model 字段；
• ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL：决定 sonnet、opus、haiku 这几个别名实际解析成哪个型号，haiku 那个还会用于后台任务。

如果你曾经在这些变量里填过别的平台的型号名，换到 CCSub 后要一起改掉。

Base URL 写错的常见形式

• ANTHROPIC_BASE_URL=https://www.ccsub.net/v1：Claude Code 会自己在后面拼 /v1/messages，结果变成 /v1/v1/messages，返回 HTML 404。正确写法是 https://www.ccsub.net，不带 /v1。
• 地址里带了语言前缀，例如 https://www.ccsub.net/zh。接口地址不需要语言前缀。
• Codex、Cursor 等 OpenAI 兼容工具：Base URL 填 https://www.ccsub.net/api/v1。Codex 报 unexpected status 404 Not Found: <!DOCTYPE html>... 时，看报错末尾的 url 就能知道它实际请求了哪个地址。

改完之后关掉终端重新打开，再启动工具，让新的配置生效。

常见问题

相关报错

• API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"Invalid JSON in request body: Unterminated string in JSON at position 10407567 (line 1 column 10407568)"}}position 是上千万的数字 = 请求体太大、传输途中被截断：/compact 或 /clear、别反复贴大截图、大文件分段读。position 很小 = 发出去的 JSON 本身格式不对。
• API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid or disabled API key"}}Key 没带上或带错了。用 /status 看 Claude Code 实际用的是哪个变量，到 /keys 重新复制完整 Key，删掉多余的 ANTHROPIC_API_KEY 后重开终端。
• unexpected status 401 Unauthorized: {"type":"error","error":{"type":"authentication_error","message":"Missing or invalid API key"}}, url: https://www.ccsub.net/api/v1/responses看报错里的 url 判断请求发去了哪；用自定义 provider + env_key 指定 CCSub 的 Key，并在启动 Codex 的同一个环境里设置好这个变量。