サブエージェントとは?
サブエージェントとは、Claude Codeがタスクを委任できる専門のアシスタントです。それぞれが独立した会話のコンテキスト ウィンドウ内で動作し、作業を行い、要約をメインスレッドに返す、集中型のヘルパーだと考えてください。 ファイルの読み込み、検索、ツール呼び出しといった中間ステップはすべて分離された状態に保たれ、メインの会話を煩雑にすることはありません。
サブエージェントが重要な理由
Claude Codeとチャットするたびに、メインのコンテキスト ウィンドウに情報が追加されていきます。すべてのツール呼び出し、すべてのファイル読み込み、すべての検索結果がそこに保存されます。そのスペースには限りがあり、いっぱいになると、Claudeは会話の前半部分を見失い始めます。
サブエージェントは、別個のコンテキスト ウィンドウを立ち上げることでこの問題を解決します。サブエージェントの開始時のコンテキストには、以下が含まれます。
- カスタムシステムプロンプト — 設定ファイルから読み込まれ、サブエージェントの役割と振る舞いを定義するもの
- タスクの説明 — 親エージェントがユーザーの依頼内容に基づいて作成するもの
その後、サブエージェントは独自に作業を進めます。ファイルを読み込み、検索を実行し、コードを編集するなど、必要な作業を何でも行います。作業が完了すると、メインの会話には要約だけが返されます。Claude Codeは、サブエージェントの会話の残りの部分を別のトランスクリプトファイルに保存します。
これにより、メインのコンテキストはクリーンな状態を保てます。答えにたどり着くまでの過程の雑音を一切受け取ることなく、答えだけを得られるのです。トレードオフとして、メインの会話ではサブエージェントがどのようにしてその結論に至ったかを確認できません。
実践的な例
見慣れないコードベースを調査していて、どのサービスが返金処理を担当しているかを知りたいとします。サブエージェントを使わない場合、Claudeは15個のファイルを読み込み、複数回の検索を実行し、複数の関数呼び出しをたどる必要があるかもしれません。必要だったのはたった1つの事実だけなのに、それらすべてがコンテキスト ウィンドウを埋めてしまいます。
サブエージェントを使えば、体験ははるかにすっきりします。質問をすると、Explore サブエージェントが立ち上がり、その調査作業をすべて独自のコンテキスト内で行い、的を絞った答えを返してくれます。
メインのコンテキスト ウィンドウに記録されるのは、質問と要約だけです。途中で読み込まれた15個のファイルは記録されません。
組み込みのサブエージェント
Claude Codeには、すぐに使えるいくつかの組み込みサブエージェントが付属しています。
- 汎用サブエージェント -- 調査と実行の両方を必要とする複数ステップのタスク向け
- Explore -- コードベースの高速な検索とナビゲーション向け
- Plan -- プランモード中に、プランを提示する前にコードベースの調査と分析を行うために使用
カスタムサブエージェント
組み込みのオプションに加えて、カスタムのシステムプロンプトとツールアクセス権を持つ独自のサブエージェントを作成することもできます。これにより、コードレビュアー、テストライター、ドキュメント生成ツールなど、自分のワークフローに合わせた専門エージェントを定義できます。
重要なポイント
サブエージェントには、主に3つのメリットがあります。
- 作業を集中的な単位に分割し、各サブエージェントが特定のタスクに専念できるようにする
- すべての中間作業を分離することで、メインのコンテキスト ウィンドウをクリーンに保つ
- 必要な情報だけを簡潔な要約として返す
組み込みのサブエージェントを使う場合でも、独自のサブエージェントを作成する場合でも、これらは長時間のClaude Codeセッションをより有効に活用するための実践的な方法です。メインのコンテキストの雑音が少ないほど、より長く、より効果的に作業を続けられます。