这他妈是 Claude Code 的稀缺金矿 —— 给 Claude Opus 5.5 配一支自己的工程团队。Sonnet 5.5 干跑腿的活，Fable 5.1 把关真正要紧的决策。高风险的活自己来规划，中等的交给别人干，Fable 在错误变成昂贵代价之前就介入。把 Opus 的 token 留给真正难的决定 • 给每个模型一个清晰的职责

• Opus 5.5，高（high）—— 规划并编写代码
• Sonnet 5.5，中（medium）—— 指挥支援团队
  • explorer —— 阅读代码库
  • worker —— 修改代码并运行测试
  • researcher —— 查阅文档
• Fable 5.1 —— 复核整个会话
• /advisor fable —— 提供第二意见

→ 在关键处向 Fable 提问，看错误从哪里开始复利

• 在制定方案之前：这是正确的做法吗？
• 当同一个错误反复出现时：我们是不是在别处找原因？
• 在宣布“完成”之前：有什么逃过了检查？

JEV（约不到半秒的有界判断）处理更小的决定：

• 该打开哪个文件
• 用哪个工具
• 重试还是就此打住

更大的模型则把注意力留给那些真正配得上它的决策。

把这段粘贴进 Claude Code ↓

“prepare a revised Claude Code setup

1. Inspect ~/.claude/agents and .claude/agents Reuse agents suited to explorer, worker and researcher; draft only missing roles Use model: sonnet and effort: medium List agents pinned to a different model and preserve their configuration
2. Propose these changes in ~/.claude/settings.json: effortLevel: high advisorModel: fable
3. Report advisor blockers: CLAUDE_CODE_DISABLE_ADVISOR_TOOL DISABLE_TELEMETRY anything blocking feature-flag fetching Also report CLAUDE_CODE_EFFORT_LEVEL Leave these settings untouched
4. Propose adding this rule to ~/.claude/CLAUDE.md: consult the advisor before a major plan, when the same error repeats, and before declaring a long task complete Show every proposed change as a diff Wait for my ‘go’ before making any edits“

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

用 advisor 工具处理艰难决策 - Claude Code 文档

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

advisor 工具让 Claude 在任务的关键时刻咨询另一个模型（通常是更强的那个），比如在敲定方案之前、卡在反复出现的某个错误上时，或者在宣布任务完成之前。advisor 会收到完整的对话内容，包括每一次工具调用及其结果，并返回指导建议，Claude 在继续之前会先应用这些建议。advisor 以 server tool 的形式（https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool）运行在 Anthropic 的基础设施上，订阅制和按量计费的账号都可以使用。由你决定哪个模型充当 advisor，而由 Claude 决定何时调用它。

本页介绍如何启用 advisor、接受哪些模型配对、咨询过程中 Claude 会展示什么，以及 advisor 的用量如何计费。

什么时候该用 advisor

advisor 适合那种长而多步的任务：大部分回合都很常规，但方案质量决定最终结果。例如大型重构、错误反复出现的调试会话，以及那些你希望在 Claude 宣布完成之前能被独立检查一遍的任务。

它在那些几乎没有可规划空间的短任务上，或者每一步都需要最强模型的工作上，价值不大。这类情况下应改用切换主模型（https://code.claude.com/docs/en/model-config#setting-your-model）的方式，或者了解 advisor 与 opusplan 和 subagent 的对比（https://code.claude.com/docs/en/advisor#compare-with-related-features），看看获取第二意见的其他途径。

启用 advisor

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

• /advisor 命令：在会话中途设置或更改 advisor，并将其保存为默认值
• advisorModel 设置：在配置文件（https://code.claude.com/docs/en/settings）中设置持久默认值
• --advisor 标志：启动时为单个会话设置 advisor

这些方式中的任何一种，都会在主模型支持 advisor（https://code.claude.com/docs/en/advisor#choose-an-advisor-model）的会话中启用它。会话开始后，Claude Code 会显示一条提示：Advisor Tool (experimental) is on and may use more tokens · /advisor。

要停止使用 advisor，请参见关闭 advisor（https://code.claude.com/docs/en/advisor#turn-the-advisor-off）。

在某些计划下，Fable 作为 advisor 还需要你一次性授权，将 Fable 用量计入用量积分（https://code.claude.com/docs/en/model-config#fable-and-usage-credits）。在你给出该授权之前会发生什么，请参见 Fable advisor 与用量积分（https://code.claude.com/docs/en/advisor#fable-advisor-and-usage-credits）。

使用 /advisor 命令

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

命令会显示 Advisor set to 加上 advisor 模型名以作确认。你的选择会保存到用户设置的 advisorModel 中，并跨会话持久生效，但 advisorModel 条目（https://code.claude.com/docs/en/settings-reference#advisormodel）中注明仅适用于当前会话的情况除外。

