「担当を3つ置いてみましたが、一覧に出るのか、名前を言わずに頼んだとき本当に選ばれるのか、確かめ方が分かりません」
「担当が本当に Haiku で動いているのか、Explore のモデルも変えられるのか、実際の結果で確かめたいです」
第11回(演習 前編:準備)で、~/practice に3つの担当(調べる・作る・確かめる)を置き、準備を終えました。第12回は、新しいセッションで手順1〜4を試します。担当の一覧、呼び出し、/tasks でモデルを見る、Explore のモデルの上書きです。手順5〜7、4D での振り返り、自己点検、連載の結びは、後編の第13回です。
記録(筆者の環境の読み方)、Code タブ・CLI・-p の対応、準備の手順は、第11回の「筆者の記録の読み方」「準備」を見てください。-p では確認の画面が出る操作が「承認が要る」として実行されずに終わる点も、第11回に書いています。
手順1〜4
手順の表は次のとおりです。ここから新しいセッションで行います。
| 手順 | やること | 確かめること |
|---|---|---|
| 1 | 「使えるサブエージェントの名前と説明を一覧にして」と頼む | 3役が出るか。出なければ第4回の「反映のタイミングと、読み込まれないとき」。description が無い定義は一覧に出ず、エラーも出ない |
| 2 | 「@infra-researcher roles/ntp が何を設定しているか、ファイルと行を調べて」と送る。続けて、名前を言わずに「roles/ntp の tasks はどこで定義されている?」と送る | 答えは、roles/ntp/defaults/main.yml の ntp_servers(ntp1〜ntp3.example.jp の3台)と、roles/ntp/tasks/main.yml の lineinfile(chrony の参照先を loop で置く)。返す形どおりか(結論・根拠〔ファイル:行〕・分からなかったこと・障害)。自然な文では、組み込みの Explore が選ばれることがある。確実に使うなら名前か @ で指定 |
| 3 | 担当が動いている間(または直後)に /tasks を打つ | infra-researcher のモデルと effort(haiku・medium のはず)。版によって haiku が Haiku 4.5 のことがある(第5回の「筆者の記録:同じ haiku でも版で 4.5 と 5.5」) |
| 4 | (任意)本体を替えずに「このリポジトリの構成を Explore で調べて」と送る。次に .claude/agents/Explore.md(name: Explore、model: haiku)を作らせ、同じ依頼を送る | Explore のモデルが、本体と同じ Opus 5.5 から Haiku に変わるか |
手順2の答えは、筆者の ~/practice(連載「Claude Code実践入門」の演習のあと)の形です。手順4の元の手順は、本体を Sonnet 5.5 に替えて比べていましたが、ここでは本体は既定のままで行います。確かめたいこと(Explore は本体のモデルに従い、定義で上書きできる)は同じです。
手順1:担当の一覧
新しいセッションで、「使えるサブエージェントの名前と説明を一覧にして」と頼みます。3役(infra-researcher・playbook-writer・playbook-reviewer)が、説明つきで出るかを見ます。
筆者の環境ではこうなった(2.1.302、
-p)
「使えるサブエージェントの名前と説明を一覧にして」に対して、「このプロジェクト用(.claude/agents/に定義)」の見出しで、3役が名前・説明・ツールつきで出た。組み込みとしてclaude、general-purpose、Explore、Plan、claude-code-guide、statusline-setupも出た(筆者の PC の環境のもの)。また、「fork を指定すると、今の会話の文脈を引き継いだ分身を起動できる」とも書いた。
手順2:呼ぶ
「@infra-researcher roles/ntp が何を設定しているか、ファイルと行を調べて」と送ります(CLI の入力欄では、@ を打って候補から選びます。Code タブの候補は、筆者は確かめていません)。続けて、名前を言わずに「roles/ntp の tasks はどこで定義されている?」と送り、どの担当が選ばれるかを見ます。
筆者の環境ではこうなった(2.1.302、
-p)-pでは@の候補は出ず、@infra-researcherは文字列のまま本体に渡る。そこで、名前を言う頼み方(「infra-researcher 担当に…」)と、@を付けた頼み方の両方を試した。3回の依頼の結果は次のとおり。
| 依頼 | 選ばれた担当 | 担当のモデル | 起きたこと |
|---|---|---|---|
| infra-researcher 担当に、roles/ntp が何を設定しているか、ファイルと行を調べさせて | infra-researcher | claude-haiku-5-5 | roles/ntp/tasks/main.yml:1-6(lineinfile、/etc/chrony.conf、regexp、loop)、defaults/main.yml:1-4(3台)、site.yml:1-5、インベントリを、行つきで返した。「handlers が無いので chronyd に反映されない」「CLAUDE.md の『最後の1行だけ置き換える』の注意は、今の regexp には当たらず、古い可能性」と指摘 |
| 「roles/ntp の tasks はどこで定義されている?」(名前を言わない) | infra-researcher(description に「どこで定義されている?」の言い回しがある) | claude-haiku-5-5 | roles/ntp/tasks/main.yml の1ファイル。本体は「この結果は調査用のサブエージェントの報告によるもので、私自身はファイルを開いて確かめていません」と書き添えた |
「@infra-researcher roles/ntp が何を…調べて」(@ を付けた) | infra-researcher | claude-haiku-5-5 | 本体が報告を受けた後、自分でも2つのファイルを Read して、行番号を確かめた |
– 2.1.302 では、
model: haikuが Haiku 5.5 で動いた。
– 担当は前(foreground)で動いた(記録のrequestShapeが foreground)。公式は、-pでは Claude が自分の判断で担当を待てる、と書いていて、これと合う(第8回の「公式の文書の今の記述(2026年11月11日時点)」)。筆者の以前の記録(CLI 2.1.289、2026-10-17)では、ふつうに頼んだ担当は裏で動いた。
– 名前を言わない依頼は、2.1.302 では infra-researcher が選ばれた。筆者の以前の記録(個人のアカウントの CLI 2.1.289、2026-10-17)では、同じ依頼で組み込みの Explore が選ばれた(そのときの description にも同じ言い回しが入っていた)。どの担当が選ばれるかは版などで変わり、確実ではない。確実に使うなら、名前か@で指定する。
– Code タブの@の候補は、筆者は確かめていない。
手順3:/tasks でモデルを見る
担当が動いている間(または直後)に、/tasks を打ちます。公式の sub-agents は、/tasks が担当の行にモデルと、設定してあれば effort を出す、と書いています(v2.1.242 以降)。infra-researcher は haiku・medium のはずです。版によっては、haiku が Haiku 4.5 になることがあります(第5回の「筆者の記録:同じ haiku でも版で 4.5 と 5.5」)。
筆者の環境ではこうなった(2.1.302、
-p)-pには/tasksが無い。担当のモデルは、セッションの記録で見た(手順2の表のとおり、infra-researcher はclaude-haiku-5-5)。/tasksの画面そのものは、筆者は確かめていない。
手順4:Explore のモデル(任意)
- 本体を替えずに、「このリポジトリの構成を Explore で調べて」と送り、Explore のモデルを見る
- 「
.claude/agents/Explore.mdを作って。name は Explore、model は haiku、description は『リポジトリの中を読んで調べる』。ほかは書かない」のように頼んで、定義を作らせる(.claude/agents/への書き込みなので、確認が出る) - 同じ依頼をもう一度送り、Explore のモデルが変わるかを見る
- 終わったら、
Explore.mdを消す
公式の sub-agents は、組み込みの Explore のモデルを「本体のモデル」と書き、Explore という名前のユーザーまたはプロジェクトの担当を置くと、組み込みを上書きして、その定義の model を使う、と書いています(model: haiku で、費用の低いモデルで探索させられる)。
筆者の環境ではこうなった(2.1.302、
-p)
| 条件 | Explore のモデル |
|---|---|
| 本体は既定(Opus 5.5)、Explore の定義なし | claude-opus-5-5(本体と同じ) |
.claude/agents/Explore.md(name: Explore、model: haiku)を置く | claude-haiku-5-5 |
本体を --model sonnet で起動、定義なし | claude-sonnet-5-5(本体と同じ) |
Explore は、リポジトリの全ファイルを
for f in …; do cat -n; doneでまとめて読もうとし、その for ループのコマンドは承認待ち(allow に無い)になった。Explore.mdは、試した後に消した。
以前の記録(CLI 2.1.289、2026-10-17。本体 Sonnet 5.5)でも、Explore は本体と同じ Sonnet 5.5、Explore.mdを置くと Haiku(その版では Haiku 4.5)で動いた。

