Claude CodeのAdvisorとは？相談役の仕組み・設定とAPIの費用

冒頭の画像は役割分担を表した概念イラストです。実際の製品画面ではありません。

Claude Codeの「Advisor」は、作業を進めるモデルに、別のモデルを相談役として付ける機能です。たとえばSonnetでコードの読み取りや修正を進め、方針が難しいところでOpusやFableへ相談する構成を作れます。

使う前に押さえたいのは、次の3点です。

作業を担当するのは主モデルのまま。 Advisorは会話を読み、計画や修正方針を返します。自分でファイルを編集したり、コマンドを実行したりする担当ではありません。
相談にも利用量と費用がかかります。 軽いモデルだけで済む仕事なら、Advisorを付けることでかえって高くなる場合があります。
Claude Codeの設定とAPIへの組み込みは別です。 利用経路、対応モデル、回数制限などが異なります。一般的なClaudeチャットや、ChatGPT・Geminiに同じ設定を追加する機能ではありません。

本記事では、まず仕組みとClaude Codeでの使い方を説明し、後半でAPIを使う開発担当者向けの確認点を整理します。2026年11月10日時点の公式資料に基づくガイドで、編集部による実機検証や費用測定ではありません。Claude Codeの公式ガイド、APIの公式仕様

主モデルとAdvisorは、何を分担する？

主モデルは、利用者の指示を受け、調査、ファイル編集、ツール操作、最終回答を進めます。APIではこの作業担当を「Executor」と呼びます。Advisorは、その途中で呼ばれる相談役です。

処理の流れは、次のようになります。

主モデルが作業を進め、方針を決める前や、同じエラーで行き詰まった場面などで相談を選ぶ。
Anthropic側でAdvisorが別に動き、会話、ツール操作と結果などの文脈を読む。
Advisorが計画、見落とし、軌道修正の案を返す。
主モデルが助言を踏まえて作業を続ける。

相談するか、いつ相談するかは主モデルが判断します。 「完了前にAdvisorへ相談して」と指示することはできますが、Claude Codeには相談を必ず実行させる設定や、相談回数を指定する設定はありません。助言と実際のファイルや実行結果が食い違う場合もあり、Advisorを付けただけで正しさが保証されるわけではありません。相談の流れとタイミング

APIのAdvisorには、システム指示やツールの定義も含む実行側の全文脈が渡されます。利用者が短くまとめた質問だけを別モデルへ送る仕組みではありません。また、Advisor自体はツールを使わないため、「別のAIにもテストを実行してもらった」とは区別が必要です。APIで渡される情報とAdvisorの役割

モデル切替やSubagentとの違い

使い方	変わること	選ぶ目安
主モデルを切り替える	作業を進める担当そのものが変わる	多くの工程で強いモデルが必要
Advisorを付ける	主担当は維持し、途中で別モデルの助言を受ける	日常的な処理は軽く、難しい判断だけ補いたい
Subagentに分担する	別の担当へ調査や実装などの作業を委ねる	作業を独立した単位に分けたい
opusplanを使う	計画モードではOpus、実行ではSonnetを使う	計画と実行で担当を切り替えたい

Advisorには同じモデルを指定できる組み合わせもあります。たとえばOpusを主担当と相談役の両方に使う場合は、低価格化より別の推論による見直しを狙う構成です。ただし、人による承認や、独立したテストの代わりにはなりません。構成ごとの違い、AnthropicのAdvisor戦略の説明

どこで使える？ Claude CodeとAPIを分けて確認

Claude Codeでは実験的機能、APIではベータとして案内されています。現時点の提供条件は次のように分けて確認します。

利用場所・接続経路	確認できた条件
Anthropicへ直接接続するClaude Code	サブスクリプション契約とAPI従量課金の両方が対象。対応モデルへのアクセスが必要
Claude Platform on AWS経由のClaude Code	v2.1.300のリリースノートには対応追加の記載。ただしCodeガイドには非対応の記述があり、公式資料が一致していない
Amazon Bedrock・Microsoft Foundryなどを経由するClaude Code	Codeガイドでは非対応。モデル自体を使えることと、Advisorが使えることは別
自社アプリから使うAdvisor API	Claude API、Claude Platform on AWS、Claude Models on Google CloudのAnthropic managed経路が対応先として記載
Managed Agents	Advisorを別の設定形式で指定。Messages APIの設定をそのまま流用しない

