サブエージェントとAgent Teams - Claude Code並列処理ガイド

この記事はこうして作られた

🔥 リアルタイム実例！

このサイトの複数ページは、まさにサブエージェントの並列実行で作成されました。
以下の4つのリサーチエージェントが同時に調査を行いました：

メインエージェント（指揮官）

↓ 4つの調査を同時に指示 ↓

セッション管理
調査エージェント

Claude Code歴史
調査エージェント

全機能リサーチ
エージェント

サイト構造
調査エージェント

↓ 結果を統合 ↓

メインエージェントが6ページを作成

メインエージェント（私）が4つのサブエージェントをバックグラウンドで並列起動し、それぞれが独立してWebで調査を実行。結果が返ってきた順に統合して、このページを含む複数ファイルを作成しました。

サブエージェントとは？

Claude CodeのTask toolを使うと、メインのエージェントが独立した子エージェント（サブエージェント）を起動できます。

💡 サブエージェントの特徴

独立したコンテキスト：メインと別のコンテキストウィンドウを持つ
並列実行可能：複数のサブエージェントを同時に走らせられる
バックグラウンド実行：裏で作業しながらメインは別の作業を続行
結果の統合：完了時にメインエージェントに結果を返す

組み込みエージェントタイプ

タイプ	用途	利用可能ツール
`general-purpose`	汎用的なタスク実行	全ツール
`Explore`	コードベース探索・リサーチ	読み取り系のみ（編集不可）
`Plan`	設計・計画の立案	読み取り系のみ（編集不可）

カスタムエージェントの定義

.claude/agents/にMarkdownファイルを置くことで、独自のエージェントを定義できます。

                            
                                # .claude/agents/security-reviewer.md

                                ---

                                name: security-reviewer

                                description: セキュリティの観点からコードをレビューする

                                allowed-tools: Read, Grep, Glob

                                model: opus

                                ---

                                あなたはセキュリティの専門家です。

                                以下の観点でコードをレビューしてください：

                                - SQLインジェクション

                                - XSS（クロスサイトスクリプティング）

                                - 認証・認可の問題

                                - 機密情報の漏洩

サブエージェント vs Agent Teams

Claude Codeには2つのマルチエージェントシステムがあります。

特徴	サブエージェント（Task tool）	Agent Teams
構造	メイン → サブ（1対多）	リード + チームメイト（協調）
通信	結果をメインに返すだけ	メンバー間で直接通信可能
適用場面	調査、分析など独立タスク	共同開発、複雑な協調作業
コンテキスト	各サブは独立、共有なし	発見を共有、協調可能
ワークツリー	isolation: "worktree" で隔離可	チームメイトごとに隔離
安定性	安定版	リサーチプレビュー

Agent Teams の仕組み

チームリード（Team Lead）

タスク割り当て ↙ ↓ ↘ レビュー&フィードバック

チームメイトA
フロントエンド担当

チームメイトB
バックエンド担当

チームメイトC
テスト担当

← メンバー間で発見を共有 →
← 互いにチャレンジ&レビュー →

💡 使い分けのコツ

サブエージェント：「調べてきて」「このファイルを分析して」→ 結果を報告して終わり
Agent Teams：「フロントとバックを同時に開発して」→ 互いに調整しながら進める

実践的な使い方

1. 並列リサーチ

複数の調査を同時に走らせて、結果を統合する。

                            
                                # Claude Codeに指示する例

                                「以下の3つを並行して調べて：

                                1. 認証ライブラリの比較

                                2. 既存コードの認証部分の分析

                                3. テストカバレッジの現状確認」

2. バックグラウンド実行

長い処理を裏で実行しながら、別の作業を続行。

                            
                                # エージェントはバックグラウンドで動作

                                # メインは別の質問に答えたり、別の作業が可能

                                # 完了すると自動的に通知される

                                「テストスイートを全部実行して結果をまとめて（バックグラウンドで）」

3. Worktree隔離

エージェントごとに隔離されたgit worktreeで作業させる。

                            
                                # サブエージェントの定義で isolation: "worktree" を指定

                                # 各エージェントが別々のブランチで安全に作業

                                # マージコンフリクトのリスクなし

4. Planモードでの活用

エージェントに計画を立てさせてからレビュー。

                            
                                「この機能の実装計画を立てて」

                                # → Planエージェントが計画を策定

                                # → 計画を確認してから実装に進む

                                # → Shift+Tab でプランモード切り替え

⚠️ 並列実行の注意点

サブエージェントは独立したコンテキストで動くため、メインの会話を知らない
同じファイルを複数エージェントが同時に編集するとコンフリクトの可能性
トークン消費量は各エージェントごとにカウントされる
Agent Teamsはリサーチプレビュー段階であり、安定性に注意

まとめ

🤖 サブエージェント

独立した子エージェントを並列起動。調査・分析に最適。

👥 Agent Teams

チームで協調作業。互いに通信・レビュー可能。

⚡ 並列処理

バックグラウンド実行+Worktree隔離で安全に高速化。

🤖👥⚡

Many agents, one mission!