命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
开关 advisor 工具——在任务关键时刻咨询第二个模型获取指导。接受 opus / sonnet / fable(v2.1.170+)或完整 model ID;不带参数则打开选择器。需 v2.1.98+。
/advisor [model|off]/advisor opus/advisor 是 Claude Code CLI 中的会话内 slash 命令,用来设置 / 切换 / 关闭 advisor 工具——让 Claude 的主模型在任务的关键时刻(确定方案前、反复卡在同一个错误时、宣告任务完成前)咨询第二个、通常更强的顾问模型,把它的指导吸收后再继续。
顾问会收到完整对话(含每一次工具调用与结果),由 Claude 自行决定何时调用,返回的指导被 Claude 应用后再往下走。它作为 server tool 跑在 Anthropic 服务端,订阅账户与 API 计费账户都可用。
版本门槛:需要 Claude Code v2.1.98 或更高,且仅限 Anthropic API——在 Amazon Bedrock / Google Vertex AI / Microsoft Foundry 上不可用。advisor 工具目前标注为实验性,行为、定价、可用性可能变化。把 Fable 5 用作顾问额外需要 v2.1.170+ 与组织的 Fable 5 访问权。
启用 advisor 有三条路:
| 方式 | 作用域 | 说明 |
|---|---|---|
/advisor [model] | 会话内设置 + 存为默认 | 不带参数打开选择器;选择写入用户 settings 的 advisorModel 并跨会话持久化 |
advisorModel 设置 | 持久默认 | 在 settings 文件里写 "advisorModel": "opus" |
--advisor <model> 标志 | 单次会话 | claude --advisor opus,优先级高于 advisorModel,但若主模型不支持会直接报错退出 |
会话内最常用:
/advisor opus
不带参数 /advisor 则弹出可选顾问模型的选择器。若当前主模型暂不支持 advisor,选择仍会被保存,等你用 /model 切到兼容主模型时自动生效(这点和 --advisor 标志不同——标志会当场报错)。
顾问必须至少和主模型一样强。接受的别名是 opus、sonnet、fable(解析为各自最新版),也可传完整 model ID 如 claude-opus-4-8。
| 主模型 | 可用顾问 | 备注 |
|---|---|---|
| Haiku 4.5 | Fable / Opus / Sonnet | Haiku 能调用顾问但不能当顾问 |
| Sonnet 4.6 | Fable / Opus / Sonnet | |
| Opus 4.6+ | Fable、或不低于主模型版本的 Opus | Opus 4.7 主配 Opus 4.6 顾问会被拒 |
| Fable 5(v2.1.170+) | 仅 Fable | Opus / Sonnet 当顾问会被拒 |
Claude Code 在发请求前校验配对:顾问比主模型弱则不挂载到主模型请求(/advisor 输出与通知会提示);主模型或顾问是无法识别的模型也不挂载。subagent 继承所配顾问,并对自己的模型重做同样的配对检查。
Claude 调用顾问时,transcript 会显示一行 Advising + 顾问模型名(调用进行中);结果返回后该行确认顾问已审阅对话。
Ctrl+O 展开这行,读顾问的完整指导。Claude 一般遵循顾问指导,但当自身证据与之矛盾(推荐步骤一试就失败、或文件内容与建议相左)时会摆出冲突而非无条件照做。
你也可以在 prompt 里像请求任何工具一样请求咨询,例如 consult the advisor before you continue。没有任何设置能强制或封顶 advisor 调用次数——想让它多咨询 / 少咨询,就在指令里写明。
| 约束 | 说明 |
|---|---|
| 版本 | 需 v2.1.98+;Fable 顾问需 v2.1.170+ |
| 仅 Anthropic API | server tool,Bedrock / Vertex / Foundry 不可用;经 LLM gateway 时取决于是否原样转发到 Anthropic API |
| 支持的主模型 | Opus 4.6+ / Sonnet 4.6 / Haiku 4.5(Fable 5 在 v2.1.170+ 也合格) |
| 计费 | 每次调用按顾问模型费率额外消耗 token;订阅计划计入用量上限,计入 /usage 会话合计 |
| 调用时机 | 由 Claude 决定,model-driven 而非规则化 |
| 方式 | 更强模型何时跑 | 如何启动 |
|---|---|---|
| advisor 工具 | 任务中途的决策点 | Claude 需要指导时自行调用 |
opusplan | plan 模式期间,执行时切回 Sonnet | 你进入 plan 模式 |
subagent 设了 model | 整个被委派的子任务 | Claude 委派或你显式调用 |
/model | 此后所有 turn | 你切换主模型 |
会话中途开 / 关 advisor 不会作废主模型的 prompt cache——这点和"换模型 / 改 effort"不同。顾问返回的指导作为 transcript 一部分在后续 turn 被缓存;但顾问自己对对话的读取不缓存,每次调用都重新处理完整 transcript。
/advisor 输出 / 通知里提示,别以为设了就一定生效。/advisor off,或在选择器里选 No advisor(清掉 advisorModel)。/advisor 命令与 --advisor 标志一起关):设环境变量 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1。/advisor off