【Claude Codeサブエージェント入門 第6回】役割とモデル・effort ― 担当ごとのeffort、公式の推奨と筆者の例、Exploreの上書き、どのモデルで動いたかの確かめ方

Claude Codeサブエージェント入門 第6回 役割とモデル・effort 生成AI

「担当も本体と同じモデルで動かしていますが、調べものまで重いモデルを使うのはもったいない気がします。どの役に、どのモデルを割り当てるのがよいのでしょうか」
「定義に 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 です。

担当の effort の優先順位を、上ほど強い順に4段で並べた図。左の矢印は「強い」から「弱い」へ向かう。1は環境変数 CLAUDE_CODE_EFFORT_LEVEL で、すべてに勝つ。2は呼び出し時の effort で、v2.1.292 以降。定義より優先。3は定義の effort で、セッションの Effort より優先。4はセッションの Effort で、定義の effort が無いとき。下の枠「値と既定」に、値は low・medium・high・xhigh・max で、Haiku 5.5・Sonnet 5.5・Opus 5.5 の既定は medium とある。最下段のオレンジの帯に「筆者の目安(案):調査は medium(下げない)、作成は medium、レビューは high」とある。図の見出しは「effort の優先順位(上ほど強い)」。

優先順位を、高い順に並べるとこうなります。

  1. 環境変数 CLAUDE_CODE_EFFORT_LEVEL(すべてに勝つ)
  2. 呼び出し時に Claude が渡す effort(v2.1.292 以降。再開した担当にも効き続ける)
  3. 担当の定義の effort(セッションの Effort より優先)
  4. セッションの 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つの担当の割り当てです。これは筆者の例で、公式の推奨ではありません。

役割担当の例modelefforttools考え方
調べる・要約するinfra-researcherhaikumediumRead, Grep, Glob読み取りだけ。出典(ファイルと行)つきで返させる。effort は medium より下げない
作る・直すplaybook-writersonnetmediumRead, Grep, Glob, Edit, Write, Bash編集を受け持つ。本実行と本番のインベントリには触れさせない
レビューするplaybook-reviewersonnethighRead, 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回の「作業別の設定の例(筆者の例)」にあります。こちらも筆者の例で、公式の推奨ではありません。

公式の推奨と筆者の例を左右に分けて示した図。左の濃い見出し「公式の推奨」の下に2つの枠がある。「本体」は、既定(Opus 5.5・Effort medium)から始める、足りなければまず Effort を上げる、モデルを替えるより Effort の調整が効くことが多い。「担当」は、単純な作業・調べものなどを速く安いモデル(Haiku)に回して費用を抑える、Explore も model: haiku の定義で上書きできる。右のオレンジの見出し「筆者の例(公式の推奨ではない)」の下の枠「役割とモデル」に4行ある。調べる=haiku・medium(読み取りだけ、出典つき)、作る=sonnet・medium、確かめる=sonnet・high、判断=本体(既定の Opus 5.5)と人。その下の灰色の帯に「公式は「どの役にどのモデル」までは書いていない。3つの役への割り当て(haiku・sonnet・sonnet)は筆者の例」、さらに下の枠に「Haiku の担当は読み取りだけにして、書き込みと判断は任せない。レビューは Sonnet の high に回す」とある。最下行は「公式の推奨と、筆者の例を分けて読む」。

Haiku 5.5 の注意:確かめずに「完了」と言うことがある

担当を Haiku に回すときの、公式の注意を原文で引きます。Haiku 5.5 のプロンプトのガイドの「Tell coding agents to verify their changes」の節です。

At low and medium effort, 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 with medium for 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 で上書きできる
役割・別名・担当の例を対応づけた図。見出しは「役割」「別名」「担当の例」。1行目(緑の枠、虫眼鏡のアイコン)「調べる・要約する」「haiku」「infra-researcher」。2行目(青の枠、チェックリストのアイコン)「作る・直す」「sonnet」「playbook-writer」。3行目(青の枠、チェックマークのアイコン)「レビューする」「sonnet」「playbook-reviewer」。4行目(橙の枠、人のアイコン)「判断する・計画する」「opus」「本体か人」。図の下に点線の枠で「Explore(.claude/agents/Explore.md に model: haiku)」「効くのは本体が Sonnet・Opus のとき」

筆者が確かめた記録です。

条件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. 「公式の推奨」と「筆者の例」を、担当のモデルについて1文ずつで言い分けてください
  2. 調査担当を Haiku にするとき、effort を low に下げず、読み取りだけ・出典つきにするのはなぜですか
  3. 本体が 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サブエージェント入門の入口のページにまとめています。

  1. サブエージェントとは
  2. 組み込みの担当と使い分け
  3. 担当を定義する
  4. toolsと返す形
  5. 担当のモデルの決まり方
  6. 役割とモデル・effort(この記事)
  7. スキルから担当を呼ぶ
  8. 順に使う・前と裏
  9. ログの要約とレビューの担当
  10. 費用を測って小さく使う
  11. 演習(前編):準備
  12. 演習(中編):読み込む・呼ぶ・モデルを見る
  13. 演習(後編):レビュー・スキル・費用
seichan

プロフィール詳細は「プロフィール」をご覧ください。
AWS Certified Solutions Architect – Professional (https://www.credly.com/badges/fd8feb88-6f1f-42ff-a94b-445bb6661cb8/public_url)
Nutanix Certified Professional - Multicloud Infrastructure 6 (https://www.credly.com/badges/5c081bef-a425-42e4-809c-85138e676630/public_url)
Palo Alto Networks System Engineer (PSE) - Hardware Firewall Professional (https://www.credly.com/badges/69dc3880-4a51-47eb-8843-47ba6ea7d013/public_url)

seichanをフォローする
生成AI
シェアする
seichanをフォローする

コメント

タイトルとURLをコピーしました