並列サブエージェントとは

Claude Codeには、メインのエージェントから複数のサブエージェントを並列で起動できる機能があります。これを活用すると、1つのタスクを複数の専門エージェントに同時に処理させ、結果を統合することができます。

特にコードレビューでは、セキュリティ・パフォーマンス・型安全性・テストカバレッジなど、異なる観点のレビューを同時並行で実行できるため、品質とスピードを両立できます。

出典: HAMY Blog — Claude Code Sub-Agents、Tim Dietrich — AI Agent Teams

9つの専門サブエージェントの設計

コードレビューを9つの専門分野に分割し、それぞれにサブエージェントを割り当てます。

エージェント構成

| # | エージェント名 | 担当分野 | チェック内容 | |---|--------------|---------|-------------| | 1 | SecurityAgent | セキュリティ | SQLインジェクション、XSS、認証バイパス、機密情報の露出 | | 2 | PerformanceAgent | パフォーマンス | N+1クエリ、メモリリーク、不要な再レンダリング | | 3 | TypeSafetyAgent | 型安全性 | any型の使用、型アサーション、null安全性 | | 4 | TestCoverageAgent | テストカバレッジ | テスト不足のロジック、エッジケースの網羅性 | | 5 | ErrorHandlingAgent | エラーハンドリング | 未捕捉例外、不適切なcatch、エラーメッセージの品質 | | 6 | APIDesignAgent | API設計 | REST規約、レスポンス形式、バージョニング | | 7 | AccessibilityAgent | アクセシビリティ | ARIA属性、キーボード操作、色コントラスト | | 8 | DependencyAgent | 依存関係 | 脆弱なパッケージ、不要な依存、バージョン整合性 | | 9 | StyleGuideAgent | コード規約 | 命名規則、ファイル構成、コメント品質 |

実装方法

CLAUDE.mdでのサブエージェント定義

プロジェクトのCLAUDE.mdに、レビュー用サブエージェントの構成を定義します。

# コードレビュー サブエージェント設定

## レビューコマンド
`/review-all` を実行した場合、以下の9つのサブエージェントを並列起動してください。

### 各エージェントの指示
1. SecurityAgent: 変更ファイルのセキュリティ脆弱性をOWASP Top 10に基づきチェック
2. PerformanceAgent: O(n²)以上のループ、N+1クエリ、メモリリークの可能性をチェック
3. TypeSafetyAgent: any型、型アサーション(as)、非nullアサーション(!)の使用をチェック
4. TestCoverageAgent: 変更されたロジックに対応するテストの有無をチェック
5. ErrorHandlingAgent: try-catchの適切さ、エラーの握りつぶし、ユーザー向けエラーメッセージをチェック
6. APIDesignAgent: REST規約準拠、レスポンス形式の一貫性をチェック
7. AccessibilityAgent: ARIA属性、セマンティックHTML、キーボード操作をチェック
8. DependencyAgent: 新規追加パッケージの安全性、ライセンス互換性をチェック
9. StyleGuideAgent: 命名規則、ファイル構成、インポート順序をチェック

## 結果の統合
全サブエージェントの結果を以下の形式で統合してください：
- 🔴 Critical: 必ず修正が必要
- 🟡 Warning: 修正を推奨
- 🟢 Info: 参考情報

CLIからの実行

# PRに対して並列レビューを実行
claude "PR #123 に対して9つのサブエージェントで並列コードレビューを実行してください"

# 特定ファイルに対してレビュー
claude "src/api/users.ts を9つの観点で並列レビューしてください"

並列実行 vs 逐次実行の速度比較

9つの観点でレビューを行う場合の処理時間を比較します。

| 実行方式 | 処理時間 | コスト | レビュー品質 | |---------|---------|-------|------------| | 逐次実行（9観点を1エージェントで） | 約15〜20分 | 低い | 後半で集中力低下のリスク | | 並列実行（9サブエージェント） | 約3〜5分 | 中程度 | 各エージェントが専門分野に集中 | | 人間によるレビュー | 30〜60分 | 高い（人件費） | 品質にバラつきあり |

並列実行は逐次実行に比べて3〜5倍高速で、かつ各エージェントが専門分野に集中するため品質も向上します。

Agent Teams vs Sub-Agents パターン

Claude Codeには、複数エージェントを活用する2つのパターンがあります。

Agent Teamsパターン

複数の独立したClaude Codeインスタンスが、それぞれ異なるタスクを担当して並行作業するパターンです。

