サブエージェントとは？

詳しい解説

サブエージェントは Claude Code の Task ツールによって生成される、独立した AI エージェントです。メインの Claude Code がタスクを複数の小さな単位に分割し、サブエージェントに並列で委譲します。例えば「プロジェクト全体のデッドコードを探す」という指示では、複数のサブエージェントがディレクトリごとに同時に調査を行います。各サブエージェントは独自のコンテキストウィンドウを持つため、メインの会話が圧迫されません。サブエージェントが特に威力を発揮するのは、大規模コードベースの横断調査、複数ファイルの並列リファクタリング、異なるモジュール間の整合性チェックなどです。例えば「全 API エンドポイントのエラーハンドリングを統一して」という指示では、メインエージェントがエンドポイント一覧を把握した後、各エンドポイントの修正をサブエージェントに振り分けて並列実行します。サブエージェントはメインエージェントより軽量なモデル（Haiku など）で実行されることが多く、コスト効率にも優れています。メインエージェントが全体の方針を決定し、サブエージェントが個別の実装を担当するという分業は、人間のテックリードとメンバーの関係に似ています。サブエージェントの結果はメインの会話に要約として返されるため、詳細な実行ログでコンテキストが埋まることもありません。