Claude Codeサブエージェントの使い方|AIに開発を分担させる方法
Claude Codeのサブエージェント機能を使って、AIに開発作業を分担させる方法を実例つきで解説。.claude/agents/ の書き方、使いどころ、コンテキストとコストを節約するコツまで、2026年7月最新の仕様で整理します。
目次
「AIにコードを書かせる」の次のステップは、「AIに”チーム”を組ませる」です。Claude Codeのサブエージェントを使うと、1つの作業を複数の専門エージェントに分担させられます。
結論から言うと、サブエージェントは「難しい機能」ではありません。Markdownファイルを1枚置くだけで、“専門担当のAI”を増やせる——それが本質です。この記事では、仕組み・作り方・使いどころを、2026年7月時点の仕様で整理します。
なお、OpenAIのGPT-5.6でも「Ultra mode」でサブエージェントを並列に動かす仕組みが搭載されるなど、AI各社が”エージェントを分担させる”方向に動いています。この考え方を押さえておくと、今後のAI開発全体が見通しやすくなります。
まず結論(TL;DR)
- サブエージェントは「独立したコンテキスト・専用の指示・限定ツール権限を持つ専門AI」
- 作り方は
.claude/agents/にMarkdownファイルを1枚置くだけ - 効果は3つ:①本筋の会話を汚さない ②ツール権限を絞れる ③安いモデルに単純作業を回せる
- Claude Codeが、説明文(description)に合った作業を自動で担当エージェントに委任する
- 実例では28体のサブエージェントで役割分担し、個人でSaaSを短期リリースした報告もある
1. サブエージェントとは?何が便利なのか
結論:メインの会話を汚さずに、特定の作業を”専門担当”に丸投げできる仕組みです。
Claude Codeでコードを書いていると、こんな経験はありませんか。「バグ調査でログを大量に読み込ませたら、会話がログで埋まって本題を見失った」——これがサブエージェントで解決します。
サブエージェントは、それぞれが独立したコンテキストウィンドウ(作業メモリ)を持ちます。調査やログ確認のような重い作業をサブエージェントにやらせると、その作業は別のメモリ空間で完結し、メインの会話には結論だけが返ってきます(Claude Code公式ドキュメント)。
メイン担当とサブエージェントの違いを整理します。
| 項目 | メインのClaude | サブエージェント |
|---|---|---|
| コンテキスト | 会話全体を保持 | 作業ごとに独立 |
| 指示(プロンプト) | その場で伝える | ファイルに固定して専門化 |
| ツール権限 | 基本すべて | 必要なものだけに限定できる |
| モデル | 選択したもの | エージェントごとに指定可(安いモデルも可) |
| 使い回し | その会話限り | 複数プロジェクトで再利用 |
つまりサブエージェントは、「役割・権限・使うモデルを固定した、再利用できる専門担当」だと考えると分かりやすいです。
2. サブエージェントの作り方は?(4ステップ)
結論:フォルダを1つ作り、Markdownファイルを置くだけ。10分あれば最初の1体ができます。
作り方は驚くほどシンプルです。
- プロジェクトに
.claude/agents/フォルダを作る(自分専用なら~/.claude/agents/) - エージェント名のMarkdownファイルを作り、frontmatterに name / description / tools / model を書く
- 本文に、そのエージェント専用の指示(システムプロンプト)を書く
- 通常の会話で作業を頼むと、Claude Codeが説明文(description)に合った作業を自動で委任する
実際のファイルはこんな形です(コードレビュー専門エージェントの例)。
---
name: code-reviewer
description: 変更されたコードのバグ・セキュリティ問題・可読性をレビューする専門エージェント。コミット前のチェックに使う。
tools: Read, Grep, Bash
model: sonnet
---
あなたはコードレビュー専門のエージェントです。
変更されたコードを読み、次の観点で指摘してください:
- バグ・ロジックの誤り
- セキュリティ上の問題(入力検証・秘密情報の混入など)
- 可読性・命名の改善余地
指摘は「深刻度(高/中/低)」を付けて、修正案とセットで返してください。
ポイントは**description(説明文)**です。ここに「いつ使うエージェントか」を具体的に書くほど、Claude Codeが適切なタイミングで自動的に呼び出してくれます。逆に説明が曖昧だと、うまく委任されません。
💡 正直な本音 最初は「レビュー担当」1体だけで十分です。いきなり何体も作ると管理しきれません。まず1体を運用して「これは便利だ」と実感してから増やすのが、挫折しないコツです。
3. どんなときに使うと効くのか?
結論:「会話が長くなる作業」「権限を絞りたい作業」「安いモデルで足りる作業」の3つが狙い目です。
公式が挙げる使いどころを、実務の言葉に翻訳するとこうなります。
- ✅ 探索・調査で会話が膨らむとき:コードベース全体の検索、ログ解析などを別メモリに追い出せる
- ✅ ツール権限を絞りたいとき:例えばレビュー担当には「読む・検索」だけ許可し、ファイル書き換えはさせない
- ✅ コストを下げたいとき:単純な整形・分類は安いモデル(Haikuなど)に回し、難しい設計だけ上位モデルに任せる
- ✅ 設定を使い回したいとき:
~/.claude/agents/に置けば、全プロジェクトで同じ専門担当を呼べる
逆に、一度きりの単純な依頼なら、わざわざエージェントを作らずメインのClaudeに直接頼むほうが速いです。何でもエージェント化すればいい、というものではありません。
4. 実例:サブエージェントで「開発チーム」を組む
結論:役割分担させると、個人でもチーム開発に近い進め方ができます。ただし並列数だけ増やせばいいわけではありません。
国内の開発者コミュニティ(ZENN)では、28体のサブエージェントで”開発チーム”を編成し、1人でSaaSを短期間でリリースした構成が共有されています(設計・実装・レビュー・テストなどを役割ごとに分担)。「無人運転」と呼ばれる、設定を作り込んで自律的に走らせる運用ノウハウも出てきています。
こうした事例が示すのは、サブエージェントの価値が「1体の賢さ」より「役割分担の設計」にあるということです。人間のチームと同じで、誰が何を担当し、どこで結果を合流させるかを決めるほど、成果が安定します。
ただし注意点もあります。
⚠️ ここは気をつけて 自律エージェントに広い権限(ファイル書き換え・コマンド実行)を与えたまま放置するのは危険です。意図しない変更や、外部からの指示混入(プロンプトインジェクション)のリスクがあります。権限は最小限にし、重要な操作は人間が確認する運用にしてください。詳しくはAIコーディング補助のセキュリティリスクで解説しています。
あなたへの影響
「サブエージェント、便利そうだけど自分に必要?」と思ったかもしれません。タイプ別に整理します。
① Claude Codeを使い始めたばかりの人へ まだ無理に使う必要はありません。まずはClaude Codeの基本に慣れて、「調査でログが会話を埋める」「同じレビュー指示を毎回打つのが面倒」と感じ始めたら、そのタイミングで1体作ってみてください。
② すでに毎日Claude Codeを使っている人へ 効果が大きいのはあなたです。「レビュー担当」「テスト担当」を分けるだけで、メインの会話がすっきりし、指示の打ち直しも減ります。さらに単純作業を安いモデルに回せば、月の利用量(コスト)も下がります。
③ チームや副業で開発している人へ 役割分担の設計をテンプレ化しておくと、案件が変わっても同じ”チーム編成”を使い回せます。属人化しがちな「レビュー観点」「命名ルール」をエージェントに固定できるのは、地味に大きなメリットです。
エージェントを”常時稼働”させたい人へ
サブエージェントを使い込むと、次に来るのが「ノートPCを閉じても動かし続けたい」という要望です。手元のMacやWindowsは、スリープやシャットダウンで処理が止まります。長時間の自律実行や、決まった時間の自動処理を安定して回したいなら、常時起動できる環境が向きます。
💡 常時稼働環境が必要になったら ConoHa VPS お申込み(PR) — root権限つきで、AI開発・LLMのセルフホスト・エージェントの常時稼働に使える国内VPS。まずは小さいプランで試して、必要になったら増強するのが無理のない始め方です。
※これは「必須」ではありません。まずは手元のPCで十分。長時間の無人運転を本格的に組むようになってから検討すれば大丈夫です。
まとめ
Claude Codeのサブエージェントは、「AIに1人で全部やらせる」から「AIに役割分担させる」への入り口です。作り方はMarkdownファイル1枚。まずはレビュー担当を1体作り、会話がすっきりする感覚を確かめてください。そこから、テスト担当・調査担当と増やしていけば、あなただけの”開発チーム”が育ちます。
大事なのは体の数ではなく、役割と権限の設計です。そして権限は最小限に——ここだけは、便利さと引き換えにしないでください。
関連記事
- Claude Codeの使い方完全ガイド2026
- Claudeの使い方完全ガイド2026
- Claude Code 効率化テクニック15選
- Claude Code 便利なコマンド10選
- Claude Code モデル選択の考え方(Opus/Sonnet/Haiku/Fable)
参考にしたソース
- Create custom subagents(Claude Code公式ドキュメント) — サブエージェントの定義方法・スコープ・ツール権限
- Claude Code Subagents: A Practical 2026 Guide(Nimbalyst) — 実務での使いどころ
- Claude Code multiple agent systems: Complete 2026 guide(eesel AI) — 複数エージェントの運用
- Claude Code Subagents: The Complete 2026 Guide to Agent Teams(skills-hub) — 役割分担の設計
- Claude Code Guide 2026: 25 Features(MarkTechPost) — 機能全体の中でのサブエージェントの位置づけ
ーー Synth
ヘッダー画像: Photo by Daniil Komov on Pexels