【Claude Codeサブエージェント入門 第12回】演習(中編)― 担当の一覧、@での呼び出し、/tasksでモデルを見る、Exploreの上書き

Claude Codeサブエージェント入門 第12回 演習(中編)― 担当の一覧、@での呼び出し、/tasksでモデルを見る、Exploreの上書き 生成AI

「担当を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-researcherclaude-haiku-5-5roles/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-5roles/ntp/tasks/main.yml の1ファイル。本体は「この結果は調査用のサブエージェントの報告によるもので、私自身はファイルを開いて確かめていません」と書き添えた
「@infra-researcher roles/ntp が何を…調べて」(@ を付けた)infra-researcherclaude-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 のモデル(任意)

  1. 本体を替えずに、「このリポジトリの構成を Explore で調べて」と送り、Explore のモデルを見る
  2. 「.claude/agents/Explore.md を作って。name は Explore、model は haiku、description は『リポジトリの中を読んで調べる』。ほかは書かない」のように頼んで、定義を作らせる(.claude/agents/ への書き込みなので、確認が出る)
  3. 同じ依頼をもう一度送り、Explore のモデルが変わるかを見る
  4. 終わったら、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)で動いた。

筆者が Claude Code 2.1.302 の CLI(claude -p)で試した結果の図。本体は既定(claude-opus-5-5)、「手動」。上段「担当の呼び方と、動いたモデル」は3行で、「名前を言って頼む」(infra-researcher 担当に、roles/ntp が何を設定しているか、ファイルと行を調べさせて)、「名前を言わない」(roles/ntp の tasks はどこで定義されている?)、「@ を付ける(-p では文字列として本体に渡った)」(@infra-researcher roles/ntp が何を…調べて)のどれも、infra-researcher が選ばれ、claude-haiku-5-5 で動いた。下段「Explore のモデル(本体を替えずに、Explore の定義だけ変える)」は3行で、既定(Opus 5.5)で Explore の定義なしなら claude-opus-5-5(本体と同じ)、既定(Opus 5.5)で .claude/agents/Explore.md(model: haiku)を置くと claude-haiku-5-5(定義で上書き)、--model sonnet で起動して定義なしなら claude-sonnet-5-5(本体と同じ)。最下行に「Explore はふつう本体と同じモデルで動き、model: haiku の定義を置くと Haiku で動く」「Explore.md は試したあとに消した」とある。

考えてみよう

  1. 手順2で、名前を言わない依頼が、infra-researcher ではなく組み込みの Explore に渡されたら、どう頼み直しますか。
  2. 手順3で、/tasks に出たモデルが、定義の haiku から想定した Haiku 5.5 ではなく Haiku 4.5 だったら、何を確かめますか。
  3. 手順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サブエージェント入門の入口のページにまとめています。

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

業務でオンプレミスとクラウドのインフラに携わり、勉強会の資料をもとに、インフラの基礎の入門の連載を書いています。仕様は公式の文書で、手順は手元の Windows・Linux・FreeBSD の環境で確かめています。
プロフィール詳細は「プロフィール」をご覧ください。
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をコピーしました