【Claude Codeサブエージェント入門 第1回】サブエージェントとは ― 別のコンテキストで動き要約だけを返す担当、担当に渡るもの・渡らないもの、あわせて読みたい公式の教材

Claude Codeサブエージェント入門 第1回 サブエージェントとは 生成AI

「調べものを頼むたびに会話が長くなって、最初に伝えたルールを守らなくなってきました。調べる作業だけ、別の場所でやらせることはできませんか」
「サブエージェントという言葉は聞くのですが、何がサブなのか、Explore というのが勝手に動いているのは何なのか、分かりません」

連載「Claude活用入門」で Claude 全体の使い方を、連載「Claude Code実践入門」で Claude Code に任せる作業の進め方(範囲・操縦・CLAUDE.md・権限・検証)を、連載「Claude Codeスキル入門」で繰り返す手順をスキルにする方法を見てきました。この連載「Claude Codeサブエージェント入門」は、その次の位置づけです。調べものや確認の作業を、別のコンテキストで動く担当(サブエージェント)に任せ、担当ごとに使うモデルや道具を決めるところまでを扱います。

第1回では、連載の案内、スキル入門のおさらい、サブエージェントとは何か(会話が埋まる問題と、別のコンテキスト)、担当に渡るもの・渡らないもの、あわせて読みたい公式の教材を扱います。


この連載の案内

この連載は全13回です。担当を定義し、モデルを選び、スキルから呼び分ける型を、次の順にそろえていきます。

  1. サブエージェントとは(この回):別のコンテキスト、渡るもの・渡らないもの
  2. 組み込みの担当と使い分け:組み込みの担当、CLAUDE.md・スキル・フックとの使い分け、使う・使わないの判断、置き場所
  3. 担当を定義する:ファイルの形、作り方、フィールドの一覧、description
  4. tools と返す形:道具を絞る、返す形と障害の報告、反映のタイミングと読み込まれないとき
  5. 担当のモデルの決まり方:model に書ける値、決まる順番、別名で書く理由
  6. 役割とモデル・effort:担当ごとの effort、公式の推奨と筆者の例の分け方
  7. スキルから担当を呼ぶ:skills: と context: fork、呼び方、スキルに「誰に頼むか」を書く
  8. 順に使う・前と裏:順に使う条件、前で動くか裏で動くか、担当の変更は巻き戻しで戻らないこと、役割で分ける例
  9. ログの要約とレビューの担当:失敗を隠さない返す形、新しい目のレビュー、3役のひな形、チームで使うなら決めておくこと
  10. 費用を測って小さく使う:担当も同じ枠を使う、/usage の見方、小さく使う工夫、連載の早見表
  11. 演習(前編):練習用のリポジトリの準備、準備プロンプトの全文、筆者の記録の読み方
  12. 演習(中編):自分の環境で、担当を読み込ませ、呼び、モデルを見る
  13. 演習(後編):レビュー・スキル・使った量を試し、4D で振り返る

前提と、この連載の扱いは次のとおりです。

  • 個人の Pro・Max のプランを前提にします。組織(Team・Enterprise)の話は、補足として添えるだけにします
  • 操作は Claude のデスクトップアプリの Code タブ(Claude Code for Desktop)を主に書きます。ターミナルで使う CLI の操作は「CLI では」と添えるので、読み替えられます
  • 数値・仕様は 2026年10月時点のものです。公式の文書は変わりやすいので、使うときは公式で確かめてください
  • 手元で確かめた版は、CLI の Claude Code 2.1.302(2026年10月18日、非対話の claude -p)と、2.1.289(2026年10月17日)です。Code タブでの見え方を確かめていない所は、「筆者は Code タブでは確かめていない」と書きます
  • この連載は、筆者が公式の文書(code.claude.com、Claude Academy)を読んで整理したもので、Anthropic の公式の文書ではありません。公式の推奨と、筆者の使い方の例は、分けて書きます

この連載の進み方を、表にまとめます。

段階内容ねらい
事前(約32分)Claude Academy「サブエージェント入門」レッスン1・3・4と、「Claude Codeを実践する」レッスン9(下の「あわせて読みたい公式の教材」)用語と考え方をそろえる。レッスン2は任意
説明(第1〜10回)担当を定義し、モデルを選び、スキルから呼び分ける型型をそろえる
演習(第11〜13回)自分の環境で、一度ずつ操作する手順結果を見て、自分の担当の定義に反映する
振り返り(第13回など)担当(調査・作成・レビュー)と任せる範囲を決める自分(やチーム)の運用にする

スキル入門のおさらい

連載「Claude Codeスキル入門」で押さえたことを、5つに絞って思い出します。この連載は、その続きです。

  • スキルにする目安:同じ指示を2回打ったらスキル。いつもは CLAUDE.md、必ずはフック
  • 書き方:description は「何を・いつ」と、使う人の言い回しで書く。SKILL.md は短く、資料は reference に、処理は scripts に置く
  • 筆者の例の検証スキル(ansible-verify):lint・構文チェック・stg への --check --diff の3つ(①〜③)を受け持ち、③で止まる。本実行と本番(prod)は人が行う(連載「Claude Codeスキル入門」第6・7回)
  • 予告された今回:スキルから担当(サブエージェント)を呼び分ければ、役割ごとにモデルを分けられる
  • 持ち越した問い:スキルにした作業のうち、担当に分けたいものは何か(この回の「考えてみよう」に入れました)

