从 Haiku 4.5 迁移清单与自检

三、从 Haiku 4.5 迁移：按清单改

下列条目摘自官方 Migration guide「Every starting model」。改完再跑上一节的 curl。

1. 换模型 ID

把 claude-haiku-4-5 或 claude-haiku-4-5-20251001 换成 claude-haiku-5-5。
在 Claude Code 里也可以跑官方 skill：/claude-api migrate this project to claude-haiku-5-5（会先让你确认范围）。

2. 重新数 token，必要时抬高 max_tokens

同一段文本在 Haiku 5.5 上大约多计 30% token。用 model: "claude-haiku-5-5" 重新 count，不要沿用 4.5 的估算。
Thinking token 也计入 max_tokens：限额太小可能在 thinking 之后就 stop_reason: "max_tokens"，还没轮到正文。

3. thinking：从 budget_tokens 改为 adaptive + effort

以前（Haiku 4.5，会在 5.5 上 400）：

{
  "model": "claude-haiku-4-5",
  "max_tokens": 16000,
  "thinking": { "type": "enabled", "budget_tokens": 8000 },
  "messages": [{ "role": "user", "content": "..." }]
}

现在：

{
  "model": "claude-haiku-5-5",
  "max_tokens": 16000,
  "thinking": { "type": "adaptive" },
  "output_config": { "effort": "medium" },
  "messages": [{ "role": "user", "content": "..." }]
}

Adaptive 默认开启：即使你不写 thinking，响应也可能以 thinking 块开头。需要摘要版 thinking 时用："thinking": {"type": "adaptive", "display": "summarized"}。

4. 删掉 temperature / top_p / top_k

Haiku 5.5 上非默认采样参数会直接 400。官方要求：omit 三者；用提示词引导行为，用 effort 控思考深度。

5. 不要再以 assistant prefill 结尾

最后一条 messages 必须是 user。以前靠 assistant 半截续写控格式的，改成：structured outputs、带 enum 的 tools，或把「请从……继续」写进 user 消息。

6.（若你用 computer use）换到 toolset

在 Claude API / Google Cloud：丢掉 computer-use-2025-01-24 beta header 与 computer_20250124，改为 {"type": "computer_toolset_20260801"}，并按官方 computer use 迁移说明处理 toolset_name。Haiku 5.5 还支持 browser_toolset_20260801（4.5 没有）。

四、快速自检清单

发请求前过一遍：

• model 已是 claude-haiku-5-5
• 没有 temperature / top_p / top_k
• 没有 thinking.budget_tokens
• messages 以 user 结尾
• 解析响应时按 type 找 text，并把 thinking 块原样回传（多轮/工具场景）
• 处理可能的 stop_reason: "refusal"（5.5 无服务端 fallback）

五、可选：Claude Code 一键迁移

在已登录 Claude Code 的项目根目录：

/claude-api migrate this project to claude-haiku-5-5

按提示确认范围后，skill 会改模型 ID、breaking 参数、prefill 与 effort，并给出人工复核清单。仍建议用本课第二节的 curl 做一次冒烟。

六、本课未覆盖（需要时再查官方）

• Prompt caching 细价与 Batch 五折：见 Overview「Pricing」
• Thinking block 账号绑定与 append-only 会话规则：见 Migration「Replay thinking blocks…」「Keep earlier turns unchanged」
• 从 Haiku 3.5/3 迁来的额外工具版本变更：见 Migration 后半段

来源

1. Claude Haiku 5.5 Overview
2. Claude Haiku 5.5 migration guide
3. What's new in Claude Haiku 5.5
4. Prompting Claude Haiku 5.5