该命令在没有终端选择器的场景下同样可用：带 -p 的非交互模式（https://code.claude.com/docs/en/headless）、Agent SDK、桌面应用，以及 Remote Control（https://code.claude.com/docs/en/remote-control）。这些场景要求 Claude Code v2.1.260 或更高版本。在这些界面上：

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

Claude Code 不会调用你所在组织的 availableModels（https://code.claude.com/docs/en/model-config#restrict-model-selection）允许列表所排除的已保存 advisor。要使用 advisor，请用 /advisor 选择一个被允许的模型。

即使当前主模型不支持某个 advisor，Claude Code 仍会将其保存下来。当你用 /model（https://code.claude.com/docs/en/model-config#setting-your-model）切换到兼容的主模型（https://code.claude.com/docs/en/advisor#choose-an-advisor-model）后，该 advisor 才会生效。如果 API 已在当前对话中拒绝过该已保存的 advisor，它会一直保持关闭状态，直到你执行 /clear 或 /compact，即使你切换了模型也一样。

在某些计划下，Fable 作为 advisor 还需要你一次性授权，将 Fable 用量计入用量积分（https://code.claude.com/docs/en/model-config#fable-and-usage-credits）。在你给出该授权之前 /advisor fable 会做什么，请参见 Fable advisor 与用量积分（https://code.claude.com/docs/en/advisor#fable-advisor-and-usage-credits）。

在设置中配置 advisorModel

不想打开会话就把 advisor 配置为默认值的话，可以在你的设置文件中这样设置：

使用 --advisor 标志

要在不改动已保存设置的情况下为单个会话设置 advisor，启动时加上该标志：

在该会话中，Claude Code 会使用标志而不是 advisorModel 设置。Claude Code 不会在 claude --help 中列出 --advisor。

如果出现以下情况，Claude Code 会在启动时以错误退出：

• 该会话的主模型不支持 advisor
• 所请求的模型（例如 Haiku）无法充当 advisor
• 你所在组织的 availableModels（https://code.claude.com/docs/en/model-config#restrict-model-selection）允许列表排除了所请求的模型
• 你请求了 Fable，而你的账号仍需要用量积分授权（https://code.claude.com/docs/en/advisor#fable-advisor-and-usage-credits）

如果你用 --advisor 启动的是后台会话（https://code.claude.com/docs/en/agent-view），而上述任一情况成立，Claude Code 会直接在没有 advisor 的情况下启动会话，而不是退出。

如果所请求的模型可以充当 advisor，但排名低于该会话的主模型（https://code.claude.com/docs/en/advisor#choose-an-advisor-model），Claude Code 仍会照常启动会话。在后台会话之外，它还会在启动时提示该模型 cannot advise 主模型。

选择 advisor 模型

Claude Code 按能力对模型在 advisor 角色上的排名进行排序，advisor 的排名必须等于或高于你所在会话的主模型。各行按主模型排名从低到高排列：

Fable 5.1 需要 Claude Code v2.1.257 或更高版本。Fable 模型需要具备 Fable 访问权限（https://code.claude.com/docs/en/model-config#work-with-fable）。

当主模型为 Opus 4.7 或 Opus 4.8 时，以 Sonnet 5.5 作为 advisor 需要 Claude Code v2.1.287 或更高版本。

advisor 可设置为 fable、opus 或 sonnet。这些别名会解析为 Claude Code 为每个模型家族内置的默认版本（https://code.claude.com/docs/en/model-config#model-aliases），并随 Claude Code 的新版本一起更新。你也可以传入完整模型 ID，例如 claude-opus-5-5。

Haiku 可以调用 advisor，但不能充当 advisor。子代理会继承已配置的 advisor，并对自己的模型应用相同的配对检查。

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

• 对于排名低于主模型的 advisor，Claude Code 不会将其附到主模型的请求上。/advisor 命令的输出和一条通知会说明这一点；参见 Advisor is less capable than the current main model（https://code.claude.com/docs/en/errors#advisor-is-less-capable-than-the-current-main-model）。自身模型满足配对条件的子代理仍可使用 advisor。
• 如果 API 拒绝了 Claude Code 所附加的 advisor 配对，Claude Code 会不带 advisor 重新发送该请求。对话会继续进行，你不会看到错误，也不会产生 advisor 调用。之后你若用 /advisor 选择另一个 advisor，它会在 /clear 或 /compact 之后以及新会话中生效。
• 如果主模型或 advisor 是 Claude Code 不认识的模型，则不会附加 advisor。

Fable advisor 与用量积分

在某些计划下，Fable 用量会记入用量积分，Fable 作为 advisor 也按同样方式计费。如果你的账号需要一次性授权将 Fable 用量计入用量积分（https://code.claude.com/docs/en/model-config#fable-and-usage-credits），Claude Code 会在你用 /model 选择 Fable 模型时征求该授权，在你接受之前不会将 Fable 应用为 advisor。

