Claude Code の advisor は、作業中のモデル (主モデル) が、要所で同等以上のモデル (相談役) に意見を聞く機能です。公式ドキュメントでは実験的機能とされており、挙動・価格・提供範囲は変わる可能性があります。
この記事では、仕様を公式ドキュメントに沿って短く整理したうえで、当社が 2 通りの方法で試した記録を載せます。1 つは、この記事を作るセッションそのものに相談役を付けた記録です。もう 1 つは、同じ課題を advisor あり・なしで解かせた比較です。確認日は 2026 年 11 月 17 日、Claude Code のバージョンは v2.1.325 です。
FIXIT起動したら「advisor が on」って出たんだけど、付けっぱなしで得するの?
Tsumiki実際に試すと、頼まない限り主モデルが 1 回も相談しない場面がありました。先にその結果を見てください。
Claude Code の advisor とは
主モデルが、同等以上の相談役に要所で意見を聞く仕組み
advisor を有効にすると、主モデルは advisor というツールを使えるようになります。主モデルがこのツールを呼ぶと、相談役のモデルが会話全体を受け取り、助言を返します。主モデルはその助言を踏まえて作業を続けます。
相談役は Anthropic のサーバー側で動きます。API のドキュメントによれば、相談役が受け取るのは、システムプロンプト、ツールの定義、それまでのやり取りとツールの結果、そのターンで主モデルが出力した文です。相談役自身はツールを持たないため、自分でファイルを開いたりコマンドを実行したりしません。判断の材料は、会話に出てきた内容だけです。
相談役のモデルは、主モデルと同じか上のランクでなければなりません。「より強いモデル」に限らず、Opus 5.5 に Opus 5.5 を付けるような同じランクの組み合わせも認められています。
いつ相談するかは主モデルが決める
公式ドキュメントによれば、主モデルは、方針を決める前、同じエラーが続くとき、作業を終えたと判断する前に相談する傾向があります。ただし、相談の時点はルールでは決まっておらず、主モデルが判断します。回数の上限を設ける設定や、相談を強制する設定はありません。プロンプトで「advisor に相談してから続けて」と頼むことはできます。
有効にする 3 つの方法と、止め方
/advisor・advisorModel・--advisor の違い
有効にする方法は 3 つあり、設定が保存されるかどうかが異なります。
| 方法 | 使い方 | 保存の扱い |
|---|---|---|
/advisor コマンド | セッション中に /advisor fable のように打つ | ユーザー設定の advisorModel に保存される |
設定ファイルの advisorModel | settings.json に "advisorModel": "opus" と書く | 設定ファイルそのもの |
--advisor フラグ | 起動時に claude --advisor opus と付ける | 保存されない。そのセッションだけ設定より優先される |
/advisor を引数なしで打つと、選べるモデルの一覧が開きます。モデル名を付けると、Advisor set to Fable 5.2 のような確認が表示されます。設定リファレンスによれば、一覧で選んだ内容は「No advisor」も含めて ~/.claude/settings.json の advisorModel に保存されます (Remote Control から選んだ場合は、そのセッションだけに適用されます)。当社の環境でも、/advisor fable を打ったあと、~/.claude/settings.json に "advisorModel": "fable" が保存されていました。
claude -p のような対話画面の無い実行でも、v2.1.260 以降は /advisor を文字で打てます。引数なしなら現在の相談役が表示されます。当社の環境で claude -p "/advisor" --model sonnet --advisor opus を実行すると、Advisor: Opus 5.5 と表示されました。
/advisor off と CLAUDE_CODE_DISABLE_ADVISOR_TOOL の違い
止め方は 2 つあります。
| 方法 | 効果 |
|---|---|
/advisor off (一覧の「No advisor」) | 相談役を外す。一覧で「No advisor」を選んだ場合は、その選択がユーザー設定に保存される |
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 | advisor の機能ごと無効にする。/advisor は使えなくなり、advisorModel と --advisor も効かない |
設定を変えずに試すなら --advisor を使う
/advisor の一覧で相談役を選び直したり外したりすると、ユーザー設定が書き換わります。advisor あり・なしを比べる場合は、ありの側を --advisor、なしの側を CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 で起動すると、普段の設定を変えずに済みます。後述の比較も、この方法で行いました。
組み合わせられるモデル (2026 年 11 月 17 日時点)
主モデルごとの相談役の対応表
公式ドキュメントの対応表は次のとおりです。上の行ほど主モデルのランクが低くなります。
| 主モデル | 付けられる相談役 |
|---|---|
| Haiku 4.5 | Fable、Opus、Sonnet、Haiku 5.5 |
| Sonnet 4.6 | Fable、Opus、Sonnet、Haiku 5.5 |
| Opus 4.6 | Fable、Opus、Sonnet 5 以降、Haiku 5.5 |
| Sonnet 5 または Haiku 5.5 | Fable、Opus 4.7 以降、Sonnet 5 以降、Haiku 5.5 |
| Opus 4.7 または Opus 4.8 | Fable、Opus 4.7 以降、Sonnet 5.5 |
| Sonnet 5.5 | Fable、Opus 5 以降、Sonnet 5.5 |
| Opus 5 または Opus 5.5 | Fable、Opus 5 以降 |
| Fable 5 | Fable 5.2、Fable 5.1、Fable 5 |
| Fable 5.1 | Fable 5.2、Fable 5.1 |
| Fable 5.2 | Fable 5.2 |
Fable 5.2 を使うには v2.1.321 以降が必要です。相談役は fable・opus・sonnet の別名か、claude-opus-5-5 のようなモデル ID で指定します。Haiku 4.5 は相談役を呼べますが、相談役にはなれません。subagent も同じ相談役を引き継ぎます。組み合わせの条件は、subagent 自身のモデルを基準に判定されます。
Messages API の advisor tool でも組み合わせに制限があります。API 側の変更は Sonnet 5.5 の解説 と Fable 5.2 の解説 で整理しています。
付けられない組み合わせでは、advisor なしで動作することがある
主モデルより下のランクの相談役を選ぶと、Claude Code は主モデルのリクエストに相談役を付けません。このことは /advisor の出力と通知で示されます。Claude Code が付けた相談役を API が拒否した場合、Claude Code は相談役を外してリクエストを送り直します。そのため、エラーは表示されず、相談も起きません。
設定したのに相談が一度も起きないときは、まず /advisor の表示で、現在の相談役が有効になっているかを確認してください。
Fable を相談役にするときは、先に使用クレジットへの同意が要る
Fable の利用が使用クレジットに課金されるプランでは、Fable を相談役にする場合も同じ扱いです。使用クレジットへの同意が済んでいないと、/advisor fable を打っても Fable は保存されず、/model fable を案内されます。/model fable を実行して Fable で続けることを選ぶと同意が記録され、そのあと Fable を相談役に選べます。Claude Code で Fable を使う全体の流れは Fable 5 を Claude Code で使う記事 を参照してください。
試した 1: 記事制作のセッションで Opus 5.5 に Fable 5.2 を付けた
この記事は、主モデル Opus 5.5、相談役 Fable 5.2 の Claude Code のセッションで作りました。最初に /advisor fable を打つと Advisor set to Fable 5.2 と表示され、そのまま「この内容の記事を書いて」と依頼しています。
着手前の相談で、作業順と実験の方法が変わった
主モデルは、公式ドキュメントと変更履歴を読んだあと、記事の方針を決める前に相談役を呼びました。依頼者は相談を指示しておらず、主モデルが自分で判断して呼んでいます。主モデルの当初の計画は「ドキュメントを読んだらすぐ構成に入る」というものでした。相談のあと、主モデルは受け取った助言を報告し、計画は次のように変わりました。
- 既存記事との重複の確認と、作業用ブランチの作成が、最初の作業に加わりました
- 比較実験の方法を決めました。
/advisorで相談役を切り替えるとユーザー設定が書き換わると指摘され、--advisorとCLAUDE_CODE_DISABLE_ADVISOR_TOOL=1を使う方法を採りました - 「短い課題では相談役が呼ばれない可能性がある。呼ばれたかを出力で確認してから書く」という注意を受け、実験の記録方法を決めました
- 1 回の比較から一般化しないこと、費用を金額で断定しないことを、執筆の条件に加えました
この相談では、主モデル自身の誤りも 2 つ見つかりました。主モデルは依頼の直前に /advisor の説明を書いており、その中で相談役を「主モデルより強力なモデル」としていました。公式の条件は「同等以上」です。もう 1 つは止め方を「〜のはず」とぼかしていた点で、/advisor off で advisor を止められることが公式に書かれています。どちらも、この記事では公式どおりに直しています。
完了前の相談で、検証していない記述が見つかった
主モデルは、記事の初稿を書き、textlint・型生成・meta の長さの検査がすべて通った時点で、完了を報告する前に 2 回目の相談をしました。検査は通っていましたが、主モデルの報告によれば、相談役は「通った検査は形式だけで、事実の裏付けが済んでいない」として、10 項目を挙げました。主な指摘は次のとおりです。
- 比較実験の結果の「3 条件とも正しい合計になった」は、各実行のモデルが最後に出した報告を書き写しただけで、成果物を検証していません
- 費用と時間の倍率で、比べる基準の条件がそろっていません
- 冒頭近くの会話で「頼まないと相談しない」と書いていますが、この記事を作るセッションでは、頼んでいないのに着手前の相談が起きています
- 相談役が受け取る内容の説明に、公式資料に無い括弧書きが入っています
/advisor offがユーザー設定に保存されるかは、公式に明記されているかを確認していません- 記事の図を「撮った画面」と書いていますが、実際は端末の表示を画像に描き直したものです
指摘を受けて、主モデルは比較の 3 条件の成果物でテストを実行し、すべて通ること、合計が 882 円になること、lineTotal が変わっていないことを確認しました。各条件のモデルの報告は、この課題では正しかったことになります。/advisor off については、公式の設定リファレンスに「一覧での選択が保存される」とは書かれていますが、/advisor off と打った場合の保存の記述は見つからなかったため、主モデルは本文の表現を弱めました。この点は、1 回目の相談で相談役自身が言い切っていた内容で、2 回目の相談で相談役が自分の前回の発言を見直したことになります。ほかの指摘も、この記事にすべて反映しています。
画面では、相談したことだけが分かる
相談中の画面には Advising using <モデル名> の行が出て、終わると Advisor has reviewed the conversation and will apply the feedback に変わります。次の図は、後述の比較の条件 C と同じ指示を対話画面で実行したセッションを再開し、端末に表示された内容を色付きのまま画像にしたものです。

