Advisor 模式

概述

Advisor（顾问模式）是 Claude Code 内置的代码审查/咨询机制。它允许当前工作的 Claude 模型在关键节点调用一个更强的模型来审查思路、方案或最终结果，并提供反馈意见。

主要用途

场景	说明
动手写代码之前	让顾问模型审查实现思路是否正确，避免方向性错误
任务完成后	作为最终的质量检查，确保交付物没有问题
卡住的时候	多次报错、方案不收敛时，让更强的模型帮忙分析
需要变更方案时	在切换思路前征求顾问意见
较长任务中	建议至少调用两次（动手前 + 完成前）
协调矛盾证据	如果主模型的数据与顾问意见相左，需要将冲突反馈给顾问解决

工作原理

1. 当前 Claude 模型调用 advisor 工具（无需传参）
2. 整个对话历史（包括所有工具调用和结果）自动发送给顾问模型
3. 顾问由更强大的模型担任（Opus 4.6 或 Sonnet 4.6）
4. 顾问返回反馈，返回值有三种形式：
   • advisor_result — 纯文本反馈
   • advisor_redacted_result — 加密/脱敏反馈（用于敏感上下文）
   • advisor_tool_result_error — 顾问不可用时的错误信息
5. 主模型参考建议进行调整

如何使用

命令

命令	作用
/advisor opus	设置顾问模型为 Opus
/advisor sonnet	设置顾问模型为 Sonnet
/advisor off	关闭顾问模式
/advisor	查看当前顾问状态

配置文件

在 settings.json 中配置：

{
  "advisorModel": "claude-opus-4-6"
}

环境变量

CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1  # 禁用 Advisor

UI 展示

当 Advisor 被调用时，界面会显示：

• "Advising" 字样 + 旋转动画 + 模型名称（如 Advising using Opus 4.6）
• 完成后：显示勾选标记和 "Advisor has reviewed the conversation and will apply the feedback"

注意事项

• 仅限第一方 API 用户：不支持 Bedrock 或 Vertex AI
• 模型要求：主模型和顾问模型都必须支持 advisor 工具（目前 Opus 4.6 和 Sonnet 4.6）
• 功能开关：由 tengu_sage_compass feature flag 控制，可能并非所有版本都开放
• 模型匹配：如果主模型不支持调用 advisor 工具，即使配置了也不会生效