这是纯金。Anthropic 刚刚分享了 Claude Code 最好的技巧之一：同时运行 Sonnet、Haiku 和 Opus 5.5，让每个模型只做自己最擅长的事。效果更好，消耗的 token 更少，因为每个任务都交给了最合适的模型。

启动方式：

claude --model sonnet --advisor opus

分工如下：

• Sonnet 5 运行主会话并编写代码
• Haiku 5.5 并行探索文件和文档
• Opus 5.5 待命作为顾问，处理重大决策
• 你不再在不需要 Opus 的任务上浪费它的上下文

Opus 只在三个时刻介入：

• 方案确定之前
• 同一个错误出现两次时
• 宣布任务完成之前

Sonnet 构建。Haiku 探索。Opus 审查。JEV 工程是同一思路再下沉一层：那些不需要思考者的分叉（选哪个文件、选哪个工具、重试还是停止）毫秒级交给 JEV 处理，大模型只处理那些展开完整决策树的情况。

• Sonnet 5 运行主会话并编辑代码
• search 在 Haiku 5.5 上映射仓库结构
• grep 在 Haiku 5.5 上查找调用位置
• docs 在 Haiku 5.5 上拉取 API 参考文档
• Opus 5.5 待命作为顾问，被咨询时读取完整对话记录
• JEV 毫秒级路由微分叉

把这棵树和下面这段提示词粘贴到 Claude Code 里：

按照这棵树重新配置我的 Claude Code 环境：

1. 在 Sonnet 5 上运行主会话，使用 Opus 5.5 作为顾问。
2. 创建三个只读的 Haiku 5.5 子代理：search（映射仓库）、grep（查找调用位置）、docs（拉取 API 参考文档）。
3. 在 CLAUDE.md 中添加一条规则：方案确定前咨询顾问，同一错误出现两次时咨询顾问，任务宣布完成前咨询顾问。
4. 将快速确定性分叉（工具选择、路径选择、重试）通过 JEV 路由。 先以 diff 形式展示所有更改。我说 go 之前不要做任何编辑。

↳ http://code.claude.com/docs/en/advisor

保存下来，以后会用到的。

用 advisor 工具升级重大决策 - Claude Code 文档

来源：https://code.claude.com/docs/en/advisor

advisor 工具让 Claude 在任务的关键时刻咨询一个通常更强的模型，例如在确定方案之前、遇到反复出现的错误时、或在宣布任务完成之前。顾问会收到完整的对话内容，包括每次工具调用及其结果，并返回指导建议，Claude 在继续之前将其纳入考虑。

advisor 在 Anthropic 基础设施上以服务器端工具的形式运行，订阅计划和 API 计费账户均可使用。

你可以选择哪个模型担任顾问，由 Claude 决定何时调用它。

本页介绍如何启用 advisor、哪些模型配对被接受、咨询期间 Claude 显示什么内容，以及 advisor 的使用如何计费。

什么时候使用 advisor

advisor 适合长时间、多步骤的任务，其中大部分轮次是常规操作，但方案质量决定了最终效果。例如大型重构、同一错误反复出现的调试会话，以及你希望在 Claude 宣布完成之前进行独立检查的任务。

它在计划空间很小的短任务中价值不大，或在每一轮都需要最强模型的工作中也不太适用。对于这些场景，改为切换主模型即可，或者了解 advisor 与 opusplan 和 subagents 的比较，获取其他获取第二意见的方式。

启用 advisor

你可以通过三种方式设置 advisor 模型：

• /advisor 命令：在会话中途设置或更改 advisor，并保存为默认值
• advisorModel 设置：在设置文件中配置持久默认值
• --advisor 标志：在启动时为单次会话设置 advisor

以上每种方式都会为支持 advisor 的主模型的会话启用该功能。

会话启动后，Claude Code 会显示一条通知：Advisor Tool (experimental) is on and may use more tokens · /advisor。

如需停止使用 advisor，请参阅关闭 advisor。

在某些计划中，将 Fable 用作顾问还需要你一次性同意将 Fable 使用量计入用量积分。有关你给出同意之前的行为，请参阅 Fable 顾问与用量积分。

使用 /advisor 命令

不带参数运行 /advisor 会打开一个选择器，列出可用的 advisor 模型，也可以直接传入模型：

