在 Claude Code 中使用 Claude Haiku 5.5（以及把它当作子代理模型）

要在 Claude Code 中使用 Claude Haiku 5.5，请先用 claude update 更新到 v2.1.293 或更高版本，然后用 claude --model claude-haiku-5-5 启动会话，或在会话中运行 /model claude-haiku-5-5。对大多数人来说，更大的收益是把它作为 subagent 运行：在 subagent 文件中写入 model: haiku，让 Sonnet 5.5 或 Opus 5.5 把搜索、测试运行和总结交给它。使用 API key 时，100K token 以内的提示词按每百万输入/输出 token 收费 $0.10/$0.50，超过后为 $0.50/$2.50。

下面涵盖：配置、haiku 别名的陷阱、effort、subagent 文件、100K 的价格台阶，以及何时该由 Sonnet 或 Opus 主导。关于模型本身，可阅读 Claude Haiku 5.5 是什么。如果你的代码要调用 API，Apifox 可保存供 Haiku subagent 运行的测试场景。

AI Coding 交流群

如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。

Claude Code 中的 Claude Haiku 5.5 一览

第 1 步：更新 Claude Code

Haiku 5.5 需要 Claude Code v2.1.293 或更高版本。更新日志条目称它“现在是 Anthropic API 上的默认 Haiku 模型”。

claude update

Claude Code 不包含在 Free 套餐中。Free 用户可以在 Claude.ai 应用中选用 Haiku 5.5，但 Claude Code 需要 Pro、Max、Team、Enterprise 或 Anthropic API key。根据 claude.com/pricing，Pro 按年付费为每月 $17，按月付费为每月 $20，Max 起价为 $100。

第 2 步：将 Haiku 5.5 选为主模型

claude --model claude-haiku-5-5

在运行中的会话里，/model claude-haiku-5-5 效果相同。如果你保存的 model 设置为 haiku，那么在 Haiku 4.5 上保存的会话会在 Haiku 5.5 上恢复。

在 Anthropic API 上，haiku 别名只代表 Haiku 5.5

在任何云服务商上，/model haiku 与 model: haiku 写在 subagent 文件里，得到的都是 Haiku 4.5。应改为固定完整 ID：在 Google Cloud 和 AWS 上的 Claude Platform 上用 claude-haiku-5-5，Foundry 上用你的部署名，Amazon Bedrock 上用推理配置文件 ID，例如 us.anthropic.claude-haiku-5-5。或者用 ANTHROPIC_DEFAULT_HAIKU_MODEL 把别名指向它（第 5 步）。

第 3 步：选择 effort 级别

Haiku 5.5 是首个支持 effort 控制的 Haiku：low、medium、high、xhigh 和 max，在 Claude Code 中默认从 medium 起步。

claude --model claude-haiku-5-5 --effort high

在会话中，/effort low 会为当前模型保存一个级别。Anthropic 的提示词指南建议把 low 用于简短的工具任务和高频请求，medium 用于大多数工作，high 用于较长的 agent 任务。把 xhigh 和 max 留给 eval 显示有增益的任务。

思考始终开启。在 Claude Code 的 Haiku 5.5 上无法关闭它；alwaysThinkingEnabled: false 和 MAX_THINKING_TOKENS=0 都不起作用。（原始 Messages API 在 high 或更低级别时可以关闭。）想要更少的思考 token 时，就调低 effort。

第 4 步：把 Haiku 5.5 作为 subagent 运行

Anthropic 表示，Haiku 5.5“在编码工作中作为 subagent 与 Opus 5.5 和 Sonnet 5.5 配合得很好”。Subagent 是带 YAML frontmatter 的 Markdown 文件，放在 .claude/agents/（项目级）或 ~/.claude/agents/（所有项目）。其中只有 name 和 description 是必需的，而 subagent 文档接受 sonnet、opus、haiku、fable、一个完整的模型 ID，或用 inherit 表示 model 的取值。我们的 subagent 指南涵盖了作用域和工具。

用一个廉价的 explorer 替换 Explore

