要在 Claude Code 中使用 Claude Sonnet 5.5，请更新到 v2.1.284 或更高版本，然后用 claude --model claude-sonnet-5-5 启动，或用 /model 选择它。你需要付费的 Claude 套餐（Pro、Max、Team 或 Enterprise）或 Anthropic API key；Free 套餐不包含 Claude Code。在所有这些情况下默认模型仍是 Opus 5.5，所以只有你主动选择时才会用到 Sonnet 5.5。按 API 费率计算，它的成本只有一半：每百万输入/输出 token $2/$10，而 Opus 5.5 是 $4/$20。
下文涵盖：配置、sonnet 别名的陷阱、effort、需要引导的习惯、成本，以及什么情况下仍应使用 Opus 5.5。关于模型本身，请参阅什么是 Claude Sonnet 5.5。如果你的代码会调用 API，Apifox 可以保存 Claude Code 针对你的改动运行的测试场景。
Claude Code 中的 Claude Sonnet 5.5 速览
| 设置项 | Sonnet 5.5 |
|---|---|
| 最低版本 | v2.1.284 |
| 套餐 | Pro、Max、Team、Enterprise、API key；不含 Free |
| 默认模型 | Opus 5.5，所以需要你自己选择 Sonnet 5.5 |
sonnet 别名 |
仅在 Anthropic API 上指向 Sonnet 5.5 |
| 上下文窗口 | 原生 1M |
| 默认 effort | medium；无法关闭思考 |
| 快速模式 | 不可用 |
来源：Claude Code 的模型配置文档和 Anthropic 的发布文章。
第 1 步：更新 Claude Code 并确认你的套餐
Sonnet 5.5 于 2026 年 9 月 28 日随 Claude Code v2.1.284 一起到来，更早的版本无法运行它：
claude update
根据 claude.com/pricing，Pro 按年付费为每月 $17，按月付费为 $20，Max 起价 $100。Free 用户可以在 Claude.ai 上与 Sonnet 5.5 对话，但不能在 Claude Code 中使用；我们的免费使用指南介绍了哪些方式可行。
第 2 步：把模型切换为 Sonnet 5.5
claude --model claude-sonnet-5-5
在会话中，/model claude-sonnet-5-5 会切换并将它保存为默认值。单独运行 /model 会打开选择器，在其中按 s 只对当前会话切换。ANTHROPIC_MODEL 或设置文件中的 "model" 项同样可用，/status 会显示当前生效的配置。
/model 的切换也会作用于继承主模型的 subagent，而恢复的会话会保留它保存时的模型。如果你曾按照我们那篇 Sonnet 5 Claude Code 指南固定了 claude-sonnet-5，请更新它：完整 ID 不会随别名一起变动。
sonnet 别名并非在所有地方都代表 Sonnet 5.5
sonnet 仅在 Anthropic API 上指向 Sonnet 5.5：
| 提供方 | sonnet 解析为 |
|---|---|
| Anthropic API | Sonnet 5.5 |
| Claude Platform on AWS | Sonnet 4.6 |
| Amazon Bedrock、Google Cloud 的 Agent Platform | Sonnet 4.5 |
| Microsoft Foundry | Sonnet 4.5 |
在云厂商上，请把 ANTHROPIC_DEFAULT_SONNET_MODEL 设为你所用提供方的 Sonnet 5.5 ID：Google Cloud 和 Claude Platform on AWS 上是 claude-sonnet-5-5，Foundry 上是你的部署名称，Bedrock 上是你的推理配置文件。同一个变量也决定 opusplan 执行时使用的模型。
不要再加 sonnet[1m]：文档说明，当 sonnet 指向 Sonnet 5.5 后它不再有任何作用，因为其 1M 窗口是原生支持的。
第 3 步：选择 effort 等级（思考保持开启）
在 Claude Code 中 Sonnet 5.5 默认从 medium 起步，比它在 Claude Platform API 上的 high 默认值低一级。等级依次为 low、medium、high、xhigh、max：
claude --model claude-sonnet-5-5 --effort high
在会话中，/effort high 会为当前模型保存一个等级，/effort 会打开滑杆，/effort auto 会清除该设置。CLAUDE_CODE_EFFORT_LEVEL 可从环境变量设置。在对话中途更改 effort 可能使提示词缓存失效，因此 Claude Code 可能会先给出提醒。
在这里你无法关闭思考。Option+T（Alt+T）开关、alwaysThinkingEnabled 和 MAX_THINKING_TOKENS=0 对 Sonnet 5.5 都没有效果。Anthropic 的提示词指南还指出，从 medium 起，它几乎每次回复前都会思考，而要求它“少思考”并不可靠。更好的做法是降低 effort，或在某条提示词中加入 ultrathink，以获得单次更深入的回合。
各等级在 CursorBench 上的表现
Cursor 在其自有测试框架中测得以下 CursorBench 4.0 分数；每项任务的成本来自 Anthropic 的发布图表。
| Effort | Sonnet 5.5 | Opus 5.5 |
|---|---|---|
low |
35.8%（$0.50） | 43.7%（$1.17） |
medium |
39.2%（$0.70） | 52.5%（$2.91） |
high |
47.8%（$1.67） | 56.0%（$3.97） |
xhigh |
53.1%（$3.88） | 56.0%（$6.98） |
max |
55.5%（$9.67） | 57.8%（$13.43） |
从 low 到 high，Sonnet 5.5 在相同等级下的成本不到 Opus 5.5 的一半。但跨等级来看：Opus 5.5 在 medium（$2.91）的得分高于 Sonnet 在 high 的得分，并且与 Sonnet 在 xhigh（成本 $3.88）的得分相差不到一个点。如果你要把 Sonnet 5.5 推到 xhigh 或 max，不妨先试试 medium 下的 Opus 5.5。
引导编码会话中出现的习惯
Anthropic 的Sonnet 5.5 提示词指南指出了在 Claude Code 中值得注意的行为：
- 在长时间的 agentic 任务中，它在
low和medium下会过早确认进度。 - 它会添加你并未要求的测试、文档和小文件，在每个 effort 等级下都是如此。
- 在
xhigh和max下，它会启动额外的评审轮次或评审 subagent。Anthropic 将其与 FrontierCode 分数的下降联系起来：max为 46.2%，低于xhigh的 52.1%。 - 在
low下它可能跳过验证，不运行测试就报告代码已完成。
该指南收录了 Anthropic 自己建议的提示词段落；在 Anthropic 的测试中，其中一段在 max 下把会话成本降低了约三分之一。下面是一组我们用自己措辞写成的较短版本，可改写后放进你的 CLAUDE.md：
## How to work in this repo
- Keep working until the task is done. Stop to ask only if you are blocked or about to delete data.
- Change only what the task needs. No new tests, docs or files unless I ask.
- Before saying a task is done, run the relevant tests and show the command and result.
- Don't start reviewer subagents unless I ask for a review.
快速模式、opusplan 与混用模型
快速模式仅支持 Opus：根据快速模式文档，包括 Opus 5.5、Opus 5 和 Opus 4.8。在 Sonnet 5.5 上运行 /fast 会把会话切换到 Opus。Sonnet 的速度来自模型本身，Anthropic 称其比 Sonnet 5 快“30%+”。
claude --model opusplan 在 plan 模式下使用 Opus，在执行阶段使用 Sonnet。它适合设计困难、改动常规的工作。Creator 的 Kevin Ngo 在 Anthropic 发布页上被引用时说，他会让 Sonnet 5.5 来搭建由 Opus 5.5 确定的游戏架构。你也可以保留 Opus 作为主模型，并为 subagent 设置 CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5。我们的 Claude Code 工作流指南还有更多模式。
何时应继续使用 Opus 5.5
Anthropic 表示 Opus 5.5“在复杂、开放式的工作上仍然明显更强”，而 Sonnet 5.5 最擅长范围清晰的任务和 bug 修复。系统卡（由 Anthropic 运行）的结论一致：在 max effort 下 SWE-Bench Pro 为 81.3 对 89.9；长上下文测试 ProgramBench 为 79.7 对 91.2。
对于含糊的 bug、架构决策、大型代码库会话和快速模式，请继续使用 Opus 5.5。对于范围明确的修复、有规格说明的功能、测试、文档和 subagent 任务，选择 Sonnet 5.5。Sonnet 确实在 Terminal-Bench 4.0 上领先（max 下 70.6%，xhigh 下 66.4%），但这是 Anthropic 自己跑的，而且回退影响了 10% 的 Opus 测试，Sonnet 仅为 1.5%。详见 Sonnet 5.5 对比 Opus 5.5。
一次会话的成本
使用 API key 时，Claude Code 按标价计费：Sonnet 5.5 为每 MTok $2/$10，Opus 5.5 为 $4/$20，两者的缓存读取都是 $0.20。Anthropic 还声称相比 Sonnet 5“每个任务最多可少花 30%”。
在 Pro、Max、Team 或 Enterprise 上，会话改为消耗套餐的用量限制，/usage 会显示你的使用情况。我们没有找到关于各模型如何计入这些限制的公开数据，所以请在你自己的任务上实测。
注意 max：Simon Willison 在 Hacker News 上报告称，他在 max 下的 pelican 测试约 15 分钟就消耗了 128,000 个思考 token，还没产出 SVG 就用完了。更多算法见 Sonnet 5.5 价格。
在 Claude Code 内部迁移 API 项目
如果你的应用通过 API 调用 Sonnet 5，Claude Code 可以帮你迁移：
/claude-api migrate this project to claude-sonnet-5-5
要预期确实存在破坏性变更：thinking: {"type": "disabled"} 会返回 400，需要改为 between_tools；强制的 tool_choice 让位于 auto 加带 strict: true 的工具；非默认的 temperature、top_p 或 top_k 会返回 400。Sonnet 5.5 对比 Sonnet 5 逐一介绍了每种修复方式。
然后针对真实 API 测试。在 Apifox 中把新旧请求保存为一组，把 ANTHROPIC_API_KEY 放在环境变量里，并对 stop_reason 和 usage 做断言，这样出现拒答或输出 token 激增时就会表现为测试失败。
使用 Apifox CLI 运行你的 API 测试
由于 Sonnet 5.5 在 low 下可能跳过测试，给它一个可运行的测试吧。Apifox CLI 可在终端中运行你保存的 Apifox 测试场景，因此 Claude Code 可以发起运行、读取结果、修复处理逻辑并重新运行。往 CLAUDE.md 里加一条规则：
- After changing an API endpoint, run its Apidog test scenario with the Apidog CLI and report pass and fail counts.
配置方法见 Claude Code 中的 Apifox CLI，GitHub Copilot 版本见 GitHub Copilot 中的 Apifox CLI。
GitHub Copilot 和 Cursor 中的 Sonnet 5.5
GitHub Copilot。根据GitHub 的更新日志，Sonnet 5.5 于 9 月 28 日在 Copilot Pro、Pro+、Max、Business 和 Enterprise 上正式可用，按提供方标价计费。它可在 VS Code、JetBrains、Copilot CLI、编码 agent 等中使用，并逐步放开。Copilot Free 和 Student 无法使用；这些套餐仅限自动模型选择，而其中不包含 Sonnet 5.5。
Cursor。Cursor 的模型页面列出 claude-sonnet-5-5，默认上下文 200k、最大 1M，在 Pro 及以上按 Other Models 额度池以同样的 $2/$10 费率计费。仅限美国的 endpoint 贵 10%。Cursor 尚未为其发布更新日志。
常见问题
Sonnet 5.5 是 Claude Code 中的默认模型吗？不是。default 在 Pro、Max、Team、Enterprise 和 Anthropic API 上都是 Opus 5.5。请用 --model 或 /model 选择 Sonnet 5.5。
我可以在 Free 套餐上使用 Claude Code 吗？不可以，Claude Code 仅限付费用户。Free 用户可以在 Claude.ai 上与它对话；参见如何免费使用 Sonnet 5.5。
为什么 /model sonnet 给我的是更旧的模型？你使用的是云厂商（Bedrock、Google Cloud、Foundry、Claude Platform on AWS），或版本早于 v2.1.284。请指定完整 ID。
它比 Opus 5.5 便宜多少？按 API 标价是一半。见价格拆解。
你的下一步
运行 claude update，用 claude --model claude-sonnet-5-5 开始你下一个范围明确的任务，并把 effort 保持在 medium 几天。加上 CLAUDE.md 规则，把设计密集型的工作交给 opusplan，并让 Opus 5.5 始终只差一个 /model。如果工作涉及 API，请接入 Apifox CLI，让每一次“完成”背后都有一次测试运行。Apifox 可免费开始使用。
HiFox：将 Agent 变成真正的队友
另外，我们也在思考，AI 如何从个人提效走进团队协作。
HiFox 是一个让人和 AI Agent 在同一个工作现场协作的平台：你可以像给同事分派任务一样指派 Agent，在任务看板中跟踪进度、查看结果，让 Agent 成为团队里的队友。
👉 立即体验 HiFox：https://hifox.com
AI Coding 交流群
如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，
欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。
