【結論】Claude CodeのSubagentとは
Subagentは、主Sessionから特定の補助Taskを委譲され、自分専用のContextで調査・処理し、結果の要約を親へ返す専門AI Assistantです。
大量の検索結果、Log、File内容を主Contextへ直接詰め込まずに済むため、Context汚染を抑えられます。
組み込みAgentとCustom Agentがあり、必要に応じてTool、Permission、Model、Memoryを分離できます。
# 起動後のセッション内で実行：Subagent一覧と設定を確認
/agents
# 起動後のセッション内で実行：Context使用量を確認
/context
# ターミナルで実行：Agent定義を確認
find .claude/agents -maxdepth 1 -type f -print具体的な手順・設定方法
主Conversationに残すべき判断と、切り離せる調査Taskを分けます。
繰り返し使う役割だけをCustom Subagentとして保存します。
Read、Grep、Globなど最小Toolから開始します。
返却形式を短いSummary、Evidence、Next actionへ固定します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
Explore Subagentを使い、認証処理に関係するFileだけを調査してください。
主Sessionには対象File、Data flow、未確認点、推奨Testだけを返してください。
編集は行わないでください。注意点・よくあるエラーと対処法
単にclaude -pを別Processで起動したものを公式Subagentと同一視しないでください。
Subagentに曖昧な責務を与えると、親Agentとの重複作業が増えます。
Agent TeamやBackground sessionは、通信や長時間並列など別の要件で選択します。