顧問工具是實驗性功能，需要 Claude Code v2.1.98 或更新版本搭配 Anthropic API。它在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上不可用。行為、定價和可用性可能會變更。
何時使用顧問
顧問適合長期、多步驟的任務，其中大多數輪次是例行的，但計畫品質決定結果。範例包括大型重構、錯誤不斷重複的除錯會話，以及您希望在 Claude 宣佈完成前獨立檢查的任務。 在短期任務（幾乎沒有計畫空間）或每個輪次都需要最強模型的工作上，它的價值較少。對於這些情況，切換主要模型，或查看顧問與 opusplan 和子代理的比較以了解獲取第二意見的其他方式。啟用顧問
您可以透過三種方式設定顧問模型：/advisor命令：在會話中途設定或變更顧問，並將其儲存為預設值advisorModel設定：在您的設定檔中配置持久預設值--advisor旗標：在啟動時為單一會話設定顧問
若要使用 Fable 5 作為顧問，您需要 Claude Code v2.1.170 或更新版本以及您的組織的 Fable 5 存取權。
使用 /advisor 命令
執行 /advisor 而不帶引數以開啟列出可用顧問模型的選擇器，或直接傳遞模型：
advisorModel，並在會話間保持。如果您目前的主要模型不支援顧問，選擇仍會被儲存，並在您使用 /model 切換到相容的主要模型時啟動。
在設定中設定 advisorModel
若要在不開啟會話的情況下將顧問配置為預設值，請在設定檔中設定它：
使用 --advisor 旗標
若要為單一會話設定顧問而不變更已儲存的設定，請使用旗標啟動：
advisorModel 設定。與 /advisor 不同（後者會儲存非作用中的選擇），如果會話的主要模型不支援顧問，旗標會以錯誤退出。
選擇顧問模型
顧問的能力必須至少與主要模型相同。每個主要模型接受的顧問為：| 主要模型 | 接受的顧問 | 備註 |
|---|---|---|
| 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 顧問會被拒絕 |
opus、sonnet 或 fable。這些別名解析為每個模型的最新版本。您也可以傳遞完整的模型 ID，例如 claude-opus-4-8。
子代理繼承已設定的顧問，並針對其自身模型應用相同的配對檢查。
Claude Code 在傳送請求前驗證配對：
- 如果顧問的能力低於主要模型，顧問不會附加到主要模型的請求。
/advisor命令輸出和通知會顯示此情況。其自身模型滿足配對的子代理仍可使用顧問。 - 如果主要模型或顧問是 Claude Code 無法識別的模型，顧問不會附加。
常見模型配對
任何接受的配對都有效。這些組合以不同方式平衡成本與能力：| 配對 | 何時使用 |
|---|---|
| Sonnet 主要 + Opus 顧問 | Sonnet 處理例行工作，並將計畫、模糊失敗和完成檢查升級到 Opus |
| Sonnet 主要 + Fable 顧問 | 在決策點獲得 Fable 5 指導，而無需全程執行 Fable 5。需要 v2.1.170 或更新版本以及 Fable 5 存取權 |
| Haiku 主要 + Opus 顧問 | 具有強大計畫的最低成本主要模型。預期成本高於單獨使用 Haiku，但低於將主要模型切換到 Sonnet 或 Opus |
| Opus 主要 + Opus 顧問 | 第二個 Opus 審查第一個。適用於獨立檢查比成本更重要的高風險任務 |
| Fable 主要 + Fable 顧問 | 當 Fable 5 可用時（v2.1.170+）的最高能力配對。Fable 是比 Opus 和 Sonnet 更高的層級，因此是 Fable 主要模型唯一接受的顧問 |
| Sonnet 主要 + Sonnet 顧問 | 用於捕捉例行疏漏的較低成本第二意見 |
Claude 何時諮詢顧問
Claude 決定何時呼叫顧問。它傾向於在提交方案前、錯誤不斷重複時以及在宣佈任務完成前進行諮詢，但時機是由模型驅動而非基於規則的。 您可以在提示中要求諮詢，就像您會要求任何工具一樣，例如consult the advisor before you continue。沒有設定來限制或強制顧問呼叫；如果您希望 Claude 在任務期間更頻繁或更少地諮詢顧問，請在您的指示中說明。
會話期間您看到的內容
當 Claude 呼叫顧問時，文字記錄會在呼叫進行中顯示帶有顧問模型名稱的Advising 行。當結果返回時，該行確認顧問已審查對話。按 Ctrl+O 展開它並閱讀顧問的完整指導。
Claude 通常遵循顧問的指導，但在其自身證據與特定聲明相矛盾時進行調整：如果建議的步驟在嘗試時失敗，或檔案內容與建議相矛盾，Claude 會表面衝突而不是無條件地遵循指導。
顧問始終收到完整的對話，Claude 控制時機。如需更多控制或不同的配置，請參閱顧問與子代理和 opusplan 的比較。
成本
每個顧問呼叫都會將對話發送到顧問模型，因此除了主要模型的使用外，還會以顧問模型的費率消耗代幣。使用 API 計費時，顧問代幣按顧問模型的輸入和輸出費率計費。在訂閱計畫上，顧問使用計入您計畫的使用限制。 Claude 在決策點而非每個輪次都呼叫顧問，因此將更快的主要模型與更強大的顧問配對通常比全程執行更強大的模型成本更低。顧問使用計入/usage 顯示的會話總計。
有關顧問代幣如何在 API 回應中報告的資訊，請參閱 Claude API 文件中的使用和計費。
對提示快取的影響
在會話中途啟用或停用顧問不會使主要模型的提示快取失效。與變更模型或努力等級不同，切換/advisor 會保持快取的前綴完整，顧問返回的指導會在後續輪次中作為文字記錄的一部分被快取。
顧問模型自身對對話的讀取不會被快取。每個顧問呼叫都會全新處理完整的文字記錄，呼叫之間沒有重複使用。
需求
顧問工具需要以下所有條件：- Claude Code v2.1.98 或更新版本：執行
claude update以升級。 - 僅限 Anthropic API：顧問是伺服器執行的工具。它在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上不可用。透過配置有
ANTHROPIC_BASE_URL的 LLM 閘道，可用性取決於閘道是否將請求完整轉發到 Anthropic API。 - 支援的主要模型：Opus 4.6 或更新版本、Sonnet 4.6 或 Haiku 4.5。Fable 5 在 Claude Code v2.1.170 或更新版本上也符合條件。
關閉顧問
若要停止使用顧問並清除已儲存的advisorModel，執行 /advisor off 或在 /advisor 選擇器中選擇 No advisor：
/advisor 命令和 --advisor 旗標，設定 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1。請參閱環境變數。
與相關功能的比較
顧問是結合模型優勢的幾種方式之一。根據您希望何時涉及第二個模型來選擇。另請參閱
- 模型配置：切換模型、設定努力等級並使用
opusplan - 有效管理成本：跨模型追蹤代幣使用
- Claude API 中的顧問工具：了解基礎伺服器工具，或直接從 Messages API 使用它
- 顧問策略：為什麼將快速主要模型與更強大的顧問配對有效