賢いモデルは高い——この制約は、ターミナルで Claude Code を回すときも同じです。全部を Fable 5 で走らせれば快適でも、使用量（サブスクなら制限、API課金なら請求）はすぐ膨らみます。/advisor は「実行は安いモデル、判断の分岐点だけ賢いモデル」を Claude Code の内側で自動的に切り替える公式機能です。API の advisor_20260301 と同じ server tool を裏で使いますが、あなたが触るのはスラッシュコマンド1つだけ。

• 0個
  再現に要するコマンド（/advisor fable）
• 0%
  SWE-bench Pro スコア維持率（Sonnet 5 + Fable 5 助言）
• 0%
  Fable 5 単独に対する価格（＝約37%オフ）

user@sinyblog:~/article ❯ 01_intro.md90秒ダイジェスト（結論先出し）

忙しい人向けに、全部を先に置きます。

1. やること：Claude Code のメインモデルを Sonnet 5 にして、/advisor fable と打つだけ。以降、Claude が要所で Fable 5 に相談する。
2. 効果：アドバイザー戦略として SWE-bench Pro で Fable 5 単独スコアの約92%を、価格の約63%で達成 ^[3]。Fable 5 はタスクあたり約1回だけ呼ばれて舵取りする。
3. 前提：Claude Code v2.1.98以降（Fable 5 をアドバイザーにするなら v2.1.170以降＋Fable 5 アクセス）、Anthropic API 直のみ（Bedrock/Vertex/Foundry 非対応）。サブスク・API課金どちらも可 ^[1]。
4. 永続化：/advisor で選ぶとユーザー設定 advisorModel に保存され、次回以降も有効。
5. やめる：/advisor off。完全に殺すなら環境変数 CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1。

user@sinyblog:~/article ❯ 02_why.mdなぜ CLI でアドバイザー戦略なのか

Claude Code で大きめのタスク——大規模リファクタ、再発するバグのデバッグ、完了前に第三者チェックを入れたい作業——を回すと、トークンの大半は「ファイルを読む」「テストを回す」「差分を書く」という機械的な作業に消えます。本当に賢さが要るのは、着手前の方針決めと詰まったときの軌道修正、そして「完了」と宣言する前の確認という、ごく一部の分岐点だけ。

それなら機械的な部分を Fable 5 で回すのは無駄です。/advisor は、メインを速く安いモデルにしたまま、Claude が判断の分岐点でだけ強いモデルに相談します。アドバイザーは会話全文（全ツール呼び出しと結果を含む）を受け取り、助言を返し、Claude はそれを踏まえて続行します ^[1]。

向くのは、大半が定型で「方針の質が成否を決める」長丁場。向かないのは、計画すべきことが少ない短いタスクや、全ターンで最強モデルが要る作業——その場合はメインモデル自体を切り替えるほうが素直です ^[1]。

user@sinyblog:~/article ❯ 03_prereq.md前提とバージョン確認

アドバイザーツールは実験的機能です。次の3つをすべて満たす必要があります ^[1]。

1. Claude Code v2.1.98 以降。Fable 5 をアドバイザー（またはメイン）に使うなら v2.1.170 以降＋組織の Fable 5 アクセス。
2. Anthropic API 直のみ。Amazon Bedrock / Google Cloud / Microsoft Foundry では使えません（server tool のため）。ANTHROPIC_BASE_URL 経由の LLM ゲートウェイは、リクエストをそのまま Anthropic API に転送する構成なら可。
3. 対応メインモデル：Opus 4.6 以降 / Sonnet 4.6 以降 / Haiku 4.5（v2.1.170 以降なら Fable 5 も可）。

まずバージョンを確認・更新します。

# 現在のバージョン確認
claude --version

# 最新へ更新（v2.1.98+ / Fable 5 アドバイザーは v2.1.170+ が必要）
claude update

user@sinyblog:~/article ❯ 04_enable.md有効化3通り（/advisor・設定・フラグ）

アドバイザーモデルの指定方法は3つ。用途で使い分けます ^[1]。

① /advisor コマンド（セッション中・永続保存）

/advisor            # 引数なし → 選択ピッカーが開く（利用可能なアドバイザー一覧）
/advisor fable      # Fable 5 をアドバイザーに指定（advisorModel に保存）
/advisor opus       # Opus をアドバイザーに
/advisor claude-opus-4-8   # フルモデルIDでも指定可

② 設定ファイルに advisorModel（永続デフォルト）

{
  "advisorModel": "fable"
}

③ 起動フラグ --advisor（そのセッション限り）

# 保存設定を変えずに、このセッションだけアドバイザーを使う
claude --model sonnet --advisor fable

user@sinyblog:~/article ❯ 05_pairing.mdモデルの組み合わせルール

鉄則は1つ——アドバイザーはメインと同等以上の性能でなければならない。メインモデル別に受け付けるアドバイザーは次の通りです ^[1]。

