Claude Codeの「advisor」　Sonnetが要所だけOpusに判断を仰ぐ

米Anthropicは、Claude Codeの公式ドキュメントで、作業中に別の上位モデルへ相談する「advisor」機能の使い方をまとめた。主に動かすモデルをSonnetにしたまま、方針を決める前や同じエラーが続く時、作業を終えたと言う前などの要所だけ、相談役のOpusが会話全体を読んで助言を返す。相談役の分のトークンは別にかかるが、上位モデルを最初から最後まで動かすより安く済むことが多いと同社は説明している。

3つの方法で相談役を付ける

Claude Codeのadvisorのドキュメントによると、相談役のモデルを決める方法は3つある。セッションの途中で「/advisor opus」のように打つコマンド、設定ファイルの「advisorModel」、起動時の「claude --advisor opus」だ。コマンドで選んだモデルはユーザー設定に保存され、次のセッションにも引き継がれる。起動時の指定はそのセッションだけに効き、保存した設定より優先される。この指定は「claude --help」の一覧には出ない。

有効になると、画面に相談役が動いていてトークンを多く使うかもしれないという通知が出る。Claudeが相談すると「Advising」の行が出て、助言が返ると「Ctrl+O」で中身を読める。相談役が助言を断った時と、呼び出しに失敗した時も、その旨が行に出る。

相談役は会話のすべて(ツール呼び出しとその結果を含む)を受け取り、Claudeはその助言を当てはめてから作業を続ける。いつ相談するかはClaudeが決め、回数を抑えたり強制したりする設定は無い。ドキュメントは、プロンプトで「consult the advisor before you continue」のように頼めば相談させられると説明している。助言と手元の証拠が食い違う時、たとえば勧められた手順が失敗した時は、Claudeは助言に従い続けずに食い違いを示す。

相談役は主のモデル以上に限る

相談役に選べるのは、主のモデルと同じか上の順位のモデルだ。ドキュメントの表では、Sonnet 5.5を主にすると、Fable、Opus 5以降、Sonnet 5.5を相談役にできる。Opus 5とOpus 5.5を主にした時はFableかOpus 5以降で、Fableを主にした時はFableだけを付けられる。Haiku 4.5は相談役を呼べるが、相談役にはなれない。

組み合わせの例として、ドキュメントは「Sonnetを主にしてOpusを相談役にする」形を挙げ、日々の作業をSonnetに任せ、計画や原因のはっきりしない失敗、完了の確認だけをOpusに回す使い方だと説明する。Haikuを主にしてOpusを付ける形は、Haiku単体より高いが、主のモデルをSonnetやOpusに替えるよりは安いという。

使えるのはAnthropicのAPIとClaude Platform on AWSで、Amazon Bedrock、GoogleのクラウドのAgent Platform、Microsoft Foundryでは使えない。Claude Platform on AWSではバージョン2.1.300以降が要り、Claude Codeの更新履歴でも2.1.300で同じ環境に「/advisor」を足したと書いている。機能はまだ試験提供で、動きや料金、使える範囲は変わることがあるとドキュメントは断っている。

相談の分だけ費用が増える

相談役は呼ばれるたびに会話全体を読み直すので、主のモデルの利用分とは別に、相談役のモデルの単価でトークンがかかる。API課金ではその入力と出力の料金を払い、定額のプランでは利用上限に数えられる。Fableを相談役にする場合は、Fableの利用を利用クレジットに付けるプランでは、相談の分も同じく利用クレジットにかかる。

プロンプトキャッシュへの影響は小さい。途中で相談役を付けたり外したりしても、主のモデルのキャッシュは崩れない。ただし相談役が会話を読む部分はキャッシュされず、毎回すべてを読み直す。止めたい時は「/advisor off」を打つ。環境変数「CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1」を付けると機能ごと止まり、保存した設定も起動時の指定も効かなくなる。

ドキュメントは、相談役が向くのは、大半の手順は定型だが計画の良し悪しで結果が決まる長い作業だとする。大きなリファクタリングや、同じエラーが繰り返すデバッグがその例だ。短い作業や、毎回最上位のモデルが要る作業では、主のモデルを替えるほうがよいとしている。軽いモデルで回しつつ要所だけ上位モデルの判断を借りる手段が、公式の手順として整った。

編集部の見方

編集部は、advisorを入れる前に、自分の作業のどこで判断を誤っているかを先に見極めるべきだと見る。相談役は会話全体を毎回読み直し、その分はキャッシュされないので、相談が多い作業では節約のつもりが費用を押し上げうる。まず失敗の多い長い作業1つで、主のモデルだけの場合と相談役を付けた場合の差し戻しの数と利用量を比べるとよい。相談の回数を設定で抑えられない以上、Claudeがどのくらいの頻度で相談するかは、試すまで分からない。