1. 为什么claude --model sonnet还是跑在 Opus 上
你敲下claude --model sonnet，回车，然后问它「你用的是哪个模型」，它回答「Opus」。或者你在会话里输入/model haiku，界面提示切换成功，但下一轮回答的推理深度和响应速度明显还是老样子。这个场景我遇到过不止一次，尤其是在同时维护多个项目、每个项目都有自己的.claude/settings.json时，模型切换失效几乎成了日常。
先把结论摆出来：Claude Code 的模型来源不是单一的，它同时会读命令行参数、环境变量、项目级配置、用户级配置，甚至还有会话内/model命令的运行时状态。这些来源之间存在优先级，一旦某个高优先级来源被低优先级来源「意外覆盖」，或者模型名称拼写不对，--model就会看起来像失效了。更隐蔽的情况是 API Key 本身不支持目标模型，请求发出去直接被拒，但客户端不会明确告诉你「Key 没权限」，而是回退到默认模型继续跑。
这篇文章聚焦的就是这个排查链路。我会从配置骨架讲起，把settings.json和ANTHROPIC_MODEL的优先级关系拆清楚，然后给出可复制的配置片段和逐条验证命令。同时说明怎么通过 TaoToken 统一 Key 和 API 通道接入，让模型参数真正落到请求里，而不是被某一层配置悄悄改掉。适合正在用 Claude Code 做日常编码、被模型切换问题卡住的开发者，也适合想把团队里多个 Claude Code 实例的模型行为统一起来的人。
核心检索词先明确：Claude Code 模型切换失效、--model不生效、ANTHROPIC_MODEL优先级、settings.json覆盖。这几个词贯穿全文，你按这个思路排查基本不会跑偏。
2. 接入前置：用 TaoToken 统一 Key 与 API 通道
在排查模型切换之前，得先保证请求通道本身是通的、可控的。Claude Code 默认会去连 Anthropic 官方端点，但很多团队和个人开发者会选择通过统一的 API 网关来管理 Key、额度和模型路由。TaoToken 在这里扮演的就是这个角色：它提供一个兼容 Anthropic 协议的 API 入口，你只需要把 Base URL 指向它，用 TaoToken 生成的 Key 替换掉原来的 Key，Claude Code 的请求就会走这条通道。
这样做的好处很直接。第一，Key 集中管理，不用在每个项目的环境变量里散落不同的 Key。第二，模型路由可控，你可以在 TaoToken 侧看到实际请求打到了哪个模型，排查「我以为切了但实际没切」时多一层观测。第三，额度与计费统一，团队里多个 Claude Code 实例共用一个通道，账单清晰。
具体操作上，你需要先拿到 TaoToken 的 API Key。打开控制台，在 API Keys 页面创建一个新 Key，复制出来。然后确认你要用的模型 ID，TaoToken 的模型对话页面和接入文档里都有当前支持的模型列表，Claude 系列通常以claude-sonnet-4-20250514、claude-opus-4-20250514、claude-haiku-4-20250514这样的全名出现，也有sonnet、opus、haiku这类简写映射。
拿到 Key 之后，Claude Code 侧需要配置三个东西：Base URL、API Key、Model ID。这三件套缺一不可，而且必须和settings.json里的字段名对齐。很多人模型切换失效，根因就是 Base URL 还指着旧端点，或者 Key 换了但settings.json里还留着旧的model字段在覆盖。
这里给一个最小可用的环境变量配置，你可以先临时验证通道是否通：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="你的TaoToken Key" export ANTHROPIC_MODEL="claude-sonnet-4-20250514"注意ANTHROPIC_BASE_URL不要带 UTM 参数，API 调用路径就是https://taotoken.net/api。设置完之后，先别急着改settings.json，直接跑一次claude --model sonnet，看它是否还回退。如果这时候模型正确了，说明问题出在配置文件覆盖；如果还是不对，那就要往 Key 权限和模型名称方向查。
TaoToken 的接入文档里有针对 Claude Code 的完整配置示例，包括settings.json的字段写法。我建议你在动手改本地配置之前，先把文档里的配置骨架复制一份出来对照，避免字段名写错导致配置根本不生效。文档入口在 TaoToken 官网的文档区，接入相关的页面会列出 Base URL、Key 获取方式和模型 ID 对照表。
还有一点值得强调：TaoToken 不是让你绕过什么，它就是一个正常的 API 服务通道，你用它来统一管理请求。排查模型切换时，通道稳定是前提，否则你会把「请求根本没发出去」误判成「模型切换失效」。所以第二步一定是先确认通道通，再查配置优先级。
3. 可复制配置：settings.json 骨架与优先级对照
Claude Code 的配置优先级从高到低大致是：命令行参数--model> 环境变量ANTHROPIC_MODEL> 项目级.claude/settings.json> 用户级~/.claude/settings.json。但实际行为里有一个坑：如果settings.json里显式写了model字段，某些版本下它会覆盖环境变量，导致你以为环境变量生效了，其实没有。所以最稳妥的做法是——在settings.json里不要写model字段，把模型选择权完全交给命令行参数或环境变量。
先看用户级配置~/.claude/settings.json的推荐骨架：
{ "streaming": true, "autoUpdate": true, "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "你的TaoToken Key" } }注意这里没有model字段。env块里放的是通道相关的环境变量，Claude Code 启动时会把这些注入到运行环境。这样你切换模型时，只需要在命令行加--model，或者临时export ANTHROPIC_MODEL，不会被配置文件里的model截胡。
项目级配置.claude/settings.json同理，推荐只放项目特有的东西，比如权限、工具开关，不要放model：
{ "permissions": { "allow": ["Bash(git status)", "Read"] } }如果你确实需要在项目级固定模型，比如这个项目统一用 Haiku 省钱，那就在项目级写model，但要清楚它会覆盖用户级，且可能覆盖环境变量。这时候命令行--model是否还能赢，取决于版本，所以最保险的验证方式是跑一次--debug看实际加载的模型。
下面这张表把各配置来源和覆盖关系列清楚，你排查时直接对照：
| 配置来源 | 路径/形式 | 是否推荐写 model | 覆盖关系 |
|---|---|---|---|
| 命令行参数 | claude --model sonnet | 是（临时） | 最高，但可能被 env 干扰 |
| 环境变量 | ANTHROPIC_MODEL | 是（持久） | 高，可能被 settings.json 覆盖 |
| 项目级配置 | .claude/settings.json | 谨慎 | 覆盖用户级 |
| 用户级配置 | ~/.claude/settings.json | 不推荐 | 最低 |
| 会话内命令 | /model sonnet | 运行时 | 需重启才稳定 |
还有一个容易忽略的点：ANTHROPIC_MODEL和ANTHROPIC_DEFAULT_SONNET_MODEL这类变量可能同时存在。如果你只改了ANTHROPIC_MODEL，但环境里还残留着ANTHROPIC_DEFAULT_SONNET_MODEL指向旧模型，切换也会看起来失效。排查时用env | grep ANTHROPIC把所有相关变量列出来，逐个确认。
配置改完之后，不要直接开新会话就下结论。先跑一条验证命令，确认 Claude Code 实际读到的模型是什么。下一节给具体命令和预期输出。
4. 验证请求：逐条命令确认模型真的切了
排查模型切换，最忌讳「改完配置直接问模型你是谁」。因为模型自报身份并不可靠，它可能基于训练数据里的默认认知回答，而不是当前实际加载的模型。正确做法是用--debug看客户端实际发出的请求参数，再结合 TaoToken 侧的请求日志确认。
第一条命令，检查环境变量污染：
env | grep -i anthropic预期输出里应该只有你显式设置的ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_MODEL。如果出现了ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL之类的变量，先记下来，它们可能是覆盖源。
第二条命令，检查配置文件里的 model 字段：
cat ~/.claude/settings.json 2>/dev/null | grep -i model cat .claude/settings.json 2>/dev/null | grep -i model如果任何一条有输出，说明配置文件里写了model，这就是嫌疑对象。把它删掉，或者改成你期望的值。
第三条命令，用 debug 模式启动，观察模型加载：
claude --model sonnet --debug 2>&1 | grep -i "model"预期能看到类似Using model: claude-sonnet-4-20250514的行。如果显示的是claude-opus-4-20250514或别的，说明--model没赢，继续往环境变量和配置文件查。
第四条命令，直接发一个最小请求，看返回里带的模型标识：
ANTHROPIC_MODEL=claude-haiku-4-20250514 claude --print "reply with only the word: ok" --max-turns 1这条命令用--print非交互模式，--max-turns 1限制只跑一轮，输出应该只有ok。如果它报错Model not available，说明 Key 或通道不支持这个模型，问题不在切换逻辑，而在权限。
第五条，如果你用 TaoToken 通道，去控制台的请求日志页面看最近一条请求的model字段。这是最硬的证据：客户端以为切了没用，服务端收到的是什么就是什么。如果服务端收到的还是旧模型，那问题在客户端配置；如果服务端收到的是新模型但行为不对，那可能是模型本身的差异，不是切换失效。
验证通过的标准是：--debug显示的模型、TaoToken 日志里的模型、你命令行指定的模型，三者一致。只要有一环对不上，就按优先级从高到低逐层排查。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
模型切换失效往往不是单独出现的，它经常和几类报错缠在一起。下面按真实报错逐条拆。
401 Unauthorized。这个最直接，Key 不对或没带上。检查ANTHROPIC_API_KEY是否设置、是否有多余空格、是否和ANTHROPIC_BASE_URL匹配。如果你用 TaoToken，确认 Key 是从控制台复制的完整字符串，没有截断。401 出现时模型切换根本无从谈起，因为请求在鉴权层就被拒了。
local proxy failed。这个报错通常出现在你本地有代理配置，但代理没起来或端口不对。Claude Code 会读HTTP_PROXY、HTTPS_PROXY环境变量。如果你不需要代理，直接unset HTTP_PROXY HTTPS_PROXY再跑。需要的话，确认代理地址和端口正确。注意这里说的是本地网络配置，不是让你去用什么特殊工具，就是普通的开发环境代理设置。
reading choices 相关报错。这类报错一般出现在响应解析阶段，说明请求发出去了、也返回了，但返回结构不符合客户端预期。常见原因是 Base URL 指向了一个不兼容 Anthropic 协议的端点，或者模型 ID 写错导致服务端返回了错误结构。检查ANTHROPIC_BASE_URL是否是https://taotoken.net/api，模型 ID 是否是文档里列出的全名。
OAuth 相关报错。Claude Code 某些版本会走 OAuth 流程，如果你同时设置了 API Key 和 OAuth token，可能冲突。排查时确认你是用 Key 模式还是 OAuth 模式，不要混用。用 TaoToken 通道时，统一走 Key 模式，把 OAuth 相关的环境变量清掉。
Model not available。这个报错直接指向权限或模型名称。先确认模型 ID 拼写，claude-sonnet-4-20250514这种全名一个字符都不能错。再确认你的 Key 是否支持该模型，TaoToken 控制台里能看到 Key 的权限范围和可用模型列表。如果 Key 只开了 Sonnet，你切 Opus 就会报这个。
切换后仍走默认模型。这是最像「切换失效」但根因最多样的一类。按这个顺序查：先env | grep ANTHROPIC看环境变量，再grep model看两个settings.json，然后--debug看实际加载，最后看 TaoToken 日志。四步走完基本能定位。
如果你在配置里用到了 CC Switch、Cline MCP 或 Codex 的auth.json，记住三件套必须写全：Base URL、Key、Model ID。缺任何一个，模型切换都会以各种奇怪的方式失败。比如auth.json里只写了 Key 没写 Base URL，请求会打到默认端点，模型自然不对。
排查清单可以浓缩成一张速查表：
| 检查项 | 命令 | 期望结果 |
|---|---|---|
| 环境变量 | env | grep ANTHROPIC | 只有预期的三个变量 |
| 用户配置 | grep model ~/.claude/settings.json | 无输出或期望值 |
| 项目配置 | grep model .claude/settings.json | 无输出或期望值 |
| 实际模型 | claude --model sonnet --debug | 显示 sonnet 全名 |
| 服务端日志 | TaoToken 控制台 | model 字段与预期一致 |
| Key 权限 | TaoToken 控制台 | 包含目标模型 |
6. 把模型选择权收拢到一处
排查到最后你会发现，模型切换失效的根因往往不是某个功能坏了，而是配置来源太多、优先级不透明。我的做法是把模型选择权收拢到一处：settings.json里不写model，通道相关的 Base URL 和 Key 放在用户级配置的env块里，模型则通过ANTHROPIC_MODEL环境变量或命令行--model指定。这样任何时候你想换模型，只改一个地方，不会出现「改了 A 被 B 覆盖」的情况。
如果你需要长期在多个项目间切换模型，可以在 shell 里做一层封装，比如给不同项目写不同的 alias，每个 alias 里带上对应的ANTHROPIC_MODEL。这样启动即生效，不用每次手动 export。TaoToken 的 Coding Plan 适合这种长期编码场景，Key 和通道统一管理，模型路由在服务端可见，排查时少一层猜测。
最后留一个实用习惯：每次改完模型配置，先跑claude --model <目标> --debug 2>&1 | grep -i model，确认客户端加载的模型对了，再去 TaoToken 控制台看请求日志确认服务端收到的模型也对了。两步都过，再开始正式干活。这个习惯帮我省掉了大量「以为切了其实没切」的返工时间。
