MemoryLake
返回全部文章
Tutorial2026 年 11 月 18 日·12 分钟阅读

什么是 Claude Code 中的 Advisor 工具?Advisor 从您的会话中看到了什么,为什么每次调用都会重新读取完整对话记录,以及 Claude Code 何时会静默丢弃它 (2026)

您将 Claude Code 设置为以 Sonnet 作为主模型,Opus 作为 Advisor(顾问),希望在漫长的调试会话的关键时刻获得第二意见。一周以来,它运行良好:在重大决策前会出现一行“Advising”。然后,在尝试更换另一个 Advisor 后,该行停止出现了。没有报错,Claude 依然照常工作。

这种沉默是有据可查的。Anthropic 关于该功能的页面指出,如果 API 拒绝了 Advisor 配对,Claude Code 会在不带 Advisor 的情况下重新发送请求,并且“对话会继续进行,因此您看不到错误,也不会收到 Advisor 调用”。

本指南涵盖了什么是 Advisor 工具、它从您的会话中看到了什么、如何开启它、哪些配对有效、Claude 何时调用它、它在上下文和缓存方面的成本、Claude Code 何时会在不告知您的情况下丢弃它,以及它与引入更强模型的其他方式的对比。

什么是 Advisor 工具

Anthropic 的文档用一句话描述了它:“Advisor 工具允许 Claude 在任务的关键时刻咨询第二个、通常是更强大的模型,例如在确定方案之前、卡在重复出现的错误时,或在宣布任务完成之前。”

三个细节定义了它的工作方式:

  • 它是第二个模型。 您保留主模型处理常规工作,并添加一个 Advisor 进行决策。
  • 它在 Anthropic 侧运行。 文档称:“Advisor 作为服务器端工具运行在 Anthropic 的基础设施上,可供订阅账户和 API 计费账户使用。”
  • Claude 决定何时使用它。 “您选择哪个模型担任 Advisor,而 Claude 决定何时调用它。”

该工具被标记为实验性功能。它需要 Anthropic API、AWS 上的 Claude Platform 或 Google Cloud 上的 Claude Models(Anthropic 托管),且无法通过 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 使用。

文档指出,Advisor 适用于“漫长的、多步骤的任务,其中大部分轮次是常规的,但计划质量决定了结果”。其示例包括大型重构、错误不断重复出现的调试会话,以及您希望在 Claude 宣布完成之前进行检查的任务。

Advisor 从您的会话中看到了什么

这部分决定了咨询的有效性。

文档明确指出:“Advisor 接收完整的对话,包括每一次工具调用和结果,并返回 Claude 在继续之前应用的指导。”随后又重复了这一点:“Advisor 始终接收完整的对话,而 Claude 控制调用时机。”

因此,Advisor 的视角是会话的对话记录。它能看到您问了什么、Claude 读取了什么、命令返回了什么,以及 Claude 到目前为止得出的结论。文档没有描述任何单独的简报。

这产生了一个实际后果。文档将 Advisor 的输入描述为“对话”。如果某个约束条件从未在会话中出现过(例如您的团队上个月做出的决定,或某个模块绝不能更改的原因),那么根据文档,Advisor 就不会收到这些信息。如果它对决策很重要,就必须出现在对话中。

Claude 也会有判断力地对待这些指导。文档称:“Claude 通常遵循 Advisor 的指导,但当其自身证据与特定主张相矛盾时,它会进行调整”。如果推荐的步骤失败,或者文件内容与建议相左,Claude 会揭示冲突,而不是盲目遵循建议。

如何开启 Advisor

文档列出了三种方式,它们的区别在于选择的持续时间。

/advisor 命令。 不带参数运行它以从列表中选择,或传递一个模型,例如 /advisor opus。文档称您的选择“将保存到用户设置中的 advisorModel 并跨会话持久存在”,设置参考中列出的少数例外情况除外。

advisorModel 设置。 在您的设置文件中进行设置,以便在不开启会话的情况下配置默认值。

