Anthropic 于9月28日发布 Claude Sonnet 5.5，API ID 为 claude-sonnet-5-5。

按发布公告，价格与 Sonnet 5 相同：每百万 Token 输入 2 美元、输出 10 美元、缓存读取 0.20 美元。

Anthropic 称每项任务所需 Token 减少，使成本最多降低30%，输出生成速度提升30%以上。两者都是供应商评估，不能保证现有应用获得同样的节省或速度。

迁移的主要风险在请求格式。Anthropic 要求过去关闭思考功能的应用改用 between_tools，而不是只替换模型 ID。

会失败的参数与变化的响应结构

Messages API 迁移指南具体列出了兼容性问题。在 Sonnet 5.5 上，thinking.type disabled 会返回 400 invalid_request_error。

关闭前置思考（up-front thinking）的设置是 between_tools，只在 effort 为 low、medium、high 时接受；xhigh 或 max 会返回 400。

tool_choice 的 any 和 tool 也会被 400 拒绝。指南给出的替代方案是 auto 搭配 strict 工具。

响应端同样有变化。响应可能以 thinking 块开头，读取 content[0].text 的代码会出错；在工具调用循环中，需要原样传回 thinking 块。

9月28日公告列出的缓存读取价格为每百万 Token 0.20 美元，而10月3日核对的迁移指南写为 0.10 美元。两个时间点的官方数字不同，实际计费应以适用价格表为准。

这些检查针对 Messages API。指南表示，Claude Managed Agents 除更改模型名称外无需其他改动。

先重放代表性请求，再比较成本

对于 Messages API 集成，第一步是重放几条代表性请求。按照指南的请求格式，关闭前置思考的重放请求如下。

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 16000,
    "thinking": {"type": "between_tools"},
    "output_config": {"effort": "high"},
    "messages": [{"role": "user", "content": "..."}]
  }'

如果保存的请求仍带有 thinking disabled 或 tool_choice any、tool，就会收到指南记录的 400 错误。失败会在质量比较之前暴露出来。

接下来是同时记录工具调用成功率、最终结果准确性、重试次数和成功任务的计费成本。即使 Token 单价不变，思考设置和额外调用也可能改变账单。

即使基础 Token 单价相近，若应用无法处理新的请求与响应规则，每项成功任务的成本仍会改变。