Advisor ツールとは何か
Anthropic のドキュメントでは、次の一文で説明されています。「Advisor ツールを使用すると、Claude は、アプローチを決定する前、繰り返されるエラーで行き詰まったとき、またはタスクの完了を宣言する前など、タスク中の重要な瞬間に、通常はより強力な第2のモデルに相談できます。」
その仕組みを定義する3つの詳細があります:
- 第2のモデルである。 ルーチンワークにはメインモデルを使い続け、意思決定のために Advisor を追加します。
- Anthropic 側で実行される。 ドキュメントには次のようにあります。「Advisor は、サーバーツールとして Anthropic のインフラストラクチャ上でサーバーサイドで実行され、サブスクリプションアカウントと API 課金アカウントの両方で利用可能です。」
- Claude が使用タイミングを決定する。 「どのモデルを Advisor にするかはユーザーが選択し、いつ呼び出すかは Claude が決定します。」
このツールは実験的(experimental)とラベル付けされています。Anthropic API、AWS 上の Claude Platform、または Google Cloud 上の Claude Models(Anthropic 管理)が必要であり、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。
ドキュメントによると、Advisor は「ほとんどのターンはルーチンだが、計画の質が結果を左右するような、長くて多段階のタスク」に適しています。例として、大規模なリファクタリング、エラーが繰り返されるデバッグセッション、完了を宣言する前にチェックさせたいタスクなどが挙げられています。
Advisor がセッションから見ているもの
これは、相談がどれほど有用であるかを決定する部分です。
ドキュメントは明快です。「Advisor は、すべてのツール呼び出しと結果を含む完全な会話を受け取り、Claude が続行する前に適用するガイダンスを返します。」後にこの点が繰り返されます。「Advisor は常に完全な会話を受け取り、Claude がタイミングを制御します。」
つまり、Advisor の視界はセッションのトランスクリプトそのものです。あなたが何を尋ねたか、Claude が何を読み取ったか、どのコマンドが何を返したか、そして Claude がこれまでに何を結論付けたかを見ることができます。ドキュメントには、これ以外の個別のブリーフィングについては記載されていません。
これには実用的な影響があります。ドキュメントは Advisor への入力を「会話」として説明しています。先月チームで下した決定や、モジュールを変更してはいけない理由など、セッション中に一度も登場しなかった制約は、Advisor が受け取る内容には含まれません。意思決定に重要であれば、会話の中に含める必要があります。
また、Claude はガイダンスを判断材料として扱います。ドキュメントには「Claude は通常 Advisor のガイダンスに従いますが、自身の証拠が特定の主張と矛盾する場合は適応させます」とあります。推奨されたステップが失敗したり、ファイルの内容がアドバイスと矛盾したりする場合、Claude は盲目的に従うのではなく、その矛盾を表面化させます。
Advisor を有効にする方法
ドキュメントには3つの方法がリストされており、選択が持続する期間が異なります。
/advisor コマンド。 引数なしで実行してリストから選択するか、/advisor opus のようにモデルを渡します。ドキュメントによると、選択内容は「ユーザー設定の advisorModel に保存され、セッションをまたいで保持されます」(設定リファレンスに記載されたいくつかの例外を除く)。
advisorModel 設定。 設定ファイルに記述することで、セッションを開かずにデフォルトを設定できます。
--advisor フラグ。 claude --advisor opus で起動すると、保存された設定を変更せずに、そのセッションのみ Advisor を設定できます。
セッション開始後、Claude Code は Advisor ツールがオンであり、より多くのトークンを消費する可能性があるという通知を表示します。
どのペアリングが機能するか
Advisor は、メインモデルと同等以上の能力を持っている必要があります。ドキュメントによると、Claude Code は Advisor ロールのモデルをランク付けしており、「Advisor はセッションのメインモデルと同等以上のランクでなければならない」とされています。
ドキュメントの承認済みペアリング表には、以下の例が含まれています:
- メインモデルが Sonnet 5.5 の場合、Advisor として Fable、Opus 5 以降、または Sonnet 5.5 を受け入れます。
- メインモデルが Opus 5 または Opus 5.5 の場合、Advisor として Fable または Opus 5 以降を受け入れます。
- メインモデルが Fable 5.2 の場合、Fable 5.2 のみを受け入れます。
Advisor は、fable、opus、sonnet といったエイリアス、または完全なモデル ID で設定します。ドキュメントは、エイリアスが「Claude Code のリリースとともに進化する、各モデルファミリーの組み込みデフォルトバージョンに解決される」と注記しています。
また、一般的なペアリングとその適性もリストされています。Sonnet メインモデルと Opus Advisor の組み合わせは、ルーチンワークを Sonnet で処理し、計画、曖昧な失敗、完了チェックを Opus にエスカレーションします。Opus メインモデルと Opus Advisor の組み合わせは、リスクの高いタスクに対してセカンドレビューを提供します。
Subagents も同じルールに従います。ドキュメントには「Subagents は設定された Advisor を継承し、自身のモデルに対して同じペアリングチェックを適用する」とあります。
Claude が Advisor を呼び出すタイミング
相談のスケジュールを立てることはできません。ドキュメントによると、Claude は「アプローチを決定する前、エラーが繰り返されるとき、タスクの完了を宣言する前に相談する傾向がありますが、タイミングはルールベースではなくモデル駆動です」とされています。
それでも影響を与えることは可能です。プロンプトで相談を依頼することができ、ドキュメントの例では、続行する前に Advisor に相談するよう Claude に指示しています。頻度については、「Advisor の呼び出しを制限したり強制したりする設定はありません。タスク中に相談の頻度を増やしたい、あるいは減らしたい場合は、指示の中でそのように伝えてください」と付け加えられています。
セッション中、相談は Advisor モデルの名前とともに「Advising」行として表示されます。完了すると、その行には次の3つの結果のいずれかが表示されます:
- Reviewed: Advisor が会話をレビューしました。
Ctrl+Oを押すとガイダンスを読めます。 - Declined: Advisor がリクエストへのアドバイスを拒否しました。
Ctrl+Oを押すと理由を確認できます。 - Unavailable: 呼び出しが失敗し、エラーコードが表示されます。
なぜ各呼び出しでトランスクリプト全体を再読み込みするのか
Advisor のセッションに対する視界は、毎回新しくなります。プロンプトキャッシュに関するドキュメントのセクションで説明されています。
メインモデルへの影響はわずかです。「セッションの途中で Advisor を有効または無効にしても、メインモデルのプロンプトキャッシュは無効になりません。」また、ガイダンス自体が記録の一部となります。「Advisor から返されたガイダンスは、以降のターンでトランスクリプトの一部としてキャッシュされます。」
Advisor 側では、何も引き継がれません。「Advisor モデル自身の会話の読み取りはキャッシュされません。各 Advisor の呼び出しは、呼び出し間での再利用なしに、フル・トランスクリプトを新たに処理します。」
これには2つの結果が伴います:
- セッションが長くなるほど、各相談の規模が大きくなる。 Advisor は毎回会話全体を読み取るため、長いセッションの後半の呼び出しは、前半よりも多くの処理を行います。
- Advisor 側では呼び出し間で何も再利用されない。 ある呼び出しと次の呼び出しを繋ぐのはトランスクリプトであり、そこには以前に返されたガイダンスが含まれています。
これが、Advisor をオンにすることがモデルの切り替えとは異なる理由でもあります。ドキュメントではこの2つを直接対比させています。モデルの切り替えとは異なり、/advisor の切り替えはキャッシュされたプレフィックスをそのまま保持します。モデルの切り替えがセッションのキャッシュとコンテキストに与える影響については、Claude Code でセッション途中にモデルを切り替えるガイドで解説しています。
コストについて
Advisor は会話を読み取るため、各呼び出しはメインモデルの使用量に加えて、Advisor モデルのレートでトークンを消費します。API 課金では、Advisor モデルの入力および出力レートを支払います。サブスクリプションプランでは、Advisor の使用量はプランの使用制限にカウントされます。ただし、Fable が使用クレジットに課金されるプランでの Fable Advisor については別のルールがあります。
ドキュメントによるこの設計の根拠は、Claude が「毎ターンではなく意思決定ポイントで」Advisor を呼び出すため、高速なメインモデルと強力な Advisor を組み合わせる方が、全体を通して強力なモデルを実行するよりも通常は安価になるという点です。Advisor の使用量は、/usage で表示されるセッション合計に含まれます。
Claude Code が Advisor を静かにドロップする場合
これは冒頭の例の挙動であり、ドキュメントではいくつかのケースが説明されています。
API がペアリングを拒否した。 「Claude Code が添付した Advisor のペアリングを API が拒否した場合、Claude Code は Advisor なしでそのリクエストを再送信します。会話は Advisor なしで継続されるため、エラーは表示されず、Advisor の呼び出しも行われません。」その後 /advisor で別の Advisor を選んだ場合、ドキュメントによると、それは /clear または /compact の後、および新しいセッションで有効になります。
Advisor のランクがメインモデルより低い。 Claude Code はメインモデルのリクエストに Advisor を添付しません。/advisor の出力と通知にこれが表示されます。
保存された Advisor が現在のメインモデルをサポートしていない。 ドキュメントには「Claude Code は、現在のメインモデルがサポートしていない Advisor も保存します。その Advisor は、/model で互換性のあるメインモデルに切り替えた後にアクティブになります」とあります。ただし注意点があります。「現在の会話ですでに API が保存された Advisor を拒否した場合、モデルを切り替えた後でも、/clear または /compact を行うまでオフのままになります。」
モデルが認識されない。 「メインモデルまたは Advisor が Claude Code の認識しないモデルである場合、Advisor は添付されません。」
組織がモデルを制限している。 組織の availableModels 許可リストで除外されている保存済み Advisor を Claude Code は呼び出しません。
機能フラグがオフである。 AWS 上の Claude Platform および Google Cloud 上の Claude Models(Anthropic 管理)以外では、Advisor は Anthropic から取得される機能フラグを必要とします。DISABLE_TELEMETRY など、取得をオフにする変数が設定されたセッションでは、Advisor は利用できません。
どのケースでもパターンは同じです。セッションは相談なしで動作し続けます。Advisor を頼りにしている場合は、長いタスクの最中に Advising 行が表示されているか確認し、/advisor を実行して何が設定されているかを確認してください。
Advisor と他のオプションの比較
ドキュメントでは、より強力なモデルを導入する4つの方法を比較しています:
- Advisor ツール: タスク途中の意思決定ポイントで、Claude が呼び出す。
opusplan: 計画モード中は Opus、実行は Sonnet。- モデルセットを指定した Subagents: 委任されたサブタスク全体に対して適用。
/model: 切り替えた後の次のリクエスト以降すべて。
Advisor は、Claude が選択した瞬間に、より強力なモデルが会話全体をレビューする唯一の方法です。他は、作業の一部を渡すか、それ以降のすべてに対してモデルを変更するかのどちらかです。
オフにする方法
/advisor off を実行するか、ピッカーで「No advisor」を選択します。ツールを完全に無効にするには、CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 を設定します。ドキュメントによると、その場合 /advisor コマンドは利用不可になり、設定された advisorModel は無視されます。
よくある勘違い
Advisor が動作しなくなったときにエラーが出ると思い込む。 Claude Code は Advisor なしで再送信し、エラーは表示しません。
Advisor がプロジェクトの履歴を知っていると仮定する。 Advisor が受け取るのは「会話」です。
拒否された後、会話の途中で Advisor を変更する。 新しい選択は /clear または /compact の後に有効になります。
メインモデルより弱い Advisor を選ぶ。 メインモデルと同等以上のランクである必要があります。
相談を強制する設定があると思う。 存在しません。指示の中で依頼してください。
解決策:Advisor に必要な情報を見せる
ステップ 1: ペアリングを確認する
/advisor を実行し、Advisor がメインモデルと同等以上のランクであることを確認します。
ステップ 2: Advising 行を監視する
長いタスクでは、相談が引き続き表示されているか確認し、Ctrl+O でガイダンスを読みます。
ステップ 3: 重要な制約を会話に含める
大きな決断の前に、重要な制約を明示します。これにより、Advisor が読み取る内容の一部になります。
ステップ 4: 制約を書き留めておく
すべてのレビューに反映させるべき決定事項や制限を記録しておき、どのセッションでも導入できるようにします。
MemoryLake でのセットアップ
Advisor は会話に含まれる内容をレビューします。依存関係をアップグレードできない理由、昨期に失敗したアプローチ、リプレイス中のモジュールなど、レビューを形作るべき決定事項は、単一のセッションの外に存在するプロジェクトのコンテキストです。
MemoryLake は、そのようなプロジェクトのコンテキスト(決定事項、制約、その背後にある理由)のための記憶レイヤーであり、あなたが管理する一箇所に保管され、ChatGPT、Claude Code、Codex などの接続したアシスタントから利用可能です。
エントリーはあなた自身の言葉で記述します。Claude Code のセッション、トランスクリプト、設定ファイル、Advisor のガイダンス、またはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。Advisor ツールは Anthropic が説明している通りに動作します。
ステップ 1: API キーを作成する
サインインしてダッシュボードからキーを生成します。他の認証情報と同様に、リポジトリの外に保管してください。

