Claude Code advisorでFable/Opus/Sonnetの助言を得る

Claude Code advisorとは

advisorは、Claude Codeがメインで使っているモデルとは別のモデルに、作業の要所だけ相談させる機能です。方針を決める直前・同じエラーで詰まったとき・タスク完了を宣言する直前といった局面で、Claudeが会話全体(すべてのツール呼び出しと結果を含む)をアドバイザーモデルに渡し、返ってきた助言を踏まえて続きを進めます。

呼び出しのタイミングはClaudeが自分で判断します。人がボタンを押すのではなく、Claudeが「ここは確認したい」と感じた場面で自動的に相談する仕組みです。Anthropic API経由でのみ使える実験的機能で、Amazon Bedrock・Claude Platform on AWS・Google CloudのAgent Platform・Microsoft Foundryでは使えません。

advisorが向くのは、大規模なリファクタリングや、同じエラーが繰り返し出るデバッグセッションなど、長く多段階のタスクです。短いタスクや、すべてのターンで最強のモデルが必要な作業には向きません。その場合はモデル自体を切り替えるほうがシンプルです。既定のadvisorモデルを固定する設定はadvisorModelで解説しています。

設定方法は3つ

advisorモデルを指定する方法は3通りあります。用途に応じて使い分けます。

セッション内で切り替える: /advisor コマンドを引数なしで実行すると、利用可能なアドバイザーモデルの一覧が開きます。モデル名を直接渡すこともできます。

/advisor opus

実行すると Advisor set to に続けてモデル名が表示され、選択は advisorModel としてユーザー設定(~/.claude/settings.json)に保存され、以降のセッションにも引き継がれます。Remote Controlのクライアントなどから選んだ場合は、そのセッションだけに効きます。

設定ファイルで既定値にする: セッションを開かずに既定のadvisorを決めておきたいときは、settings.json に直接書きます。

{
  "advisorModel": "opus"
}

起動時のフラグで単発指定する: 保存済みの設定を変えずに、その回だけadvisorを使いたいときは --advisor フラグを渡します。

claude --advisor opus

--advisor は claude --help の一覧には出てきません。v2.1.285で claude --help の出力を advisor で検索しても、該当する行はありませんでした。メインモデルがadvisorに対応していない、指定したモデル(Haikuなど)がアドバイザーとして使えない、組織の availableModels 許可リストが対象モデルを除外している、のいずれかに該当すると起動時にエラーで終了します。Fableを指定して課金同意が済んでいない場合も同じです。ただしバックグラウンドセッションを --advisor 付きで開始した場合は、これらの条件に当てはまってもエラー終了せず、advisorなしでセッションが始まります。

モデルの組み合わせルール

advisorは「メインモデルと同等以上の能力」でなければ設定できません。Claude Codeのドキュメントにある組み合わせは次のとおりです。

Fableモデルをメインとして使う場合もadvisorとして使う場合も、Fableアクセス権限が必要です。Fable 5はClaude Code v2.1.170以降、Fable 5.1はv2.1.257以降で使えます。プランのサポート記事はFable 5.1の条件を2.1.255以降と書いています。ただしchangelogにはv2.1.253〜v2.1.256の項がなく、Claude Codeのドキュメントとchangelogはv2.1.257で一致しています。

advisorの指定は fable / opus / sonnet のエイリアスか、claude-opus-5-5 のようなフルのモデルIDで行います。エイリアスはClaude Codeがリリースごとに更新するそのモデルファミリーの既定バージョンに解決されます。fable はv2.1.257以降、Claude apps gatewayのセッションを除いてFable 5.1です。

表の「拒否」と「APIが拒否」は、失敗の見え方が違います。

「APIが拒否」の組み合わせに当たっていて /advisor で選び直したときも、反映されるのは /clear か /compact のあと、または新しいセッションからです。

v2.1.284以降は、Anthropic API上でsonnetエイリアスがSonnet 5.5に解決されます。日常の実装をSonnetで回していたセッションは、メインモデルがSonnet 5.5に変わります。Messages APIのadvisor toolでは、Sonnet 5.5をexecutorにしたときのadvisorはMythos 5.1・Fable 5.1・Mythos 5・Fable 5・Opus 5.5・Opus 5・Sonnet 5.5に限られ、返ってくる助言は暗号化されたadvisor_redacted_resultです。この互換表にはSonnet 5.5の相手としてOpus 4.7・4.8が載っていません。Claude Codeの表で使えることになっているSonnet 5.5とOpus 4.7・4.8の組み合わせも、APIが拒否する側に当たる可能性があります。Sonnetメインで--advisorを使っている人は、上で見た「APIが拒否」に当たっていないかを確かめておくと安心です。

advisorが効いていないと感じたときは、次の順で確かめます。

組み合わせの選び方は、コストと能力の釣り合いで決めます。