命令会显示 Advisor set to 加上 advisor 模型名称作为确认。你的选择会保存到用户设置的 advisorModel 中，并跨会话持久生效，除非 advisorModel 条目标注为仅应用于当前会话。

该命令在没有终端选择器的场景下也可用：非交互模式（带 -p）、Agent SDK、桌面应用以及 Remote Control。

这需要 Claude Code v2.1.260 或更高版本。

在这些场景中：

• 不带参数运行 /advisor 会打印当前 advisor 模型及其接受的别名。
• 带模型运行 /advisor，例如 /advisor opus，来设置它。
• 运行 /advisor off 来关闭它。

Claude Code 不会调用你的组织 availableModels 白名单中排除的已保存 advisor。要使用 advisor，请用 /advisor 选择一个允许的模型。

Claude Code 仍会保存当前主模型不支持的 advisor。当你通过 /model 切换到兼容的主模型后，该 advisor 会激活。

如果 API 已在当前对话中拒绝了已保存的 advisor，它会保持关闭状态，直到执行 /clear 或 /compact，即使切换了模型也不会立即恢复。

在某些计划中，将 Fable 用作顾问还需要你一次性同意将 Fable 使用量计入用量积分。有关 /advisor fable 在你给出同意之前的行为，请参阅 Fable 顾问与用量积分。

在设置中配置 advisorModel

不想开启会话就配置 advisor 为默认值？直接在设置文件中设置即可。

使用 --advisor 标志

要在不更改已保存设置的情况下为单次会话设置 advisor，使用该标志启动：

Claude Code 在该会话中使用该标志而非 advisorModel 设置。

claude --help 中不会列出 --advisor。

Claude Code 在以下情况下会以错误退出：

• 该会话的主模型不支持 advisor
• 请求的模型（例如 Haiku 4.5）不能担任顾问
• 你的组织 availableModels 白名单排除了请求的模型
• 你请求了 Fable 但你的账户仍需要用量积分同意

如果你启动的是后台会话并使用了 --advisor，且上述任一情况适用，Claude Code 会不带 advisor 启动会话而不是退出。

如果请求的模型可以担任顾问但排名低于该会话的主模型，Claude Code 仍会启动会话。在非后台会话中，它还会在启动时发出警告，说明该模型无法为主模型提供建议。

选择 advisor 模型

Claude Code 按能力对 advisor 角色的模型进行排名，advisor 必须排名等于或高于你会话的主模型。表格从最低排名的主模型到最高排名排列。

Fable 5.1 需要 Claude Code v2.1.257 或更高版本。Fable 模型需要 Fable 访问权限。

Sonnet 5.5 作为 Opus 4.7 或 Opus 4.8 主模型的顾问需要 Claude Code v2.1.287 或更高版本。

Haiku 5.5 作为主模型或作为顾问需要 Claude Code v2.1.293 或更高版本。

将 advisor 设置为 fable、opus 或 sonnet。这些别名会解析为 Claude Code 为每个模型系列内置的默认版本，该版本随 Claude Code 新版本发布而更新。

你也可以传入完整的模型 ID，例如 claude-opus-5-5 或 claude-haiku-5-5。

Haiku 4.5 可以调用 advisor 但不能担任顾问。

子代理会继承配置的 advisor，并对其自身模型应用相同的配对检查。

Claude Code 在发送请求之前验证配对，API 会再次验证：

• 对于排名低于主模型的 advisor，Claude Code 不会将其附加到主模型的请求上。/advisor 命令输出和通知会显示这一点；参见 advisor 低于当前主模型的情况。
• 自身模型满足配对条件的子代理仍可能使用 advisor。
• 如果 API 拒绝了 Claude Code 附加的 advisor 配对，Claude Code 会不带 advisor 重新发送该请求。对话在没有 advisor 的情况下继续，你不会看到错误，也不会有 advisor 调用。之后你用 /advisor 选择不同的 advisor，将在 /clear 或 /compact 以及新会话后生效。
• 如果主模型或 advisor 是 Claude Code 不识别的模型，advisor 不会被附加。

Fable 顾问与用量积分

在某些计划中，Fable 使用量按用量积分计费，Fable 作为顾问也按同样方式计费。

如果你的账户需要一次性同意将 Fable 使用量计入用量积分，Claude Code 会在你用 /model 选择 Fable 模型时请求同意，并且在你接受该同意之前不会将 Fable 应用为 advisor。

