Claude Code 用 Haiku 5.5 做 Subagent：升级、/model 与 .claude/agents/
按官方文档把 Claude Code 升到支持 Haiku 5.5，用 /model 与 subagent frontmatter 把搜索/只读任务交给 haiku，主会话留在 Sonnet/Opus。
入门·2 课时·38 分钟·图文实操
免费学习无需登录
你将学会
- 确认 CLI 能切到 claude-haiku-5-5
- 分清 haiku 别名在各云上的指向
- 写一份只读 finder Subagent
适合谁
- 已安装 Claude Code 的开发者
- 想把搜索任务交给 Haiku 的同学
课前准备
- 终端能运行 claude
- 不把真实密钥写入仓库
课程目录
2 课时 · 38 分钟课程说明
Claude Code 用 Haiku 5.5 做 Subagent：升级、/model 与 .claude/agents/
本课按 Anthropic 官方 Claude Code 文档整理，目标是：把 Claude Code 升到支持 Haiku 5.5，用
/model与 subagent frontmatter 把搜索/只读任务交给 haiku，主会话留在 Sonnet/Opus。
主要来源：Model configuration · Create custom subagents · Claude Haiku · Haiku 5.5 Overview
你将得到什么
- 确认 CLI ≥ v2.1.293，并能切到
claude-haiku-5-5 - 搞清
haiku别名在 Anthropic API 与 Bedrock / GCP Agent Platform 等上的差异 - 一份可落盘的只读
finderSubagent（model: haiku+ Glob/Grep/Read） - 可选：覆盖内置 Explore，或用 env 强制所有 subagent 走 Haiku
课前准备
- 已安装 Claude Code，终端能跑
claude。 - 本课侧重 Claude Code Subagent 路由，不重复 Messages API 全文迁移（见站内 course 62
claude-haiku-5-5-migration-quickstart）。 - 密钥占位用
YOUR_ANTHROPIC_API_KEY，勿写入真密钥。
课程结构（2 课时）
- 升级 Claude Code 并切到 Haiku 5.5（
upgrade-model-haiku-5-5）
claude update→ 查版本 →/model/--model→ 别名陷阱与定价对照。 - 写只读 finder Subagent（Haiku + 覆盖 Explore）（
haiku-finder-subagent）
~/.claude/agents/finder.md→ 试跑委托 → 可选 Explore 覆盖与CLAUDE_CODE_SUBAGENT_MODEL_FORCE。
速览（官方核验）
| 项 | 值 |
|---|---|
| Haiku 5.5 最低 CLI | v2.1.293+（claude update） |
| 推荐全名 | claude-haiku-5-5 |
Anthropic API 上 haiku | Haiku 5.5 |
Bedrock / GCP Agent Platform / Foundry 等上 haiku | 可能仍是 Haiku 4.5 → 钉全名或 ANTHROPIC_DEFAULT_HAIKU_MODEL |
| 定价（≤100K prompt） | $0.10 / $0.50 per MTok |
| 定价（>100K prompt） | $0.50 / $2.50 per MTok |
| Subagent 目录 | ~/.claude/agents/ 或 .claude/agents/ |
| Force 全 subagent 模型 | CLAUDE_CODE_SUBAGENT_MODEL + CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1（force ≥ v2.1.257） |
跟做时请始终以官方文档为准。