Fable 5とOpus 5の違いで扱っている料金・データ保持の差は、そのままadvisorに選ぶときの判断材料にもなります。常時Fableモデルを回すコストを避けつつ判断力だけ借りたいなら、advisorとしての起用が現実的な選択肢です。Sub-agentsは親セッションのadvisor設定を引き継ぎ、Sub-agent自身のモデルに対して同じ組み合わせの判定を受けます。Sub-agentの定義にadvisorを指定する項目は、公式ドキュメントに見当たりません。メインモデルには付かない組み合わせでも、判定を満たすSub-agentは使い続けられます。

Fableモデルをadvisorに使うときの注意

一部のプランではFableモデルの利用がusage creditsに課金されます。/model でFableを選んだときと同様、advisorとしてFableを選ぶ際にも初回だけ課金への同意が必要です。同意していない状態で /advisor fable を実行すると、Claude Codeはadvisor設定を保存せず、代わりに /model fable を案内します。claude --advisor fable で起動した場合は、起動時にエラーで終了して同じ案内を出します(バックグラウンドセッションではadvisorなしで起動)。同意を済ませるには /model fable を実行してFableモデルの利用を選択し、そのあとで改めてadvisorとしてFableを指定します。Fable 5.1自体の仕様はClaude Fable 5.1の仕様解説、Fable 5の仕様はClaude Fable 5とはで扱っています。

いつ呼ばれ、いくらかかるか

advisorを呼び出すタイミングはモデル駆動で、ルールで固定されているわけではありません。方針決定の直前・繰り返すエラーに詰まったとき・完了を宣言する前に相談する傾向がありますが、回数を制限したり強制したりする設定はありません。「続ける前にadvisorに相談して」のようにプロンプトで直接頼むこともできます。

呼び出し中は Advising の行にadvisorのモデル名が出ます。結果が返ると、行は次の3通りのどれかに変わります。

Claudeは基本的にadvisorの助言に従います。試した手順が実際に失敗した場合やファイルの中身が助言と矛盾する場合は、無条件に従わず矛盾点を表に出します。

コストの面では、advisorを呼ぶたびにアドバイザーモデルが会話全体を読み込むため、メインモデルの使用量に加えてアドバイザーモデルのレート分のトークンが消費されます。API課金ではアドバイザー分の入出力トークンをそのモデルの単価で支払い、サブスクリプションプランではadvisorの使用量もプランの利用上限に加算されます(Fableモデルがadvisorのときだけ、Fableモデル自体がusage credits課金対象のプランではusage creditsに計上)。advisorはターンごとではなく判断が必要な局面でだけ呼ばれるため、軽いメインモデルに強いadvisorを組み合わせるほうが、強いモデルを最初から使い続けるより総コストは低くなりやすい構成です。使用量は /usage のセッション合計に含まれます。

advisorのオン・オフはメインモデルのプロンプトキャッシュを無効化しません。モデルの変更や、多くのモデルでのeffortレベルの変更とは違い、/advisor の切り替えはキャッシュされた会話の接頭辞をそのまま保ちます。ただしadvisorモデル自身の会話読み込みはキャッシュされず、呼び出すたびに会話全体を読み直します。返ってきた助言は、以降のターンではトランスクリプトの一部としてキャッシュされます。

opusplanやSub-agentsとの違い

強いモデルを組み合わせる方法はadvisorだけではありません。「いつ強いモデルが動くか」で選び分けます。

advisorは「メインは軽く保ったまま、要所だけ強いモデルの目を入れたい」場合に向きます。plan modeの計画品質だけを底上げしたいならopusplan、サブタスクごと丸ごと強いモデルに任せたいならSub-agentsのモデル指定、常に最強のモデルで走らせたいなら /model で切り替える、という住み分けです。advisorはこの中で唯一「呼ぶかどうかをClaude自身が判断する」方式であり、人間が都度指示しなくても要所で自動的に第三者チェックが入る点が他の3つと違います。advisor・plan・code-review・ultrareviewをどう使い分けるかの全体像はClaude Code advisorの使い分け — plan・code-review・ultrareviewとの違いで比較しています。

advisorを止める

/advisor off を実行するか、/advisor のピッカーで「No advisor」を選ぶと、advisorの利用を止めて保存済みの advisorModel をクリアします。

/advisor off

advisor機能そのものを無効化したい場合は環境変数 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 を設定します。この場合 /advisor コマンド自体が使えなくなり、設定済みの advisorModel も無視されます。--advisor フラグは受け付けられますが効果を持ちません。

よくある質問

メインモデルやadvisorをClaude Codeが認識できないモデルIDにするとどうなりますか

メインモデルまたはadvisorのどちらかがClaude Codeにとって未知のモデルIDの場合、advisorはそもそも紐付けられません。カスタムのゲートウェイ経由でモデルIDを直接指定している場合はこの条件に該当しやすいので、/advisor の出力で意図どおりに紐付いているか確認します。

まとめ

長いタスクでメインを軽く保ちたいなら、advisorが有力な選択肢です。一方、Sonnet 5.5をメインにしてOpus 4.7・4.8を相手に選ぶ場合は、APIが拒否してadvisorが黙って外れる可能性があります。使う前に /advisor の出力で紐付きを確かめておくと安心です。