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