Claude Sonnet 5.5 是 Anthropic 在 Opus 5.5 之后推出的 Claude 5.5 家族第二款模型。相比 Sonnet 5，它更聪明、更高效，速度快 30%。每 token 价格与 Sonnet 5 持平，但完成同样的工作通常需要少得多的 token，所以大多数任务总成本最多降低 30%。

它面向范围明确、有清晰规格和可验证结果的日常任务：修 bug、快速迭代功能、制作文档/幻灯片/电子表格、执行可重复的 agent 任务（调查、审查、起草）。复杂且需要谨慎判断的长期工作，官方建议用 Opus 5.5。Epic Games 的早期测试称，Sonnet 5.5 在系统设计审计和数据流审查上达到了更高档模型的质量，能处理数万行代码的游戏系统架构，响应迅速，可运行多小时任务，且需要的提示规定更少。

定价方面，Sonnet 5.5 输入 $2/百万 token、输出 $10/百万 token，缓存写入 5 分钟 $2.50、1 小时 $4，缓存读取 $0.20；所有价格（含批处理和提示缓存）与 Sonnet 5 一致，仅美国推理价格为标准价的 1.1 倍。模型规格上，上下文窗口为 1M token（原生，无 beta），最大输出 128k token（批处理 API 最高 300k，需 beta header），知识截止 2026 年 6 月。思考默认开启（自适应思考），effort 分为 low/medium/high/xhigh/max，API 默认 high，Claude Code 默认 medium。图像输入走高分辨率层级，长边最大 2576 像素，一张 2000×1500 图像的 token 成本约为 Sonnet 4.6/4.5 或 Haiku 4.5 的 2.5 倍，不需要细节时应先缩小再发送。

从 Sonnet 5 迁移有五个破坏性变更和一个响应形状变化。第一，thinking 的 type 设为 disabled 会返回 400，改用 between_tools 可关闭预先思考，但它只支持 low/medium/high，且不能与 display、budget_tokens、block_binding 一起发送。第二，强制 tool_choice（any 或 tool）返回 400，需改为 auto，并把工具标记为 strict: true，同时每个对象的 schema 要带 additionalProperties: false。第三，对话必须保持只追加；Sonnet 5.5 能读取 Sonnet 5 的思考块，所以切换模型后推理能延续，但其他模型读不了 5.5 的思考块。第四，computer use 在 Claude API 和 Google Cloud 上只能通过 computer_toolset_20260801 使用，旧的 computer_20251124 声明和 beta header 都要移除，Amazon Bedrock 仍接受旧格式。第五，advisor 配对有兼容限制：Sonnet 5.5 执行器拒绝 Opus 4.8、Opus 4.7 和 Sonnet 5 作为 advisor，接受 Opus 5.5、Opus 5 和 Sonnet 5.5，且建议内容以加密的 advisor_redacted_result 块返回。第六个变更本身不会报错，但响应形状会变：工具调用之间的长笔记现在以 progress-update thinking blocks 返回，默认显示为空；在自适应思考模式下，需设置 thinking.display 为 updates 或 summarized 才能渲染这些块。官方提供了完整迁移指南；Claude Code 也能通过 /claude-api migrate 命令自动完成模型 ID 和破坏性参数的替换。

调优上，官方建议重新跑一遍 effort 评估，因为等级已重新校准，旧设置不延续。默认从 high 开始；agentic 编码和多步工具调用从 medium 开始，困难任务再升 high；聊天等延迟敏感场景用 medium 或 low；xhigh/max 仅在评测确认有质量提升时使用。如果倾向于用 xhigh 或 max，官方提醒这会想得更久、花更多钱，可能失去 Sonnet 在质量/速度/成本上的平衡，这时应考虑 Opus 5.5。思考会计入 max_tokens，agentic 编码建议把 max_tokens 设为 128,000 并流式响应。低 effort 下模型有时会跳过真正执行变更的检查，官方提供了一段系统提示，要求对可运行、可构建或可类型检查的代码先跑测试、类型检查或构建再报告完成。不要要求模型在回复中写出推理，否则容易触发 reasoning_extraction 拒绝，应改用 thinking.display 设为 summarized 读取思考。提示缓存的最小可缓存提示为 512 token（Sonnet 5 为 1024），更短的系统提示和工具定义也能缓存；缓存读取成本是输入价格的十分之一。顶层 effort 变化会使缓存失效，需要单轮不同 effort 时用 per-message effort（beta）保持缓存。

拒绝行为上，Sonnet 5.5 在自动行为审计中对齐和诚实指标大多改善或匹配 Sonnet 5，也是首个具备类似最强大模型网络安全防护的 Sonnet 模型。被拒请求返回 HTTP 200 和 stop_reason 为 refusal，stop_details 分为 cyber、bio、frontier_llm、reasoning_extraction、general_harms 五类；服务器端 fallback 只对 cyber 和 frontier_llm 拒绝在 Sonnet 5 上重试。模型今天已在 Claude API、Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry 上线。Claude Code 从 v2.1.284 起，sonnet 别名指向 Sonnet 5.5，默认 medium effort，无法关闭思考，也没有 fast mode；默认模型仍是 Opus 5.5，需要手动用 /model sonnet 切换。