Sub-agents で巨大リポジトリの調査を 10 倍速にする — Claude Code 公式パターン

数万ファイルのリポジトリを Claude Code に調査させると、すぐにコンテキストが枯渇する。Sub-agents は別コンテキストで探索を走らせ、結果サマリだけを返すため、メイン会話を汚さずに調査を分離できる。本稿は公式ドキュメント準拠で活用パターンと注意点を整理する。

なぜサブエージェントが効くか

Claude Code の本質的な制約は「コンテキストウィンドウは有限で、埋まるほど性能が落ちる」こと。コードベース探索で何十ファイルも読むと、本来やりたい実装の前にコンテキストが枯渇する。

Sub-agents は別のコンテキストで動き、要約だけを返す。公式ドキュメントは "subagents are one of the most powerful tools available" と明記している。

使い方の基本

``` use subagents to inv