从 Claude Haiku 4.5 迁移到 Claude Haiku 5.5 时，除了替换模型 ID，还必须同步处理自适应思考、采样参数、助手预填充、计算机工具集、思考块账户绑定和仅追加对话等兼容性变化。
适合的任务：迁移调用 Claude Haiku 4.5、Claude Haiku 3.5 或 Claude Haiku 3 的 Messages API 代码，并核对 Amazon Bedrock、Google Cloud、Microsoft Foundry 或 Claude Platform on AWS 的模型 ID。
不适合的任务：把这份迁移清单当作通用提示词模板，或直接用于未使用 Messages API 的集成。使用 Claude Managed Agents 时，官方指南称除了更新模型名称之外无需其他更改。
适用的模型版本：目标为 Claude Haiku 5.5；主要迁移路径为 Claude Haiku 4.5，指南也列出从 Claude Haiku 3.5 及更早版本迁移时的额外变化。
适用的客户端、Agent 或 API：Messages API；Claude Code 中可调用 Claude API skill；适用于 Claude API，以及指南列出的 Amazon Bedrock、Google Cloud、Microsoft Foundry 和 Claude Platform on AWS。
推荐的推理档位和参数：Haiku 5.5 默认启用 adaptive thinking，使用 output_config.effort 调整思考量。迁移指南的示例使用 medium；默认值另见官方模型概览。迁移时省略 temperature、top_p 和 top_k 是安全做法；max_tokens 要为思考块留出空间。
官方指南给出的 Claude Code 迁移命令是：
/claude-api migrate this project to claude-haiku-5-5该命令来自官方迁移指南。指南说明，skill 会在编辑文件前要求确认迁移范围，并在确认后执行模型 ID 替换、破坏性参数变更、预填充替换和 effort 校准；它还会检测 Amazon Bedrock 与 Claude Platform on AWS 客户端，并调整对应模型 ID 格式和功能变更。这里不把它扩写成未在来源中出现的提示词。
从 Haiku 4.5 迁移思考配置时，官方给出的请求前后对比如下：
// Claude Haiku 4.5
{
"model": "claude-haiku-4-5",
"max_tokens": 16000,
"thinking": { "type": "enabled", "budget_tokens": 8000 },
"messages": [{ "role": "user", "content": "..." }]
}// Claude Haiku 5.5
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}先按实际平台替换模型 ID：
| 平台 | Claude Haiku 4.5 | Claude Haiku 5.5 |
|---|---|---|
| Claude API | claude-haiku-4-5-20251001 或 claude-haiku-4-5 | claude-haiku-5-5 |
| Amazon Bedrock | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-5-5 |
| Claude Platform on AWS | claude-haiku-4-5 | claude-haiku-5-5 |
| Google Cloud | claude-haiku-4-5@20251001 | claude-haiku-5-5 |
| Microsoft Foundry | claude-haiku-4-5 | claude-haiku-5-5 |
claude-haiku-5-5 是固定模型 ID，没有日期后缀，也没有单独的别名。
重新计算 token 数和成本。官方指南称，Haiku 5.5 使用较新的 tokenizer；相同文本的 token 数相比 Haiku 4.5 约增加 30%，具体增幅取决于内容。应使用 model: "claude-haiku-5-5" 重新计数，不要沿用旧模型的计数。
将旧的 thinking: {"type": "enabled", "budget_tokens": N} 改为 thinking: {"type": "adaptive"}，使用 output_config.effort 控制思考量。自适应思考默认开启；若没有设置 thinking，响应仍可能以一个或多个 thinking block 开头。
读取响应时按内容块的 type 选择文本或工具调用，不要假设第一个内容块就是答案；将 thinking block 与工具结果原样传回。思考 token 会计入 max_tokens，较小的上限可能在输出文本前以 stop_reason: "max_tokens" 停止。
从请求中移除 temperature、top_p 和 top_k 是安全做法。指南说明 temperature=1 和 top_p=0.99 可接受，但非默认值会返回 400；同时传入 temperature 与 top_p 也会返回 400，任何 top_k 值都会返回 400。官方建议使用提示来引导行为。
删除以助手轮次结尾的预填充。Haiku 5.5 即使关闭思考也会以 400 拒绝 assistant prefill。格式控制应改用结构化输出，或在分类场景使用带枚举字段的工具；开场白放进 system prompt；续写和上下文提醒放进 user turn。
如果使用计算机使用功能，在 Claude API 和 Google Cloud 上移除 computer-use-2025-01-24 beta 标头，将 computer_20250124 替换为 {"type": "computer_toolset_20260801"}。按每个 tool_use 块的 name 和 toolset_name 分派，处理同一轮的每个此类块，并在结果中回传 toolset_name。如果环境没有实现默认开启的缩放功能，可加入 "configs": {"zoom": {"enabled": false}}；同时移除 fine-grained-tool-streaming-2025-05-14 beta 标头。
如果跨账户重放存储的对话，用生成每个对话思考块的账户重放。Haiku 5.5 的 thinking block 只在生成它的账户或关联账户中有效。
保持对话仅追加：如果改变 system、tools 或较早的 messages，不要把旧 thinking block 继续发回。否则请求可能返回 400；指南对 2026-08-31 00:00 UTC 前创建的账户还说明了该错误与 thinking.block_binding.prefix_mismatch_behavior 设置的关系。
处理 stop_reason: "refusal"。指南称 Haiku 5.5 的安全分类器可能拒绝请求，且没有服务器端回退机制。若组织使用 Haiku 4.5 的 Priority Tier 承诺，还需单独规划容量，因为 Haiku 5.5 不支持 Priority Tier。
迁移命令：/claude-api migrate this project to claude-haiku-5-5。
目标模型 ID：Claude API、Claude Platform on AWS、Google Cloud 和 Microsoft Foundry 使用 claude-haiku-5-5；Amazon Bedrock 使用 anthropic.claude-haiku-5-5。
思考配置：thinking: {"type": "adaptive"}；通过 output_config.effort 调整思考量；来源页面给出的示例为 "medium"。
思考块与工具：默认 thinking block 的 thinking 字段为空，只包含 signature；要查看摘要可用 display: "summarized"。强制 tool_choice 不会先产生 thinking；若需模型先思考，应使用 auto。
参数约束：官方建议省略 temperature、top_p、top_k；旧的 enabled thinking、assistant prefill 和旧计算机工具声明会触发迁移问题，其中多项会返回 400。
token 变化：相同文本在 Haiku 5.5 上比 Haiku 4.5 多约 30% token，具体增幅取决于内容。
计算机使用：迁移到 computer_toolset_20260801；Claude API 和 Google Cloud 还支持 browser_toolset_20260801，Haiku 4.5 不支持该浏览器工具。
旧版 Haiku 的额外变化：从 Haiku 3.5 或 Haiku 3 迁移时，旧版 code_execution_20250522 需升级到 code_execution_20250825 或更高版本；文本编辑器需迁移到 text_editor_20250728，工具名称为 str_replace_based_edit_tool，且该版本没有 undo_edit 命令。
更旧版本的兼容性：Haiku 3.5 和 Haiku 3 的停用状态及可用平台不同。迁移时还需核对旧模型 ID/别名、model_context_window_exceeded 停止原因、工具调用字符串末尾换行符和提示风格；不能只替换模型名。
这是官方迁移清单，不是对业务代码成功率、延迟或成本的独立测评；实际结果取决于客户端、平台、工具循环、输入内容和账户状态。
迁移指南没有提供完整的 SDK 版本矩阵、每个平台的全部错误示例或自动化测试脚本。不能据此补写未公开的 SDK 版本要求。
effort 不是固定的思考 token 预算；来源只说明它控制自适应思考量。不要把 medium 解释成某个固定 token 数。
thinking block 的账户绑定和仅追加要求只适用于携带思考块的对话回放与续接；不应把它理解为普通无状态请求的额外登录要求。
计算机工具集迁移的具体成员分派和结果格式必须结合当前工具循环检查；来源给出了迁移方向，但没有替应用代码生成完整的工具实现。
在隔离环境保留一份 Haiku 4.5 请求样例，记录原模型 ID、thinking、采样参数、assistant prefill、工具声明、max_tokens 和消息历史。
仅按本页清单替换模型 ID、thinking/effort、工具集和消息结构，并分别记录每次请求的 HTTP 状态、stop_reason、内容块类型、token 用量和成本。
用同一份文本在两个模型 ID 上重新执行 token 计数，核对 token 增幅，不能直接沿用 Haiku 4.5 的旧计数。
对带 thinking block 的续接、跨账户回放、修改较早消息、assistant prefill、旧采样参数和旧 computer tool 分别做兼容性测试，并保留 400 错误或成功响应作为证据。
迁移完成后，用真实业务的分类、提取、路由和工具调用样例验收；来源页面没有给出业务通过率，因此不要把迁移成功等同于业务效果达标。
Claude Haiku 5.5