Claude Sonnet 5.5 为仍在使用 Sonnet 5 的运营商带来五项 API 破坏性变更

五种在 Claude Sonnet 5 上可以正常运行的请求，在 Claude Sonnet 5.5 上将返回 400 invalid_request_error。Anthropic 于 2026 年 9 月 28 日发布新模型；TheRouter 对 anthropic/claude-sonnet-5-5 的路由当天即确认上线，一次探测请求在 2530 毫秒内完成。如果你的集成尚未对照破坏性变更清单审查，部分请求此刻可能正在无声失败。

强制工具调用变为硬性错误

最常见的触发点是 tool_choice。在 Claude Sonnet 5.5 上，将 tool_choice 设为 {"type": "any"} 或 {"type": "tool", "name": "..."} 会立即返回 400：

tool_choice: type "tool" and "any" are not supported for this model.

tool_choice: {"type": "auto"} 和 {"type": "none"} 仍然支持。如果你的管道依赖强制工具选择来保证结构化输出，需要迁移到带 strict: true 的严格工具调用，或者改用结构化输出。对大多数管道而言，最低成本的路径是去掉强制选择器，并在系统提示中用语言描述工具的适用场景。

thinking: disabled 被拒绝；改用 between_tools

Claude Sonnet 5.5 默认开启自适应思考。要关闭它，需发送 thinking: {"type": "between_tools"}——这是该模型的最低思考设置。发送旧的 thinking: {"type": "disabled"} 会返回一个 400，错误信息会指引你使用 between_tools。如果集成完全不使用工具，between_tools 实际上等同于抑制预先思考，响应只包含文本，行为与 Sonnet 5 上的 disabled 一致。

需要注意的一个细节：between_tools 仅在 low、medium 和 high 努力级别下有效。在 xhigh 或 max 级别下发送 between_tools 同样会返回 400。要在这些努力级别下运行，必须使用自适应思考（省略 thinking 字段，或发送 {"type": "adaptive"}）。

思考块与模型及会话绑定

Claude Sonnet 5.5 的思考块会记录产生它的模型，只在匹配的上下文中被接受。实际影响：如果你缓存了包含思考块的会话并在不同模型上回放，或发送来自其他组织账户的思考块，API 会静默丢弃该块，或返回 400——具体取决于账户创建日期以及是否发送了 thinking-binding-controls-2026-08-01 测试版请求头。

2026 年 8 月 31 日之后创建的账户默认强制执行严格的块绑定。在思考块产生之后，若系统提示、工具列表或更早的消息发生了变更，回放时将触发 400。解决方法是保持会话只追加、不修改，使用会话中系统消息更新指令，而非编辑原有系统字段。

对于在会话中间切换模型的运营商——例如在 Sonnet 5 上为 Anthropic 路由长上下文，再升级到 Sonnet 5.5——过渡是干净的：Sonnet 5.5 可以读取 Sonnet 5 的思考块。反向迁移（在 Claude API 和 Google Cloud 上升至 Claude Opus 5.5）同样支持。其他任何跨模型切换都会导致思考块被丢弃。

computer_20251124 在 Claude API 和 Google Cloud 上不再被接受

使用旧版 computer_20251124 工具类型的计算机使用集成，在 Claude API 和 Google Cloud 上将收到 400：

'claude-sonnet-5-5' does not support tool types: computer_20251124.

替代方案是 computer_toolset_20260801，在 Claude API 和 Google Cloud 上无需测试版请求头即可使用。Amazon Bedrock 上的 Sonnet 5.5 仍接受 computer_20251124，因此 Bedrock 集成无需立即更新。

迁移步骤：将旧的 tools 条目替换为 {"type": "computer_toolset_20260801"}，并更新代理循环以处理成员 tool_use 块和结果中的 toolset_name。已经使用该工具集或浏览器使用工具的集成无需改动。

顾问工具配对范围收窄

如果你正在使用顾问工具测试版，Claude Sonnet 5.5 执行器现在拒绝以 Claude Opus 4.8、Claude Opus 4.7 和 Claude Sonnet 5 作为顾问，并返回 400。可接受的顾问包括：Claude Mythos 5.1、Claude Fable 5.1、Claude Mythos 5、Claude Fable 5、Claude Opus 5.5、Claude Opus 5，或 Claude Sonnet 5.5 本身。每个被接受的顾问都会以加密的 advisor_redacted_result 块返回建议——客户端无法再直接读取建议文本。

未发生变化的内容

定价与 Claude Sonnet 5 完全相同：每百万 token 的输入输出费率不变，批处理折扣和缓存读取费率不变。Claude API 上的模型概览将 Sonnet 5.5 列在快速延迟层，与 Haiku 4.5 并列，支持 100 万 token 上下文窗口和 12.8 万 token 最大输出。需要完整规格（包括平台可用性和停用日期）的路由运营商，请直接查阅 Claude Sonnet 5.5 模型页面。

努力级别已重新校准。相同的努力值不会产生与 Sonnet 5 上相同深度的思考，因此直接沿用硬编码的努力设置会改变输出结果。Anthropic 建议一般任务从 high 开始，规格明确的 agent 编码任务从 medium 开始。

路由至新模型

TheRouter 对 anthropic/claude-sonnet-5-5 的路由已于 2026-10-05 确认可用；一次测试补全在 2530 毫秒内返回，共消耗 26 个 token（提示词 22 个，补全 4 个）。将集成固定在 claude-sonnet-5 而非当前别名的运营商，在切换目标模型 ID 前应对照上述五项破坏性变更完成审查。Anthropic 供应商页面列出了通过网关可用的全部 Claude 模型，定价参考涵盖本世代模型的 token 费率。