Claude Platform on AWSとAmazon Bedrockは別の経路です。 また、Google Cloudでも提供・管理の方式を区別する必要があります。API側の対応表だけで、同じ経路のClaude Codeも使えるとは判断しないでください。

AWS経由のCodeを検討している場合は、利用バージョン、ログイン経路、設定後にAdvisorが実際に呼ばれているかを担当者に確認します。本記事では資料の不一致を解消する実機結果を得ていないため、利用可否を一律には断定しません。Codeの提供条件、v2.1.300のリリースノート、APIの対応経路

Claude Codeで設定する手順

1. バージョンと利用できるモデルを確認する

まず claude --version でバージョンを確認します。Fable 5.2を使う場合は、Claude Code v2.1.321以降が必要です。必要に応じて、利用環境に合う公式の更新手順で最新版にします。

Desktop、Remote Control、非対話モードの -p、Agent SDKなど、選択画面を出せない場面で /advisor の文字列コマンドを使う対応はv2.1.260以降です。これはAdvisor機能全体の初登場バージョンを示すものではありません。Codeの対応バージョン、Fable 5.2追加のリリース

組織で使う場合は、管理者によるモデルの許可も確認します。availableModels の許可一覧にないAdvisorは呼ばれません。Fableでは契約・シートの利用権も必要です。

2. 主モデルを選び、Advisorを付ける

たとえば、Sonnetを主担当、Opusを相談役にするには、Claude Code内で次のように設定します。

/model sonnet
/advisor opus

Fableを相談役にする場合は、対応する主モデルを選んだうえで /advisor fable と指定します。/advisor だけを入力すると、選択画面や現在の設定を確認できます。

通常、/advisor で選んだモデルは利用者の設定に保存され、次のセッションにも引き継がれます。ただし、Remote Controlクライアントなど、現在のセッションだけに適用される接続形態もあります。設定の保存先と例外

主な現行モデルの組み合わせを抜粋すると、次のようになります。

主モデル	指定できるAdvisorの例
Haiku 5.5	Haiku 5.5、Sonnet 5.5、Opus 5.5、Fable 5.2
Sonnet 5.5	Sonnet 5.5、Opus 5.5、Fable 5.2
Opus 5.5	Opus 5.5、Fable 5.2
Fable 5.2	Fable 5.2

組み合わせは任意ではなく、Claude CodeとAPIの両方で検査されます。たとえばFable 5.2を主担当にして、Opusを相談役に付けることはできません。旧モデルを使う場合は公式の対応表を確認してください。対応する組み合わせ

opus、sonnet、fable はモデル名の短縮指定で、Claude Codeの更新に伴い指すバージョンが変わります。比較条件を固定したい場合は、/advisor claude-opus-5-5 のように完全なモデルIDを使い、主モデルのバージョンも記録します。モデル名と短縮指定

3. 一度だけ試すか、常用するかを選ぶ

目的	設定方法
セッション中に選ぶ・変更する	`/advisor opus` など
保存済みの設定を変えず、一度の起動だけ使う	`claude --advisor opus`
設定ファイルに既定値を書く	`"advisorModel": "opus"`
Advisorを解除する	`/advisor off`
管理上の理由で機能を停止する	環境変数 `CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`

--advisor はその起動に限り保存設定より優先されます。公式ガイドでは、claude --help には表示されないフラグとされています。設定ファイルで解除する場合は advisorModel を削除します。起動時の指定と解除方法

Fableの追加課金への同意を求められたら

Fableをusage creditsで使う契約では、初回の課金同意が必要な場合があります。/advisor fable が適用されず /model fable を案内されたら、利用条件と支出設定を確認してから進めます。

同意のために /model fable を実行すると、主モデルの選択もFableへ変わります。 Sonnetを主担当にしたいなら、その後 /model sonnet に戻してから /advisor fable を設定します。相談役を付けるつもりで、主担当までFableにしたままにしないよう確認してください。Fable Advisorとusage credits

設定したのに動かないときは

設定を保存できたことと、相談が行われたことは別です。相談時には Advising とAdvisorのモデル名が表示され、結果は Reviewed、Declined、Unavailable などで示されます。