# ターミナル1: フロントエンド担当エージェント
claude "UserDashboardコンポーネントを実装してください"

# ターミナル2: バックエンド担当エージェント
claude "Dashboard用のAPIエンドポイントを実装してください"

# ターミナル3: テスト担当エージェント
claude "UserDashboardのE2Eテストを実装してください"

Sub-Agentsパターン

1つのメインエージェントが複数のサブエージェントにタスクを委任するパターンです。

# メインエージェントに指示
claude "以下のタスクを並列サブエージェントに分割して実行してください:
1. セキュリティレビュー
2. パフォーマンスレビュー
3. テストカバレッジ分析"

パターンの使い分け

| 比較項目 | Agent Teams | Sub-Agents | |---------|-------------|------------| | 制御方式 | 手動（複数ターミナル） | 自動（メインエージェントが制御） | | 適切な規模 | 大規模（機能単位の分割） | 中規模（観点単位の分割） | | コンテキスト共有 | Git経由で間接的 | メインエージェント経由 | | 結果の統合 | 手動でマージ | 自動で統合レポート | | 最適な用途 | 並行機能開発 | レビュー・分析・テスト生成 |

実践的なワークフロー例

ワークフロー1: PR作成前の自動レビュー

# 1. 変更内容の確認
git diff --stat

# 2. 9つのサブエージェントで並列レビュー
claude "現在の変更に対して並列サブエージェントレビューを実行し、
CriticalとWarningの指摘があれば修正してください"

# 3. 修正後にPR作成
claude "レビュー指摘の修正が完了したらPRを作成してください"

ワークフロー2: 定期的なコードベース監査

claude "src/ ディレクトリ全体に対して以下の並列監査を実行してください:
- SecurityAgent: 脆弱性スキャン
- PerformanceAgent: ボトルネック検出
- DependencyAgent: 依存関係の脆弱性チェック
結果をmarkdownレポートにまとめてください"

サブエージェントの出力例

9つのサブエージェントが出力するレビュー結果の統合例です。

# 並列コードレビュー結果

## 🔴 Critical (2件)
1. [SecurityAgent] src/api/users.ts:45 — SQLインジェクションの脆弱性
   ユーザー入力が直接クエリに渡されています
2. [ErrorHandlingAgent] src/services/payment.ts:78 — 例外の握りつぶし
   catch ブロックが空で、決済エラーが検知されません

## 🟡 Warning (5件)
1. [PerformanceAgent] src/components/UserList.tsx:23 — 不要な再レンダリング
2. [TypeSafetyAgent] src/utils/helpers.ts:12 — any型の使用 (3箇所)
3. [TestCoverageAgent] src/services/payment.ts — テスト未作成
4. [APIDesignAgent] src/api/users.ts — レスポンス形式が統一されていない
5. [AccessibilityAgent] src/components/Modal.tsx — aria-label未設定

## 🟢 Info (3件)
1. [DependencyAgent] lodash 4.17.20 → 4.17.21への更新を推奨
2. [StyleGuideAgent] インポート順序が規約と異なるファイルが2つ
3. [TypeSafetyAgent] 型推論で十分な箇所に明示的な型注釈あり

コスト最適化のコツ

並列サブエージェントはコストがかかるため、以下の工夫で最適化しましょう。

| 最適化方法 | 効果 | 実装難易度 | |-----------|------|-----------| | 変更ファイルのみをレビュー対象にする | コスト50%削減 | 低い | | Critical観点のみ並列化（3〜4エージェント） | コスト50〜60%削減 | 低い | | PR規模に応じてエージェント数を動的に変更 | コスト30%削減 | 中程度 | | キャッシュ活用（同一ファイルの再レビュー防止） | コスト20%削減 | 中程度 | | Maxプランの定額制を活用 | コスト予測可能に | 低い |

まとめ

9つの並列サブエージェントによるコードレビューは、Claude Codeの並列処理能力を最大限に活かした高度な活用法です。各エージェントが専門分野に集中することでレビュー品質が向上し、並列実行により速度も3〜5倍に向上します。

まずは3つ程度のエージェント（セキュリティ、パフォーマンス、テストカバレッジ）から始め、効果を確認しながら徐々にエージェント数を増やしていくのがおすすめです。

出典: HAMY Blog — Claude Code Sub-Agents and Agent Teams、Tim Dietrich — Building AI Agent Teams