図と同じ部分を文字で示すと、次のとおりです。
Ran 2 shell commands
⏺ Advising using Opus 5.5
⎿ ✔ Advisor has reviewed the conversation and will apply the feedback
⏺ Tests first.
Ran 1 shell command
⏺ Advising using Opus 5.5
⎿ ✔ Advisor has reviewed the conversation and will apply the feedback公式ドキュメントによれば、助言が読める形で返された場合は Ctrl+O で中身を表示できます。ただし API のドキュメントでは、Fable 5.2・Opus 5.5・Sonnet 5.5 などの相談役は、助言を暗号化した形式で返すとされています。主モデルは助言を読めますが、利用者の側では助言の本文を読めません。利用者が助言の中身を知る手段は、主モデルの報告と、その後の行動の変化です。
試した 2: claude -p で、同じ課題を advisor あり・なしで比べた
比べ方
課題は、小さな請求書計算のコードの修正です。現状のコードは明細行ごとに消費税を切り捨てて合計しており、これを「1 請求書につき税率ごとに 1 回だけ切り捨てる」計算に直します。レシートに出す明細行の金額 (lineTotal) は変えてはいけない、という条件を付けました。テストの明細では、行ごとに切り捨てると合計 880 円、正しい計算では 882 円になります。
主モデルは Sonnet 5.5、相談役は Opus 5.5 で、effort はデフォルトのままです (対話画面の表示は medium)。同じ指示を、次の 3 つの条件で 1 回ずつ実行しました。
| 条件 | 起動方法 | 指示への追加 |
|---|---|---|
| A | claude -p "<指示>" --model sonnet --advisor opus | なし |
| B | CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 claude -p "<指示>" --model sonnet | なし |
| C | A と同じ | 「終える前に advisor に確認してもらってください」 |
相談役が呼ばれたかどうかは、--output-format stream-json --verbose の出力で判定しました。呼ばれると、name に advisor を持つ server_tool_use が出力に現れ、最後の集計の modelUsage に相談役のモデルが加わります。
結果
| 条件 | 相談の回数 | ターン数 | 所要時間 | 定価換算の費用 |
|---|---|---|---|---|
| A | 0 回 | 5 | 約 26 秒 | 約 0.17 ドル |
| B | - | 5 | 約 25 秒 | 約 0.17 ドル |
| C | 1 回 | 8 | 約 62 秒 | 約 0.48 ドル (うち相談役 約 0.28 ドル) |
費用は、出力の total_cost_usd (定価で換算した値) です。当社はサブスクリプションのプランで実行しているため、この金額が請求されるわけではありません。使用量の上限に算入される量の目安として扱ってください。
実行後の成果物を、この記事を作るセッションの主モデルが検証したところ、3 つの条件ともテストがすべて通り、合計は 882 円で、lineTotal は変更されていませんでした。実行の記録を見ると、どの条件もテストを先に書いてから実装しています。結果の正しさに差は出ていません。
条件 A では、相談役は有効でしたが、1 回も呼ばれませんでした。所要時間も費用も、advisor なしの条件 B とほぼ同じです。
条件 C では、主モデルは実装とテストを終えたあとに相談役を呼びました。主モデルの報告によれば、作業を止めるほどの問題は無く、指摘は、テストのコメントの記述が実際のテストケースと食い違っている点だけでした。主モデルはそのコメントを直してから作業を終えています。相談役の Opus 5.5 は、約 5.4 万トークンをキャッシュなしで読み込み、約 2,900 トークンを出力しました。読み込んだ量には、当社の環境のシステムプロンプトやツールの定義も含まれるため、読み込む量は環境によって変わります。
対話画面でも、条件 C と同じ指示で 1 回実行しました (上の図)。こちらでは、主モデルはファイルを読んだ直後と、テストと実装を書いたあとの 2 回、相談役を呼んでいます。同じ指示でも、条件 C と対話画面の実行では相談の時点と回数が異なりました。
この比較から言えること、言えないこと
言えるのは、この課題と条件では、相談を頼まなければ advisor を有効にしても何も変わらなかった、ということです。相談を頼んだ条件 C は、頼まなかった条件 A と比べて、費用が約 2.8 倍、時間が約 2.4 倍になり、指摘はテストのコメントの修正 1 件でした。
言えないのは、advisor の効果の大きさです。課題は 1 つ、試行は各 1 回で、課題自体も Sonnet 5.5 が単独で解ける難しさでした。難しい課題や長い作業では結果が変わる可能性があります。
公式の測定も、条件によって結果が分かれています。2026 年 4 月の公式ブログ「The advisor strategy」は、Sonnet 4.6 に Opus 4.6 を付けた組み合わせで、SWE-bench Multilingual のスコアが単独より 2.7 ポイント上がり、タスクあたりの費用が 11.9% 下がったと報告しています。一方、公式ガイド「Optimizing for cost and intelligence」(2026 年 11 月 17 日に確認) は、Opus 5.5 に Fable 5.1 を付けた Anthropic 社内のコーディング評価で、スコアの向上は 1.7 ポイントで誤差の範囲に近く、費用は Opus 5.5 単独の約 2.1 倍だったとしています。同じガイドには、主モデルがほとんど相談しなかった評価では、スコアが単独と同程度か下回ったという結果も載っています。また、Sonnet 5.5 を effort のデフォルトの high で動かした 20 問では、相談が 1 回も起きなかったと書かれています。当社の条件 A は effort も課題も異なりますが、指示が無いと相談が起きなかった点は同じでした。
FIXITじゃあ、頼まないと相談しないってこと?
Tsumiki短い課題ではそうでした。記事づくりの長い作業では、頼まなくても相談が入りました。
advisor が役立つ場面、役立たない場面
公式ドキュメントが挙げる場面と、当社の 2 つの記録を並べると、次のように整理できます。判断の軸は、主モデルが実際に相談するかどうかです。同じ公式ガイドも「相談役は、主モデルが相談したときにしか役に立たない」と書いています。
| 場面 | 判断 | 根拠 |
|---|---|---|
| 方針を誤ると後の作業がすべて無駄になる、長い作業 | 向く | 試した 1 では、頼まなくても着手前に相談が起き、作業順と実験の方法が変わった |
| 作業を終える前に、別の目で確認したいとき | 向く | 試した 1 では、検査が通ったあとの相談で、検証していない記述が見つかった |
| 同じエラーが繰り返し出るデバッグ | 向く | 公式ドキュメントが挙げる場面。当社では試していない |
| 数ターンで終わる短い作業 | 向かない | 試した 2 の条件 A では、相談が 1 回も起きず、結果も費用も advisor なしとほぼ同じだった |
| すべてのターンで最も強いモデルが要る作業 | 向かない | 公式ドキュメントは、相談役ではなく主モデルを切り替えるよう勧めている |
短い作業で使う場合は、相談を頼む一言を指示に加えてください。長い作業では、相談が何回起きたかを記録してください。相談がほとんど起きないなら、その記録を、主モデルの effort を確認するか advisor を外すかの判断材料にします。
費用と使用量の考え方
相談役を呼ぶたびに、相談役のモデルが会話全体を読みます。その分の費用は、主モデルの費用に加えて発生し、支払い方法によって扱いが異なります。
| 支払い方法 | 相談役の利用分の扱い |
|---|---|
| API 課金 | 相談役のモデルの単価で入出力のトークンが請求される |
| サブスクリプション | プランの使用量の上限に算入される |
| Fable が使用クレジットに課金されるプラン | Fable の相談役も使用クレジットに課金される |
相談役の読み込みにはプロンプトキャッシュが効かず、相談のたびに会話全体を最初から読みます。会話が長くなるほど、1 回の相談の費用は大きくなります。試した 2 の条件 C でも、相談役の費用は主モデルの費用を上回りました。
一方、セッションの途中で /advisor を切り替えても、主モデルのプロンプトキャッシュは失われません。相談役の利用分は /usage の集計に含まれます。Claude Code の費用の全体像は Claude Code のコスト最適化の記事 で整理しています。
opusplan・subagent・/model との使い分け
強いモデルを組み合わせる方法は、advisor のほかにも 3 つあります。違いは、強いモデルが動く時点です。
| 方法 | 強いモデルが動く時点 | 始まり方 |
|---|---|---|
| advisor | 作業の途中の、判断の要所 | 主モデルが必要と判断して呼ぶ |
| opusplan | プランモードの間。実行に移ると Sonnet に切り替わる | 利用者がプランモードに入る |
| モデルを指定した subagent | 委任された作業の全体 | 主モデルが委任するか、利用者が呼ぶ |
/model | 次のリクエストから先のすべて | 利用者が切り替える |
advisor の相談役は会話全体を読み、助言だけを返します。作業そのものは主モデルが続けます。subagent は、委任された作業を自分で進めます。subagent の設計は subagent の活用パターン を参照してください。
設定したのに相談されないとき、チームで使うときの確認点
相談が起きない場合は、次の順に確認します。
- 設定は正しく、主モデルが相談しなかっただけの可能性があります。短い作業では起こり得るので、まず「advisor に相談してから続けて」と指示して、相談が起きるかを確認します
- 提供経路を確認します。advisor は Anthropic API、Claude Platform on AWS、Claude Models on Google Cloud (Anthropic managed) で使え、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では使えません。LLM ゲートウェイを経由する場合、advisor を使えるかどうかは、ゲートウェイが advisor のリクエストを転送するかで決まります
- 機能フラグを確認します。Anthropic API の経路では、advisor に Anthropic から取得する機能フラグが必要です。
DISABLE_TELEMETRYのように取得を止める環境変数があると、advisor は有効になりません - 組み合わせを確認します。主モデルより下のランクの相談役は付きません。
/advisorの表示で、現在の相談役を確認してください - Fable を相談役にする場合は、使用クレジットへの同意が済んでいるかを確認します
- 組織で
availableModelsを設定している場合は、相談役のモデルが許可されているかを確認します。許可されていないモデルは、保存されていても呼ばれません
チームで使う場合、相談役は availableModels で制御でき、subagent にも引き継がれます。相談役の利用分は使用量や費用に加わるため、全員に勧める前に、自社の作業での相談の回数と、/usage で見た使用量の増え方を記録しておくと、判断の根拠になります。



