Claude Code サブエージェント活用パターン10選

Claude Code の サブエージェント 機能を使うと、メインの会話とは別のコンテキストで独立したタスクを実行できます。本記事では、実務で役立つ10個のパターンを紹介します。

サブエージェントとは

サブエージェントは、メイン会話のコンテキストを汚染せずに、独立したタスクを実行できる仕組みです。長いリサーチや大量のファイル探索を任せることで、メインのコンテキストを節約できます。

パターン1: 並列リサーチ

複数のディレクトリを同時に調査するパターンです。

3つのサブエージェントを並列で起動して、以下を調査してください:
1. src/components/ のコンポーネント一覧
2. src/pages/ のルーティング構造
3. src/lib/ のユーティリティ関数

メインのコンテキストには各エージェントの要約だけが返ってくるので、トークンを大幅に節約できます。

パターン2: 大規模ファイル探索

巨大なログファイルやコードベースの調査をサブエージェントに任せます。

production.log を調査して、過去24時間のエラー発生パターンと
頻度を集計してください。サブエージェントを使って実行してください。

数万行のログでもメインのコンテキストには要約だけが返ります。詳細は Claude Code Hooks 活用法 も参考になります。

パターン3: テスト実行と結果分析

テストスイート全体を走らせて、失敗したものだけを抽出するパターン。

npm test を実行し、失敗したテストの原因を分析してください。
出力が長くなるので、サブエージェントで実行してから要約を返してください。

パターン4: コードレビューの並列化

複数のファイルを同時にレビューします。

以下3つのファイルを、それぞれサブエージェントで並列レビューしてください:
- src/auth/login.ts
- src/auth/logout.ts
- src/auth/refresh.ts

各レビューは「セキュリティ・パフォーマンス・可読性」の3観点で評価してください。

パターン5: ドキュメント生成

API ドキュメントなど大量の生成タスクをサブエージェントに任せます。

src/api/ 以下のすべてのエンドポイントを調査して、
OpenAPI 形式のドキュメントを生成してください。

パターン6: マイグレーション計画

レガシーコードの調査と移行計画を作るパターンです。

旧バージョンの認証システム（src/legacy/auth/）を調査して、
新システム（src/auth/）への移行計画を立ててください。
影響を受けるファイル一覧と作業手順を出してください。

パターン7: 依存関係の調査

package.json のすべての依存パッケージを調べて、最新版や脆弱性を確認します。

// メインで指示
const prompt = `
package.json の依存パッケージを調査してください:
1. それぞれの最新バージョンを確認
2. 既知の脆弱性をチェック
3. アップデート推奨度を High/Medium/Low で評価

サブエージェントを使って効率的に調査してください。
`;

パターン8: マルチファイル編集の準備

大規模リファクタリングの前に、影響範囲を調べるパターンです。

useState を useReducer にリファクタリングしたい。
プロジェクト全体で useState を使っているコンポーネントを
リストアップして、それぞれの複雑度（state数、更新パターン数）を
評価してください。

CLAUDE.md ベストプラクティス と組み合わせると、リファクタリング方針を明確にできます。

パターン9: 並列翻訳

多言語化プロジェクトでサブエージェントが活躍します。

docs/ja/ 配下のすべてのドキュメントを、
英語・中国語・韓国語に翻訳してください。
言語ごとにサブエージェントを使って並列実行してください。

10言語対応サイトの運営にはこのパターンが必須です。詳しくは Claude Code 多言語実装 を参照。

パターン10: パフォーマンス分析

プロファイリング結果の分析をサブエージェントに任せます。

node --prof app.js
node --prof-process isolate-*.log > profile.txt

# Claude Code に渡す
cat profile.txt | claude -p "ボトルネックを特定して改善案を出して"

profile.txt が膨大な場合は、サブエージェント経由で要約・優先順位付けまで行わせます。

サブエージェントを使うときのコツ

1. タスクを明確に分割する

サブエージェントには「何をして、何を返してほしいか」を明確に伝えます。曖昧な指示は曖昧な結果につながります。

2. 並列実行を意識する

独立したタスクは並列実行できます。1つずつ順番にやるより、並列で投げて結果を待つ方が圧倒的に速いです。

3. メインに戻すデータ量を絞る

サブエージェントの結果は要約してメインに返します。詳細データは必要なときだけ取りに行きます。

まとめ

• サブエージェントはコンテキスト節約と並列処理の強力な武器
• リサーチ・テスト・レビュー・ドキュメント生成など多くのタスクで活躍
• タスクの明確化と並列化を意識することで効率が倍増する

公式ドキュメントは Anthropic Claude Code Docs を参照してください。サブエージェントを使いこなして、Claude Code の真の実力を引き出しましょう。