--advisor 标志。 使用 claude --advisor opus 启动,为单个会话设置 Advisor,而不更改保存的设置。

会话开始后,Claude Code 会显示一条通知,说明 Advisor 工具已开启且可能会消耗更多 token。

哪些配对有效

Advisor 的能力必须至少与您的主模型相当。文档称 Claude Code 会对 Advisor 角色的模型进行排名,并且“Advisor 的排名必须等于或高于您会话的主模型”。

文档中接受的配对表包括以下示例:

  • Sonnet 5.5 作为主模型 接受 Fable、Opus 5 或更高版本,或 Sonnet 5.5 作为 Advisor。
  • Opus 5 或 Opus 5.5 作为主模型 接受 Fable 或 Opus 5 或更高版本。
  • Fable 5.2 作为主模型 仅接受 Fable 5.2。

您可以使用别名(fable、opus 或 sonnet)或完整的模型 ID 来设置 Advisor。文档指出,别名“解析为 Claude Code 为每个模型系列内置的默认版本,该版本随新的 Claude Code 版本而更新”。

它还列出了常见的配对及其适用场景。Sonnet 主模型配合 Opus Advisor 可以让 Sonnet 处理常规工作,并将规划、模糊的失败和完成检查升级给 Opus。Opus 主模型配合 Opus Advisor 则为高风险任务提供第二次审查。

Subagents(子智能体)遵循相同的规则。文档称:“Subagents 继承配置的 Advisor,并针对其自身模型应用相同的配对检查。”

Claude 何时调用 Advisor

您无法安排咨询时间。文档称 Claude “倾向于在确定方案之前、当错误不断重复出现时,以及在宣布任务完成之前进行咨询,但时机是由模型驱动而非基于规则的”。

您仍然可以施加影响。您可以在提示词中要求咨询,文档中的示例是告诉 Claude 在继续之前咨询 Advisor。关于频率,它补充道:“没有设置可以限制或强制 Advisor 调用;如果您希望 Claude 在任务期间增加或减少咨询频率,请在指令中说明。”

在会话期间,咨询会显示为带有 Advisor 模型名称的“Advising”行。返回时,该行会显示以下三种结果之一:

  • Reviewed(已审查): Advisor 审查了对话。按 Ctrl+O 读取其指导。
  • Declined(已拒绝): Advisor 拒绝就该请求提供建议。按 Ctrl+O 查看给出的原因。
  • Unavailable(不可用): 调用失败,该行会显示错误代码。

为什么每次调用都会重新读取整个对话记录

Advisor 每次对会话的观察都是全新的。文档中关于提示词缓存(prompt caching)的部分解释了这一点。

对于您的主模型,影响很小:“在中途启用或禁用 Advisor 不会使主模型的提示词缓存失效。” 并且指导本身也会成为记录的一部分:“Advisor 返回的指导在后续轮次中作为对话记录的一部分被缓存。”

而在 Advisor 侧,没有任何内容会被保留:“Advisor 模型自身对对话的读取是不被缓存的。每次 Advisor 调用都会重新处理完整的对话记录,调用之间没有重用。”

这会产生两个后果:

  • 长会话会使每次咨询的规模变大。 Advisor 每次都会读取整个对话,因此长会话后期的调用处理的内容比早期更多。
  • Advisor 侧的调用之间没有重用。 连接两次调用的纽带是对话记录,其中包含了之前返回的指导。

这也是为什么开启 Advisor 与切换模型不同。文档直接对比了两者:与切换模型不同,切换 /advisor 会保持缓存的前缀完整。我们在在 Claude Code 会话中途切换模型指南中介绍了模型切换对会话缓存和上下文的影响。

成本是多少

Advisor 需要读取对话,因此每次调用都会在主模型用量的基础上,按 Advisor 模型的价格消耗 token。在 API 计费模式下,您支付 Advisor 模型的输入和输出费用。在订阅计划中,Advisor 的使用计入您的计划使用限制,对于在按使用额度计费的计划中使用 Fable Advisor,有单独的规则。

