Newsroom
AIEII

Claude Code 怎么切换 Opus 5.5:/model 用法、降级和常见报错

Claude Code 里输入 /model opus 就能切到 Opus 5.5,需要 v2.1.280 以上。本文讲别名、默认模型、effort 档位、fallbackModel 降级配置,以及版本过低时的处理。

TL;DR
  • 会话里输入 /model opus 即切到 Opus 5.5(模型 ID claude-opus-5-5),要求 Claude Code v2.1.280 或更高;Pro、Max、Team、Enterprise 和 API 账号的默认模型本来就是 Opus 5.5。
  • 想省额度:Opus 5.5 默认 effort 是 medium,日常活用 /model sonnet 切到 Sonnet 5.5(需 v2.1.284),或用 opusplan 让 Opus 只负责规划。
  • 想自动降级:在 settings.json 写 fallbackModel 数组,最多 3 个模型,只在模型过载或不可用时切换,限流和额度报错不会触发。
Claude Code 怎么切换 Opus 5.5:/model 用法、降级和常见报错

在 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 账号上,三个常用别名现在解析成:

别名解析结果最低版本
opusOpus 5.5v2.1.280
sonnetSonnet 5.5v2.1.284
haikuHaiku 5.5v2.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 能跑多少次,第三方文章里的具体数字我没法在官方页面核实,这里不引用。能确定的省额度手段有三个:

  1. 保持 medium effort。 Opus 5.5 的默认 effort 是 medium,可选 low、medium、high、xhigh、max。用 /effort 或 --effort 调整,难题再拉高。
  2. 日常活切 Sonnet 5.5。 /model sonnet,改文案、写测试、小重构都够用。API 价格上 Sonnet 5.5 也比 Opus 5.5 便宜,价格明细见 Opus 5.5 API 定价那篇。
  3. 用 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 后仍是旧版 OpusClaude 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。

相关阅读

参考

常见问题

Claude Code 怎么切换到 Opus 5.5?
会话中输入 /model opus,或启动时 claude –model opus。Anthropic API 上 opus 别名已解析到 Opus 5.5,也可以写完整 ID claude-opus-5-5。需要 Claude Code v2.1.280 以上,旧版本先 claude update。
/model 选的模型会一直保留吗?
会。官方文档写明 /model 会把选择存为默认值;在选择器里按 Enter 是保存,按 s 只对当前会话生效。–model 和 ANTHROPIC_MODEL 只对启动的那次会话有效。
Opus 5.5 额度用得快怎么办?
Anthropic 没有公布各档订阅的具体次数。降低消耗的办法是日常任务切 Sonnet 5.5、用 opusplan 拆分规划和执行、保持默认 medium effort,并用 /usage 看剩余额度。
模型过载时能自动换成 Sonnet 吗?
可以,配置 fallbackModel 或启动时加 –fallback-model sonnet,haiku。最多串 3 个模型,只在过载、不可用或不可重试的服务端错误时切换,且只持续当前这一轮。
广告合作联系
立即联系 →
加入会员申请
了解详情 →
← Claude Opus 5.5 API 多少钱:$4/$20 … MCP server 怎么从零写:Python 示例、调试和 … →
💬 Comments
4 min read