在 Claude Code 里切到 Opus 5.5,会话中输入 /model opus 就行。前提是版本不低于 v2.1.280,旧版本先运行 claude update。
另外一个容易被忽略的事实:Pro、Max、Team、Enterprise 和 API 账号,官方文档写的默认模型本来就是 Opus 5.5。所以多数人不需要"切换",需要的是知道怎么切走、怎么降级、怎么看自己现在到底在用哪个。
三种切换方式,优先级不同
以下内容来自 Claude Code 官方模型配置页,最后核对 2026-10-09。
| 方式 | 写法 | 作用范围 |
|---|---|---|
| 会话内 | /model opus 或 /model claude-opus-5-5 | 立即生效,并存为默认 |
| 启动参数 | claude --model opus | 只对这次启动 |
| 环境变量 | ANTHROPIC_MODEL=opus | 只对这次启动 |
| 设置文件 | "model": "opus" | 每次默认 |
| 新会话默认 | ANTHROPIC_DEFAULT_MODEL=opus | 需 v2.1.236 以上 |
优先级从上往下递减。直接输入 /model 不带参数会打开选择器:按 Enter 保存为默认,按 s 只用于当前会话。想确认当前用的是哪个,运行 /status。
settings.json 的最小写法:
{
"model": "opus"
}
别名对应哪个模型
在 Anthropic API 账号上,三个常用别名现在解析成:
| 别名 | 解析结果 | 最低版本 |
|---|---|---|
opus | Opus 5.5 | v2.1.280 |
sonnet | Sonnet 5.5 | v2.1.284 |
haiku | Haiku 5.5 | v2.1.293 |
另外几个别名:opus[1m] 和 sonnet[1m] 是 100 万 token 上下文版本;opusplan 在计划模式用 Opus,执行阶段换成 Sonnet;best 在能用 Fable 的账号上等于 Fable,否则等于 opus;default 清除模型覆盖,回到账号默认。
注意第三方平台不一样。官方表格里 Microsoft Foundry 上 opus 还是 Opus 4.6,Bedrock 和 Google Cloud 上 opus 是 Opus 5.5 但 sonnet 仍是 4.5。在这些平台上要固定版本,用 ANTHROPIC_DEFAULT_OPUS_MODEL 写具体模型 ID,别依赖别名。
控制消耗:effort、Sonnet 和 opusplan
Anthropic 没有公布 Pro 和 Max 各档用 Opus 5.5 能跑多少次,第三方文章里的具体数字我没法在官方页面核实,这里不引用。能确定的省额度手段有三个:
- 保持 medium effort。 Opus 5.5 的默认 effort 是
medium,可选low、medium、high、xhigh、max。用/effort或--effort调整,难题再拉高。 - 日常活切 Sonnet 5.5。
/model sonnet,改文案、写测试、小重构都够用。API 价格上 Sonnet 5.5 也比 Opus 5.5 便宜,价格明细见 Opus 5.5 API 定价那篇。 - 用 opusplan。
/model opusplan:计划模式让 Opus 想,执行时 Sonnet 动手,长任务里能少烧一大截 Opus。
剩余额度用 /usage 看。具体窗口和重置时间以你账号里显示的为准。
自动降级到 Sonnet:fallbackModel
模型过载或临时不可用时,可以让 Claude Code 自动换一个。两种写法:
claude --fallback-model sonnet,haiku
{
"fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}
规则有四条:
- 最多串 3 个模型,按顺序尝试。
- 启动参数优先于设置文件。
- 切换只持续当前这一轮,下一轮还是回到主模型。
- 认证、计费、限流、请求过大和传输错误不会触发降级。
最后一条要记牢。额度用完或被限流时,fallbackModel 不会救你,它只处理"模型那一端出问题"的情况。
自动模式要不要关
Claude Code v2.1.283 起,交互式终端和 VS Code 会话默认从 auto mode 启动,由一个分类器模型代替你审批操作。更早的版本只有 Pro、Max、Team 默认如此。
按 Shift+Tab 可以切换:从 auto 按一次到 manual,再依次是 accept edits 和 plan。想固定启动模式,在 ~/.claude/settings.json 写:
{
"permissions": {
"defaultMode": "manual"
}
}
两个细节:defaultMode: "auto" 写在项目的 .claude/settings.json 里不生效,必须放用户级文件;想彻底禁用 auto mode,官方的做法是在 managed settings 里设 permissions.disableAutoMode 为 "disable",那是给组织管理员用的。
常见问题怎么处理
| 现象 | 原因 | 处理 |
|---|---|---|
/model opus 后仍是旧版 Opus | Claude Code 低于 v2.1.280,别名没更新 | claude update,再 /status |
| 想固定在 Opus 5 不跟着升级 | 别名会随版本更新 | 用完整 ID,或设 ANTHROPIC_DEFAULT_OPUS_MODEL |
| 第三方平台报模型不可用 | 默认模型在你账号里还没启用 | Bedrock 和 Google Cloud 会自动退到旧版本,Foundry 直接报错,需要自己 pin 版本 |
| 设了 fallbackModel 但限流时没切 | 限流不在触发范围 | 换时间重试,或手动 /model sonnet |
| 敏感话题的请求被换了模型 | 安全回退机制 | /config 里的 “Switch models when a message is flagged” 或 switchModelsOnFlag 可调 |
我的判断
我的建议是默认就用 Opus 5.5 的 medium effort,不要一上来就开 max。大多数改代码的任务,medium 够用,真正卡住了再用 /effort high 重来一轮,比全程高档位省得多。
如果你每天都撞额度,别硬扛,把默认改成 opusplan,再配上 fallbackModel。预算紧的人(Pro 档)更应该这么做,因为额度规则没有公开数字,只能靠少用 Opus 来控制。
不适合的情况:只改几行配置、写提交信息、跑格式化,这类活用 Opus 是浪费,直接 /model sonnet。