
Claude Code 怎么用 Haiku 5.5:模型指定方法与档位
在 Claude Code 里用上 Haiku 5.5,一共两步:先把 Claude Code 升到 v2.1.293 或更高版本(执行 claude update),再在会话里输入 /model haiku,或者想锁死版本就直接写完整模型名 claude-haiku-5-5。Haiku 5.5 在 2026 年 10 月 7 日随官方发布全平台上线,官方定位是编码子智能体和跑量任务,适合和 Sonnet 5.5、Opus 5.5 搭配使用,不需要重新安装任何东西。
前置准备:版本和登录
- 版本门槛:Haiku 5.5 要求 Claude Code v2.1.293 或更高版本。老版本直接 /model 是找不到它的,先在终端执行 claude update 升级,再用 claude --version 确认版本号。
- 登录授权:执行 claude login,浏览器会自动打开授权页,完成后凭证写入本地,之后不用重复登录。
- 网络环境:国内访问按你已有的方案处理,这一点和使用 Claude Code 本身没有区别。
如果你是第一次搭 Claude Code,先看Claude Code ECC 完整教程;中断的会话想接着写,参考Claude Code 会话恢复指南。
方法一:会话内 /model 切换(最快)
在会话里输入 /model,会弹出模型选择器,选 Haiku 5.5 那行回车即可;也可以直接输入 /model haiku 一步到位。想锁死具体版本,用完整模型名:
/model haiku
/model claude-haiku-5-5
注意一个行为:切换模型会连带影响继承主会话模型的子智能体。如果你想子智能体固定用别的模型,要在子智能体定义里写 model 字段,见下文重点段。
方法二:启动参数 claude --model
在启动时指定模型,只对本次启动的会话生效,适合在不同终端跑不同模型:
claude --model haiku
claude --model claude-haiku-5-5
方法三:环境变量
适合脚本和长期默认。三个变量分工不同:
export ANTHROPIC_MODEL=haiku
export ANTHROPIC_DEFAULT_MODEL=claude-haiku-5-5
export CLAUDE_CODE_SUBAGENT_MODEL=haiku
ANTHROPIC_MODEL 控制本次启动用的模型;ANTHROPIC_DEFAULT_MODEL 设置新会话默认;CLAUDE_CODE_SUBAGENT_MODEL 会把所有子智能体强制统一到一个模型,不想一个个配置时用它。
方法四:settings.json 永久配置
在用户级或项目级的 settings.json 里写 model 字段,每次启动自动生效:
{
"model": "haiku"
}
四种方法按优先级排列:会话内 /model 最优先,其次是启动参数,然后是环境变量,最后是 settings.json。设置细节以官方模型配置文档为准。
把 Haiku 5.5 设成子智能体模型(重点)
官方发布页明确把 Haiku 5.5 定位为「与 Opus 5.5、Sonnet 5.5 搭配的编码子智能体」:大模型负责规划拆解,Haiku 批量执行标准明确的活。子智能体的模型配置写在 Markdown 定义文件的 YAML 头里,官方文档(创建自定义子智能体)的示例长这样:
---
name: code-improver
description: Scans files and suggests improvements for readability, performance, and best practices.
tools: Read, Grep, Glob
model: haiku
---
You are a code improvement specialist.

文件放项目级 .claude/agents/ 目录,或用户级 ~/.claude/agents/ 目录。放项目里可提交到仓库让团队共用,放用户目录则所有项目可用。官方的内置 Explore 子智能体(代码搜索用)也可以用一个同名用户子智能体覆盖成 model: haiku,把探索成本压到最低。
effort 推理档位怎么配
Haiku 5.5 是 Haiku 系列第一个支持推理档位调节的模型。官方博客(Claude Code 模型与 effort 选择)说得很清楚:effort 控制的不是单纯的思考时间,还包括读多少文件、跑多少验证、多步任务推进多远。
- 默认档位 medium,官方建议大多数任务直接用默认,别每个任务都手动调。
- 简单任务(重命名、格式化、信息提取)开 low,响应最快、token 最省。
- 代码审查、安全审计这类开 high,让它多读文件、多验证。
- 关键架构决策开 max,但要接受更慢和更贵。
- 子智能体定义文件同样支持 effort 字段,可以按子智能体固定档位;会话内用 /effort 命令临时调整也是社区常用做法。
判断口诀:如果 Claude 答错了是因为没读某个文件、没跑测试,这是「没尽力」,往上加 effort;如果它带着完整上下文认真做了还是错,这是「能力不够」,该换更大的模型,而不是加档位。