相談表示がない： 主モデルが相談を選んでいない場合に加え、モデルの組み合わせ、組織の許可、利用権、課金同意を確認します。
組み合わせが拒否された： CodeがAdvisorなしで再試行し、会話自体は続くことがあります。新しいAdvisorを指定しても、/clear や /compact、新しいセッションでの確認が必要な場合があります。
Unavailableと表示された： 相談に失敗しています。作業が続いたとしても、Advisorによる確認が済んだとは扱わないでください。
組織の設定で機能が止まる： Advisorは機能フラグの取得にも依存します。テレメトリー等を制限する設定で無効になる場合があるため、担当者へ確認します。Advisorのためだけに社内の制限を勝手に解除しないようにします。

読み取り可能な助言が返った場合は Ctrl+O で確認できます。ただし、Fable 5.2やOpus 5.5などのAdvisorはAPI上で暗号化された結果を返すため、どのモデルでも助言全文を読めるわけではありません。 「Reviewed」の表示だけで、助言の内容まで監査できたとは考えないことが大切です。Codeの表示とトラブルシューティング、APIの結果形式

費用と利用枠はどう増える？

Advisorの相談分は、主モデルの利用量に上乗せされます。API従量課金なら相談役モデルの入力・出力単価、Claude Codeのサブスクリプションなら原則として契約の利用枠へ計上されます。Fableがusage credits対象のプランでは、Advisorにしても同じ扱いです。

費用を比べるときは、少なくとも次の3構成を分けます。

軽い主モデルだけで完了させる。
軽い主モデルに強いAdvisorを付ける。
強いモデルを最初から主担当にする。

Advisorを付ける構成が、常に最安というわけではありません。相談によってやり直しが減る可能性はありますが、短い確認だけで済む仕事では追加費用の方が大きくなることもあります。Codeの費用

また、Codeの現行ガイドでは、Advisorは相談のたびに会話全体を読み直し、Advisor側の読み取りにはキャッシュが使われないと説明しています。長い会話で何度も呼ぶほど、この分の消費に注意が必要です。主モデル側のキャッシュとは別の話です。後述するAPIの任意キャッシュ機能を、Codeでも自動的に使えるとは考えないでください。Codeのキャッシュへの影響

FableをAdvisorにする場合の通常条件

契約	Fable利用の通常の扱い
Max・Ultra	全モデル共通の週次枠のうち、最大50%まで
Teamのプレミアムシート	同じく週次枠の最大50%まで
Pro・Teamのスタンダードシート	usage creditsによる追加の従量課金
旧シート単位のEnterprise	プレミアムは50%枠、スタンダードはusage credits
使用量ベースのEnterprise・Claude API	API料金による従量課金

50%は別枠の追加付与ではなく、全体の週次枠の内数です。 Fableを主担当にしても相談役にしても、契約に応じたFableの利用条件を確認します。プラン別の公式条件

2026年11月10日時点では、発売記念としてProとTeamのスタンダードシートにも一時的に50%枠が含まれています。終了は日本時間2026年11月17日16時59分（11月16日23時59分PT）です。特典中の消費だけを見て、通常時も同じ月額内で使えると判断しないでください。期間限定特典

Fable 5.2の標準API単価は100万トークン当たり入力8ドル、出力40ドルです。相談1回の固定料金ではなく、読み取る文脈と生成量で変わります。Codeでは /usage のセッション合計も見ながら、追加利用の支出上限を確認します。Fable 5.2の仕様・単価、usage creditsの管理

APIに組み込む場合は、回数と費用の集計まで設計する

ここからは、既存アプリや自社エージェントを開発する担当者向けです。Messages APIでは、主モデルをリクエストの model に、相談役を tools 内に指定します。advisor-tool-2026-03-01 のベータ指定が必要です。

たとえば主モデルを claude-sonnet-5-5 にしたリクエストへ、次のツール定義を追加します。これは設定部分の例で、リクエスト全体ではありません。

{
  "type": "advisor_20260301",
  "name": "advisor",
  "model": "claude-opus-5-5",
  "max_uses": 2,
  "max_tokens": 4096
}

この例では相談を1ターン最大2回、Advisorの出力を1回4,096トークンまでにしています。数値は説明用で、最適値ではありません。主な注意点は次のとおりです。

