7つのサブエージェントを同時に起動して、CLAUDE.mdの設定を何も考えずに放り込んだら1日で$50飛んだ。

コンテキスト爆発、エージェント同士のコンフリクト、無限ループ、全部踏んだ。

そこから3ヶ月かけて、コストを70%削減しながら5人分の並列開発を回せるCLAUDE.md設定に辿り着いた。

この記事では、12のパターンと5つのプロジェクト別テンプレートを出す。

基本7パターンで土台を作り、上級5パターンでエラー制御・CI連携・セキュリティまでカバーする。

さらにReact SPA、Rails、ML、モバイル、マイクロサービスの5プロジェクト別テンプレートと、実案件ケーススタディ3本、トラブルシュート完全ガイドまで付けた。

全部コピペで使えるCLAUDE.mdテンプレート付きだ。

3つの方式、実務で使うのは95%がSubagents

Claude Codeのマルチエージェント機能には3種類ある。

Task tool は1つのサブエージェントだけを起動するやつで、調査タスクとか単発の小さい作業向き。

「このエラーログを解析して」みたいな依頼に使う。

Subagents は複数のサブエージェントを並列で起動できて、中規模開発で一番使う。

PM、Architect、Implementerを同時に動かして3段階パイプラインを組むイメージ。

Agent Teams はエージェント同士が連携して動く大規模プロジェクト向けだけど、experimental扱いでコストが7倍かかるから、正直10人月以上の案件じゃないと元が取れない。

実務では95%がSubagentsで事足りるので、この記事でもSubagents中心でいく。

【パターン1】調査特化パイプライン — 3並列で巨大リポジトリを制圧

巨大なリポジトリを調査するとき、1エージェントだと時間がかかりすぎて、100ファイルあるディレクトリを1つずつ見ていたら日が暮れる。

そこでExplore agentを3並列で起動して、ディレクトリを分割調査させる。

リファクタ前の影響範囲調査とか、初めて触るコードベースの把握に使える。

CLAUDE.md設定テンプレート

# 調査特化パイプライン

## Subagents設定

### Explore-A
- 対象: `src/models/`, `src/services/`
- タスク: ActiveRecordモデルの依存関係を調査
- 出力: `investigation/models.md`

### Explore-B
- 対象: `src/controllers/`, `src/views/`
- タスク: コントローラとビューの対応関係を調査
- 出力: `investigation/controllers.md`

### Explore-C
- 対象: `lib/`, `config/`
- タスク: 外部ライブラリと設定ファイルの使われ方を調査
- 出力: `investigation/libs.md`

## 起動条件

ユーザーが「リポジトリ全体を調査して」と依頼したら、上記3エージェントを並列起動する。
各エージェントの調査結果を統合して最終レポートを作成する。

実装例

100ファイルあるRailsアプリで「決済機能に影響する範囲を全部洗い出せ」という依頼が来て、単一エージェントだと推定3時間かかるところ、3並列にしたら38分で終わった。

コストは単一調査の約1.2倍かかるけど（コンテキストの重複があるから）、3倍速で終わるなら時間単価で考えれば圧倒的に安い。

ただし調査範囲を事前に明確にしないとダメで、曖昧な指示だとエージェント間で調査が重複して無駄が出る。

ディレクトリ単位で分割するのが一番シンプルで確実。