ansible-verify は、筆者が練習用のリポジトリに置いた検証のスキルです。この連載の演習でも、スキルから担当を呼ぶ手順(第7回、第13回)で使います。


あわせて読みたい公式の教材

Claude Academy(academy.claude.com)に、この連載に近い無料の公開コースがあります(2026年11月8日時点の表示です)。

筆者のおすすめは、レッスン1・3・4と、レッスン9です(合計約32分)。レッスン2は任意です。/agents から担当を作る画面の手順(スコープ、作り方、ツール、モデル、色)を説明していますが、今の Claude Code の /agents は案内を表示するだけで、画面が違うためです(第3回の「/agents は案内だけ」で扱います)。

講座の題・時間・URL は、筆者が2026年11月8日に実際のページで確かめたものです(10月17日の時点では、講座の題は「サブエージェントの概要」、レッスン2の題は「サブエージェントの作成」でした)。変わることがあるので、実際のページで確かめてください。


会話が埋まる問題と、別のコンテキスト

ファイルの読み込み、検索、ログの出力。調べものをするたびに、本体(メインの会話)のコンテキストは埋まります。いっぱいになるほど、Claude は最初の指示を見失いやすくなります(連載「Claude活用入門」第5回「コンテキストの管理」、連載「Claude Code実践入門」第1回「コンテキストは毎ターン送り直される」)。範囲を決めない探索が会話を膨らませる点は、連載「Claude Code実践入門」第1回「よくある失敗パターン5つ」の「終わらない探索」の行で見ました。

サブエージェントは、別のコンテキストで動く担当です。 担当は自分のコンテキストでファイルを読み、検索し、終わると要約だけを本体に返します。担当の会話は、その後捨てられます。

公式の文書は、サブエージェントを次のように説明しています。

  • 検索結果・ログ・ファイルの中身のように、あとで参照しない内容が本体の会話にあふれてしまいそうな横道の作業のときに使う。担当は自分のコンテキストでその作業をして、要約だけを返す
  • 同じ種類の担当を同じ指示で何度も立ち上げているなら、自作の担当(カスタムのサブエージェント)を定義する

Academy の例では、返金処理を担当するサービスを調べるとき、担当なしなら15個のファイルを本体に読み込みます。担当に任せれば、本体に残るのは質問と要約だけです。

本体と担当のコンテキストを対比する図。左に大きな枠「本体(メインの会話)」があり、中に「質問」「要約」の2つの箱だけが入っている。右に別の枠「担当(別のコンテキスト)」があり、中に「15個のファイルの読み込み」「検索」「ログ」の3つの箱が縦に積まれている。本体から担当へ向かう矢印に「依頼」、担当から本体へ戻る矢印に「要約」と書かれている。担当の枠の下に小さく「会話は終わると捨てられる」とある。最下部の帯に「引き換え:どう結論に至ったかは見えない」と書かれている。

要点は3つです。

  • 調べものは、本体の会話を埋める
  • 担当は、別のコンテキストで働く
  • 戻るのは要約だけ。経緯は見えない

引き換えに、担当がどう結論に至ったかは見えません。筆者が CLI の Claude Code 2.1.302 で、担当に練習用のリポジトリの roles/ntp を調べさせたとき、本体は担当の報告のあとに「この結果は調査用のサブエージェントの報告によるもので、私自身はファイルを開いて確かめていません」と書き添えました(claude -p、2026年10月18日)。要約だけが戻る、とはこういうことです。重要な結論は、担当の報告に出典(ファイルと行)を求めて、本体で確かめます(連載の後の回で、返す形として扱います)。

冒頭の1つ目の相談が、これです。調べものを別のコンテキストに出せば、本体の会話は埋まりません。 ただし、何でも任せればよいわけではありません。どんなときに任せるかは、第2回の「使う・使わないの判断ルール」で扱います。


担当に渡るもの・渡らないもの

担当は、新しい独立したコンテキストで始まります。公式の文書は、担当は会話の履歴、すでに呼び出したスキル、Claude がすでに読んだファイルを見ない、と書いています。

渡るものは次の5つです(フォーク=fork の担当を除きます。下で触れます)。

  • 担当のシステムプロンプト:定義の本文
  • 依頼文:Claude が、仕事を渡すときに書く文
  • CLAUDE.md:本体が読み込む階層の全部(~/.claude/CLAUDE.md、プロジェクトのルール、CLAUDE.local.md、管理ポリシーのファイル、プロジェクトの指示として読み込んだ AGENTS.md)
  • git status:担当の起動時に、Claude Code がリポジトリから読み取るスナップショット
  • skills: に書いたスキル:担当の定義の skills: に名前を書いたスキルの全文