ステップ 2: 最初の記憶をアップロードする
解決策のステップ 4 で書いた内容、つまりすべてのレビューが尊重すべき制約から始めます。1つのエントリーにつき1つの決定事項を記述します。

ステップ 3: AI とエージェントを接続する
Claude Code、Codex、および使用している他のアシスタントを接続します。大きな決断の前に、同じ制約をどのセッションにも持ち込むことができます。

実務で何が変わるか
第一の違いは、より情報に基づいたレビューです。重要な制約が、Advisor が読み取る会話の中に含まれるようになります。
第二は、セッション間の一貫性です。新しいセッションを毎回同じ決定事項から開始できます。
第三は、ツール間の一貫性です。Claude Code でも他のアシスタントでも、同じコンテキストを利用できます。
Advisor ツールのベストプラクティス
長くて意思決定の多いタスクに使用する。 短いタスクではメリットがほとんどありません。
高速なメインモデルと強力な Advisor をペアにする。 これはドキュメントで、全体を通して強力なモデルを実行するよりも通常は安価であると説明されている組み合わせです。
モデル変更後にペアリングを確認する。 Advisor はメインモデルと同等以上のランクである必要があります。
沈黙に注意する。 Advising 行が表示されない場合は、Advisor がドロップされた可能性があります。
Advisor 変更後は /clear または /compact を使用する。 拒否された Advisor は、それまでオフのままになります。
大きな決断の前に制約を述べる。 Advisor は会話を読み取ります。
プロンプトで相談を依頼する。 相談を強制する設定はありません。
結論
Advisor ツールを使用すると、Claude はアプローチの決定前、エラーの再発時、タスク完了の宣言前などの重要な瞬間に、より強力なモデルに相談できます。Advisor は毎回完全な会話を受け取り、Advisor 自身の読み取りはキャッシュされないため、呼び出しのたびにトランスクリプト全体が再処理されます。オン・オフの切り替えはメインモデルのプロンプトキャッシュを無効にせず、そのガイダンスはトランスクリプトの一部となります。
Claude Code はいくつかのケースで Advisor の使用を停止し、API がペアリングを拒否した場合はエラーなしで停止します。ペアリングを確認し、Advising 行を監視し、重要な制約を会話に含めることで、Advisor のレビューが実際に知っておくべき情報に基づいたものになるようにしてください。