在你接受之前，无论你是输入 /advisor fable 还是在 /advisor 选择器中挑选 Fable，Claude Code 都不会将其保存为 advisor，而是引导你去使用 /model fable。使用 claude --advisor fable 时，Claude Code 会在启动时退出，并显示一条指向 /model fable 的消息。在后台会话（https://code.claude.com/docs/en/advisor#use-the-advisor-flag）中，它会直接在没有 advisor 的情况下启动会话，而不是退出。

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

要接受授权，请运行 /model fable 并选择继续使用 Fable。Claude Code 会记录该授权，并将 Fable 保存为你所选的模型（https://code.claude.com/docs/en/model-config#default-model-setting）。之后再把 Fable 选作 advisor。

常见的模型配对

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

Claude 何时会咨询 advisor

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

你可以在提示词中请求咨询，就像请求任何其他工具一样，例如 consult the advisor before you continue。没有设置可以限制或强制 advisor 调用次数；如果你想让 Claude 在任务中更频繁或更少地咨询，直接在指令中说明即可。

会话过程中你会看到什么

Claude 调用 advisor 时，转录记录会显示一行带 advisor 模型名的 Advising，在调用进行期间显示。结果返回后，该行会说明 advisor 是否给出了指导：

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

Claude 通常会遵循 advisor 的指导，但当自身证据与某一具体说法相矛盾时会做出调整：如果推荐的步骤在尝试时失败，或者文件内容与该建议相悖，Claude 会把冲突呈现出来，而不是无条件地照做。

advisor 始终会收到完整对话，而时机由 Claude 控制。如果需要更多控制权或不同的配置方式，请参见 advisor 与子代理和 opusplan 的对比（https://code.claude.com/docs/en/advisor#compare-with-related-features）。

成本

Claude 调用 advisor 时，advisor 模型会读取对话，因此每次调用除主模型的用量外，还会按 advisor 模型的费率消耗 token。这些 advisor token 如何计费取决于你的付费方式：

• API 计费：advisor token 按 advisor 模型的输入和输出费率付费
• 订阅计划：advisor 用量计入你所在计划的用量限额，但在 Fable 用量记入用量积分的计划下，Fable advisor 计入的是用量积分（https://code.claude.com/docs/en/model-config#fable-and-usage-credits）

如果你的账号需要用量积分授权，在你给出授权之前 Fable advisor 不会计费，因为 Claude Code 在此之前不会应用该选择（https://code.claude.com/docs/en/advisor#fable-advisor-and-usage-credits）。

Claude 是在决策点调用 advisor，而不是每个回合都调用，因此把更快的主模型与更强的 advisor 搭配，通常比全程跑更强的模型更省钱。

advisor 用量会计入 /usage（https://code.claude.com/docs/en/costs#track-your-costs）所显示的会话总量。关于 advisor token 如何在 API 响应中报告，请参见 Claude API 文档中的 Usage and billing（https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing）。

对提示词缓存的影响

在会话中途启用或关闭 advisor，不会使主模型的提示词缓存（https://code.claude.com/docs/en/prompt-caching）失效。与切换模型（https://code.claude.com/docs/en/prompt-caching#switching-models）不同，切换 /advisor 会保留缓存前缀不变，而 advisor 返回的指导会在后续回合中作为转录记录的一部分被缓存。

advisor 模型自身对对话的读取不会被缓存。每次 advisor 调用都会重新处理完整转录，调用之间没有任何复用。

要求

advisor 工具需要同时满足以下条件：

• 仅支持 Anthropic API：advisor 是在服务端执行的工具。它在 Amazon Bedrock、AWS 上的 Claude Platform、Google Cloud 的 Agent Platform 以及 Microsoft Foundry 上均不可用。若通过配置了 ANTHROPIC_BASE_URL 的 LLM 网关（https://code.claude.com/docs/en/llm-gateway）使用，是否可用取决于该网关能否将请求完整转发给 Anthropic API。如果网关或其上游不认识 advisor 工具，请参见 Automatic retry and error forwarding（https://code.claude.com/docs/en/llm-gateway-protocol#automatic-retry-and-error-forwarding），了解 Claude Code 的应对方式。
• 受支持的主模型：Fable、Opus 4.6 及以上版本、Sonnet 4.6 及以上版本，或 Haiku 4.5。每个主模型接受哪些 advisor，请参见 选择 advisor 模型（https://code.claude.com/docs/en/advisor#choose-an-advisor-model）。
• 需要能够获取 feature flag：Claude Code 通过从 Anthropic 获取的 feature flag 来开启 advisor。在某个会话中，如果设置了关闭 flag 获取的变量（例如 DISABLE_TELEMETRY），advisor 将保持关闭。参见 需要获取 feature flag 的功能（https:/