Claude Sonnet 5.5 兼顾速度与智能，是两者的最佳组合。有五项 “breaking changes”（破坏性变更）会影响已在 Claude Sonnet 5 上运行的代码：

另有一项变更会改变响应结构，但不会导致任何请求失败：工具调用之间的文本以 thinking 块的形式返回。如果应用程序会将这些文本流式传输给用户，那么在工具调用之间，应用程序将不再输出任何内容。要恢复输出，需设置一个会返回该文本的 display 值，或使用 between_tools 关闭前置思考。

新模型

模型 Claude API ID 描述
Claude Sonnet 5.5 claude-sonnet-5-5 速度与智能的最佳组合

“Adaptive thinking”（自适应思考）默认开启，“effort parameter”（努力程度参数）用于控制思考深度。该参数在 Claude API 上的默认值为 high。“tokenizer”（分词器）与 Claude Sonnet 5 相同，因此相同的文本会产生相同的令牌数。有关 “context window”（上下文窗口）、输出限制、知识截止日期和价格，请参阅 Claude Sonnet 5.5 模型页面。

有关所有当前模型，请参阅模型概览。

破坏性变更

使用 between_tools 关闭前置思考

要在 Claude Sonnet 5.5 上关闭前置思考，请发送 thinking: {"type": "between_tools"}，而不是 "disabled"。这是该模型上最低的思考设置，在所有提供 Claude Sonnet 5.5 的平台上均可用，且无需 beta 标头。模型在工具调用之间写下的简短进度更新仍会以 thinking 块的形式返回，并附带摘要文本。请将这些块与助手轮次的其余部分一起原样传回。您传回的进度更新块会向模型提供它所写的完整笔记，而不是摘要。如果您的请求不使用工具，响应将只包含文本，与在 Claude Sonnet 5 上使用 disabled 时相同。

在 Claude Sonnet 5.5 上，发送 thinking: {"type": "disabled"} 的请求会返回 400 invalid_request_error，其消息会提示您改用 between_tools。

between_tools 可在 low、medium 和 high effort 下使用。在 xhigh 或 max effort 下，带有 between_tools 的请求会返回 400 错误。要以 xhigh 或 max 运行，请使用自适应思考：省略 thinking 字段或发送 thinking: {"type": "adaptive"}，两者等效。使用 between_tools 时，effort 无法在对话中途更改：与当前生效级别不同的逐消息 output_config.effort 会返回 400 错误。要为每个轮次设置不同的 effort，请使用自适应思考。

between_tools 不接受其他字段：与其一起发送 display、budget_tokens 或 block_binding 会返回 400 错误。手动思考预算（thinking: {"type": "enabled", "budget_tokens": N}）会返回 400 错误。请参阅思考以及迁移指南中的关闭前置思考。

不支持强制工具使用

Claude Sonnet 5.5 不支持 “forced tool use”（强制工具使用）。将 tool_choice 设置为 {"type": "any"} 或 {"type": "tool", "name": "..."} 会返回 400 invalid_request_error：

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

支持 tool_choice: {"type": "auto"}（默认值）和 {"type": "none"}。同样的检查也适用于令牌计数端点。要获得符合 schema 的工具输入，请保持 tool_choice: {"type": "auto"}，并通过严格工具使用设置 strict: true，或将 schema 移至结构化输出。要让模型调用工具而不是以文本回复，请在提示中说明何时适用该工具。迁移指南展示了修改前后的对比。

思考块与模型和对话绑定

每个思考块都会记录生成它的模型。每个模型都能读取自己的块，但只能读取部分其他模型的块。Claude Sonnet 5.5 可以读取来自 Claude Sonnet 5、Claude Opus 4.8、Claude Haiku 4.5 及更早模型的思考块，并且在 Claude API 和 Claude Models on Google Cloud (Google managed) 上还能读取来自 Claude Haiku 5.5 的思考块，但无法读取来自 Claude Opus 5、Claude Opus 5.5 或任何 Claude Fable 或 Claude Mythos 模型的思考块。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Opus 5.5 可以读取 Claude Sonnet 5.5 的思考块；其他模型均不能。

因此，从 Claude Sonnet 5 切换到 Claude Sonnet 5.5 的对话，或在 Claude API 和 Claude Models on Google Cloud (Google managed) 上从 Claude Sonnet 5.5 升级到 Claude Opus 5.5 的对话，会保留其推理内容；而任何其他离开 Claude Sonnet 5.5 的切换，切换后的轮次都将在没有这些推理内容的情况下运行。当请求携带目标模型无法读取的块时，API 会在模型看到它之前将其丢弃：请求会成功，且被丢弃的块不计费。使用 thinking-binding-controls-2026-08-01 beta 请求头时，丢弃情况会在顶层 input_transformations 数组中报告。请参阅在对话中途切换模型。

