機能解説

Claude Codeの/advisorコマンドとは？
セカンドオピニオンAIの使い方

行き詰まった時だけ、より強いモデルに相談する。コストを抑えつつ判断の質を上げる仕組みを解説します。

Claude Codeには、2026年4月にパブリックベータとして追加された/advisorという、まだあまり知られていないコマンドがあります。「安いモデルで作業を進めつつ、判断に迷った時だけ強いモデルに相談する」という、コストと精度を両立させる面白い仕組みです。

advisorツールとは何か

advisorツールは、Claudeが作業の途中で2番目の（通常はより強力な）モデルに相談できるサーバー側の機能です。相談先のモデルはユーザーが選びますが、いつ相談するかはClaude自身が判断します。

相談を持ちかけるタイミングとして典型的なのは以下の3つです。

ある方針にコミットする前
同じエラーが繰り返し発生して行き詰まった時
タスク完了を宣言する前

advisorに送られるのは会話全体（すべてのツール呼び出しと結果を含む）で、返ってきたガイダンスをClaudeが以降の作業に反映します。

向いているタスク・向いていないタスク

大規模なリファクタリングや、同じエラーが繰り返し出るデバッグセッション、完了を宣言する前に第三者チェックが欲しいタスクなど、「大半のターンは定型作業だが、計画の質が結果を左右する」長いタスクに向いています。逆に、計画するほどでもない短いタスクや、常に最強モデルが必要な作業には向きません（その場合はメインモデル自体を切り替えるべきです）。

有効化する3つの方法

① `/advisor`コマンド

セッション中に設定

/advisor opus

引数なしで実行すると選択肢のピッカーが開きます。設定はユーザー設定にadvisorModelとして保存され、以降のセッションでも引き継がれます。

② 設定ファイルでの永続設定

settings.json

{
  "advisorModel": "opus"
}

③ `--advisor`フラグ（そのセッション限定）

起動時に指定

claude --advisor opus

保存済みのadvisorModel設定より優先されますが、そのセッション限りの一時指定です。

使えるモデルの組み合わせ

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.8	Opus 4.6やSonnet 5をadvisorに指定すると拒否される
Fable 5	Fableのみ	OpusやSonnetは拒否される（v2.1.170以降が必要）

指定はopus・sonnet・fableのエイリアス、またはclaude-opus-4-8のようなフルモデルIDのいずれでも可能です。

よく使われる組み合わせ

組み合わせ	向いている場面
Sonnetメイン + Opus advisor	定型作業はSonnetで、計画・曖昧な失敗・完了判定はOpusにエスカレーション
Haikuメイン + Opus advisor	最安のメインモデルに強力な計画立案能力を付与。Haiku単体より高コストだがSonnet/Opusへの切り替えよりは安い
Opusメイン + Opus advisor	2つ目のOpusがレビュー役。コストよりも独立した確認が重要な高難度タスク向け
Sonnetメイン + Sonnet advisor	低コストなセカンドオピニオンで、定型的な見落としを拾う

どのタイミングで呼ばれるか

相談のタイミングはルールベースではなくモデル駆動です。頻度を強制する設定項目はありませんが、プロンプトで明示的に頼むことはできます。

プロンプトでの指示例

続ける前にadvisorに相談してください

実行中に見える情報

advisorが呼ばれると、トランスクリプトにAdvisingという行がアドバイザーモデル名とともに表示されます。結果が返ってくると、レビュー完了が示されます。Ctrl+Oを押すと、advisorが返した完全なガイダンスを展開して読めます。

Claudeはガイダンスを鵜呑みにしない

Claudeは基本的にadvisorの助言に従いますが、実際に試して失敗した、あるいはファイルの中身が助言と矛盾する、といった自分の得た証拠と食い違う場合は、その矛盾を提示します。advisorの指示を無条件に実行するわけではありません。

コストへの影響

advisorを1回呼ぶたびに、その時点までの会話全体がadvisorモデルに送られるため、メインモデルの使用量に加えてadvisorモデルのレートでもトークンが消費されます。API課金の場合はadvisorモデルの入出力レートで、サブスクリプションプランの場合はプランの利用上限にカウントされます。

ただし、Claudeは毎ターンではなく決定的な局面でのみadvisorを呼ぶため、速いメインモデルと強いadvisorを組み合わせる方が、強いモデルを最初から最後まで走らせるより総コストは低くなる傾向があります。使用量は/usageコマンドのセッション合計に反映されます。

プロンプトキャッシュへの影響

セッション中に/advisorのON/OFFを切り替えても、メインモデルのプロンプトキャッシュは無効化されません。モデルやeffortレベルの変更とは異なり、advisorのトグルはキャッシュ済みのプレフィックスを保ったままです。advisorが返したガイダンス自体も、以降のターンではトランスクリプトの一部としてキャッシュされます。一方、advisorモデル自身が会話を読み取る処理はキャッシュされません。毎回の呼び出しで会話全体を新規に処理します。

利用条件

Claude Code v2.1.98以降（claude updateでアップグレード）
Anthropic APIのみ。サーバー側で実行されるツールのため、Amazon Bedrock・Google Cloud Agent Platform（旧Vertex AI）・Microsoft Foundryでは利用できません。ANTHROPIC_BASE_URLで構成したLLM Gateway経由の場合、ゲートウェイがリクエストをそのままAnthropic APIに転送するかどうかに左右されます
対応メインモデル：Opus 4.6以降・Sonnet 4.6以降・Haiku 4.5。Fable 5はv2.1.170以降で対応
Fable 5をadvisorとして使う場合も、組織側でFable 5へのアクセス権とv2.1.170以降が必要

サードパーティプロバイダーでは使えない機能

advisorはサーバー側で実行されるツールという性質上、Bedrock・Vertex AI・Foundryでは提供されていません。これはAuto Modeとは異なり環境変数を設定しても有効化できない制限です。Anthropic API（またはそれをそのまま中継するLLM Gateway）を使っている場合のみの機能だと理解しておいてください。

オフにする方法

セッション単位でオフ

/advisor off

これにより保存済みのadvisorModel設定もクリアされます。ツール自体を完全に無効化したい場合は、環境変数を設定します。

ツール自体を無効化

export CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1

これを設定すると/advisorコマンド自体が使えなくなり、設定済みのadvisorModelも無視されます。--advisorフラグはエラーにならず受け付けられますが、効果を持ちません。

似た機能との使い分け

複数のモデルの強みを組み合わせる方法は、advisor以外にもいくつかあります。「強いモデルがいつ動くか」で選び分けるのがコツです。

方式	強いモデルが動くタイミング	起動方法
advisorツール	タスク途中の決定的な局面のみ	Claudeが必要と判断した時に自動で呼ぶ
opusplan	プランモード中のみ、その後Sonnetに切り替えて実行	プランモードに入る
サブエージェント（model指定）	委任されたサブタスクの間ずっと	Claudeが委任、またはユーザーが直接呼び出す
/model	以降のすべてのターン	手動でモデルを切り替える