你将得到什么

• 确认本机 Claude Code ≥ v2.1.293（Haiku 5.5 最低要求）
• 可复制的升级命令、会话内切模型、启动时钉模型
• haiku 别名在 Anthropic API 与 Bedrock / GCP Agent Platform 等上的对照表
• Haiku 5.5 公开定价（按 prompt 是否超过 100K）

课前准备

1. 已安装 Claude Code CLI，并能在终端运行 claude（登录方式按你日常：Claude.ai 订阅或 Anthropic API Key 均可）。
2. 本课不走 Messages API 迁移（那是站内 course 62 claude-haiku-5-5-migration-quickstart）；这里只动 Claude Code 的模型路由。
3. 密钥若用环境变量，占位一律写 YOUR_ANTHROPIC_API_KEY，不要把真密钥写进文件或截图外传。

一、为什么要升到 v2.1.293+

官方 Model configuration 写明：

Use v2.1.293 or later with Haiku 5.5. Run claude update to upgrade.

更早版本请求 Haiku 5.5 可能失败（文档指向「Claude Code does not support this model」类错误）。
同页还写：Sonnet 5.5 需 ≥ v2.1.284，Opus 5.5 需 ≥ v2.1.280——本课以 Haiku 5.5 为准。

二、动手：升级并核对版本

在终端执行：

claude update

升级完成后，用下列任一方式看版本（以你本机 CLI 实际输出为准）：

claude --version

或在交互会话里打开状态：

/status

对照结果（成功时你会看到）：

• claude update 结束无报错；若已是最新，会提示已是最新版本
• 版本号形如 2.1.293 或更高（至少满足 ≥ 2.1.293）
• /status 里能看到当前账号与模型相关信息（具体字段随版本略有差异）

若升级失败：检查网络与安装方式（npm 全局 / 官方安装脚本等），修好后重跑 claude update，再核对版本。

三、用 `/model` 或 `--model` 切到 Haiku 5.5

方式 A：会话内切换（推荐先练这个）

启动 Claude Code：

claude

在会话里输入：

/model claude-haiku-5-5

也可以先打开选择器再选：

/model

官方说明要点：

• /model <alias|name> 立即切换
• 在选择器里：Enter = 切换并写入用户默认；s = 仅本会话切换、不改默认
• 直接键入 /model claude-haiku-5-5 的行为等同按 Enter（会保存为默认）

方式 B：启动时指定（只影响这一次启动）

claude --model claude-haiku-5-5

也可用别名（见下一节「别名陷阱」）：

claude --model haiku

方式 C：环境变量（会话级）

export ANTHROPIC_MODEL=claude-haiku-5-5
claude

对照结果（成功时你会看到）：

• 状态行或 /status 显示当前模型为 Haiku 5.5 / claude-haiku-5-5（或你 provider 上的等价 ID）
• 随便发一句短任务（例如「用一句话说明当前工作目录名」），能正常回复，且无「不支持此模型」类错误
• 若误用过旧 CLI：会提示模型不受支持 → 回到第二节升级

可选：切回日常主力模型（主会话通常更适合 Sonnet / Opus）：

/model sonnet

或：

/model opus

四、别名陷阱：`haiku` 不一定是 5.5

官方 alias 表（Anthropic API 列）：

但同一文档的 Provider 对照表写明：在部分第三方平台上，haiku 仍解析为 Haiku 4.5：

因此：

1. 直连 Anthropic API：/model haiku 通常就是 Haiku 5.5。
2. Bedrock / GCP Agent Platform / Foundry / Claude Platform on AWS：不要假设 haiku = 5.5；请钉全名或改默认 Haiku 映射。

钉全名（任意 provider 都更稳）：

/model claude-haiku-5-5

或启动：

claude --model claude-haiku-5-5

把别名 haiku 永久指到 5.5（第三方部署常用；值必须是完整模型名 / 你方 provider 的等价 ID）：

export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

也可写进 Claude Code 的 settings（用户级示意）：

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

路径一般为 ~/.claude/settings.json（以你本机为准）。改完后新开一个 claude 会话再测。

对照结果：

• Anthropic API：/model haiku 与 /model claude-haiku-5-5 应落在同一代 Haiku 5.5
• Bedrock 等：仅 /model haiku 时 /status 或实际请求可能仍是 4.5；改用全名或 ANTHROPIC_DEFAULT_HAIKU_MODEL 后应能打到 5.5（前提是账号已开通该模型）

五、定价对照（Anthropic 公开价）

摘自 Claude Haiku 产品页 与 Overview（Claude Platform / Anthropic API 标价；Bedrock 等以云厂商账单为准）：

补充（官方 Overview）：

• Model ID：claude-haiku-5-5
• 上下文：1M tokens（Claude Code 文档：Haiku 5.5 默认跑 1M 窗口，无需 [1m] 后缀）
• 产品页明确：Haiku 5.5 适合做 Subagent（主模型规划，Haiku 接搜索/摘要等子任务）——下一课时会动手写

Claude Code 的 /model 选择器在直连 Anthropic API（或代理其价目的网关）时可能显示标价；第三方 provider 上选择器可能不显示 Anthropic 列表价。

六、本课自检清单

• claude update 后版本 ≥ 2.1.293
• 已用 /model claude-haiku-5-5 或 claude --model claude-haiku-5-5 成功跑过一轮
• 若走 Bedrock / GCP Agent Platform / Foundry 等：已钉全名或设置 ANTHROPIC_DEFAULT_HAIKU_MODEL，不盲信 haiku 别名
• 主会话日常仍可用 sonnet / opus；Haiku 留给快、省、高并发的只读/搜索类委托（下一课）

七、本课未覆盖（下一课）

• 自定义 Subagent 的 Markdown + YAML frontmatter
• 用 model: haiku 覆盖内置 Explore，或新建 finder 只读代理
• CLAUDE_CODE_SUBAGENT_MODEL + CLAUDE_CODE_SUBAGENT_MODEL_FORCE 强制所有 subagent 走 Haiku

来源

1. Model configuration · Claude Code Docs
2. Claude Haiku · Anthropic
3. Claude Haiku 5.5 Overview