在你接受同意之前，当你输入 /advisor fable 或在 /advisor 选择器中选择 Fable 时，Claude Code 不会将 Fable 保存为 advisor，而是引导你使用 /model fable。

使用 claude --advisor fable 时，Claude Code 会以错误退出，提示信息指向 /model fable。在后台会话中，它会不带 advisor 启动会话而不是退出。

如果 Fable 已保存为你的 advisorModel，Claude Code 会在不附加 advisor 的情况下发送请求。在主模型支持 advisor 的交互式会话中，它还会显示一条通知，指向 /model fable。

要接受同意，运行 /model fable 并选择继续使用 Fable。Claude Code 会记录该同意并将 Fable 保存为你选择的模型。然后再将 Fable 选为 advisor。

常见模型配对

任何被接受的配对都可以使用。以下组合以不同方式平衡了成本与能力。

Claude 何时咨询 advisor

由 Claude 决定何时调用 advisor。它倾向于在确定方案之前、同一错误反复出现时、以及宣布任务完成之前进行咨询，但具体时机由模型驱动而非规则控制。

你可以在提示词中请求咨询，方式与请求任何工具相同，例如 继续之前先咨询顾问。

没有设置可以限制或强制 advisor 调用；如果你想让 Claude 在任务中更频繁或更少地咨询顾问，在指令中说明即可。

会话中你会看到什么

当 Claude 调用 advisor 时，对话记录在调用进行中会显示一行包含 advisor 模型名称的 Advising。

当结果返回时，该行会报告顾问是否给出了指导：

• Reviewed：该行确认顾问已审阅对话。当顾问返回了可读的指导内容时，按 Ctrl+O 查看。
• Declined：该行显示 Advisor declined to advise on this request。如果顾问给出了理由，按 Ctrl+O 查看。
• Unavailable：advisor 调用失败，该行显示 Advisor unavailable ()，其中括号内是调用返回的代码。

Claude 通常遵循顾问的指导，但当自身证据与某个具体说法矛盾时会做出调整：如果推荐的步骤尝试后失败，或文件内容与建议矛盾，Claude 会指出冲突而非无条件遵循指导。

顾问始终收到完整对话，调用时机由 Claude 控制。如需更多控制或不同配置，请参阅 advisor 与 subagents 和 opusplan 的比较。

成本

当 Claude 调用 advisor 时，advisor 模型会读取对话，因此每次调用都会按 advisor 模型的费率消耗 token，此外还有主模型的使用量。

advisor token 的计费方式取决于你的付费方式：

• API 计费：你按 advisor 模型的输入和输出费率支付 advisor token
• 订阅计划：advisor 使用量计入你计划的使用限额，但 Fable 顾问在 Fable 使用量按用量积分计费的计划中按用量积分计费

如果你的账户需要用量积分同意，在你给出同意之前 Fable 顾问不产生任何费用，因为 Claude Code 在此之前不会应用该选择。

Claude 在决策点而非每一轮调用 advisor，因此将更快的主模型与更强的 advisor 配对通常比全程运行更强的模型花费更少。

advisor 使用量计入 /usage 显示的会话总用量中。

有关 advisor token 在 API 响应中的报告方式，请参阅 Claude API 文档中的使用与计费。

对提示词缓存的影响

在会话中途启用或禁用 advisor 不会使你主模型的提示词缓存失效。

与切换模型不同，切换 /advisor 会保持缓存前缀完整，顾问返回的指导内容在后续轮次中会作为对话记录的一部分被缓存。

advisor 模型自身对对话的读取不会被缓存。每次 advisor 调用都会全新处理完整对话，调用之间不会复用。

要求

advisor 工具需要满足以下所有条件：

• 仅限 Anthropic API：advisor 是服务器端执行的工具。在 Amazon Bedrock、AWS 上的 Claude Platform、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。通过配置了 ANTHROPIC_BASE_URL 的 LLM 网关使用时，可用性取决于网关是否完整转发请求到 Anthropic API。如果网关或其上游不识别 advisor 工具，请参阅自动重试和错误转发，了解 Claude Code 的响应方式。

• 受支持的主模型：Fable、Opus 4.6 或更高版本、Sonnet 4.6 或更高版本、Haiku 4.5 或 Haiku 5.5。请参阅选择 advisor 模型，了解每个主模型接受哪些顾问。

• 功能标志获取：Claude Code 通过从 Anthropic 获取的功能标志来开启 advisor。在