本文へスキップ

005 / 開発

Claude Codeで「調べるのはHaiku、作るのはSonnet、見直すのはOpus」を実際に組む

公開
2026.10.15
最終更新
2026.10.15
執筆
IGUANA LAB編集部
確認の状況
実行して確認
端末の記録。researcher サブエージェントを呼ぶと claude-haiku-4-5 が、reviewer を呼ぶと claude-opus-5 が本体の claude-sonnet-5 と並んで動き、それぞれの出力トークン数と費用が表示される
この repo で実際に走らせた記録です。数値は --output-format json が返した modelUsage そのもので、丸めていません(2026-10-15)。

「Opusが考え、Sonnetが作り、Haikuが調べる」という使い分けが話題になっています。 考え方は理にかなっています。ただし、出回っているコマンドはそのままでは動きません。

この記事では、

  1. 出回っているコマンドのどこが実在しないか
  2. 実在する仕組みだけで同じことを組む方法
  3. 実際に走らせた費用と時間の実測値

を順に出します。設定ファイルは全文を載せるので、そのまま写して使えます。

サブエージェントの公式ドキュメント(外部サイト) 設定の公式ドキュメント(外部サイト)

まず、動かないところ

検証した環境は Claude Code 2.1.278(2026-10-15 時点)です。

BASH
# 出回っているコマンド
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: を絞っているのには理由があります。調べもの担当に書き込みの道具を渡さなければ、 間違って直してしまうことが起きません。 見直し担当も同じで、読む道具しか持たせていません。

使い方

BASH
claude --model sonnet

あとは普通に頼むだけです。本体(Sonnet)が必要に応じてサブエージェントを呼びます。 名前を出して指示することもできます。

researcher サブエージェントで content/guides の .mdx を数えて
reviewer サブエージェントに lib/schema.ts を見てもらって

実測:本当にモデルが分かれるのか

「そう書いた」だけでは確かめたことになりません。実際に走らせて、モデルごとの使用量を出しました。

BASH
claude -p "researcher サブエージェントで content/skills の .mdx を数えて。件数だけ。" \
  --model sonnet --output-format json

返ってきた modelUsage を抜き出すと、こうでした。

モデル役割入力出力費用
claude-sonnet-5本体4247$0.0525
claude-haiku-4-5-20251001researcher18411$0.0064

2つのモデルが1回の依頼の中で動いています。 frontmatter の model: haiku は効いています。

見直し担当も同じように確かめました。

BASH
claude -p "reviewer サブエージェントに lib/schema.ts を見てもらい、気づいた点を 2 つだけ挙げて。" \
  --model sonnet --output-format json

モデル役割出力費用
claude-sonnet-5本体670$0.0598
claude-opus-5reviewer2,860$0.1663

このときの指摘は、実際にこのサイトのコードの食い違いを当てていました。

  1. 検証の不整合(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.14303.9秒opus-5 $0.1430
Sonnet 本体 + Haiku で調査$0.058911.5秒sonnet $0.0525 / haiku $0.0064
Haiku だけ$0.02444.7秒—
Sonnet 本体 + Opus で見直し$0.226254.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

この記事を書くときに参照した資料と、内容を確認した日です。

RELATED GUIDES