【結論】Claude Codeサブエージェントの作り方
Claude CodeのSubagentは、別のClaudeプロセスを無制限に起動するシェル裏技ではなく、独立したContext window、System prompt、Tool、Permissionを持つ公式機能です。
繰り返し使う専門役割は.claude/agents/へMarkdownで定義し、対話中の/agentsから作成・編集・確認できます。
並列化が必要でも、同じFileを複数Agentへ同時編集させず、調査・Test・Reviewなど独立性の高いTaskへ分割します。
# ターミナルで実行：Project用Agentディレクトリを作成
mkdir -p .claude/agents
# 起動後のセッション内で実行：Subagent管理画面を開く
/agents
# 起動後のセッション内で実行：利用可能なAgentを確認
/agents
# ターミナルで実行：定義をVersion管理対象として確認
git status --short .claude/agents具体的な手順・設定方法
/agentsでProject scopeのAgentを作成し、name、description、tools、model、permissionModeを設定します。役割はSecurity review、Test failure analysis、Documentationなど一つに絞ります。
Read-only Agentから始め、必要なToolだけを許可します。
変更前に専用Branchまたはworktreeを作成し、AIの説明ではなくGit差分とTest結果を人間が確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
security-reviewer Subagentを作成してください。
対象は現在のgit diffだけです。
File編集、Git操作、外部通信は禁止し、重大度、根拠、File、Line、修正案だけを返してください。注意点・よくあるエラーと対処法
Subagentは単一Session内で動き、独立Sessionを大量監視する仕組みとは用途が異なります。