advisor ツールは実験的機能であり、Anthropic API を使用する Claude Code v2.1.98 以降が必要です。Amazon Bedrock、Google Vertex AI、Microsoft Foundry では利用できません。動作、価格設定、および利用可能性は変更される可能性があります。
advisor を使用する場合
advisor は、ほとんどのターンが定型的であるが、プラン品質が結果を決定する長い複数ステップのタスクに適しています。例としては、大規模なリファクタリング、エラーが繰り返し発生するデバッグセッション、および Claude が完了を宣言する前に独立して確認したいタスクが挙げられます。 計画する必要がほとんどない短いタスク、またはすべてのターンで最強のモデルが必要な作業では、価値が低くなります。その場合は、メインモデルを切り替えるか、advisor が opusplan およびサブエージェントとどのように比較されるかを参照して、2 番目の意見を得る他の方法を確認してください。advisor を有効にする
advisor モデルは 3 つの方法で設定できます。/advisorコマンド：セッション中に advisor を設定または変更し、デフォルトとして保存しますadvisorModel設定：設定ファイルで永続的なデフォルトを構成します--advisorフラグ：起動時に単一セッションの advisor を設定します
Fable 5 を advisor として使用するには、Claude Code v2.1.170 以降と、組織の Fable 5 アクセスが必要です。
/advisor コマンドを使用する
引数なしで /advisor を実行して、利用可能な advisor モデルをリストするピッカーを開くか、モデルを直接渡します。
advisorModel に保存され、セッション全体で保持されます。現在のメインモデルが advisor をサポートしていない場合、選択は引き続き保存され、/modelで互換性のあるメインモデルに切り替えるときにアクティブになります。
設定で advisorModel を設定する
セッションを開かずにデフォルトとして advisor を構成するには、設定ファイルで設定します。
--advisor フラグを使用する
保存された設定を変更せずに単一セッションの advisor を設定するには、フラグを使用して起動します。
advisorModel 設定よりも優先されます。/advisor とは異なり、セッションのメインモデルが advisor をサポートしていない場合、フラグはエラーで終了します。
advisor モデルを選択する
advisor はメインモデル以上の機能を持つ必要があります。各メインモデルで受け入れられる advisor は次のとおりです。| メインモデル | 受け入れられる advisor | 注記 |
|---|---|---|
| Haiku 4.5 | Fable、Opus、Sonnet | Haiku は advisor を呼び出すことはできますが、advisor として機能することはできません |
| Sonnet 4.6 | Fable、Opus、Sonnet | |
| Opus 4.6 以降 | Fable、メインモデルのバージョン以上の Opus | Opus 4.7 メインと Opus 4.6 advisor は拒否されます |
| Fable 5 (v2.1.170+) | Fable | Opus または Sonnet advisor は拒否されます |
opus、sonnet、または fable として設定します。これらのエイリアスは各モデルの最新バージョンに解決されます。claude-opus-4-8 などの完全なモデル ID を渡すこともできます。
Subagent は設定された advisor を継承し、独自のモデルに対して同じペアリングチェックを適用します。
Claude Code はリクエストを送信する前にペアリングを検証します。
- advisor がメインモデルより機能が低い場合、advisor はメインモデルのリクエストに接続されません。
/advisorコマンド出力と通知がこれを表示します。独自のモデルがペアリングを満たす Subagent は引き続き advisor を使用できます。 - メインモデルまたは advisor が Claude Code が認識しないモデルである場合、advisor は接続されません。
一般的なモデルペアリング
受け入れられるペアリングはすべて機能します。これらの組み合わせは、異なる方法でコストと機能のバランスを取ります。| ペアリング | 使用する場合 |
|---|---|
| Sonnet メイン + Opus advisor | Sonnet は定型的な作業を処理し、計画、曖昧な失敗、および完了チェックを Opus にエスカレートします |
| Sonnet メイン + Fable advisor | 決定ポイントで Fable 5 ガイダンスを取得し、Fable 5 全体を実行しません。v2.1.170 以降と Fable 5 アクセスが必要です |
| Haiku メイン + Opus advisor | 強力な計画を備えた最も低コストのメインモデル。Haiku のみよりもコストが高くなることが予想されますが、メインモデルを Sonnet または Opus に切り替えるよりは低くなります |
| Opus メイン + Opus advisor | 2 番目の Opus が最初の Opus をレビューします。コストよりも独立したチェックが重要な高リスクタスクに役立ちます |
| Fable メイン + Fable advisor | Fable 5 が利用可能な場合の最高機能ペアリング（v2.1.170+）。Fable は Opus および Sonnet より上位のティアであるため、Fable メインモデルの唯一の受け入れられた advisor です |
| Sonnet メイン + Sonnet advisor | 定型的な見落としをキャッチするための低コストの 2 番目の意見 |
Claude が advisor に相談する場合
Claude は advisor をいつ呼び出すかを決定します。アプローチをコミットする前、エラーが繰り返し発生する場合、およびタスク完了を宣言する前に相談する傾向がありますが、タイミングはルールベースではなくモデル駆動です。 プロンプトで相談をリクエストするのと同じ方法で、プロンプトで相談をリクエストできます。例えば、continue する前に advisor に相談してください。advisor 呼び出しをキャップまたは強制する設定はありません。タスク中に Claude が advisor に相談する頻度を増やしたい場合は、指示で言及してください。
セッション中に表示される内容
Claude が advisor を呼び出すと、トランスクリプトに呼び出しが進行中の advisor モデル名を含むAdvising 行が表示されます。結果が返されると、行は advisor が会話をレビューしたことを確認します。Ctrl+O を押して展開し、advisor の完全なガイダンスを読みます。
Claude は一般的に advisor のガイダンスに従いますが、独自の証拠が特定の主張と矛盾する場合は適応します。推奨されたステップが試行時に失敗した場合、またはファイルの内容がアドバイスと矛盾する場合、Claude はガイダンスに無条件に従うのではなく、矛盾を表示します。
advisor は常に完全な会話を受け取り、Claude がタイミングを制御します。より多くの制御または異なる構成については、advisor がサブエージェントおよび opusplan とどのように比較されるかを参照してください。
コスト
各 advisor 呼び出しは会話を advisor モデルに送信するため、メインモデルの使用に加えて advisor モデルのレートでトークンを消費します。API 課金では、advisor トークンは advisor モデルの入力および出力レートで課金されます。サブスクリプションプランでは、advisor 使用量はプランの使用制限にカウントされます。 Claude は各ターンではなく決定ポイントで advisor を呼び出すため、より高速なメインモデルをより強力な advisor と組み合わせることは、通常、より強力なモデルを全体で実行するよりもコストが低くなります。advisor 使用量は/usageで表示されるセッション合計にカウントされます。
advisor トークンが API レスポンスでどのように報告されるかについては、Claude API ドキュメントの 使用量と課金を参照してください。
プロンプトキャッシュへの影響
セッション中に advisor を有効または無効にしても、メインモデルのプロンプトキャッシュは無効になりません。モデルまたは努力レベルを変更するとは異なり、/advisor を切り替えるとキャッシュされたプレフィックスはそのまま保持され、advisor が返したガイダンスは後のターンでトランスクリプトの一部としてキャッシュされます。
advisor モデル自体の会話の読み取りはキャッシュされません。各 advisor 呼び出しは完全なトランスクリプトを新たに処理し、呼び出し間での再利用はありません。
要件
advisor ツールには、以下のすべてが必要です。- Claude Code v2.1.98 以降：
claude updateを実行してアップグレードします。 - Anthropic API のみ：advisor はサーバー実行ツールです。Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません。LLM ゲートウェイを通じて
ANTHROPIC_BASE_URLで構成されている場合、利用可能性はゲートウェイがリクエストを Anthropic API に完全に転送するかどうかに依存します。 - サポートされているメインモデル：Opus 4.6 以降、Sonnet 4.6、または Haiku 4.5。Fable 5 も Claude Code v2.1.170 以降で適格です。
advisor をオフにする
advisor の使用を停止し、保存されたadvisorModel をクリアするには、/advisor off を実行するか、/advisor ピッカーで No advisor を選択します。
/advisor コマンドと --advisor フラグを含む）を無効にするには、CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 を設定します。環境変数を参照してください。
関連機能との比較
advisor は、モデルの強みを組み合わせるいくつかの方法の 1 つです。2 番目のモデルをいつ関与させるかに基づいて選択します。関連項目
- モデル構成：モデルを切り替え、努力レベルを設定し、
opusplanを使用します - コストを効果的に管理する：モデル全体のトークン使用量を追跡します
- Claude API の Advisor ツール：基盤となるサーバーツールを理解するか、Messages API から直接使用します
- advisor 戦略：高速メインモデルをより強力な advisor と組み合わせる理由