API 还会检查 Claude Sonnet 5.5 思考块之前的任何内容自该块生成以来是否发生了更改：system 提示、tools 或更早的消息。请保持对话仅追加：使用对话中途系统消息来更改指令或工具，而不是进行编辑。对于在 2026 年 8 月 31 日 00:00 UTC 或之后创建的账户，如果请求在此类更改后重放某个块且未设置 thinking.block_binding.prefix_mismatch_behavior，则会收到 400 错误。这适用于 Claude API、Amazon Bedrock 和 Claude Models on Google Cloud (Google managed)。对于在该日期之前创建的账户，仅当请求将该字段设置为 "error" 时才会收到该错误。如果要改为丢弃受影响的块，请发送 thinking-binding-controls-2026-08-01 beta 标头并将该字段设置为 "drop_block"。block_binding 仅适用于 thinking: {"type": "adaptive"}。使用任何其他思考设置时，您无法发送 block_binding，因此请删除错误中指明的块以及其后的每个 thinking 和 redacted_thinking 块，然后重试一次。

请参阅保留思考以及迁移指南中的关于思考块的说明。

Claude API 和 Claude Models on Google Cloud (Google managed) 上不支持 computer_20251124 计算机使用工具

在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Sonnet 5.5 仅通过 computer_toolset_20260801 工具集支持计算机使用。声明早期 computer_20251124 工具的请求会返回 400 invalid_request_error。在 Claude API 上，消息会指出被拒绝的类型，然后列出模型接受的工具类型。其开头为：

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

在 Amazon Bedrock 上，Claude Sonnet 5.5 接受早期的 computer_20251124 工具。

要迁移 Claude API 或 Claude Models on Google Cloud (Google managed) 上的现有集成，请按照从 computer_20251124 迁移中的说明操作，其中展示了迁移前后的请求。删除 beta 标头，将 tools 条目替换为 {"type": "computer_toolset_20260801"}，并更新您的智能体循环，以处理成员 tool_use 块、批量操作以及结果中的 toolset_name。该工具集在 Claude API 和 Claude Models on Google Cloud (Google managed) 上均可用。对于其他平台，请参阅计算机使用工具的 API 支持部分。已经使用该工具集的集成以及浏览器使用工具无需任何更改。

部分 Advisor 工具组合不受支持

使用 Advisor 工具（beta）时，Claude Sonnet 5.5 执行者需要以 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 本身作为顾问。Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5 和 Claude Haiku 5.5 顾问可与 Claude Sonnet 5 执行者配合使用，但与 Claude Sonnet 5.5 执行者配合时会返回 400 invalid_request_error。Claude Sonnet 5.5 接受的每个顾问都会以加密形式返回其建议，即 advisor_redacted_result 块，因此您的客户端无法读取建议文本。请参阅 Advisor 工具的模型兼容性和结果变体。

功能支持

Claude Sonnet 5.5 支持逐消息 effort（beta）、对话中途系统消息、对话中途工具更改（beta）、最小可缓存提示为 512 个令牌的提示缓存、批处理、Files API、PDF 支持、视觉，以及服务器端和客户端工具。逐消息 effort、对话中途系统消息和对话中途工具更改在 Claude Sonnet 5 上不可用，后者的最小可缓存提示为 1,024 个令牌。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，计算机使用需要 computer_toolset_20260801 工具集（请参阅计算机使用破坏性变更）。有关模型可用性，请参阅各功能的页面。

按需压缩（beta）

使用 compact-2026-09-04 beta 标头时，发送顶层 compaction 参数的请求会返回一个经过签名的 compaction 块，其中包含整个对话的摘要。之后，您需要将该块放在最前面发送，以替代被摘要的消息。压缩时机由您决定。在满足压缩与保留思考中所述条件的情况下，您保留的轮次中的思考块在替换后仍可保持有效。这一点对 Claude Sonnet 5.5 尤为重要，因为它的思考块与对话绑定。有关平台可用性和完整的请求流程，请参阅按需压缩。

在消息中定义工具（beta）

使用 inline-tools-2026-09-15 beta 标头时，对话中途系统消息中的 tool_addition 块可以携带完整的工具定义，而不仅仅是引用。这样，您可以在对话中途添加工具、更改其 schema，或将服务器工具升级到更新版本，而无需编辑 tools，也不会使提示缓存失效。请参阅在消息中定义工具。

思考块仅限于生成它们的账户

Claude Sonnet 5.5 生成的思考块仅在生成它们的账户或与其关联的账户中有效。当其他账户发送这些块之一时，API 会在模型接收之前丢弃该块，且请求会成功。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，使用 thinking-binding-controls-2026-08-01 beta 请求头时，响应会在 input_transformations 中列出每个被丢弃的块，并附带 reason: "organization_binding_mismatch"。来自早期模型的块不受影响。请参阅保留思考中的来自其他账户的思考块。

行为差异

