「担当も本体と同じモデルで動かしていますが、調べものまで重いモデルを使うのはもったいない気がします。どの役に、どのモデルを割り当てるのがよいのでしょうか」
「定義に effort も書けると聞きました。モデルと effort は、どちらを先に替えるものですか」
第5回では、担当のモデルが決まる順番と、別名で書く理由、組織の許可リストを見ました。第6回は、その上でどの役にどのモデルと effort を割り当てるかです。ここは、Anthropic の公式の推奨を土台にして、筆者の例と分けて書きます。
この回では、担当ごとの effort、公式の推奨と筆者の例の分け方、役割とモデルの対応(筆者の例)、組み込みの Explore のモデルの上書き、どのモデルで動いたかの確かめ方を扱います。冒頭の1つ目の相談は「公式の推奨と筆者の例」の節、2つ目の相談は「effort も担当ごとに」の節が答えです。数値・仕様は2026年10月時点です。
effort も担当ごとに
担当の定義には、モデルだけでなく effort(考える量の水準)も書けます。
- 値:
low・medium・high・xhigh・max。選べる値はモデルで違う(Haiku 5.5・Sonnet 5.5・Opus 5.5 は5つ) - 優先順位:定義の
effortはセッションの Effort より優先。呼び出し時の effort(v2.1.292 以降)は定義より優先。環境変数CLAUDE_CODE_EFFORT_LEVELはすべてに勝つ。セッションの Effort が効くのは、担当が本体と同じモデルで動くときだけ(v2.1.317 以降) - 既定:Fable 5.2・Haiku 5.5・Sonnet 5.5・Opus 5.5 は
medium、ほかは原則high(Opus 4.7 はxhigh。組織が既定を決めていればその値)(公式) - 筆者の目安(案):調査は
medium(下げない)、作成はmedium、レビューはhigh(第9回の「3役のひな形(筆者の例)」) - 確かめる:
/tasksの担当の行に effort が出るかは、筆者は Code タブでは確かめていない。筆者の CLI(2.1.289)では、出力に担当の effort が出ず判定できなかった
補足:出典は https://code.claude.com/docs/ja/sub-agents の「Choose an effort level」と https://code.claude.com/docs/ja/model-config です。