文档对这种设计的辩护是,Claude 在“决策点而非每一轮”调用 Advisor,因此使用较快的主模型配合较强的 Advisor 通常比全程运行较强模型的成本更低。Advisor 的使用情况会出现在 /usage 显示的会话总计中。

Claude Code 何时会静默丢弃 Advisor

这就是开头示例中的行为,文档描述了几种情况。

API 拒绝配对。 “如果 API 拒绝了 Claude Code 附加的 Advisor 配对,Claude Code 会在不带 Advisor 的情况下重新发送该请求。对话会继续进行,因此您看不到错误,也不会收到 Advisor 调用。” 如果您随后使用 /advisor 选择另一个 Advisor,文档称它将在 /clear 或 /compact 之后以及新会话中生效。

Advisor 排名低于主模型。 Claude Code 不会将其附加到主模型的请求中。/advisor 的输出和通知会显示这一点。

保存的 Advisor 不支持当前主模型。 文档称:“Claude Code 仍会保存当前主模型不支持的 Advisor。该 Advisor 将在您使用 /model 切换到兼容的主模型后激活。” 它还补充了一个限制:“如果 API 在当前对话中已经拒绝了保存的 Advisor,它将保持关闭状态直到执行 /clear 或 /compact,即使在切换模型后也是如此。”

模型无法识别。 “如果主模型或 Advisor 是 Claude Code 无法识别的模型,则不会附加 Advisor。”

您的组织限制了模型。 如果您组织的 availableModels 允许列表排除了某个保存的 Advisor,Claude Code 就不会调用它。

功能标志(Feature flags)已关闭。 在 AWS 上的 Claude Platform 和 Google Cloud 上的 Claude Models(Anthropic 托管)之外,Advisor 需要从 Anthropic 获取功能标志。如果会话中的变量关闭了获取功能(例如 DISABLE_TELEMETRY),则无法使用该功能。

每种情况下的模式都是相同的:会话继续工作,只是没有咨询。如果您依赖 Advisor,请在执行长任务期间检查是否有“Advising”行,并运行 /advisor 查看设置情况。

Advisor 与其他选项的对比

文档比较了引入更强模型的四种方式:

  • Advisor 工具: 在任务中途的决策点,由 Claude 调用。
  • opusplan: 在计划模式期间使用,然后使用 Sonnet 执行。
  • 设置了模型的 Subagents: 用于整个委派的子任务。
  • /model: 从下一个请求开始,当您切换时生效。

Advisor 是唯一一种由更强模型在 Claude 选择的时刻审查整个对话的方式。其他方式要么移交部分工作,要么为后续的所有内容更改模型。

如何关闭它

运行 /advisor off,或在选择器中选择“No advisor”。要完全禁用该工具,请设置 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1。文档称,随后 /advisor 命令将变得不可用,任何配置的 advisorModel 都会被忽略。

人们首先会尝试什么

期望在 Advisor 停止工作时看到错误。 Claude Code 会在不带它的情况下重新发送且不显示错误。

假设 Advisor 了解您的项目历史。 它接收的是当前对话。

在被拒绝后在对话中途更改 Advisor。 新的选择在 /clear 或 /compact 后生效。

选择比主模型弱的 Advisor。 它的排名必须等于或高于主模型。

期望有设置可以强制咨询。 并没有。请在您的指令中提出要求。

解决方法:给 Advisor 它需要看到的信息

第 1 步:检查配对

运行 /advisor 并确认 Advisor 的排名等于或高于您的主模型。

第 2 步:留意 Advising 行

在长任务中,检查咨询是否仍然出现,并使用 Ctrl+O 读取指导。

第 3 步:将关键约束放入对话中

在重大决策之前,陈述重要的约束条件,以便它们成为 Advisor 读取内容的一部分。

第 4 步:记录约束条件

记录应该影响每次审查的决策和限制,以便您可以将它们带入任何会话中。

在 MemoryLake 中设置

