【Claude Codeサブエージェント入門 第2回】組み込みの担当と使い分け ― Explore・Plan・general-purpose、CLAUDE.md・スキル・フックとの違い、使う・使わないの判断、担当の置き場所と優先順位

Claude Codeサブエージェント入門 第2回 組み込みの担当と使い分け 生成AI

「Explore や Plan が勝手に動いているようですが、あれは何ですか。自分で作らなくても使えるのですか」
「CLAUDE.md、スキル、フック、サブエージェント。どれに書けばよいのか、いつも迷います。何でも担当に任せてよいのでしょうか」

第1回(サブエージェントとは)で、サブエージェントは別のコンテキストで動き、要約だけを返す担当であること、担当に渡るもの・渡らないものを見ました。この回は、その担当をどう選ぶかです。自分で作る前に、Claude Code が最初から持っている組み込みの担当を知り、ほかの手段(CLAUDE.md・スキル・フック・/btw)との使い分けと、「担当に任せるか、本体でやるか」の判断を押さえます。最後に、担当の定義ファイルをどこに置くかを見ます。

第2回では、組み込みの担当、使い分け、使う・使わないの判断、置き場所と優先順位を扱います。


組み込みの担当

Claude Code には、自分で作らなくても使える組み込みの担当があります。公式の文書の一覧は、次のとおりです。

担当モデル使われる場面
Explore本体のモデル(本体が Fable のときだけ接続の方法で変わる。下で説明)コードの検索・調査(読み取り専用)
Plan本体と同じプランで、計画の前に調べる(読み取り専用)
general-purpose本体と同じ調査と変更の両方が要る、複数ステップの作業
claude固有なし(決まる順番に従う)特化した担当に当てはまらないとき
statusline-setupSonnet/statusline を実行したとき
claude-code-guideHaikuClaude Code の機能を質問したとき
組み込みの担当6つとモデルを、担当・モデル・使われる場面の3列で並べた表形式の図。Explore は本体と同じモデルで、コードの検索・調査(読み取り専用)に使われる。Plan は本体と同じモデルで、プランで計画の前に調べる(読み取り専用)。general-purpose は本体と同じモデルで、調査と変更の両方が要る複数ステップの作業に使われる。claude はモデルが固有なし(決まる順番に従う)で、特化した担当に当てはまらないときに使われる。statusline-setup は Sonnet で、/statusline を実行したときに使われる。claude-code-guide は Haiku で、Claude Code の機能を質問したときに使われる。下の枠に、組み込みの担当は本体の権限ルールを引き継ぐこと、使わせないときは permissions.deny に Agent(Explore) のように書くことが書かれている。

公式の文書の言い方では、Explore は「コードベースの検索と分析に最適化された、速い読み取り専用の担当」、Plan は「プランモードで、計画を示す前に文脈を集める調査の担当」、general-purpose は「調査と実行の両方が要る複雑な複数ステップの作業向けの有能な担当」です。claude は「より特化した担当に当てはまらない作業のための、何でも受ける担当」です。

  • 組み込みの担当は、本体の権限ルールを引き継ぎます。 使わせないときは、permissions.deny に Agent(Explore) のように書きます(組み込みの担当にも、自作の担当にも使えます。deny の書き方は連載「Claude Code実践入門」第6回「allow・ask・denyルールの書き方」)
  • Explore と Plan だけを無効にする環境変数 CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1(Claude Code v2.1.198 以降)もあります。無効にしたあとの動きは、公式の2つの文書で書き方が違うので(片方は「本体がファイルを直接読んで調べる」、もう片方は「検索ツールか general-purpose で調べる」)、使うなら公式で確かめてください。この連載では使いません
  • Academy のレッスン1は、組み込みを「汎用・Explore・Plan」の3つだけ挙げています。 公式の一覧には、表のとおり claude・statusline-setup・claude-code-guide もあります。名前の食い違いではなく、Academy の記述が一部だけ、ということです
  • 名前に注意が要るものがあります。 Academy「Agent Skills入門」のレッスン5「スキルの共有」は Explorer・Plan・Verify と書いていますが、公式の担当の名前は Explore・Plan・general-purpose です。/verify は担当ではなく、組み込みのスキルです(連載「Claude Codeスキル入門」で扱います)
  • 組み込みの担当は、スキルを事前に読み込みません。 同じレッスン5は、組み込みの担当はスキルに「一切アクセスできない」、自作の担当は skills に列挙しないと「認識しない」と書いています。公式は「Built-in agents don’t preload skills」と書いていて、「使えない」とは書いていません。自作の担当でも、skills: に列挙しないスキルは、Skill ツール経由で呼べる、とあります。ただし disable-model-invocation: true のスキル(/verify を含む)は、担当に事前に読み込めません