優先順位を、高い順に並べるとこうなります。
- 環境変数
CLAUDE_CODE_EFFORT_LEVEL(すべてに勝つ) - 呼び出し時に Claude が渡す effort(v2.1.292 以降。再開した担当にも効き続ける)
- 担当の定義の
effort(セッションの Effort より優先) - セッションの Effort(担当が本体と同じモデルで動くときだけ)
4つ目には条件があります。公式は、定義にも呼び出し時にも effort が無い担当について、本体と同じモデルならセッションで選んだ水準(/effort や --effort)で動き、「On another model, that level doesn’t apply.」(別のモデルでは、その水準は効かない)と書き、水準を決めたいなら定義に effort を書くよう勧めています。CHANGELOG の 2.1.317 には、別のモデルで動く担当は、セッションの水準ではなく、そのモデルに保存した水準か、そのモデルの既定を使うようにした、とあります。たとえば本体が Opus 5.5 で Effort を high にしていても、model: haiku の担当に effort を書かなければ、high は引き継がれません。
呼び出し時の effort は、第5回の「モデルの決まる順番」の「①呼び出し時の指定が最優先」と同じ型です。モデルでも effort でも、定義に書いた値は、呼ぶ側の指定で上書きされうる、と覚えておきます。
選べる値はモデルで違います。公式の model-config の表では、Fable の各モデルと、Opus 5.5・Sonnet 5.5・Haiku 5.5(と Opus 5、Sonnet 5、Opus 4.8、Opus 4.7)は low・medium・high・xhigh・max の5つ、Opus 4.6 と Sonnet 4.6 は xhigh が無い4つです。同じ表に載っていないモデルは effort に対応しません。Haiku 4.5 はこの一覧に載っていません(連載「Claude活用入門」第3回の「Effort とは」の節にある「Haiku 4.5 は Effort に対応していない」と合います)。第5回の「筆者の記録:同じ haiku でも版で 4.5 と 5.5」で見たように、Claude Code が 2.1.293 より前だと haiku は Haiku 4.5 に解決されます。その版で effort: medium を書いた担当の動き(無視されるのか、エラーになるのか)は、筆者が確かめた範囲では公式の文書に見つかりませんでした。haiku の担当に effort を書くときは、Claude Code の版が 2.1.293 以降かどうかを先に確かめておきます。
公式の推奨と筆者の例
担当にどのモデルと effort を割り当てるかを書く前に、公式が書いていることと筆者の例を分けておきます。混ぜると、筆者の好みを公式の推奨と取り違えてしまうためです。
公式の推奨:本体は既定、軽い作業の担当は軽いモデルへ
- 本体:公式の既定(Opus 5.5・Effort medium)から始める。足りなければ、まず Effort を上げる。モデル選びのガイドは「Most workloads start with Claude Opus 5.5.」「Tuning effort is often a better lever than switching models.」と書く(連載「Claude Code実践入門」第1回の「モデルとEffortの選び方(公式の推奨)」で引用したものです)。「On Claude Opus 5.5 and Claude Haiku 5.5 the default is
medium; start there and adjust the same way.」(Opus 5.5 と Haiku 5.5 の既定はmedium。そこから始めて、同じように調整する)とも書く - 担当:公式は、サブエージェントを使う利点として、軽いモデルへ振り分けて費用を抑えることを挙げる。次の表は、その記述です
| 公式の文書 | 記述(原文の抜粋と、その意味) |
|---|---|
| sub-agents の利点の一覧 | 「Control costs by routing tasks to faster, lower-cost models like Haiku」(Haiku のような速くて安いモデルへ作業を振り分けて、費用を抑える) |
| sub-agents の Explore の節 | Explore という名前のユーザー・プロジェクトの担当は組み込みを上書きして自分の model を持つので、「define one with model: haiku to run exploration on a lower-cost model」(model: haiku の定義を作れば、安いモデルで探索させられる) |
| costs の「Choose the right model」 | 「For simple subagent tasks, specify model: haiku in your subagent configuration」(単純な担当の作業には、定義に model: haiku を書く) |
| choosing-a-model(モデル選びのガイド) | 表の Haiku 5.5 の行に、用途として「sub-agent tasks」(サブエージェントの作業)。「High-volume, straightforward tasks」(大量の、単純な作業)には、速くて費用効率のよいモデルから始めるのも一案、と書く |
| Haiku 5.5 の What’s new | 「built for high-volume, latency-sensitive work such as classification, routing, extraction, and subagent tasks」(分類・振り分け・抽出・サブエージェントの作業のような、大量で遅延に敏感な作業向け) |
effort のページの low の用途 | 「Simpler tasks that need the best speed and lowest costs, such as subagents」(最高の速さと最低の費用が要る、サブエージェントのような単純な作業) |
(2026年10月18日に筆者が確認した公式の記述です)
つまり、公式の推奨は「本体は既定のまま。調べもののような単純な作業を任せる担当は、Haiku のような速く安いモデルに回して費用を抑える」です。担当を軽いモデルに回すこと自体は、筆者の好みではなく公式の書いていることです。
一方、公式が書いていないこともあります。「調査担当は Haiku、レビュー担当は Sonnet の high」のような、役ごとのモデルと effort の細かい割り当てです。筆者が確認した範囲では、Claude Code のベストプラクティスのページにも、公式ブログ「Choosing a Claude model and effort level in Claude Code」(2026年7月7日)にも、サブエージェントの model・effort の勧めは見つかりませんでした。次の割り当ては、公式の推奨ではなく筆者の例です。
筆者の例:調べる・作る・レビューする・判断する
筆者の3つの担当の割り当てです。これは筆者の例で、公式の推奨ではありません。
| 役割 | 担当の例 | model | effort | tools | 考え方 |
|---|---|---|---|---|---|
| 調べる・要約する | infra-researcher | haiku | medium | Read, Grep, Glob | 読み取りだけ。出典(ファイルと行)つきで返させる。effort は medium より下げない |
| 作る・直す | playbook-writer | sonnet | medium | Read, Grep, Glob, Edit, Write, Bash | 編集を受け持つ。本実行と本番のインベントリには触れさせない |
| レビューする | playbook-reviewer | sonnet | high | Read, Grep, Glob, Bash | 確かめる役なので effort は high。Edit・Write は持たせない |
| 判断する・計画する | (本体と人) | 本体の既定(Opus 5.5) | 既定(medium) | 本体の道具 | 担当には任せない。結果を見て決めるのは本体と人 |
Haiku に調査を任せるときは、次の公式の注意を知っておきます。筆者の例の「effort は medium より下げない」「読み取りだけ・出典つき」は、この注意とも合う置き方です。
- Haiku 5.5 は、確かめずに「完了」と言うことがある:Anthropic の Haiku 5.5 のガイドは、Effort が
low・mediumのとき、コードの変更を確かめずに完了と報告することがある、と注意している(次の節) - この注意は
mediumにも当てはまる。effort だけでは防げないので、役割(読み取りだけ・出典つき・確かめるのは本体)で補う - だから、Haiku の担当には書き込みと判断を任せない。調べるだけなら、間違えても本体が出典を見て確かめられる
- 確かめる役(レビュー)は、Sonnet の
highにする。作る役とは別の担当・別の目にする
Pro で使用量の枠が厳しい人は、本体を Sonnet 5.5 にする設定の例が、連載「Claude活用入門」第3回の「作業別の設定の例(筆者の例)」にあります。こちらも筆者の例で、公式の推奨ではありません。

