/advisor

アドバイザーを使うと、Claude はタスクの途中の重要な場面で、2 つ目の、通常はより強力なモデルに相談します。相談する場面は、方針を決める前、同じエラーが繰り返されて行き詰まったとき、タスクの完了を宣言する前などです。アドバイザーにするモデルは利用者が選び、いつ呼び出すかは Claude が判断します。

アドバイザーは、Claude がタスクの途中で 2 つ目のモデルに相談するためのツールです。アドバイザーはツール呼び出しと結果を含む会話の全体を受け取り、助言を返します。

• 相談のタイミング: Claude は、方針を決める前、エラーが繰り返されるとき、タスクの完了を宣言する前に相談する傾向があります。ただし、タイミングは規則ではなくモデルの判断で決まります。
• 助言の扱い: 推奨された手順を試して失敗した場合や、ファイルの内容が助言と食い違う場合、Claude は助言に無条件で従わず、その食い違いを示します。
• モデルの組み合わせ: Claude Code はアドバイザーの役割についてモデルを能力順に並べており、アドバイザーはセッションのメインモデルと同じかそれより上位である必要があります。Haiku 4.5 はアドバイザーを呼び出せますが、アドバイザーにはなれません。
• Subagents: Subagents (サブエージェント) は設定されたアドバイザーを引き継ぎ、自分のモデルに対して同じ組み合わせの確認を行います。
• 組み合わせを拒否された場合: API がアドバイザーとの組み合わせを拒否すると、Claude Code はアドバイザーを外してリクエストを送り直し、会話はアドバイザーなしで続きます。

/advisor コマンドのほかに、次の 2 つの方法でもアドバイザーを設定できます。

• 設定ファイル: セッションを開かずに既定のアドバイザーを決めるには、設定ファイルで "advisorModel" に "opus" などを指定します。
• 起動時のフラグ: 保存済みの設定を変えずに 1 回のセッションだけアドバイザーを指定するには、claude --advisor opus で起動します。

ターミナルの選択画面が無い環境では、/advisor を引数なしで実行すると、現在のアドバイザーのモデルと、指定に使える別名が表示されます。テキスト形式のコマンド (/advisor、/advisor <model>、/advisor off) は、デスクトップアプリ、Remote Control、その他のヘッドレス (-p/Agent SDK) セッション向けに追加されたものです。

アドバイザーを有効にしてセッションを始めると、Advisor Tool (experimental) is on and may use more tokens · /advisor という通知が表示されます。

• トークンの消費: セッション開始時の通知のとおり、アドバイザーを有効にするとトークンを多く使う場合があります。アドバイザーの利用分は、/usage が示すセッションの合計に含まれます。
• 呼び出し回数の制御: プロンプトで相談を頼むことはできますが、アドバイザーの呼び出しに上限を設けたり、強制したりする設定はありません。
• プロンプトキャッシュ: セッションの途中でアドバイザーを有効・無効にしても、メインモデルのプロンプトキャッシュは無効になりません。
• 全体の無効化: CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 を設定すると、アドバイザーのツールが完全に無効になります。この場合 /advisor コマンドは使えず、設定済みの advisorModel も無視されます。
• 対象プラン: 利用できるプランについては、公式のリリースノートには記載がありません。

1. /advisor を引数なしで実行すると、使えるアドバイザーのモデルを並べた選択画面が開きます。/advisor opus のように、モデルを直接指定することもできます。
2. 設定が終わると Advisor set to に続けてアドバイザーのモデル名が表示されます。選んだモデルはユーザー設定の advisorModel に保存されます。
3. アドバイザーの利用をやめるときは、/advisor off を実行するか、/advisor の選択画面で No advisor (アドバイザーなし) を選びます。