「調べものを頼むたびに会話が長くなって、最初に伝えたルールを守らなくなってきました」
「サブエージェントという言葉は聞くのですが、何がサブなのか、どう作ればいいのか分かりません」
Claude Codeのサブエージェントは、調べものやレビューのような作業を、別のコンテキストで動く担当に任せ、要約だけを本体に返してもらう仕組みです。会話が埋まるのを避けられるうえ、担当ごとに使うモデルや道具を決められます。一方で、担当に何が渡り、何が渡らないのか、どのモデルで動くのか、費用はどうなるのかを知らずに使うと、思わぬ結果になりがちです。
連載「Claude Codeサブエージェント入門」は、担当の仕組みから、定義の書き方、モデルとeffortの決まり方、スキルからの呼び方、ログの要約とレビュー、費用の測り方までを順に説明し、最後は練習用のリポジトリで手を動かして確かめるところまでを扱う全13回の連載です。このページは、その入口として、各回の内容と読む順番をまとめています。

この連載で分かること
- 担当の仕組み:別のコンテキストで動き要約だけを返すこと、担当に渡るもの・渡らないもの、組み込みの担当(Explore・Plan・general-purpose など)と、CLAUDE.md・スキル・フックとの使い分け
- 定義の書き方:
.claude/agents/に置く Markdown の形、nameとdescription、toolsで道具を絞る書き方、返す形と障害の報告 - モデルとeffort:
modelに書ける値と決まる順番、別名と完全なIDの違い、担当ごとのeffort、どのモデルで動いたかの確かめ方 - スキルとの組み合わせ:担当の
skills:とスキルのcontext: fork、担当の呼び方、スキルに「誰に頼むか」を書く決まり、順に使うときの条件と、前・裏の違い - レビューと費用:失敗を隠さないログの要約、新しい目で見るレビュー担当、3役のひな形、使用量の枠と
/usageの見方、小さく使う工夫 - 演習:練習用のリポジトリに3つの担当を置き、一覧・呼び出し・モデルの確認・レビュー・スキルからの受け渡し・使った量を試し、4D で振り返る
数値や仕様は、2026年10月時点の情報に合わせています。Claude Code の機能・画面・版は変わりやすいので、記事の中に確かめた日付や版を添えています。
こんな人に向いています
- Claude Code に調べものやレビューを任せていて、会話が長くなって困っている人
- スキルの次の段階として、担当(サブエージェント)の作り方と使い分けを整理したい人
- 担当ごとにモデルや effort を決めたい人、使用量や費用を抑えたい人
- チームで、調査・作成・レビューの担当の定義を共有して運用したい人
学ぶ順番
全13回を、4つのまとまりに分けています。初めての人は第1回から順に読むのがおすすめです。1回の記事は12分前後で読めます(全部で約2時間40分)。演習の3回は、手元の環境で手を動かす回です。
担当とは何かと、定義の書き方(第1〜4回)
- 第1回 サブエージェントとは
調べものが会話を埋める問題、別のコンテキストで動き要約だけを返す仕組み、担当に渡るもの・渡らないもの、Explore・PlanがCLAUDE.mdを読まないこと、公式の教材。 - 第2回 組み込みの担当と使い分け
組み込みの担当(Explore・Plan・general-purposeなど)、CLAUDE.md・スキル・フックとの使い分け、「中間作業は要るか」の判断、担当の置き場所と優先順位。 - 第3回 担当を定義する(2026年11月16日公開予定)
.claude/agents/ のMarkdownという定義ファイルの形、Claudeに頼むか手で書くか、フィールドの一覧、「いつ任せるか」を伝えるdescriptionの書き方。 - 第4回 toolsと返す形(2026年11月17日公開予定)
toolsで道具を絞る書き方、Bashの一部だけ止めるdeny、返す形と「遭遇した障害」の欄、定義が反映されるタイミングと読み込まれない定義の点検。
モデルを決めて、スキルから呼ぶ(第5〜8回)
- 第5回 担当のモデルの決まり方(2026年11月17日公開予定)
modelに書ける値、決まる順番、haikuが版で指す先が変わる理由、別名か完全なIDか、組織の許可リスト(availableModels)による置き換え。 - 第6回 役割とモデル・effort(2026年11月18日公開予定)
担当ごとのeffortの優先順位、公式の推奨と筆者の例の役割分け、Haiku 5.5の注意、Exploreの上書き、/tasksでどのモデルで動いたかを確かめる方法。 - 第7回 スキルから担当を呼ぶ(2026年11月18日公開予定)
担当のskills:とスキルのcontext: fork+agent:の違い、担当の呼び方、スキルに「誰に頼むか」を書く5つの決まり、筆者の資料づくりの分担の例。 - 第8回 順に使う・前と裏(2026年11月19日公開予定)
担当を順に使う4つの条件、前と裏で動く既定と公式の文書の今の記述、担当の変更が巻き戻しで戻らないこと、調べものとAnsibleの例。
レビューと費用(第9〜10回)
- 第9回 ログの要約とレビューの担当(2026年11月19日公開予定)
失敗を隠さない要約の返す形、経緯を知らない目でレビューする担当、調べる・作る・確かめる3役のひな形、チームで使うなら決めておくこと。 - 第10回 費用を測って小さく使う(2026年11月20日公開予定)
担当も同じ使用量の枠に数えられること、API定価と筆者の費用の例、/usageの内訳の見方、小さく使う工夫、連載の早見表。
手を動かして確かめる演習(第11〜13回)
- 第11回 演習(前編):準備(2026年11月20日公開予定)
練習用リポジトリに3つの担当を置く準備、準備プロンプトの全文、モデルとモードの設定、筆者の記録(Codeタブ・CLI・-p)の読み方。 - 第12回 演習(中編):読み込む・呼ぶ・モデルを見る(2026年11月21日公開予定)
担当の一覧、@や名前での呼び出し、/tasksでのモデルの確認、Exploreのモデルの上書き、筆者の環境(Claude Code 2.1.302)での結果。 - 第13回 演習(後編):レビュー・スキル・費用(2026年11月21日公開予定)
作成担当に直させてレビュー担当に見せる、スキルの最後で担当に渡す、使った量を測る、4Dでの振り返り、自己点検、持ち帰りの3点、連載の結び。
目的別の読み方
全部を読む時間が無いときは、困っていることに近い回から読んでください。
| 困っていること・知りたいこと | まず読む回 |
|---|---|
| 調べものをすると会話が埋まる・サブエージェントが何か分からない | 第1回 → 第2回 |
| 自分で担当を作りたい(ファイルの形、description、tools) | 第3回 → 第4回 |
担当のモデルや effort を決めたい・haiku がどのモデルになるのか知りたい | 第5回 → 第6回 |
| スキルから担当を呼びたい・担当を順に使いたい | 第7回 → 第8回 |
| ログの要約やレビューを担当に任せたい | 第9回 |
| 担当を使うと使用量や費用がどうなるのか知りたい | 第10回 |
| 練習用のリポジトリで手を動かして確かめたい | 第11回 → 第12回 → 第13回 |
あわせて読みたい連載
この連載は、Claude Code の使い方の連載の続きの位置づけです。前提になる話題を、次の連載で扱っています。
- 連載「Claude Codeスキル入門」:繰り返す手順をスキルにする方法を解説しています。この連載の演習で担当の受け渡し先に使う検証スキル
ansible-verifyは、第6回・第7回で作ります - 連載「Claude Code実践入門」:作業範囲・操縦・CLAUDE.md・権限・検証を扱っています。第7回に「新しい目でレビューする」節があり、担当の編集が巻き戻しで戻らないことは第3回にも書いてあります
- 連載「Claude活用入門」:Claude 全体の使い方の連載です。モデルと Effort の選び方は第3回で解説しています
よくある質問
前提の知識はどのくらい必要ですか?
Claude Code を使ったことがあれば読み進められます。この連載はスキル入門の続きの位置づけで、第1回におさらいを載せています。個人の Pro・Max のプランを前提に、Claude のデスクトップアプリの Code タブの操作を主に書き、ターミナルで使う CLI の操作は「CLI では」と添えています。
どの回から読めばいいですか?
初めての人は第1回から順に読んでください。第1〜2回で担当の仕組みと使い分けをつかむと、後の回が理解しやすくなります。演習(第11〜13回)は、練習用のリポジトリを使って手を動かす回なので、説明の回を読んだあとに進めるのがおすすめです。特定の困りごとがある人は、上の「目的別の読み方」から読み始めても構いません。
内容はいつの時点の情報ですか?
数値や仕様は2026年10月時点の情報に合わせています。筆者の環境で確かめた版は、Claude Code 2.1.302 と 2.1.289 です。たとえば haiku の別名が指すモデルは版で変わるなど、Claude Code の機能は変わりやすいため、記事の中で確かめた日付や版を添えています。この連載は、公式の文書を読んで筆者が整理したもので、Anthropic の公式の文書ではありません。使うときは公式の文書で確かめてください。