【Claude Codeサブエージェント入門 第5回】担当のモデルの決まり方 ― modelに書ける値、決まる順番、別名と完全なID、組織の許可リストによる置き換え

Claude Codeサブエージェント入門 第5回 担当のモデルの決まり方 生成AI

「定義に model: haiku と書いたのに、本当にそのモデルで動いているのでしょうか。呼ぶ側が別のモデルを指定したら、どうなりますか」
「同じ haiku と書いても、人によって動くモデルが違うと聞きました。何が違うのですか」

第4回(toolsと返す形)では、tools で担当の道具を絞る方法、返す形、定義の反映のタイミングを見ました。ここからは、担当ごとにモデルを選ぶ話です。第5回は仕組みの回で、model に書ける値、モデルの決まる順番、別名で書く理由、組織の許可リストを扱います。どのモデルをどの役に割り当てるか(公式の推奨と筆者の例)は、次の第6回です。

前提を1つ置いておきます。本体(普通に話しかけている会話)のモデルは、公式の既定(Claude Code は Opus 5.5・Effort medium)のままです(連載「Claude Code実践入門」第1回の「モデルとEffortの選び方(公式の推奨)」)。この回で決めるのは、本体が担当に仕事を渡したときに、担当が動くモデルです。

冒頭の1つ目の相談は「モデルの決まる順番」の節、2つ目の相談は「別名で書く理由」の節が答えです。数値・仕様は2026年10月時点です。


model に書ける値

担当の定義の model: には、次の値が書けます。

項目意味メモ
別名 haiku・sonnet・opus・fable系統の最新版を指すこの連載のひな形はこれで書く(「別名で書く理由」の節)
完全な IDそのモデルに固定公式の書き方の例は claude-opus-5-5(この連載のひな形では使わない)。使えないと置き換わる(「組織の許可リスト」の節)
inherit本体と同じモデル本体を替えれば担当も替わる
省略決まる順番で選ばれる次の「モデルの決まる順番」の節
スキルの model:そのスキルが動くターンの間だけ、本体のモデルを切り替える担当の model: とは別。役割で分けるのは担当のほう

補足:スキルの model: は連載「Claude Codeスキル入門」第2回の「frontmatter のフィールド」で扱う1行です。context: fork のスキルでは、動かす担当のモデルを決めます。出典は https://code.claude.com/docs/ja/sub-agents と https://code.claude.com/docs/ja/skills です。

スキルの model: と担当の model: の違いを、公式の記述で補います。

  • スキルの model::そのスキルが有効な間のモデルで、適用されるのは現在のターンの残りだけ。設定には保存されず、次のプロンプトを送るとセッションのモデルに戻る。/model と同じ値か、本体のモデルのままにする inherit が書ける
  • context: fork のスキル:このときの model: は、動かす担当(フォークされた担当)のモデルを決める
  • 担当の model::sonnet・opus・haiku・fable、claude-opus-5-5 のような完全な ID、inherit が書ける。省略すると、次の節の順番で選ばれる

モデルの決まる順番

担当のモデルは、次の順で最初に当てはまったもので決まります。①呼び出しのときに Claude が渡す model、②定義の model(inherit は本体のモデル)、③環境変数 CLAUDE_CODE_SUBAGENT_MODEL、④本体のモデルです。

注意したいのは①が最優先な点で、定義に haiku と書いても、Claude が呼び出しで別のモデルを渡せば、そちらが使われます。守らせたいときは、頼み方に書くか、全担当を1つのモデルに固定します(第10回の「小さく使う工夫」)。③は v2.1.251 より前は最優先で、定義より先に効きました。版で順番が変わる例です。

  • ①呼び出し時の指定が最優先
  • ②定義、③環境変数、④本体の順
  • 定義の haiku も上書きされうる
モデルの決まる順番を示す、上から下への4段の階段の図。1段目(最も濃い青)「① 呼び出し時に Claude が渡す model」、2段目「② 定義の model(inherit は本体)」、3段目「③ 環境変数 CLAUDE_CODE_SUBAGENT_MODEL」、4段目(最も薄い青)「④ 本体のモデル」。右側に上から下への矢印と「上から順に、あれば決まり」の文字。1段目の右には橙色の枠の注意書き「定義に haiku と書いても、①があれば①が勝つ」。図の下端に灰色の帯「①が最優先。定義の haiku も上書きされうる」

公式の記述(Claude Code の sub-agents のページの「Choose a model」)でも、順番は同じです。①呼び出しごとの model のパラメーター、②担当の定義の model、③モデルの別名かIDを入れた CLAUDE_CODE_SUBAGENT_MODEL、④本体のモデル。v2.1.251 より前は、CLAUDE_CODE_SUBAGENT_MODEL がこの順番の先頭で、呼び出しごとのパラメーターも定義の model(model: inherit を含む)も上書きしていた、と公式は書いています。


別名で書く理由

