
「Opusが考え、Sonnetが作り、Haikuが調べる」という使い分けが話題になっています。 考え方は理にかなっています。ただし、出回っているコマンドはそのままでは動きません。
この記事では、
- 出回っているコマンドのどこが実在しないか
- 実在する仕組みだけで同じことを組む方法
- 実際に走らせた費用と時間の実測値
を順に出します。設定ファイルは全文を載せるので、そのまま写して使えます。
サブエージェントの公式ドキュメント(外部サイト) 設定の公式ドキュメント(外部サイト)まず、動かないところ
検証した環境は Claude Code 2.1.278(2026-10-15 時点)です。
# 出回っているコマンド
claude --advisor opus --subagentshaiku| 書かれているもの | 実際 |
|---|---|
--advisor | 存在しません |
--subagents(--subagentshaiku) | 存在しません |
| 「Opus 5.5 / Sonnet 5.5 / Haiku 5.5」 | 5.5 という世代はありません |
claude --help で確認できます。実在するのは次のものです。
--model <model> このセッションのモデル。別名は 'fable' 'opus' 'sonnet'
(フルネームは 'claude-fable-5' のような形)
--agent <agent> このセッションのエージェント
--agents <json> カスタムエージェントをJSONで定義
--fallback-model <model> 既定のモデルが使えないときの退避先
--forward-subagent-text サブエージェントの文章と思考を転送する
モデルの世代も違います。現行は Opus 5 / Sonnet 5 / Fable 5.1 と Haiku 4.5 です。 「5.5」と書いて渡しても、その名前のモデルはありません。
では、やりたいことはできないのか。できます。
--advisor という入口が無いだけで、役割ごとにモデルを変える仕組みは実在します。
実在する仕組み:サブエージェントにモデルを書く
Claude Code は .claude/agents/ に置いた Markdown を「サブエージェント」として読みます。
この先頭(frontmatter)に model: を書くと、そのエージェントだけ別のモデルで動きます。
ここが肝です。つまり、
- 本体=セッションのモデル(
--model sonnet) - 調べもの=
model: haikuと書いたサブエージェント - 見直し=
model: opusと書いたサブエージェント
という三段構えが、追加のフラグなしで組めます。
ファイル1:調べもの担当(Haiku)
.claude/agents/researcher.md
---
name: researcher
description: 調べもの専門。ファイルの場所・件数・設定値など「探して数える」仕事を担当する。読むだけで、書き換えはしない。
model: haiku
tools: Read, Grep, Glob, Bash
---
あなたは調査担当です。
- **読むだけ。** ファイルを書き換えない
- 答えは**短く構造化して**返す。全文の貼り付けはしない
- 見つからなかったものは「無い」とはっきり言う。推測で埋めないファイル2:見直し担当(Opus)
.claude/agents/reviewer.md
---
name: reviewer
description: 設計レビュー専門。複数ファイルにまたがる設計、同じ失敗が 2 回続いたときの原因分析、仕上げ前の差分レビューを担当する。
model: opus
tools: Read, Grep, Glob
---
あなたはレビュー担当です。
- **実装しない。** 指摘と理由だけを返す
- 直す価値のある順に並べる。好みの問題は書かない
- 根拠にしたファイルと行を示すtools: を絞っているのには理由があります。調べもの担当に書き込みの道具を渡さなければ、
間違って直してしまうことが起きません。 見直し担当も同じで、読む道具しか持たせていません。
使い方
claude --model sonnetあとは普通に頼むだけです。本体(Sonnet)が必要に応じてサブエージェントを呼びます。 名前を出して指示することもできます。
researcher サブエージェントで content/guides の .mdx を数えて
reviewer サブエージェントに lib/schema.ts を見てもらって
実測:本当にモデルが分かれるのか
「そう書いた」だけでは確かめたことになりません。実際に走らせて、モデルごとの使用量を出しました。
claude -p "researcher サブエージェントで content/skills の .mdx を数えて。件数だけ。" \
--model sonnet --output-format json返ってきた modelUsage を抜き出すと、こうでした。
| モデル | 役割 | 入力 | 出力 | 費用 |
|---|---|---|---|---|
claude-sonnet-5 | 本体 | 4 | 247 | $0.0525 |
claude-haiku-4-5-20251001 | researcher | 18 | 411 | $0.0064 |
2つのモデルが1回の依頼の中で動いています。 frontmatter の model: haiku は効いています。
見直し担当も同じように確かめました。
claude -p "reviewer サブエージェントに lib/schema.ts を見てもらい、気づいた点を 2 つだけ挙げて。" \
--model sonnet --output-format json| モデル | 役割 | 出力 | 費用 |
|---|---|---|---|
claude-sonnet-5 | 本体 | 670 | $0.0598 |
claude-opus-5 | reviewer | 2,860 | $0.1663 |
このときの指摘は、実際にこのサイトのコードの食い違いを当てていました。
- 検証の不整合(schema.ts:59-61): skill の「verified なら testedAt 必須」というルールが、 guide 側の同種ルール(115-118行の
.refine())のようにスキーマ内で検証されず、 コメントのみで宣言されている。実体はlib/content.ts:60とscripts/validate-content.ts:124-131に別々に重複実装され、 片方向チェックと双方向チェックで強さが食い違っている。
実測:費用はどうなるのか
同じ「content/skills の .mdx を数えて」を、構成を変えて 4 通り走らせました。
| 構成 | 費用 | 時間 | 内訳 |
|---|---|---|---|
| Opus だけ | $0.1430 | 3.9秒 | opus-5 $0.1430 |
| Sonnet 本体 + Haiku で調査 | $0.0589 | 11.5秒 | sonnet $0.0525 / haiku $0.0064 |
| Haiku だけ | $0.0244 | 4.7秒 | — |
| Sonnet 本体 + Opus で見直し | $0.2262 | 54.1秒 | sonnet $0.0598 / opus $0.1663 |
ここから読み取れることを、宣伝せずに書きます。
わかったこと1:この程度の用事なら、効果は小さい
Opus だけ($0.143)と三段構え($0.059)で確かに差は出ましたが、 三段構えの費用のほとんど($0.0525 / $0.0589)は本体の Sonnet 側です。 Haiku が担当した調査そのものは $0.0064 しかかかっていません。
つまり**節約が効くのは「調査が長いとき」**です。短い用事では、 セッションを立ち上げた時点の読み込み(キャッシュ読み)が費用の大半を占めます。
わかったこと2:Opus の見直しは高い。だから「いつでも」は間違い
見直しを1回挟んだだけで $0.2262、Opus だけの構成より高くなりました。 出力が 2,860 トークンと長かったためです。
これは失敗ではなく、仕組みどおりです。Opus は長く考えて長く書きます。 だからこそ呼ぶ場面を絞るのが本質で、「常に相談する」設定にすると逆に高くつきます。
元のプロンプトが挙げている呼びどころは、この点では妥当です。
- 複数ファイルにまたがる設計を決めるとき
- 同じ失敗が2回続いたとき
- 仕上げ前に差分を見てもらうとき
わかったこと3:速さは犠牲になる
三段構えは 11.5 秒、Opus だけは 3.9 秒でした。 手数が増えるぶん遅くなります。 待ち時間が気になる用事では、分けない方が速いです。
元のプロンプトを、動く形に直す
出回っているプロンプトは「設定を作らせる」ものでしたが、 実在しないキーを前提にしているので、そのまま渡すと存在しない設定を作ろうとします。
実在する範囲だけに直したものがこちらです。 そのまま貼れます。
このプロジェクトに、役割ごとにモデルを分けた構成を作ってください。
やりたいこと:
本体 = Sonnet(実装・編集・テスト)
調べもの = Haiku のサブエージェント(探す・数える・読む)
見直し = Opus のサブエージェント(設計レビュー・原因分析・最終確認)
手順:
1. まず `claude --help` を実行し、この版で実在するフラグを確認してください。
存在しないフラグ(--advisor など)は使わないでください。
2. `.claude/agents/` に researcher.md と reviewer.md を作ってください。
frontmatter に name / description / model / tools を書きます。
- researcher は model: haiku、tools は読み取り系のみ
- reviewer は model: opus、tools は読み取り系のみ(実装はさせない)
3. 作る前に、ファイルの中身を差分として見せてください。
4. 承認を得るまでファイルを書かないでください。
守ること:
- 存在しない設定キーを作らない
- この版で確認できない設定は「確認できなかった」と書く
- 調べものはサブエージェント側で完結させ、要約だけ本体へ返す変えた点は3つです。
| 元 | 直したもの | 理由 |
|---|---|---|
--advisor / --subagents を前提 | .claude/agents/ の frontmatter | 前者は実在しない |
| 「Opus 5.5 / Sonnet 5.5 / Haiku 5.5」 | 世代を書かず別名で指定 | 5.5 という世代が無い |
| 「Jev を組み合わせる」 | 削除 | 該当するものを確認できなかった |
まとめ
--advisorも--subagentsも無い。 あるのは--modelと.claude/agents/のmodel:- 三段構えは本当に組める。 実測で 2 つのモデルが 1 回の依頼の中で動いた
- 節約が効くのは調査が長いとき。 短い用事では本体の読み込みが費用の大半
- Opus の見直しは 1 回 $0.17 前後。 呼ぶ場面を絞るのが本質
- 速さは落ちる。 手数が増えるぶん待つ
考え方は正しいので、実在する部品で組み直せば、ちゃんと動きます。
本文中の費用・時間は 2026-10-15 に Claude Code 2.1.278 で実際に走らせた値です。 モデルの料金は変わることがあるので、金額そのものではなく比率を見てください。
SOURCES
この記事を書くときに参照した資料と、内容を確認した日です。
- Claude Code — サブエージェント(Subagents)公式ドキュメント(外部サイト)確認 2026.10.15
- Claude Code — 設定(Settings)公式ドキュメント(外部サイト)確認 2026.10.15
