サブエージェント

Claude Codeで大規模なコードベースを扱うと、コンテキストウィンドウがすぐに圧迫されます。テスト実行のログ、ファイル探索の結果、レビュー出力——これらがメイン会話に蓄積すると、Claude の応答品質が低下していきます。 サブエージェントは、この問題を「独立したコンテキストウィンドウで専門タスクを処理する」というアプローチで解決する機能です。メインの会話を汚さずに、調査・テスト・レビューなどの作業を委任し、要約だけを受け取れます。 サブエージェントの仕組み サブエージェントは、Claude Codeが特定のタスクを委任できる専門AIアシスタントです。それぞれが独自のコンテキストウィンドウ、カスタムシステムプロンプト、ツールアクセス設定、権限設定を持ちます。 動作の流れは次のとおりです。 ユーザーがClaude Codeに指示を出す Claude Codeがタスク内容とサブエージェントのdescriptionを照合する 適切なサブエージェントにTask()ツールでタスクを委任する サブエージェントが独立したコンテキストで処理を実行する 結果がメイン会話に要約として返される 重要な制約として、サブエージェントは他のサブエージェントを生成できません。ネストされた委譲が必要な場合は、メイン会話から複数のサブエージェントをチェーンするか、Skillsを使用する必要があります。 組み込みサブエージェントの種類と役割 Claude Codeには、あらかじめ用意された組み込みサブエージェントがあります。 サブエージェント名 使用モデル ツール権限 主な用途 Explore Haiku 読み取り専用（Read, Grep, Glob） ファイル検索・コードベース探索 Plan 親から継承 読み取り専用 プランモード中のコードベース調査 general-purpose 親から継承 すべてのツール 複雑なマルチステップ操作 Bash 親から継承 Bash実行 別コンテキストでのターミナル操作 statusline-setup Sonnet 設定用ツール /statuslineでのステータスライン設定 Claude Code Guide Haiku 読み取り専用 Claude Code機能に関する質問応答 Exploreは最もよく使われる組み込みサブエージェントです。Haikuモデルで動作するため高速かつ低コストで、コードベースの検索に最適化されています。呼び出し時には徹底度レベル（quick / medium / very thorough）が指定され、検索の深さが調整されます。 カスタムサブエージェントの作り方 /agents コマンドによる対話的作成 最も手軽な方法は/agentsコマンドです。 /agents 表示されるメニューから以下の手順で進めます。 「Create new agent」を選択 スコープ（User-level / Project-level）を選択 作成方法を選ぶ（Claude生成 or 手動） エージェントの説明を入力 使用ツールを選択 モデルを選択 背景色を選択して保存 保存後すぐに利用可能になり、セッションの再起動は不要です。 ...