内置的 Explore subagent 运行在主对话所用的模型上，而不是 Haiku。在 Opus 5.5 会话中，每次 Explore 搜索都在 Opus 上运行。一个命名为 Explore 的用户级或项目级 subagent 会覆盖内置的 Explore，并保留自己的 model：

---
name: Explore
description: Fast read-only codebase search. Use to find files, symbols and call sites without editing anything.
tools: Read, Grep, Glob
model: haiku
effort: low
---

You search the codebase and report what you find. Return file paths with line
numbers and a short summary of each match. Never edit files.

把它保存为 .claude/agents/Explore.md。它工作时运行 /tasks 来确认所用模型。在云服务商上，把 haiku 换成第 2 步中的完整 ID。

强制所有 subagent 都使用 Haiku

要让每个 subagent（包括 Explore）都在 Haiku 上运行，请在设置文件的 env 块中同时设置这两个变量：

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL 单独设置时只是一个默认值：subagent 自己的 model 字段优先级更高，Explore 也不会改变。

第 5 步：把后台工作指向 Haiku 5.5

ANTHROPIC_DEFAULT_HAIKU_MODEL 设置“用于 haiku 的模型，或后台功能”所用的模型，例如为 claude --resume 总结过往会话。较旧的 ANTHROPIC_SMALL_FAST_MODEL 已弃用，参见 环境变量参考；如果你的 shell 配置仍在设置它，请替换掉。

在 Anthropic API 上无需设置任何东西。在 Google Cloud 上，后台任务默认使用 Sonnet；在 Foundry 上默认使用主模型；在 Bedrock 上默认使用 Sonnet 或主模型。在你的账户中启用 Haiku 5.5 后，就把它固定下来：

# Google Cloud's Agent Platform
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

# Amazon Bedrock (inference profile ID)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=us.anthropic.claude-haiku-5-5

长会话中的 100K 价格台阶

Haiku 5.5 的价格取决于提示词长度，而 Claude Code 在每一轮都把整个对话作为提示词发送。一旦会话上下文超过 100K token，每个请求就按 $0.50/$2.50 计费，而不是 $0.10/$0.50，是短提示词费率的五倍。文档没有说明缓存 token 是否计入这一门槛，所以按计入来做预算。

自动压缩帮不了你：Haiku 5.5 默认在约 967K token 时压缩，所以会话可以先远远超过价格台阶。按 token 付费时，有两个习惯会有帮助：

1. 更早压缩。 /autocompact 100k 会设置 Claude Code 接受的最小窗口，这样会话会在接近边界时压缩，而不是接近 1M 时。
2. 把体积大的工作推给 subagent。 Subagent 有自己的上下文，所以测试日志和搜索结果不会进入主对话。

即便超过 100K，$0.50/$2.50 也只有 Sonnet 5.5 的 $2/$10 的四分之一。在付费套餐上，会话改用使用额度，而 Anthropic 尚未公布 Haiku 5.5 如何计入这些额度。我们的 Haiku 5.5 定价拆解详细算过这笔账。

Max 和 Team 订阅用户：新的每月 API 额度（Max 5x 为 $100，Max 20x 为 $200，Team 最多可共享至 $500）不覆盖交互式 Claude Code，参见 Anthropic 的 API 额度文档。

何时应继续让 Sonnet 5.5 或 Opus 5.5 主导

Anthropic 表示，Sonnet 5.5 和 Opus 5.5“在复杂的 agentic 编码任务上仍是更好的选择”。在由 Anthropic 以 max effort 在 Claude Code 中运行的 Terminal-Bench 4.0 上，Haiku 5.5 得分为 39.2%，而 Sonnet 5.5 为 70.6%。发布图表还补充了每次尝试的成本：

在 medium 下，两者每次尝试的成本大致相同，而 Sonnet 得分更高。Haiku 的 token 价格优势并不能延续到长时间的 shell 工作中，所以不要让它在困难的编码会话中担纲。

计算机操作则是另一番景象。在 OSWorld 2.1 上，Haiku 5.5 在 medium 下每次尝试拿到 53.3%，花费 $0.13，而 Sonnet 5.5 在 low 下拿到 57.9%，花费 $0.68。我们的 Haiku 5.5 基准测试拆解列出了每一行，Sonnet 5.5 Claude Code 指南则涵盖了主模型这一侧。