定義の model: を別名で書くか、完全な ID で書くか。この連載のひな形は別名ですが、その理由を、確かめられたことと公式の記述に分けて挙げます。

  • 使えるモデルは時期と組織で変わる:Haiku 5.5 は2026年10月7日に発表されました(Anthropic の発表では「available now on all platforms」)。ただし、Pro・Max の Claude Code・Code タブのモデルのメニューに Haiku 5.5 が出るかは、公式の文書では確かめられていません(連載「Claude Code実践入門」第1回の「モデルとEffortの選び方(公式の推奨)」と同じ言い方です)
  • 別名は版で解決先が変わる:公式は、haiku が Haiku 5.5 を指すのは v2.1.293 以降と書く。筆者の CLI(2.1.289、2026-10-17)では、本体の --model haiku も、担当の model: haiku も Haiku 4.5 で動いた。CLI を 2.1.302 に上げて確かめると、担当の model: haiku は claude-haiku-5-5 で動いた
  • 完全な ID は置き換えられうる:組織の許可リストに無いと別のモデルになる(次の節)。別名なら許可された最新の版になる
  • 同じ系統は本体の版になる:本体が同じ系統なら、担当の別名は本体のモデルそのもの。筆者は Code タブでは確かめていない
  • この連載のひな形は別名で書く:haiku・sonnet・opus。この連載の中の役割の説明は「Haiku 5.5・Sonnet 5.5・Opus 5.5」と書く
  • 筆者がこのブログの連載づくりに使っている担当は、完全な ID で固定している:claude-haiku-5-5・claude-sonnet-5-5・claude-opus-5-5。どちらも筆者の例(公式がどちらかを勧めているわけではない。下の節)
同じ model: haiku でも、版で指すモデルが変わることを示した図。左の箱「model: haiku(別名)」から3本の矢印が、版ごとの3つの箱へ伸び、それぞれ解決先の箱につながる。1つ目は Claude Code 2.1.289(筆者の CLI で確かめた。本体の --model haiku も、担当の model: haiku も同じ)で、解決先は Haiku 4.5。2つ目は v2.1.293 以降(公式:haiku が Haiku 5.5 を指す)で、解決先は Haiku 5.5。3つ目は Claude Code 2.1.302(筆者の演習。model: haiku の担当は claude-haiku-5-5 で動いた)で、解決先は Haiku 5.5。下の枠「完全な ID と別名」に、別名(haiku・sonnet・opus)は許可された最新の版になること、完全な ID(claude-haiku-5-5 など)はそのモデルに固定され、組織の許可リストに無いと置き換えられうることが書かれている。最下行に「別名は版で解決先が変わるので、動いたモデルを確かめる」とある。図の見出しは「同じ model: haiku でも、版で指すモデルが変わる」。

補足:出典は https://code.claude.com/docs/ja/sub-agents と https://code.claude.com/docs/ja/model-config です。

筆者の記録:同じ haiku でも版で 4.5 と 5.5

筆者が同じ PC で、Claude Code の版だけを替えて確かめた結果です。

Claude Code の版model: haiku の担当が動いたモデル
2.1.289(2026-10-17)Haiku 4.5(claude-haiku-4-5)
2.1.302(2026-10-18)Haiku 5.5(claude-haiku-5-5)