什么任务适合交给 Haiku 5.5
适合它的:重复执行类任务。比如批量补注释、格式化、跑测试找错误、搜索代码库、信息提取、文档摘要、修简单 bug。这些任务验收标准明确,Haiku 5.5 单价只有 Sonnet 5.5 短请求的约二十分之一,把这类活下沉到 Haiku 是最划算的用法。
不适合它的:复杂多步编码、跨文件重构、长周期自主规划。Terminal-Bench 4.0 基准上 Haiku 5.5 得 39.2%,Sonnet 5.5 是 70.6%,差距很清楚,官方也建议复杂 agent 编码优先用 Sonnet 5.5 或 Opus 5.5。
一句话判断:任务已经拆好、验收标准明确、可以并行跑,交给 Haiku 5.5;任务模糊、要跨文件、需要长时间自主决策,留给 Sonnet 5.5 或 Opus 5.5。

验证成功:怎么确认跑通了
- 启动时终端第一行会显示当前模型名,看到 Haiku 5.5 或 claude-haiku-5-5 就是切换成功。
- 会话里输入 /model,选择器当前行有勾选标记。
- 用一个小任务实测:让子智能体跑一次代码搜索或信息提取,对比返回速度和 token 消耗,确认配置生效。
常见报错速查
| 现象 | 原因 | 解法 |
|---|---|---|
| 提示 Claude Code does not support this model | Claude Code 版本低于 v2.1.293 | 执行 claude update 升级后重启 |
| /model 列表里只有 Haiku 4.5 | 走 AWS/GCP/Azure 通道时,haiku 别名解析到旧版 | 改用完整模型名 claude-haiku-5-5 |
| 启动后提示 selected model 有问题 | 模型名写错 | 核对 claude-haiku-5-5 拼写和平台是否支持 |
斜杠命令整体用法可参考Claude Code 斜杠命令 2026 大全;想控制 API 账单,叠加Claude Max 每月 API 额度能进一步省订阅费。
常见问题
Claude Code 里怎么切到 Haiku 5.5?
先 claude update 升到 v2.1.293+,再在会话里 /model haiku,或启动时 claude --model haiku;想锁死版本用完整模型名 claude-haiku-5-5。
为什么我的 /model 里只有 Haiku 4.5?
haiku 别名在 Anthropic API 上解析为 Haiku 5.5,但在 Amazon Bedrock、Google Cloud、微软 Foundry 等第三方平台会解析到旧版。在这些平台直接用完整模型名 claude-haiku-5-5。
子智能体怎么固定用 Haiku 5.5?
在 .claude/agents/ 或 ~/.claude/agents/ 下的定义文件 YAML 头里写 model: haiku;也可以设 CLAUDE_CODE_SUBAGENT_MODEL=haiku 环境变量把所有子智能体统一到 Haiku。
Haiku 5.5 能替代 Sonnet 5.5 写代码吗?
复杂多步编码不行。Terminal-Bench 4.0 上 Haiku 5.5 得 39.2%,Sonnet 5.5 是 70.6%。它适合任务拆好、验收标准明确的执行活,复杂编码建议主模型用 Sonnet 5.5 或 Opus 5.5。
effort 档位要自己调吗?
大多数任务用默认 medium 就行。代码审查、安全相关开 high 甚至 max;简单任务开 low 省 token。判断标准是「没尽力还是没能力」:漏读文件、没跑测试加 effort,认真做了还错就换大模型。
用 Haiku 5.5 会不会很慢?
不会。官方称 Haiku 5.5 是标准模式下家族里速度最快的模型,正好适合低延迟、高频调用场景;配合低档 effort 响应更快。

京ICP备2024094994号-29