渡らないものは次の4つです。

  • 会話の履歴
  • すでに読んだファイルと、使ったスキル
  • 本体の自動メモリー(フォークだけは例外)
  • 出力スタイル:担当は自分のシステムプロンプトで動くので、出力スタイルは担当の返答を形作りません(フォークだけは例外)
担当(別のコンテキスト)に何が渡り、何が渡らないかを示した図。左の青い枠「本体」の中に「メインの会話」があり、そこから右の緑の枠「担当(別のコンテキスト)に渡るもの」へ5本の矢印が伸びる。渡るものは、システムプロンプト(定義の本文)、依頼文(Claude が書く)、CLAUDE.md、git status、skills: のスキルの5つで、それぞれ緑の丸い印が付いている。その下に「渡らないもの」として、破線の枠で「× 会話の履歴」「× 読んだファイル・使ったスキル」「× 自動メモリー」「× 出力スタイル」の4つが並ぶ。最下行の帯に「Explore・Plan は CLAUDE.md と git status も読まない」とある。
担当に渡るかもの補足
渡るシステムプロンプト(定義の本文)担当への指示になる
渡る依頼文Claude が仕事を渡すときに書く文
渡るCLAUDE.md本体が読み込む階層の全部
渡るgit status起動時のスナップショット
渡るskills: のスキル全文が起動時に入る
渡らない会話の履歴新しい独立した会話で始まる
渡らない読んだファイル・使ったスキル担当は自分で読み直す
渡らない自動メモリー本体の自動メモリーは読み込まれない
渡らない出力スタイル担当は自分のシステムプロンプトで動く

次の4点も押さえておきます。

  • 担当のコンテキストの大きさは、本体ではなく担当のモデルで決まります。 公式は、小さいウィンドウのモデルに任せれば、その担当は小さいウィンドウになる、と書いています
  • Explore と Plan は、CLAUDE.md と git status も読みません。 速く安く調べるためです(Explore と Plan は組み込みの担当です。第2回の「組み込みの担当」で扱います)。自作の担当は、既定では CLAUDE.md と git status の両方を読み込みます。自作の担当で CLAUDE.md を読ませたくないときは、定義に omitClaudeMd: true を書けます(Claude Code v2.1.271 以降。管理ポリシーのファイルは、それでも読み込まれます)。依頼文だけで足りる担当向けの設定です
  • 守らせたいルールは、頼むときに書きます。 Explore に調べものを頼むときに、CLAUDE.md のルールが前提になっているなら、依頼文に入れます(連載「Claude Code実践入門」第7回「新しい目でレビューする」にも、Explore は CLAUDE.md を読まないという注意があります)
  • 例外は fork です。 /subtask(Claude Code v2.1.212 以降)で動かす fork は、会話を丸ごと引き継ぎます。筆者の環境で担当の一覧を出させたところ、Claude は「fork を指定すると、今の会話の文脈を引き継いだ分身を起動できる」とも答えました(CLI 2.1.302、claude -p)

冒頭の2つ目の相談の、半分がここで分かります。組み込みの Explore は、CLAUDE.md を読まずに、速く安く調べる担当です。残りの半分(何が組み込みで、どんなときに動くか)は、第2回の「組み込みの担当」で扱います。


考えてみよう

  1. 最近の作業で、一度読んだだけで二度と見ないファイルや検索結果が本体の会話に残っていた場面はありましたか。それは、担当に任せて要約だけを受け取れたでしょうか
  2. 調べものを担当に頼むとき、CLAUDE.md に書いてある注意を守ってほしい場合、依頼文にどう書きますか。Explore に頼む場合と、自作の担当に頼む場合で、違いはありますか
  3. スキルにした作業(または、2回以上同じ指示を打った作業)のうち、担当に分けたいものは何ですか。調べる・作る・確かめるのどれにあたりますか

ヒント:1は「会話が埋まる問題と、別のコンテキスト」、2・3は「担当に渡るもの・渡らないもの」の節を見直してください。


まとめ

  • サブエージェントは、別のコンテキストで動き、要約だけを返す担当。調べものが本体の会話を埋める問題を避けられる
  • 引き換えに、担当がどう結論に至ったかは見えない。重要な結論は、出典を求めて本体で確かめる
  • 担当に渡るのは、システムプロンプト(定義の本文)・依頼文・CLAUDE.md・git status・skills: のスキル。渡らないのは、会話の履歴・読んだファイル・使ったスキル・自動メモリー・出力スタイル
  • 担当のコンテキストの大きさは、担当のモデルで決まる
  • Explore と Plan は、CLAUDE.md と git status も読まない。守らせたいルールは、頼むときに書く。例外の fork は、会話を丸ごと引き継ぐ
  • 公式の教材は、Academy の「サブエージェント入門」レッスン1・3・4と、「Claude Codeを実践する」レッスン9(レッスン2は任意)

次回は、組み込みの担当(Explore・Plan・general-purpose など)、CLAUDE.md・スキル・フックとの使い分け、使う・使わないの判断、担当の定義の置き場所を扱います。


連載「Claude Codeサブエージェント入門」全13回

全回の目次と、読む順番・目的別の読み方は、Claude Codeサブエージェント入門の入口のページにまとめています。

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

コメント

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