Haiku 5.5 の注意:確かめずに「完了」と言うことがある
担当を Haiku に回すときの、公式の注意を原文で引きます。Haiku 5.5 のプロンプトのガイドの「Tell coding agents to verify their changes」の節です。
At
lowandmediumeffort, Claude Haiku 5.5 sometimes reports a code change as done without running a check.
(low と medium の effort では、Claude Haiku 5.5 は、確認を実行しないままコードの変更を完了と報告することがある)
ガイドは、結果を確かめずに報告する場面を見たら、確かめることを求める段落をシステムプロンプトに足すよう勧め、「Anthropic の試験では、この文章でモデルは変更をより多く確かめ、性能が上がったが、その分トークンが増えた」と書いています。同じガイドは、low では長いエージェントのプロンプトで、検索を飛ばす・早く止まる・確認を飛ばすことが増える、とも書き、effort を上げると早く止まることも減る(費用は増える)としています。
この注意は、担当の使い方に直結します。
- Haiku の担当には、書き込みや判断を任せない。調べて報告させ、本体(または人)が確かめる
- 返す形に「何を確かめたか」「確かめていないこと」の欄を持たせる(第4回の「返す形と、障害の報告」、第9回の「レビュー担当(新しい目)」)
- 担当の effort を
lowに下げない。公式の effort のページはlowの用途に「サブエージェントのような単純な作業」を挙げる一方、Haiku 5.5 については「Start withmediumfor most work, including agentic coding.」(エージェントのコーディングを含め、多くの作業は medium から始める)とも書いています。筆者の例はmediumを下限にしています
筆者が非対話の claude -p(Claude Code 2.1.302)で試したとき、infra-researcher(haiku・medium)は、ファイルと行を示して調べた結果を返しました。名前を言わずに頼んだときは、本体が「この結果は調査用のサブエージェントの報告によるもので、私自身はファイルを開いて確かめていません」と書き添え、@infra-researcher を付けて頼んだときは(-p では @ は候補から選ぶ操作ではなく、ただの文字列で、本体が名前から担当を選びました。第7回の「担当の呼び方3つ」)、本体が報告を受けた後に自分で2つのファイルを Read して行番号を確かめました。調査は担当、確かめるのは本体、という分け方です。
役割とモデルの対応(筆者の例)
次の割り当ては筆者の例です。公式の推奨は、上の「軽い作業の担当は Haiku のような軽いモデルへ」までです。集める・調べる・要約する担当は Haiku 5.5(haiku)、作る・直す・レビューする担当は Sonnet 5.5(sonnet)、判断する・計画する役は Opus 5.5(opus) で、多くは本体か人が受け持ちます。
組み込みの Explore は、既定では本体と同じモデルです。個人またはプロジェクトに Explore という名前の定義を置くと優先され、model: haiku と書けば安いモデルで調べさせられます。効くのは本体を Sonnet や Opus にしているときです。
- 調べる=haiku、作る・レビュー=sonnet
- 判断する・計画する=opus(本体か人)
- Explore も
model: haikuで上書きできる