一个实用的分工：Sonnet 5.5 或 Opus 5.5 作为主模型，Haiku 5.5 负责 Explore、测试运行、读日志和抓取文档。

示例：一个运行你的 Apifox 测试的 Haiku subagent

测试运行冗长且重复，很适合 Haiku。Apifox CLI 可以在终端里运行你保存的 Apifox 测试场景，因此 subagent 可以运行它们并回传一份简短报告，同时让主模型的上下文保持干净。

---
name: api-test-runner
description: Runs the project's Apidog test scenarios with the Apidog CLI after an API endpoint changes, then reports pass and fail counts with the failing requests.
tools: Bash, Read
model: haiku
effort: low
---

Run the Apidog CLI test command documented in this repo's README for the
scenario that covers the changed endpoint. Report the pass and fail counts.
For each failure, give the request name, the expected result and the actual
result. Don't edit code. Don't retry a failed run more than once.

CLI 的配置（包括 auth 和运行命令）见 Claude Code 中的 Apifox CLI。下载 Apifox 即可构建 subagent 要运行的场景。

把应用从 Haiku 4.5 迁移

如果你的应用通过 API 调用 Haiku 4.5，可以让 Claude Code 开始迁移：

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

预计会有破坏性变更：手动 budget_tokens 思考、非默认的 temperature 或 top_p、任何 top_k，以及 assistant prefill，在 Haiku 5.5 上都会返回 400。Haiku 5.5 vs Haiku 4.5 指南列出了每一项修复方法。编辑之后，把旧请求和新请求作为一对保存在 Apifox 中，将 ANTHROPIC_API_KEY 存为环境变量，并对 stop_reason 和 usage 做断言，这样新增的 refusal 停止或 token 的跳变会让测试失败，而不是流入生产环境。

常见问题

Claude Code 中的默认模型是 Haiku 5.5 吗？ 不是。它是 Anthropic API 上的默认 Haiku 模型，也就是说 haiku 别名指向它。用 --model 或 /model 把它选为主模型。

在 Free 套餐下能在 Claude Code 里使用 Haiku 5.5 吗？ 不能。Claude Code 需要付费套餐或 API key。Free 用户可以在 Claude.ai 应用中选 Haiku 5.5；参见如何免费使用 Claude Haiku 5.5。

为什么 model: haiku 给我的却是 Haiku 4.5？ 你用的是 Bedrock、Google Cloud、Foundry 或 Claude Platform on AWS，或者版本低于 v2.1.293。固定完整 ID，或设置 ANTHROPIC_DEFAULT_HAIKU_MODEL。

能关闭思考以节省 token 吗？ 在 Claude Code 中不能。改为调低 effort；low 是最省钱的设置。

下一步

运行 claude update，加上 Haiku 的 Explore 覆盖配置，并让当前主模型再用一周。然后，如果你的项目有 API，就加上 test-runner subagent。若想在自己的代码中调用该模型，请从 Haiku 5.5 API 指南开始。Apifox 可免费开始使用，并能为那个 subagent 提供真实的测试来运行。

开发必备：API 全流程管理神器 Apifox

介绍完上文的内容，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、调试、设计、测试、Mock、自动化测试于一体的工具，Apifox 是目前提升研发效率的首选。

如果你正在开发项目，不妨试试其极其友好的界面设计，它完全兼容 Postman 和 Swagger 数据格式，导入数据非常方便，，即使是新手也能很快上手，点击这里即可注册使用。

值得一提的是，除了个人和常规团队使用，针对有高安全合规要求、或需要在内网环境协作的企业，Apifox 还提供了深度定制的私有化部署方案。

获取专属报价与部署方案

详细的私有化部署系统架构与安全白皮书

针对您公司规模的专属报价单

免费的 1v1 专属产品演示 (Demo) 机会

获取部署方案

* 提交后，我们的客户经理将在 1 个工作日内与您联系

林俊锋 企业微信

@Apifox 专属顾问

扫码备注: 私有化 + 公司名