アドバイザーは opus / sonnet / fable（各最新版に解決）か、claude-opus-4-8 のようなフルIDで指定します。アドバイザーがメインより弱いと、メインのリクエストにはアドバイザーが付かず、/advisor の出力と通知でその旨が表示されます。サブエージェントは設定済みアドバイザーを継承し、各自のモデルで同じ整合チェックを受けます ^[1]。

user@sinyblog:~/article ❯ 06_verify.md効いているかを確認する

設定しただけでは「本当に相談しているか」が見えにくいもの。Claude Code は相談中を可視化します ^[1]。

1. Claude がアドバイザーを呼ぶと、トランスクリプトにAdvising 行（アドバイザーのモデル名付き）が表示される。
2. 結果が返ると、その行が「アドバイザーが会話をレビューした」ことを示す表示に変わる。
3. Ctrl+O で展開すると、アドバイザーの助言全文が読める。
4. 現在の設定は /advisor（引数なし）で確認できる。ペアが不成立なら、その旨が出力・通知される。

* Advising with Fable 5 ...            # 相談中（呼び出しはClaudeの判断）
* Advisor reviewed the conversation   # 完了。Ctrl+O で助言全文を展開

user@sinyblog:~/article ❯ 07_when.mdいつ呼ばれる？呼ばせ方

呼び出しのタイミングはClaude が判断します。傾向としては「着手前」「エラーが再発したとき」「完了宣言の前」ですが、ルールベースではなくモデル駆動です ^[1]。

明示的に相談させたいときは、普通のツールと同じようにプロンプトで頼むだけ。呼び出し回数を強制・上限化する設定はありません——増やしたい／減らしたいときは指示文で伝えます ^[1]。

この設計を確定する前に、必ずアドバイザーに相談してから進めて。

（英語なら）consult the advisor before you continue

プロジェクト共通の癖にしたいなら、CLAUDE.md に「大きな方針決定・破壊的変更の前にはアドバイザーに相談する」といった方針を書いておくと、都度言わずに済みます。

user@sinyblog:~/article ❯ 08_settings.mdsettings.json 実例（user / project）

チームや複数プロジェクトで運用するなら、設定ファイルで固定します。/advisor で選んだ値はユーザー設定（~/.claude/settings.json）に保存されますが、プロジェクト単位で共有したい場合は .claude/settings.json に置きます。

{
  "model": "sonnet",
  "advisorModel": "fable"
}

user@sinyblog:~/article ❯ 09_cost.mdコストとキャッシュの挙動

アドバイザー呼び出しは会話全文をアドバイザーモデルに送るため、メインの使用量に加えてアドバイザーモデルのレートでトークンを消費します ^[1]。

1. API課金：アドバイザー分はアドバイザーモデルの入出力レートで課金。サブスク：アドバイザー利用はプランの使用上限にカウント。
2. アドバイザーは毎ターンではなく分岐点だけで呼ばれるので、強いモデルを通しで走らせるより通常は安くなる。これがアドバイザー戦略の肝。
3. 使用量は /usage のセッション合計に反映される。
4. プロンプトキャッシュは壊れない：/advisor のオン/オフ切替は、/model や effort 変更と違ってメインのキャッシュを無効化しない。アドバイザーが返した助言は以降のターンでトランスクリプトの一部としてキャッシュされる。ただしアドバイザー自身の会話読み込みはキャッシュされず、呼び出しごとに全文を処理する。

user@sinyblog:~/article ❯ 10_off.mdオフにする / 完全無効化

やめ方も明快です ^[1]。

/advisor off        # 使用停止＋保存済み advisorModel をクリア
                    # （ピッカーで「No advisor」を選んでも同じ）

# /advisor コマンド自体が使えなくなり、advisorModel も無視される。
# --advisor フラグは受理されるが無効（既存スクリプトは壊れない）。
export CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1

user@sinyblog:~/article ❯ 11_pitfalls.md使い分けと落とし穴チェックリスト

「第二のモデルを絡ませる」手段は複数あります。いつ強いモデルを動かしたいかで選びます ^[1]。

本番運用前に、この一覧を上から確認してください。

user@sinyblog:~/article ❯ 99_summary.mdまとめ

API を書かなくても、Claude Code のアドバイザー戦略はスラッシュコマンド1つで再現できました。要点は3つに集約できます。

1. 有効化は /advisor fable の1コマンド。メインを /model sonnet にしておけば、Sonnet 5 が実務を回し、Fable 5 が要所で助言する。永続化は advisorModel、単発は --advisor。
2. 前提は3つ：v2.1.98+（Fable 5 は v2.1.170+ ＋アクセス）／Anthropic API 直のみ／アドバイザーはメイン同等以上。効いているかは Advising 行＋Ctrl+O、コストは /usage で確認。
3. タイミングは Claude 判断。増減はプロンプトや CLAUDE.md で伝える。やめるのは /advisor off、完全に殺すなら CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1。プロンプトキャッシュは切替で壊れない。