筆者が確かめた記録です。
| 条件 | Explore が動いたモデル |
|---|---|
本体は既定(claude-opus-5-5)、Explore の定義なし(2.1.302) | claude-opus-5-5(本体と同じ) |
.claude/agents/Explore.md(name: Explore、model: haiku)を置く(2.1.302) | claude-haiku-5-5 |
本体を --model sonnet で起動、定義なし(2.1.302) | claude-sonnet-5-5(本体と同じ) |
| 本体を Sonnet 5.5 にした(2.1.289) | Sonnet 5.5。定義を置くと Haiku で動いた |
Explore は本体に従い、同じ名前の定義を置けば上書きできます。本体を Opus にしていても Sonnet にしていても、上書きは効きます。なお、筆者は Code タブでは確かめていません。
この割り当てを使うかどうかは、読む人の判断です。公式の推奨(本体は既定、単純な作業の担当を軽いモデルへ)から外れない範囲で、自分の作業に合わせて変えてかまいません。
どのモデルで動いたかを確かめる
定義に書いたモデルと、実際に動いたモデルが同じとは限りません(呼び出し時の指定、環境変数、許可リストによる置き換え、版による別名の解決先の違い)。動いたモデルを確かめる方法です。
/tasks:担当の行に、モデルと、その担当に決めた effort が出る(v2.1.242 以降。公式)- Code タブの
/tasks:使えるか、行にモデルが出るかは、筆者は確かめていない。公式のデスクトップのページは、担当を含む背景作業を見るパネル(タイトルバーの ⋮ メニューの Background tasks。英語の公式の名前で、日本語の画面での表示名は筆者は確かめていない)を書いている - 筆者の CLI(2.1.289)で確かめた:本体を Haiku にしても Sonnet 5.5 にしても、
model: haikuの担当は Haiku 4.5 で動いた(第5回の「筆者の記録:同じ haiku でも版で 4.5 と 5.5」)。本体のモデルに関係なく、model: haikuの担当は Haiku で動いた - 置き換えの警告:頼んだモデルと実際のモデルが出る(第5回の「組織の許可リスト(availableModels)と置き換え」)
- 版の確認:Claude Code の版は
/status。公式の desktop の文書には、Code タブでもローカルのセッションで/statusと打つと「Claude Code」の行に版が出る、とある(筆者は Code タブでは確かめていない)
補足:出典は https://code.claude.com/docs/ja/sub-agents と https://code.claude.com/docs/ja/desktop です。
/tasks は対話のセッションの機能です。筆者は非対話の claude -p で試したので /tasks は使えず、担当が動いたモデルはセッションの記録(~/.claude/projects/<プロジェクト>/<セッション>/subagents/*.jsonl の model)で確かめました。
考えてみよう
- 「公式の推奨」と「筆者の例」を、担当のモデルについて1文ずつで言い分けてください
- 調査担当を Haiku にするとき、effort を
lowに下げず、読み取りだけ・出典つきにするのはなぜですか - 本体が Opus 5.5 のとき、
Exploreを安いモデルで動かすには、どうしますか。それは本体を替えなくても効きますか
ヒント:1と2は「公式の推奨と筆者の例」の節、3は「役割とモデルの対応(筆者の例)」の節を見直してください。
まとめ
- 担当の定義には
effortも書ける。優先順位は、環境変数CLAUDE_CODE_EFFORT_LEVEL> 呼び出し時の effort(v2.1.292 以降)> 定義のeffort> セッションの Effort - 公式の推奨:本体は既定(Opus 5.5・medium)から始め、足りなければまず Effort を上げる。単純な担当の作業は、Haiku のような速く安いモデルに回して費用を抑える(Explore も
model: haikuの定義で上書きできる) - 筆者の例(公式の推奨ではない):調べる=
haiku・medium(読み取りだけ・出典つき)、作る=sonnet・medium、レビューする=sonnet・high、判断する=本体(既定の Opus 5.5)と人 - Haiku 5.5 は、Effort が low・medium のとき、確かめずに「完了」と報告することがある(公式の注意)。Haiku の担当に書き込みと判断を任せず、確かめるのは本体か別の担当にする
- Haiku 4.5 は effort の対応モデルの一覧に無い。
haikuが Haiku 4.5 になる 2.1.293 より前の版でのeffort:の動きは、公式に見つからなかった - 動いたモデルは確かめる。
/tasks(v2.1.242 以降)で担当の行にモデルと effort が出る
次回は、スキルから担当を呼ぶ方法(skills: と context: fork、呼び方、スキルに「誰に頼むか」を書く)を扱います。
連載「Claude Codeサブエージェント入門」全13回
全回の目次と、読む順番・目的別の読み方は、Claude Codeサブエージェント入門の入口のページにまとめています。
- サブエージェントとは
- 組み込みの担当と使い分け
- 担当を定義する
- toolsと返す形
- 担当のモデルの決まり方
- 役割とモデル・effort(この記事)
- スキルから担当を呼ぶ
- 順に使う・前と裏
- ログの要約とレビューの担当
- 費用を測って小さく使う
- 演習(前編):準備
- 演習(中編):読み込む・呼ぶ・モデルを見る
- 演習(後編):レビュー・スキル・費用


コメント