Anthropic 官方 Claude Opus 5.5 新能力与 API 配置

一句话结论

Claude Opus 5.5 始终启用自适应思考，迁移时应改用 effort 控制思考深度，并检查强制工具调用、思考块传递和电脑操作工具的兼容性。

适用场景

• 适合的任务：将 Claude Opus 5 或旧版 Claude API 集成迁移到 Opus 5.5；为长时间运行的 Agent 检查工具调用和思考块处理；确认各云平台的模型 ID 与功能支持。

• 不适合的任务：直接推断模型在特定业务上的效果；按本页信息编写完整提示词或代替具体功能文档实现所有 API 流程。

• 适用的模型版本：Claude Opus 5.5，Claude API 模型 ID 为 claude-opus-5-5。

• 适用的客户端、Agent 或 API：Claude API、AWS Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry；部分功能的平台支持不同，需按下文边界检查。

• 推荐的推理档位和参数：省略 thinking 或使用 {"type":"adaptive"}，通过 output_config.effort 控制推理档位；默认值为 medium。显式设置 effort，并针对目标任务重新测量延迟、成本和效果。

可直接使用的内容

本来源是 API 配置与迁移说明，没有提供一份完整可复制的提示词。核心配置原则如下：

• 请求模型使用 claude-opus-5-5；云平台的模型标识见“原始证据与数据”。

• 不要发送 thinking: {"type":"disabled"} 或带手工 token 预算的 thinking: {"type":"enabled", "budget_tokens": N}；这两种请求会返回 HTTP 400。省略 thinking 或设置为 {"type":"adaptive"}。

• 不使用 tool_choice 的 any 或指定 tool 形式；使用 auto，需要结构化 JSON 时为工具 schema 启用 strict: true，或采用 structured outputs。

• 对话历史中的 thinking blocks 按模型与对话绑定。工具循环应按 block 的 type 识别内容，并将 thinking blocks 原样传回；不要依赖内容块固定位置。

• 若在 Claude API 或 Google Cloud 使用旧的 computer_20251124 工具，迁移到 computer_toolset_20260801，移除旧 beta header，并更新 Agent 循环以处理 member 类型的 tool_use block、批量动作和结果中的 toolset_name。

• 如果应用向用户展示工具调用之间的进度文字，检查 thinking block 的显示设置；默认 thinking.display: "omitted" 会让其中的文字不可见。

测试或工作流步骤

1. 将模型 ID 更新为 claude-opus-5-5。

2. 搜索并删除 disabled thinking 和手动 budget_tokens thinking 配置；按任务设置 output_config.effort，从 medium 基线开始评估。

3. 检查请求中的 tool_choice。将 any 或指定工具改为 auto，通过提示词说明何时适用工具；若需严格 schema，使用 strict: true 或 structured outputs。

4. 检查响应与历史序列化代码：按 block 的 type 解析，将 thinking blocks 原样放回后续工具请求；确认是否需要展示工具调用之间的进度文字，并据此设置 thinking.display。

5. 若使用电脑操作，按部署平台确认工具类型：Claude API 和 Google Cloud 使用 computer_toolset_20260801；Bedrock 仍支持 computer_20251124。已使用新 toolset 或 browser use 的集成无需因这一项迁移。

6. 对目标平台及真实工作负载重新运行集成测试和 effort sweep，不沿用 Opus 5 的默认档位或工具假设。

原始证据与数据

• Anthropic 将 Opus 5.5 定位为长时间运行的 Agent 编码和知识工作模型，Claude API ID 为 claude-opus-5-5。

• Opus 5.5 的 thinking 始终启用。禁用 thinking 或指定手工 thinking token budget 会返回 400 invalid_request_error；官方建议省略 thinking 字段或使用 adaptive thinking，并用 effort 控制思考。

• tool_choice: {"type":"any"} 与 tool_choice: {"type":"tool", "name":"..."} 不受支持；auto（默认）和 none 受支持。文档还将 schema-valid JSON 场景指向 auto 加 strict tool use，或 structured outputs。

• thinking blocks 记录生成它们的模型。Opus 5.5 可读取 Opus 5 及更早的 Opus、Sonnet、Haiku 模型的 thinking blocks；跨到其他模型时可能丢失之前模型的推理内容。无法读取的 block 会在模型看到请求前被丢弃，且不计费。符合条件的账户默认还会检查 block 之前的系统提示、工具和消息是否改变；账户创建日期和 beta 行为见原文。

• Claude API 与 Google Cloud 上不接受旧 computer_20251124 工具；AWS Bedrock 上该工具仍可使用。官方迁移目标为 computer_toolset_20260801。

• 官方列出的支持项包括 per-message effort（beta）、对话中 system message、task budgets、最小 512 token 可缓存提示的 prompt caching、batch processing、Files API、PDF、vision，以及服务端和客户端工具。computer use 的例外依部署平台而异。

• Fast mode（research preview）仅在 Claude API 可用，使用 speed: "fast" 和 fast-mode-2026-02-01 beta header。

• inline tool definitions 使用 inline-tools-2026-09-15 beta header；按需压缩使用 compact-2026-09-04 beta header。两项均有各自的平台和模型可用范围，集成前需打开原文链接的功能文档确认。

• 模型 ID：Claude API claude-opus-5-5；Amazon Bedrock anthropic.claude-opus-5-5；Claude Platform on AWS、Google Cloud、Microsoft Foundry 使用 claude-opus-5-5。

• 文档显示价格为每百万输入 token $4、输出 token $20；批处理为 $2 / $10。价格和功能可能变化，应以当前平台定价页为准。

适用边界

• 本页是 Anthropic 的官方兼容性和迁移说明，不是独立性能测评，也没有公开可复现的任务集、完整请求样例和结果表。

• 文档未给出发布日期；以上采集日期表示本次核对日期。价格和平台支持情况应在实际部署时再次确认。

• 不同云平台的工具支持存在差异；尤其不要把 Claude API / Google Cloud 的电脑操作工具限制外推到 Bedrock。

• effort 默认值与 Opus 5 不同，且相同档位下 thinking 用量可能变化。应通过自有 eval 校准，不能据此直接断言任一任务质量更高。

• Anthropic 在本页面还说明了安全拒绝、图表识别等行为差异；它们不构成本配置条目的独立效果证据。

复现说明

在 Claude API 和目标云平台各准备一份现有 Opus 5 请求，分别检查模型 ID、thinking、tool_choice、thinking block 往返序列化及电脑操作工具类型。按本页迁移规则修改后，对成功路径和预期拒绝路径执行请求级集成测试；记录平台、SDK、请求参数、响应状态、stop reason、时延和 token 用量。Effort 至少比较 medium 与实际候选档位，并使用同一任务集和工具环境。