Advisor 审查的是对话包含的内容。应该影响其审查的决策(例如为什么不能升级某个依赖项、上个季度失败了哪种方案,或者哪个模块正在被替换)是项目上下文,可以存在于单个会话之外。

MemoryLake 是此类项目上下文(如决策、约束及其背后的原因)的记忆层,统一保存在您维护的一个地方,并可供您连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。

您可以用自己的语言亲自编写条目。不会从您的 Claude Code 会话、对话记录、设置文件、Advisor 指导或任何供应商的存储中读取、写入或删除任何内容。Advisor 工具将按照 Anthropic 描述的方式工作。

第 1 步:创建 API 密钥

登录并从控制面板生成密钥。像对待任何其他凭据一样,将其存储在代码库之外。

MemoryLake 控制台显示 API 密钥屏幕,在此处创建并复制新密钥以供 agent 使用
MemoryLake 控制台显示 API 密钥屏幕,在此处创建并复制新密钥以供 agent 使用

第 2 步:上传您的第一条记忆

从您在解决方法的第 4 步中编写的内容开始:每次审查都应遵守的约束条件。每个条目记录一个决策。

MemoryLake 工作区显示已上传的第一批文档,列出了每个文件变为可搜索记忆的过程
MemoryLake 工作区显示已上传的第一批文档,列出了每个文件变为可搜索记忆的过程

第 3 步:连接您的 AI 和 agent

连接 Claude Code、Codex 和您使用的其他助手。同样的约束条件可以在任何重大决策之前的会话中出现。

MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和 agent 框架
MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和 agent 框架

这在实践中改变了什么

第一个区别是审查的信息更充分。重要的约束条件存在于 Advisor 读取的对话中。

第二个是跨会话的一致性。每个新会话都可以从相同的决策开始。

第三个是跨工具的一致性。相同的上下文在 Claude Code 和其他助手中均可用。

Advisor 工具的最佳实践

将其用于漫长的、决策密集的任务。 短任务收益微乎其微。

将快速的主模型与更强的 Advisor 配对。 文档描述这种组合通常比全程运行更强模型更便宜。

在更改模型后检查配对。 Advisor 的排名必须等于或高于主模型。

留意沉默。 没有“Advising”行可能意味着 Advisor 已被丢弃。

更改 Advisor 后使用 /clear 或 /compact。 被拒绝的 Advisor 会一直保持关闭状态直到执行这些操作。

在重大决策前陈述约束条件。 Advisor 读取的是对话内容。

在提示词中要求咨询。 没有强制咨询的设置。

结论

Advisor 工具允许 Claude 在关键时刻咨询更强大的模型:在确定方案之前、当错误不断重复出现时,或在宣布任务完成之前。Advisor 每次都会接收完整的对话,且其自身的读取内容不会被缓存,因此每次调用都会重新处理整个对话记录。开启或关闭它不会使主模型的提示词缓存失效,且其指导会成为对话记录的一部分。

Claude Code 在几种情况下会停止使用 Advisor,且当 API 拒绝配对时,它不会报错。请检查您的配对,留意“Advising”行,并将重要的约束条件放入对话中,以便 Advisor 的审查基于您真正需要它了解的信息。

常见问题

什么是 Claude Code 中的 Advisor 工具?

这是一个实验性功能,允许 Claude 在任务的关键时刻咨询第二个、通常是更强大的模型。

Advisor 能看到什么?

完整的对话,包括每一次工具调用和结果。

如何开启 Advisor?

运行带有模型参数的 /advisor,在设置中设置 advisorModel,或使用 --advisor 启动单个会话。

为什么没有调用 Advisor?

可能是 API 拒绝了配对,Advisor 排名低于主模型,或者您的设置阻止了它。运行 /advisor 进行检查。

Advisor 会影响提示词缓存吗?

切换它不会使主模型的提示词缓存失效。Advisor 自身对对话的读取是不被缓存的。

我可以强制 Claude 咨询 Advisor 吗?

没有相关的设置。请在您的提示词或指令中要求咨询。

如何关闭 Advisor?

运行 /advisor off,或设置 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 以完全禁用它。