max_usesは1ターンの上限。 省略時は無制限です。1ターンが、ツール結果の返送などで複数のHTTPリクエストにまたがる場合もあります。
ツール内のmax_tokensはAdvisor用。 思考と本文の合計を制限し、最小値は1,024です。リクエスト上位のmax_tokensや主モデルのtask budgetでは、Advisor側の消費を制限できません。
必要ならAdvisor側のキャッシュを明示する。 caching に {"type":"ephemeral","ttl":"5m"} などを指定できます。初期値は無効で、1時間の指定もあります。
会話全体の予算はアプリで管理する。 ターンごとの回数制限だけでは、長い会話や多くの利用者による総支出を止められません。

いずれもMessages APIの機能です。Claude Codeのコマンドで同じ回数制限を指定できるという意味ではありません。APIの設定項目と費用制御

成功レスポンスだけでなく、継続・失敗時も扱う

APIでは server_tool_use に続き advisor_tool_result が返ります。Opus 5.5やFable 5.2などは advisor_redacted_result という暗号化された形式を使うため、常に content.text がある前提では実装できません。返されたブロックは、次のリクエストに改変せず引き継ぎます。

処理が pause_turn で中断された場合は、同じツール定義とベータ指定を維持して再開します。会話途中でAdvisorの削除、モデル変更、キャッシュ設定変更を行うと、思考履歴の整合性チェックに関係する場合もあります。単に設定を差し替えるだけにせず、公式の継続処理を確認してください。結果形式・会話の継続

費用の集計では、レスポンス上位のusageだけを合計しないことも重要です。 上位は実行側の使用量なので、usage.iterations[] の type: "advisor_message" に記録される相談分を、Advisorの単価で加算します。iterations全件から集計する設計なら、上位usageを重ねて加算しないようにします。相談役モデルの利用制限に達した場合など、Advisorのエラーを受けても主モデルが作業を続けることがあるため、「API呼び出し全体は成功した」と「相談に成功した」を分けて記録します。APIの利用量・課金・エラー

Managed Agentsでは multiagent 内の advisor を使う別形式で、上の max_uses、max_tokens、caching は指定できません。どの製品の設定例なのかを確認してから実装します。Managed AgentsでのAdvisor

業務で使う前に決めたい、データと確認のルール

Advisorへは会話やツール結果が渡るため、主モデルだけでなく相談役に選ぶモデルのデータ保持条件も確認します。Fable 5.2は原則として入力・出力の少なくとも30日間の保持が必要な対象モデルです。Anthropicの明示承認による例外などを除き、通常のゼロデータ保持（ZDR）をそのまま適用できません。

Advisor API一般に「ZDR eligible」の表示があっても、Fableを含むすべての組み合わせが無条件にZDRで使えるという意味ではありません。顧客情報、非公開コード、社内資料を扱う場合は、契約と社内ルールを確認します。対象モデルの保持条件、APIのデータ保持

また、AIが「Advisorが確認した」と報告しても、送信、削除、本番反映などの承認を自動的に済ませる理由にはしないでください。Advisor自身が操作結果を実測するわけではなく、助言全文を読めない構成もあります。テスト結果、人によるレビュー、操作権限と承認記録を別に残します。関連する確認方法は、AIの作業報告と承認記録を確認するガイドで整理しています。

まず何で試す？同じ仕事で3構成を比べる

比較しやすいのは、完成条件が明確で、何度もやり直している仕事です。たとえば次のようなものが候補になります。

既存のテストがある、複数ファイルにまたがる改修。
同じエラーへの対処を繰り返している不具合調査。
複数資料の食い違いを整理し、根拠を示して結論を出す作業。

これらは活用案であり、Advisorが必ず改善することを示した自社での測定結果ではありません。短い文章の整形や定型的な確認は、まず主モデルだけで十分かを見ます。

試す際は、同じ資料と完成条件で「今の構成」「Advisor付き」「強い主モデルだけ」を新しい会話で比べます。記録するのは、モデルの完全名、推論設定、完了までの時間、実際の利用量、相談の成功・失敗、人の手直し時間です。

難所が減り、追加の消費や待ち時間に見合うなら採用する。 主モデルだけで十分なら付けない。機能を有効にできることより、自分たちの仕事が少ない手戻りで終わるかを基準にすると判断しやすくなります。

情報確認日：2026年11月10日。Advisorは実験的・ベータ機能で、対応モデル、設定、課金、提供経路は変わる場合があります。特にClaude CodeのClaude Platform on AWS対応は、公式資料に不一致があるため導入時の確認が必要です。