从 Sonnet 5 迁到 5.5 会报错的五处

平台文档写 Sonnet 5.5 有五处不兼容：事先思考要改成 between_tools，强制工具会报错，思考块绑定会话，旧的 computer_20251124 在 Claude API 与 Google Cloud 上不被接受，advisor 拒绝三款旧模型。

从 Sonnet 5 迁到 5.5 会报错的五处

把模型名改成 claude-sonnet-5-5 之后，原来跑在 Sonnet 5 上的客户端可能直接失败。平台 overview 写 claude sonnet 5.5 不兼容 有五处。第六种变化不让请求失败，但会让工具调用之间的进度文字消失。

作者：CodePass 技术编辑

五条会失败的改动

  1. 事先思考不能再用旧的关闭方式。最低档是 between_tools，它关掉的是事先思考，并且只在 high 及以下的努力档有效。发布页对「思考关着」的迁移写的就是先改成这个设置。

  2. 强制工具调用会报错。和 Opus 5.5 一样，指定必须调用某一个工具的 tool_choice 不再被接受。对照见 Opus 5.5 的四处不兼容。

  3. 思考块绑在这个模型和这段对话上。不能把上一轮、另一个模型留下的 thinking 块原样塞进新请求。

  4. 在 Claude API 和 Google Cloud 上，旧的计算机使用工具 computer_20251124 不被接受。overview 只点名了这两处。

  5. advisor 工具拒绝把 Claude Opus 4.8、Opus 4.7 和 Sonnet 5 当作 advisor。这是 Sonnet 5.5 多出来的一条，Opus 5.5 那篇没有写同一句。

另外，把 temperature、top_p 或 top_k 设成非默认值会返回 400。这写在 Good to know，不在那五条标题里。采样参数也要先改回默认，再改模型名。

不报错但界面变安静的一条

工具调用之间的文字放进 thinking 块。应用如果把这段文字流式播给用户，在设置能把文本返回来的 display 之前，工具之间会没有字。也可以改用 between_tools 关掉事先思考。请求本身仍然成功。

迁移顺序：测试 Key 上先发一条不带工具、不带采样参数的短请求，确认 claude-sonnet-5-5 已开通。然后改 between_tools、去掉强制 tool_choice、删掉历史里的旧 thinking 块，最后测计算机使用和 advisor。Sonnet 5 的 ID 发布页没有写退役日。

参考资料