考えてみよう
- 手順2で、名前を言わない依頼が、infra-researcher ではなく組み込みの Explore に渡されたら、どう頼み直しますか。
- 手順3で、
/tasksに出たモデルが、定義のhaikuから想定した Haiku 5.5 ではなく Haiku 4.5 だったら、何を確かめますか。 - 手順4の
Explore.mdを消し忘れると、どうなりますか。
ヒント:1つ目は手順2の囲み、2つ目は第5回の「モデルの決まる順番」と「別名で書く理由」、3つ目は手順4の説明を見直してください。
まとめ
- 手順1:一覧に3役が出る。description が無い定義は出ない(エラーも出ない)
- 手順2:名前か
@で指定すれば確実に呼べる。名前を言わない依頼で選ばれる担当は、版や依頼文で変わる。筆者の 2.1.302 では、model: haikuが Haiku 5.5 で動いた - 手順3:
/tasksで担当のモデルと effort を見る(筆者は-pなので記録で確認) - 手順4:Explore は本体のモデルで動き、
Explore.md(model: haiku)で上書きできる。終わったら消す
次回の第13回は、手順5から続けます。作成担当とレビュー担当、スキルから担当への受け渡し、使った量を試し、4D で振り返って、連載を結びます。
連載「Claude Codeサブエージェント入門」全13回
全回の目次と、読む順番・目的別の読み方は、Claude Codeサブエージェント入門の入口のページにまとめています。
- サブエージェントとは
- 組み込みの担当と使い分け
- 担当を定義する
- toolsと返す形
- 担当のモデルの決まり方
- 役割とモデル・effort
- スキルから担当を呼ぶ
- 順に使う・前と裏
- ログの要約とレビューの担当
- 費用を測って小さく使う
- 演習(前編):準備
- 演習(中編):読み込む・呼ぶ・モデルを見る(この記事)
- 演習(後編):レビュー・スキル・費用

コメント