出典は、公式の sub-agents のページ(https://code.claude.com/docs/ja/sub-agents)と、Academy のレッスン1です。

Explore のモデルは本体のモデル

公式の文書で、Explore のモデルは本体のモデルです。例外は、本体が Fable で動いているときだけで、接続の方法で次のように変わります。

  • Claude のサブスクリプション、Anthropic Console のアカウント、ANTHROPIC_BASE_URL 経由の LLM ゲートウェイ:Explore は、opus の別名が指す Opus で動く
  • Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、Claude apps gateway:Explore は本体のモデルのまま

Fable は、どのプランでも既定のモデルではなく、自分で選んだときだけ使われます(公式の model-config)。公式のサポートの記事は、Max プランには Fable 用の別の週ごとの上限がある、と書いています(https://support.claude.com/en/articles/12429409 )。プランと席の種類によっては、Fable の利用が枠ではなく usage credits に請求されることもあります(model-config)。Pro で Fable を選べるかの明記は、筆者が確かめた範囲では見つかっていません。つまり、本体が Opus 5.5 なら Explore も Opus 5.5、本体が Sonnet 5.5 なら Sonnet 5.5 と覚えておけば十分です。

Plan は本体のモデルを引き継ぎます(環境変数で全担当のモデルを強制したときを除く。第10回の「小さく使う工夫」)。general-purpose は、環境変数 CLAUDE_CODE_SUBAGENT_MODEL を設定していればそのモデル、なければ本体のモデルです(この環境変数は、第5回の「モデルの決まる順番」で扱います)。

筆者が試した結果は次のとおりです(CLI の Claude Code 2.1.302、claude -p、2026年10月18日。担当のモデルはセッションの記録で見ました)。

本体のモデルExplore のモデル
既定(Opus 5.5)。Explore の定義なしclaude-opus-5-5(本体と同じ)
--model sonnet で起動(Sonnet 5.5)。Explore の定義なしclaude-sonnet-5-5(本体と同じ)

また、公式は、Explore という名前の自作の担当(ユーザーかプロジェクトの担当)は、組み込みを上書きして、自分の model を保つと書いています。model: haiku を書いた定義を置けば、探索を安いモデルで動かせます。筆者が .claude/agents/Explore.md に model: haiku を書いて試すと、Explore は claude-haiku-5-5 で動きました(2.1.302)。この手順は、第12回の演習(手順4)で扱います。

haiku の別名が Haiku 5.5 を指すのは、Anthropic API で Claude Code v2.1.293 以降です。筆者の CLI 2.1.289 では Haiku 4.5 でした(第5回の「別名で書く理由」で扱います)。表の claude-code-guide の「Haiku」も、版で指すモデルが変わります。

筆者の環境の一覧

筆者の練習用のリポジトリ(演習の準備で、自作の担当を3つ置いたもの)で、「使えるサブエージェントの名前と説明を一覧にして」と頼むと(CLI 2.1.302、claude -p)、「このプロジェクト用(.claude/agents/ に定義)」の見出しで自作の3つが名前・説明・ツールつきで出ました。そのほかに、組み込みとして claude・general-purpose・Explore・Plan・claude-code-guide・statusline-setup の6つも出ました。表の6つと同じです。


スキル・CLAUDE.md・フックとの使い分け

担当は、ほかの手段と役割が違います。次の表で、動き方を比べます。

手段向いているもの動き方
CLAUDE.mdいつも当てはまる標準・制約毎回読み込む。指示で、たいてい守られる
スキル特定の作業の手順と知識説明が一致したとき、今の会話に読み込む
フック絶対に飛ばせないルールイベントごとにコードで動く。強制する(連載「Claude Codeフック入門」)
サブエージェント(担当)別のコンテキストに任せる作業別の会話で動き、要約だけが戻る
/btw今の会話の内容への質問道具を使わず、答えは履歴に残らない

連載「Claude Codeスキル入門」第1回(スキルとは何か)で見た、CLAUDE.md・スキル・フックの比較の表に、/btw を足した形です。公式の features-overview(https://code.claude.com/docs/ja/features-overview)の表の言い方も、同じ区分です。

  • CLAUDE.md:毎回の会話で読み込まれる、持続する文脈。プロジェクトの規約や「いつも X する」ルール
  • スキル:Claude が使える、手順・知識・ワークフロー。繰り返し使う内容や、繰り返す作業
  • サブエージェント:結果を要約して返す、隔離された実行のコンテキスト。コンテキストの隔離、並行する作業、専門の担当
  • フック:イベントで動く、スクリプト・HTTP リクエスト・MCP ツールの呼び出し・プロンプト・サブエージェント。一致するイベントのたびに必ず動かしたい自動化

また、公式は「これらは組み合わせられる」と書いています。担当は skills: でスキルを事前に読み込めます。スキルは context: fork で、別のコンテキストで動かせます(第7回の「スキルと担当の組み合わせ方2つ」で扱います)。

今の会話の内容は、担当ではなく /btw で聞きます。 公式は、/btw は会話の全体を見られるが道具は持たず、答えは履歴に加わらない、と書いています。担当は、道具を持ち、受け取った依頼文(fork なら会話のコピー)から始めます。この会話ですでに分かっていることは /btw、新しく調べに行くことは担当、という使い分けです(出典:https://code.claude.com/docs/ja/interactive-mode)。


使う・使わないの判断ルール

何を担当に任せるかの判断は、問い1つです。

  • 問いは1つ:中間作業は要るか。要らない(最終結果だけでよい)なら、任せる。要る(途中を見て反応したい)なら、本体で

Academy のレッスン4の言い方も同じです。「中間作業は重要か?」に「いいえ」なら担当に任せ、「はい」ならメインの会話にとどめる、です。この問いから、向く作業と向かない作業が決まります。

  • 向く作業:調べもの・探索、コードレビュー(新しい目)、別のシステムプロンプトが要る作業(書式の指示など)
  • 向かない①:「あなたは○○の専門家です」だけの担当。Claude はもともとその知識を持つ
  • 向かない②:各段が前の段の発見に依存する逐次パイプライン(第8回の「逐次パイプラインとの両立」で詳しく)
  • 向かない③:失敗の全文が要るテストの実行。診断に完全な出力が要る(第9回の「ログの要約で失敗を隠さない」で詳しく)
  • 公式が本体を勧める場面:行き来の多い作業、計画・実装・テストが文脈を共有する作業、小さな変更、待ち時間が気になる作業

向かない3つは、Academy のレッスン4が挙げるアンチパターンです。公式の「Choose between subagents and main conversation」(https://code.claude.com/docs/ja/sub-agents)は、次のように書いています。

  • 担当を使う:メインの文脈に要らない冗長な出力が出る作業、特定のツールの制限や権限を課したい作業、作業が自己完結していて要約を返せる作業
  • 本体を使う:頻繁な行き来や反復する手直しが要る作業、複数の段階が大きな文脈を共有する作業(計画・実装・テストなど)、小さく狙いを絞った変更、待ち時間が重要な作業

公式と Academy で、強調が違う所があります。扱いは次のとおりです。

  • 逐次パイプライン:Academy は「各ステップが前の発見に依存するパイプラインは避ける」と書き、公式は担当を順に使う例(Chain subagents)を挙げます。段ごとに独立した成果物(ファイル)で受け渡せるなら順番に使ってよく、前の発見に強く依存する作業(バグの再現→修正など)は本体で続ける、と両方を見ます(第8回の「逐次パイプラインとの両立」)
  • 専門家を名乗らせる担当:Academy は避けるよう書きます。公式の例には、本文に「expert」と書いた担当もあります。筆者は、名乗らせること自体ではなく、名乗らせるだけで中身の指示が無い担当が向かない、という意味だと読んでいます
  • テストの実行:公式の例には、テストスイートを担当に走らせ、失敗したテストとそのエラーメッセージだけを返させるものがあります。全文が要るかどうかは、返す形しだいです(第9回の「ログの要約で失敗を隠さない」)

冒頭の2つ目の相談が、これです。何でも担当に任せるのではなく、「中間作業は要るか」を問います。 要らない調べものとレビューは担当向き、行き来する作業と小さな変更は本体向きです。

出典は、Academy のレッスン4(https://academy.claude.com/ja/courses/introduction-to-subagents/using-subagents-effectively)と、公式の sub-agents の「Choose between subagents and main conversation」です。

担当に任せるかどうかの判断を示した図。上の濃い箱「問いは1つ:中間作業は要るか」から2つに分かれる。左の緑の箱「要らない(最終結果だけでよい)→ 担当に任せる」の下に「向く作業」として、調べもの・探索、コードレビュー(新しい目)、別のシステムプロンプトが要る作業(書式の指示など)が並ぶ。右のオレンジの箱「要る(途中を見て反応したい)→ 本体で」の下に「公式が本体を勧める場面」として、行き来の多い作業、計画・実装・テストが文脈を共有する作業、小さな変更、待ち時間が気になる作業が並ぶ。最下段の赤い枠「担当に向かない3つ」には、「あなたは○○の専門家です」だけの担当(Claude はもともとその知識を持つ)、各段が前の段の発見に依存する逐次パイプライン、失敗の全文が要るテストの実行(診断に完全な出力が要る)の3つがある。

担当の置き場所と優先順位

担当は、.claude/agents/ に置く Markdown 1つが1人です(定義の中身は、第3回の「ファイルの形」で扱います)。置き場所は5つあり、同じ名前なら優先順位の高いほうが使われます。

置き場所範囲(優先順位)使い方(筆者の例を含む)
管理設定組織全体(1・最も高い)組織が配る
--agents フラグそのセッションだけ(2)CLI で JSON を渡す
.claude/agents/そのプロジェクト(3)チームで共有するならここ。Git に入れる
~/.claude/agents/自分の全プロジェクト(4)個人の試し書き
プラグインの agents/有効にした場所(5・最も低い)名前は「プラグイン名:名前」。配り方は連載「Claude Codeチーム活用入門」第6回(プラグインで配る)
  • 同じ名前は、優先順位の高いほうが使われます。担当の名前は name だけで決まります(サブフォルダーに分けても同じ。.claude/agents/ と ~/.claude/agents/ は、サブフォルダーも含めて読まれます)
  • スキルとは向きが逆:同じ名前のスキルは、個人(~/.claude/skills/)がプロジェクトに優先します(連載「Claude Codeスキル入門」第8回の「優先順位と名前の付け方」)。担当は、settings.json などの設定ファイルと同じく、プロジェクトが個人に優先します(連載「Claude Code実践入門」第6回の「設定ファイルの階層」)
  • プロジェクトの担当は、作業ディレクトリからリポジトリのルートまでさかのぼって探されます。途中の .claude/agents/ が同じ name を定義していたら、作業ディレクトリに近いほうが使われます
  • プラグインの担当は、hooks・mcpServers・permissionMode などが無視されます(安全のため)。名前の形は「<プラグイン名>:<name>」で、name に : は使えません
  • 組織のプラン(Team・Enterprise)の補足:管理設定の strictPluginOnlyCustomization で agents を絞ると、~/.claude/agents/・.claude/agents/・--add-dir のフォルダーの担当は読み込まれません。プラグインの担当、組み込みの担当、管理ポリシーのフォルダーの担当は読み込まれます。個人の Pro・Max では、通常は関係しません
  • チームで共有するなら:公式の文書も、プロジェクトの担当はバージョン管理に入れて、チームで共有するよう勧めています(「Check into version control」)。筆者は、.claude/agents/ に置いて Git で共有します

出典は、公式の sub-agents のページです。プラグインの担当と配り方は、連載「Claude Codeチーム活用入門」第6回(プラグインで配る)で扱います。

担当の置き場所と優先順位を、上ほど強い順に5段で並べた図。左の矢印は「強い」から「弱い」へ向かう。1(最も高い)は管理設定で、範囲は組織全体、組織が配るもの。2は --agents フラグで、そのセッションだけ、CLI で JSON を渡す。3は .claude/agents/ で、そのプロジェクト、Git で共有する。4は ~/.claude/agents/ で、自分の全プロジェクト、個人の試し書き。5(最も低い)はプラグインの agents/ で、有効にした場所、名前は「プラグイン名:名前」。下の枠に、同じ名前は優先順位の高いほうが使われること、担当の名前は name だけで決まること(サブフォルダーに分けても同じ)が書かれている。図の見出しは「担当の置き場所と優先順位(上ほど強い)」。

考えてみよう

  1. 自分の最近の作業で、Explore が動いていた場面を思い出せますか。そのときの本体のモデルは何で、Explore も同じモデルだったでしょうか(/model で確かめます)
  2. 次の作業を、担当に任せるか本体でやるか、「中間作業は要るか」で分けてください。①ログを読んで原因の候補を探す ②見つけた原因を直して、すぐテストを回す ③今の会話で話した設計案を、ほかの人に説明するための要約を作る
  3. 自分の担当の定義を、どの置き場所に置きますか。自分だけで試すものと、チームで使うものを分けて考えてください

ヒント:1は「Explore のモデルは本体のモデル」、2は「使う・使わないの判断ルール」(③は /btw の説明)、3は「担当の置き場所と優先順位」の節を見直してください。


まとめ

  • 組み込みの担当は、Explore・Plan・general-purpose・claude・statusline-setup・claude-code-guide。自分で作らなくても使える。使わせないときは permissions.deny に Agent(Explore) のように書く
  • Explore のモデルは本体のモデル(本体が Fable のときだけ接続の方法で変わる)。同じ名前の自作の担当を置けば、組み込みを上書きできる
  • CLAUDE.md は「いつも」、スキルは「特定の作業の手順」、フックは「絶対に」、担当は「別のコンテキストに任せる作業」。今の会話の内容は /btw で聞く
  • 判断の問いは1つ、「中間作業は要るか」。要らない(調べもの・レビュー)なら担当、要る(行き来・小さな変更)なら本体
  • 置き場所は5つ。同じ名前は優先順位の高いほうが使われ、チームで共有するなら .claude/agents/(Git)

次回は、担当の定義ファイルの形、作り方(Claude に頼むか、ファイルを書くか)、フィールドの一覧、description の書き方を扱います。


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