即使不更改任何代码，Claude Sonnet 5.5 在以下几个方面也会表现出与 Claude Sonnet 5 的不同。Claude Sonnet 5.5 提示指南针对每一项都提供了指导：

  • 努力程度已重新校准。 同一努力程度级别产生的思考量与在 Claude Sonnet 5 上不同。请重新测试各个努力程度，而不是沿用原有设置。除非您的工作负载属于智能体类型或对延迟敏感，否则请从 high 开始。对于智能体编码和多步骤工具使用，明确定义的任务可从 medium 开始，更难或更长的任务再调整为 high。对于聊天和其他对延迟敏感的工作，请从 medium 或 low 开始。
  • 工具调用之间的文本以思考块返回。 在工具调用之间，长于一两句话的笔记会以进度更新 thinking 块返回。较短的评论仍为 text。在默认的 display: "omitted" 下，进度更新块的文本为空，因此将这些笔记流式传输给用户的应用程序在工具调用之间会保持静默，且不会报错。如果您使用 between_tools 关闭前置思考，文本会返回。要接收这些文本，请参阅迁移指南中的工具调用之间的文本以思考块返回。
  • 安全防护类别。 模型的安全防护措施可能会以五种 stop_details 类别拒绝请求。"cyber" 表示该请求可能导致网络危害。"bio" 表示它可能导致生物危害。"frontier_llm" 表示它可能有助于开发竞争性 AI 模型。"reasoning_extraction" 表示它要求模型在响应文本中复现其内部推理。"general_harms" 表示它属于其他使用政策领域。请参阅拒绝、回退和计费。

拒绝、回退和计费

拒绝和回退中的所有内容均适用于 Claude Sonnet 5.5。被拒绝的请求会返回 HTTP 200，带有 stop_reason: "refusal" 以及一个指明政策领域的 stop_details 对象。请处理拒绝并配置回退。服务器端回退（fallbacks: "default"）在 Claude API 和 Claude Models on Google Cloud (Anthropic managed) 上处于 beta 阶段，它会在 Claude Sonnet 5 上重试 "cyber" 和 "frontier_llm" 拒绝。它不会重试 "bio"、"reasoning_extraction" 或 "general_harms" 拒绝。您也可以使用 SDK 中间件或您自己的重试逻辑。在产生任何输出之前到达的拒绝是否计费取决于其拒绝类别，并且无论哪种情况都会计入您的“rate limit”（速率限制）。请参阅拒绝的计费方式。

定价

Claude Sonnet 5.5 的价格与 Claude Sonnet 5 相同，但提示缓存读取除外，其费用为每百万令牌 0.10 美元，是 Claude Sonnet 5 费率的一半。有关完整价目表、数据驻留和工具定价，请参阅定价。

可用性

Claude Sonnet 5.5 可在以下平台使用：

从 Claude Sonnet 5 迁移

更新您的模型 ID：

Python

model = "claude-sonnet-5"  # Before
model = "claude-sonnet-5-5"  # After

TypeScript

let model = "claude-sonnet-5"; // Before
model = "claude-sonnet-5-5"; // After

C#

var model = Model.ClaudeSonnet5; // Before
model = Model.ClaudeSonnet5_5; // After

Go

model := anthropic.ModelClaudeSonnet5  // Before
model = anthropic.ModelClaudeSonnet5_5 // After

Java

Model model = Model.CLAUDE_SONNET_5; // Before
model = Model.CLAUDE_SONNET_5_5; // After

PHP

$model = Model::CLAUDE_SONNET_5; // Before
$model = Model::CLAUDE_SONNET_5_5; // After

Ruby

model = Anthropic::Model::CLAUDE_SONNET_5 # Before
model = Anthropic::Model::CLAUDE_SONNET_5_5 # After

然后检查以下六项：

  1. 如果您的代码使用 disabled 关闭思考，请改为发送 between_tools，并使用 high 或更低的努力程度。
  2. 将 tool_choice 类型 any 和 tool 替换为 auto 加上严格工具使用。
  3. 保持对话仅追加。在编辑较早的历史记录后重放 Claude Sonnet 5.5 思考块的请求可能会返回 400 错误。请参阅思考块与模型和对话绑定。
  4. 如果您在 Claude API 或 Claude Models on Google Cloud (Google managed) 上通过 computer_20251124 使用计算机使用功能，请迁移到工具集。
  5. 如果您将 Advisor 工具与 Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5 或 Claude Haiku 5.5 顾问一起使用，请切换到 Claude Sonnet 5.5 接受的顾问。
  6. 如果您的界面会显示工具调用之间的文本，请在使用自适应思考时设置 thinking.display。使用 between_tools 时，无需设置该字段文本也会返回。请参阅工具调用之间的文本在思考块中返回。

迁移指南提供了从 Claude Sonnet 5 及更早模型迁移的分步说明以及完整的检查清单。

后续步骤

  • 模型概览：所有当前 Claude 模型的完整规格和定价。

  • 迁移指南：将代码从 Claude Sonnet 5 及更早模型迁移到 Claude Sonnet 5.5。

  • Claude Sonnet 5.5 提示指南：Claude Sonnet 5.5 特有的行为差异和提示模式。

  • Effort：控制 Claude 在响应时使用的令牌数量，从 low 到 max。

  • 思考：自适应思考的工作原理以及思考块的保留方式。

  • 拒绝与回退：处理 stop_reason: "refusal" 并在其他模型上重试。