2.1.302 では、本体のモデルは指定せず既定(claude-opus-5-5)で動かし、担当が動いたモデルはセッションの記録(~/.claude/projects/<プロジェクト>/<セッション>/subagents/*.jsonl の model)で確かめました。公式の CHANGELOG は、2.1.293 で「Added Claude Haiku 5.5 (claude-haiku-5-5), now the default Haiku model on the Anthropic API」と書いています。

公式の文書は、別名と完全な ID のどちらを勧めているか

公式の sub-agents のページは、model に別名と完全な ID の両方が書けると説明しています(「Model alias」と「Full model ID」。完全な ID は --model フラグと同じ値)。model-config のページは、次のように書きます。

  • 別名は、使っている提供元(プロバイダー)にとって推奨される版を指し、時間とともに更新される
  • 特定の版に固定したいときは、完全なモデル名を使う(例:claude-opus-5-5)か、対応する環境変数(ANTHROPIC_DEFAULT_OPUS_MODEL など)を設定する
  • opus や sonnet が古いモデルに解決される場合、新しいモデルは完全なモデル名を明示するか、ANTHROPIC_DEFAULT_OPUS_MODEL・ANTHROPIC_DEFAULT_SONNET_MODEL を設定して選ぶ

筆者が確かめた範囲では、公式の文書にどちらか一方を勧める文は見つかりませんでした(担当の定義の例は、model: inherit、model: sonnet、model の行が無いものがあります)。つまり、別名は新しい版に追従する代わりに解決先が動き、完全な ID は固定できる代わりに置き換えの対象になる、という使い分けです。版を固定したい理由があるなら完全な ID、版に追従させたいなら別名を選びます。この連載のひな形(3役)は別名で書きます。筆者がこのブログの連載づくりに使っている担当は、完全な ID で版を固定しています。

別名の解決先は、提供元でも変わります。公式の model-config の表では、opus・sonnet・haiku の別名は、Anthropic API では最新の版を指し、一部の提供元では前の版を指します。

提供元opussonnethaiku
Anthropic APIOpus 5.5Sonnet 5.5Haiku 5.5
Claude Platform on AWSOpus 5.5Sonnet 4.6Haiku 4.5
Amazon Bedrock、Google Cloud の Agent PlatformOpus 5.5Sonnet 4.5Haiku 4.5
Microsoft FoundryOpus 4.6Sonnet 4.5Haiku 4.5

(2026年10月時点の公式の表です。Claude の Pro・Max のサブスクリプションでこの表のどの行に当たるかを書いた箇所は、筆者が確かめた範囲では見つかりませんでした。筆者の 2.1.302 では、上の記録のとおり haiku が Haiku 5.5 でした)

同じ系統の別名の扱いにも決まりがあります。公式によると、opus のような系統の別名を呼び出し時の model や定義の model に書き、本体のモデルがその系統なら、担当は本体の正確なモデル([1m] の接尾辞を含む)で動きます。本体と同じ長い文脈の窓(コンテキストウィンドウ)を持てるためです。一方、環境変数 CLAUDE_CODE_SUBAGENT_MODEL に書いた別名は、本体と同じ系統でも、常に別名が指す版になります(inherit にすると、未設定と同じです)。


組織の許可リスト(availableModels)と置き換え

ここは組織のプラン(Team・Enterprise)の補足です。組織が管理設定で配る許可リストの話で、個人の Pro・Max では、組織が配った許可リストは通常ありません。

  • 許可リスト:組織は availableModels で使えるモデルを絞れる。担当の model: も、呼び出し時の指定も、環境変数も、この許可リストと照らされる
  • 系統の別名の場合:opus などが許可されていなければ、許可された中でその系統の最新の版で動く(v2.1.222 より前は本体のモデルで動いた)
  • それ以外の場合:許可されていない完全な ID などは、本体のモデルで動く。許可リストにその系統の版が1つも無いときも同じ
  • 警告:対話のセッションでは、置き換えると、頼んだモデルと実際のモデルを示す警告が出る。文言と出方は、筆者は確かめていない
  • 組織の管理設定の中身:組織ごとに違うので、組織の管理者に確かめる

補足:出典は https://code.claude.com/docs/ja/sub-agents の「Choose a model」と https://code.claude.com/docs/ja/model-config です。

別名と完全な ID の使い分けは、この置き換えの規則とつながっています。完全な ID(例:claude-opus-5-5)が許可リストに無いと、その担当は本体のモデルで動きます。別名(例:opus)なら、許可された中の最新の版で動きます。「頼んだモデルで動いた」と思い込まず、実際に動いたモデルを確かめるのが確実です(確かめ方は、第6回の「どのモデルで動いたかを確かめる」)。


考えてみよう

  1. 定義に model: haiku と書いた担当が、別のモデルで動くことはありますか。あるなら、どんなときですか
  2. 同じ model: haiku の担当が、人によって Haiku 4.5 で動いたり Haiku 5.5 で動いたりするのはなぜですか
  3. 定義の model: を完全な ID で書くと、別名で書く場合に比べて何が変わりますか

ヒント:1は「モデルの決まる順番」の節、2は「筆者の記録:同じ haiku でも版で 4.5 と 5.5」、3は「別名で書く理由」と「組織の許可リスト」の節を見直してください。


まとめ

  • 担当のモデルは、①呼び出し時の model → ②定義の model → ③環境変数 CLAUDE_CODE_SUBAGENT_MODEL → ④本体のモデルの順で最初に当てはまったもので決まる。①が最優先なので、定義の haiku も上書きされうる。③は v2.1.251 より前は最優先だった
  • model: に書ける値は、別名(haiku・sonnet・opus・fable)、完全な ID、inherit、省略。スキルの model: はそのターンの残りだけ本体のモデルを切り替えるもので、担当の model: とは別
  • 別名は版で解決先が変わる。haiku が Haiku 5.5 を指すのは v2.1.293 以降で、筆者の CLI では 2.1.289 が Haiku 4.5、2.1.302 が Haiku 5.5 だった
  • 公式の文書は、別名と完全な ID のどちらも書けると説明し、別名は更新され、固定したいときは完全な IDと書く。どちらかを勧める文は、筆者が確かめた範囲では見つからなかった。この連載のひな形(3役)は別名で書き、筆者がこのブログの連載づくりに使っている担当は完全な ID で固定している
  • 組織の許可リスト(availableModels)に無い値は置き換えられる。系統の別名は許可された最新の版、それ以外は本体のモデル(Team・Enterprise の補足)
  • 動いたモデルは頼んだモデルと同じとは限らないので、実際に確かめる

次回は、担当ごとの effort、公式の推奨と筆者の例(本体は既定、担当は軽いモデルへ)、役割とモデルの対応、どのモデルで動いたかの確かめ方を扱います。


連載「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をコピーしました