--- title: Claude Sonnet 5.5 的新变化 url: https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5 description: 从 Claude Sonnet 5 迁移到 Claude Sonnet 5.5 时会发生哪些变化：破坏性变更、功能支持、行为差异、定价和可用性。 --- Claude Sonnet 5.5 兼顾速度与智能，是两者的最佳组合。有五项 "breaking changes"（破坏性变更）会影响已在 Claude Sonnet 5 上运行的代码： * [使用 `between_tools` 关闭前置思考](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#turn-off-up-front-thinking)。 * [强制工具使用会返回错误](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#forced-tool-use-is-not-supported)。 * [思考块与模型和对话绑定](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them)。 * [在 Claude API 和 Google Cloud 上，不再接受早期的 `computer_20251124` 计算机使用工具](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#computer-20251124-is-not-supported)。 * [顾问工具拒绝将 Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5 和 Claude Haiku 5.5 作为顾问](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#advisor-tool-pairings)。 另有一项变更会改变响应结构，但不会导致任何请求失败：[工具调用之间的文本以 `thinking` 块的形式返回](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#text-between-tool-calls)。如果应用程序会将这些文本流式传输给用户，那么在工具调用之间，应用程序将不再输出任何内容。要恢复输出，需设置一个会返回该文本的 `display` 值，或使用 `between_tools` 关闭前置思考。 ## 新模型 | 模型 | Claude API ID | 描述 | | ----------------- | ----------------- | ---------- | | Claude Sonnet 5.5 | claude-sonnet-5-5 | 速度与智能的最佳组合 | "[Adaptive thinking](https://platform.claude.com/docs/zh-CN/build-with-claude/thinking)"（自适应思考）默认开启，"[effort parameter](https://platform.claude.com/docs/zh-CN/build-with-claude/effort)"（努力程度参数）用于控制思考深度。该参数在 Claude API 上的默认值为 `high`。"tokenizer"（分词器）与 Claude Sonnet 5 相同，因此相同的文本会产生相同的令牌数。有关 "context window"（上下文窗口）、输出限制、知识截止日期和价格，请参阅 [Claude Sonnet 5.5 模型页面](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/overview)。 有关所有当前模型，请参阅[模型概览](https://platform.claude.com/docs/zh-CN/models/overview)。 ## 破坏性变更 ### 使用 `between_tools` 关闭前置思考 要在 Claude Sonnet 5.5 上关闭前置思考，请发送 `thinking: {"type": "between_tools"}`，而不是 `"disabled"`。这是该模型上最低的思考设置，在所有提供 Claude Sonnet 5.5 的平台上均可用，且无需 beta 标头。模型在工具调用之间写下的简短[进度更新](https://platform.claude.com/docs/zh-CN/build-with-claude/thinking#progress-updates)仍会以 `thinking` 块的形式返回，并附带摘要文本。请将这些块与助手轮次的其余部分一起原样传回。您传回的进度更新块会向模型提供它所写的完整笔记，而不是摘要。如果您的请求不使用工具，响应将只包含文本，与在 Claude Sonnet 5 上使用 `disabled` 时相同。 在 Claude Sonnet 5.5 上，发送 `thinking: {"type": "disabled"}` 的请求会返回 400 `invalid_request_error`，其消息会提示您改用 `between_tools`。 `between_tools` 可在 `low`、`medium` 和 `high` 努力程度下使用。在 `xhigh` 或 `max` 努力程度下，使用 `between_tools` 的请求会返回 400 错误。要以 `xhigh` 或 `max` 运行，请使用自适应思考：省略 `thinking` 字段，或发送与之等效的 `thinking: {"type": "adaptive"}`。使用 `between_tools` 时，努力程度不能在对话中途更改：如果[按消息](https://platform.claude.com/docs/zh-CN/build-with-claude/effort#change-effort-mid-conversation-beta)设置的 `output_config.effort` 与当前生效的级别不同，将返回 400 错误。要按轮次调整努力程度，请使用自适应思考。 `between_tools` 不接受任何其他字段：与其一同发送 `display`、`budget_tokens` 或 `block_binding` 会返回 400 错误。手动思考预算（`thinking: {"type": "enabled", "budget_tokens": N}`）也会返回 400 错误。请参阅[思考](https://platform.claude.com/docs/zh-CN/build-with-claude/thinking)以及迁移指南中的[前后对比](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/migration-guide#turn-off-up-front-thinking)。 ### 不支持强制工具使用 Claude Sonnet 5.5 不支持 "forced tool use"（强制工具使用）。将 `tool_choice` 设置为 `{"type": "any"}` 或 `{"type": "tool", "name": "..."}` 会返回 400 `invalid_request_error`： ```text wrap tool_choice: type "tool" and "any" are not supported for this model. ``` 支持 `tool_choice: {"type": "auto"}`（默认值）和 `{"type": "none"}`。[令牌计数](https://platform.claude.com/docs/zh-CN/build-with-claude/token-counting)端点也会执行相同的检查。如需符合 schema 的工具输入，请保留 `tool_choice: {"type": "auto"}`，并通过[严格工具使用](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/strict-tool-use)设置 `strict: true`，或将 schema 移至[结构化输出](https://platform.claude.com/docs/zh-CN/build-with-claude/structured-outputs)。要让模型调用工具而不是以文本回复，请在提示中说明何时应使用该工具。迁移指南展示了[前后对比](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/migration-guide#forced-tool-use)。 ### 思考块与模型和对话绑定 每个思考块都会记录生成它的模型。每个模型都能读取自己的块，但只能读取部分其他模型的块。Claude Sonnet 5.5 可以读取来自 Claude Sonnet 5、Claude Opus 4.8、Claude Haiku 4.5 及更早模型的思考块，在 Claude API 和 Google Cloud 上还可以读取来自 Claude Haiku 5.5 的思考块，但不能读取来自 Claude Opus 5、Claude Opus 5.5 或任何 Claude Fable 或 Claude Mythos 模型的思考块。在 Claude API 和 Google Cloud 上，Claude Opus 5.5 可以读取 Claude Sonnet 5.5 的思考块；其他模型均不能。 因此，从 Claude Sonnet 5 切换到 Claude Sonnet 5.5 的对话，或在 Claude API 和 Google Cloud 上从 Claude Sonnet 5.5 升级到 Claude Opus 5.5 的对话，会保留其推理内容；而从 Claude Sonnet 5.5 进行的任何其他切换，在切换后的轮次中都将不带推理内容运行。当请求携带目标模型无法读取的块时，API 会在模型看到之前将其丢弃：请求会成功，且被丢弃的块不计费。使用 `thinking-binding-controls-2026-08-01` beta 标头时，丢弃情况会在顶层的 `input_transformations` 数组中报告。请参阅[在对话中途切换模型](https://platform.claude.com/docs/zh-CN/build-with-claude/preserved-thinking#switching-models)。 API 还会检查 Claude Sonnet 5.5 思考块之前的任何内容自该块生成以来是否发生了变化：`system` 提示、`tools` 或较早的消息。对于在 2026 年 8 月 31 日 00:00 UTC 或之后创建的账户，该检查在 Claude API、Amazon Bedrock 和 Google Cloud 上默认强制执行。在这些账户上，在发生此类更改后重放某个块的请求会返回 400 错误。若要改为丢弃受影响的块，请发送 `thinking-binding-controls-2026-08-01` beta 标头，并将 `thinking.block_binding.prefix_mismatch_behavior` 设置为 `"drop_block"`。在较旧的账户上，将该字段设置为任一值都会使请求选择启用该检查。`block_binding` 仅适用于 `thinking: {"type": "adaptive"}`。使用 `between_tools` 时，请保持历史记录仅追加，或从被编辑的轮次起删除思考块。 保持对话仅追加，这样检查就永远不会失败：使用[对话中途的系统消息](https://platform.claude.com/docs/zh-CN/build-with-claude/mid-conversation-system-messages)来更改指令或工具，而不是进行编辑。请参阅[保留思考](https://platform.claude.com/docs/zh-CN/build-with-claude/preserved-thinking)以及迁移指南中[关于此变更的说明](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/migration-guide#thinking-blocks)。 ### Claude API 和 Google Cloud 不支持 `computer_20251124` 计算机使用工具 在 Claude API 和 Google Cloud 上，Claude Sonnet 5.5 仅通过 `computer_toolset_20260801` 工具集支持 "[computer use](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/computer-use-tool)"（计算机使用）。声明早期 `computer_20251124` 工具的请求会返回 400 `invalid_request_error`。在 Claude API 上，错误消息会先指出被拒绝的类型，然后列出该模型接受的工具类型。消息开头如下： ```text wrap 'claude-sonnet-5-5' does not support tool types: computer_20251124. ``` 在 Amazon Bedrock 上，Claude Sonnet 5.5 接受早期的 `computer_20251124` 工具。 要迁移在 Claude API 或 Google Cloud 上的现有集成，请按照[从 `computer_20251124` 迁移](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124)操作，其中展示了请求的前后对比。移除 beta 标头，将 `tools` 条目替换为 `{"type": "computer_toolset_20260801"}`，并更新您的智能体循环以处理成员 `tool_use` 块、批量操作以及结果中的 `toolset_name`。该工具集在 Claude API 和 Google Cloud 上可用。有关其他平台，请参阅计算机使用工具的[兼容性](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/computer-use-tool#compatibility)部分。已经使用该工具集的集成以及[浏览器使用工具](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/browser-use-tool)无需更改。 ### 部分顾问工具组合不受支持 使用[顾问工具](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/advisor-tool)（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` 块，因此您的客户端无法读取建议文本。请参阅顾问工具的[模型兼容性](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/advisor-tool#model-compatibility)和[结果变体](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/advisor-tool#result-variants)。 ## 功能支持 Claude Sonnet 5.5 支持以下功能：[按消息设置努力程度](https://platform.claude.com/docs/zh-CN/build-with-claude/effort#change-effort-mid-conversation-beta)（beta）、[对话中途的系统消息](https://platform.claude.com/docs/zh-CN/build-with-claude/mid-conversation-system-messages)、[对话中途的工具更改](https://platform.claude.com/docs/zh-CN/build-with-claude/mid-conversation-system-messages#mid-conversation-tool-changes)（beta）、"[prompt caching](https://platform.claude.com/docs/zh-CN/build-with-claude/prompt-caching)"（提示缓存，最小可缓存提示为 512 个令牌）、[批处理](https://platform.claude.com/docs/zh-CN/build-with-claude/batch-processing)、[Files API](https://platform.claude.com/docs/zh-CN/build-with-claude/files)、[PDF 支持](https://platform.claude.com/docs/zh-CN/build-with-claude/pdf-support)、[视觉](https://platform.claude.com/docs/zh-CN/build-with-claude/vision)，以及服务器端和客户端[工具](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/overview)。Claude Sonnet 5 不支持按消息设置努力程度、对话中途的系统消息和对话中途的工具更改，其最小可缓存提示为 1,024 个令牌。在 Claude API 和 Google Cloud 上，计算机使用需要 `computer_toolset_20260801` 工具集（请参阅[破坏性变更](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#computer-20251124-is-not-supported)）。有关各模型的可用性，请参阅各功能的页面。 ### 按需压缩（beta） 使用 `compact-2026-09-04` beta 标头时，发送顶层 `compaction` 参数的请求会返回一个经过签名的 `compaction` 块，其中包含整个对话的摘要。之后，您需要将该块放在最前面发送，以替代被摘要的消息。压缩时机由您决定。在满足[压缩与保留思考](https://platform.claude.com/docs/zh-CN/build-with-claude/compaction-thinking-blocks#conditions-for-kept-thinking-to-stay-valid)中所述条件的情况下，您保留的轮次中的思考块在替换后仍可保持有效。这一点对 Claude Sonnet 5.5 尤为重要，因为它的[思考块与对话绑定](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them)。有关平台可用性和完整的请求流程，请参阅[按需压缩](https://platform.claude.com/docs/zh-CN/build-with-claude/compaction-on-demand)。 ### 在消息中定义工具（beta） 使用 `inline-tools-2026-09-15` beta 标头时，对话中途系统消息中的 `tool_addition` 块可以携带完整的工具定义，而不仅仅是引用。这样，您可以在对话中途添加工具、更改其 schema，或将服务器工具升级到更新版本，而无需编辑 `tools`，也不会使提示缓存失效。请参阅[在消息中定义工具](https://platform.claude.com/docs/zh-CN/build-with-claude/mid-conversation-system-messages#define-tools-in-a-message-beta)。 ### 思考块仅限于生成它们的账户 Claude Sonnet 5.5 生成的思考块仅在生成它们的账户或与其关联的账户中有效。当其他账户发送这些块之一时，API 会在模型看到之前丢弃该块，且请求会成功。在 Claude API 和 Google Cloud 上，使用 `thinking-binding-controls-2026-08-01` beta 标头时，响应会在 `input_transformations` 中列出每个被丢弃的块，并附带 `reason: "organization_binding_mismatch"`。来自较早模型的块不受影响。请参阅[保留思考](https://platform.claude.com/docs/zh-CN/build-with-claude/preserved-thinking#account-bound-thinking)。 ## 行为差异 即使不更改任何代码，Claude Sonnet 5.5 在以下几个方面也会表现出与 Claude Sonnet 5 的不同。[Claude Sonnet 5.5 提示指南](https://platform.claude.com/docs/zh-CN/build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5)针对每一项都提供了指导： * **努力程度已重新校准。** 同一[努力程度](https://platform.claude.com/docs/zh-CN/build-with-claude/effort)级别产生的思考量与在 Claude Sonnet 5 上不同。请重新测试各个努力程度，而不是沿用原有设置。除非您的工作负载属于智能体类型或对延迟敏感，否则请从 `high` 开始。对于智能体编码和多步骤工具使用，明确定义的任务可从 `medium` 开始，更难或更长的任务再调整为 `high`。对于聊天和其他对延迟敏感的工作，请从 `medium` 或 `low` 开始。 * **工具调用之间的文本以思考块的形式返回。** 在工具调用之间，超过一两句话的笔记会以[进度更新 `thinking` 块](https://platform.claude.com/docs/zh-CN/build-with-claude/thinking#progress-updates)的形式返回，较短的说明仍为 `text`。在默认的 `display: "omitted"` 设置下，进度更新块的文本为空，因此会将这些笔记流式传输给用户的应用程序在工具调用之间将不再输出任何内容，且不会报错。如果您[使用 `between_tools` 关闭前置思考](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#turn-off-up-front-thinking)，文本会重新返回。[迁移指南](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/migration-guide#text-between-tool-calls)介绍了如何接收这些文本。 * **安全防护类别。** 模型的安全防护机制可能会以五种 [`stop_details` 类别](https://platform.claude.com/docs/zh-CN/build-with-claude/refusals-and-fallback#refusal-response)之一拒绝请求。`"cyber"` 表示该请求可能助长网络危害。`"bio"` 表示该请求可能助长生物危害。`"frontier_llm"` 表示该请求可能协助开发与之竞争的 AI 模型。`"reasoning_extraction"` 表示该请求要求模型在响应文本中复现其内部推理。`"general_harms"` 表示该请求属于其他使用政策领域。请参阅[拒绝、回退和计费](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#refusals-fallback-and-billing)。 ## 拒绝、回退和计费 [拒绝与回退](https://platform.claude.com/docs/zh-CN/build-with-claude/refusals-and-fallback)中的所有内容均适用于 Claude Sonnet 5.5。被拒绝的请求会返回 HTTP 200，其中包含 `stop_reason: "refusal"` 以及一个指明政策领域的 [`stop_details`](https://platform.claude.com/docs/zh-CN/build-with-claude/refusals-and-fallback#refusal-response) 对象。请处理拒绝情况并配置回退。[服务器端回退](https://platform.claude.com/docs/zh-CN/build-with-claude/refusals-and-fallback#server-side-fallback)（`fallbacks: "default"`，beta 阶段，仅限 Claude API）会在 Claude Sonnet 5 上重试 `"cyber"` 和 `"frontier_llm"` 类别的拒绝，但不会重试 `"bio"`、`"reasoning_extraction"` 或 `"general_harms"` 类别的拒绝。您也可以使用 [SDK 中间件](https://platform.claude.com/docs/zh-CN/build-with-claude/refusals-and-fallback#client-side-fallback)或自行实现重试。在产生任何输出之前发生的拒绝是否计费取决于其拒绝类别，但无论是否计费，都会计入您的 "rate limits"（速率限制）。请参阅[拒绝如何计费](https://platform.claude.com/docs/zh-CN/build-with-claude/refusals-and-fallback#how-refusals-are-billed)。 ## 定价 Claude Sonnet 5.5 的价格与 Claude Sonnet 5 相同，但提示缓存读取除外，其费用为每百万令牌 0.10 美元，是 Claude Sonnet 5 费率的一半。有关完整价目表、数据驻留和工具定价，请参阅[定价](https://platform.claude.com/docs/zh-CN/about-claude/pricing)。 ## 可用性 Claude Sonnet 5.5 可在以下平台使用： * **Claude API：** 所有客户，模型 ID 为 `claude-sonnet-5-5`。 * **AWS：** [Amazon Bedrock 中的 Claude](https://platform.claude.com/docs/zh-CN/build-with-claude/claude-in-amazon-bedrock)，模型 ID 为 `anthropic.claude-sonnet-5-5`；以及 [Claude Platform on AWS](https://platform.claude.com/docs/zh-CN/build-with-claude/claude-platform-on-aws)，模型 ID 为 `claude-sonnet-5-5`。 * **Google Cloud：** [Google Cloud 上的 Claude](https://platform.claude.com/docs/zh-CN/build-with-claude/claude-on-vertex-ai)，模型 ID 为 `claude-sonnet-5-5`。 * **Microsoft Foundry：** [Microsoft Foundry 中的 Claude](https://platform.claude.com/docs/zh-CN/build-with-claude/claude-in-microsoft-foundry)，模型 ID 为 `claude-sonnet-5-5`。 ## 从 Claude Sonnet 5 迁移 更新您的模型 ID： ```python Python model = "claude-sonnet-5" # Before model = "claude-sonnet-5-5" # After ``` ```typescript TypeScript let model = "claude-sonnet-5"; // Before model = "claude-sonnet-5-5"; // After ``` ```csharp C# var model = Model.ClaudeSonnet5; // Before model = Model.ClaudeSonnet5_5; // After ``` ```go Go model := anthropic.ModelClaudeSonnet5 // Before model = anthropic.ModelClaudeSonnet5_5 // After ``` ```java Java Model model = Model.CLAUDE_SONNET_5; // Before model = Model.CLAUDE_SONNET_5_5; // After ``` ```php PHP $model = Model::CLAUDE_SONNET_5; // Before $model = Model::CLAUDE_SONNET_5_5; // After ``` ```ruby 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` 加上[严格工具使用](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/strict-tool-use)。 3. 保持对话仅追加。在编辑较早的历史记录后重放 Claude Sonnet 5.5 思考块的请求可能会返回 400 错误。请参阅[思考块与模型和对话绑定](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them)。 4. 如果您在 Claude API 或 Google Cloud 上通过 `computer_20251124` 使用计算机使用功能，请[迁移到工具集](https://platform.claude.com/docs/zh-CN/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124)。 5. 如果您将顾问工具与 Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5 或 Claude Haiku 5.5 顾问一起使用，请[切换到 Claude Sonnet 5.5 接受的顾问](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/whats-new-sonnet-5-5#advisor-tool-pairings)。 6. 如果您的界面会显示工具调用之间的文本，请在使用自适应思考时设置 `thinking.display`。使用 `between_tools` 时，无需设置该字段文本也会返回。请参阅[工具调用之间的文本在思考块中返回](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/migration-guide#text-between-tool-calls)。 [迁移指南](https://platform.claude.com/docs/zh-CN/models/sonnet-5-5/migration-guide)提供了从 Claude Sonnet 5 及更早模型迁移的分步说明以及完整的检查清单。 ## 后续步骤 所有当前 Claude 模型的完整规格和定价。 将代码从 Claude Sonnet 5 及更早模型迁移到 Claude Sonnet 5.5。 Claude Sonnet 5.5 特有的行为差异和提示模式。 控制 Claude 在响应时使用的令牌数量，从 low 到 max。 自适应思考的工作原理以及思考块的保留方式。 处理 `stop_reason: "refusal"` 并在其他模型上重试。