【結論】解決策 / 実行コマンド
Claude Codeのサブエージェントは、単なるプロンプト内の役割分担ではなく、独自のシステムプロンプト、ツール権限、モデル設定、コンテキストを持つ専用エージェントです。
調査結果だけを親セッションへ返せるため、大規模リポジトリの探索でメインコンテキストを圧迫しにくい点が最大のメリットです。
# ターミナルで実行：プロジェクト用エージェント保存先を作成
mkdir -p .claude/agents
# ターミナルで実行：レビュー用サブエージェントを作成
cat > .claude/agents/code-reviewer.md <<'EOF'
---
name: code-reviewer
description: 変更差分の品質・安全性・テスト不足をレビューする
model: sonnet
tools: Read, Grep, Glob, Bash
---
Git差分を確認し、重大度順に問題と修正案を報告してください。
ファイルは変更せず、根拠となる箇所を明示してください。
EOF
# ターミナルで実行：Claude Codeを起動
claude具体的な手順・設定方法
- プロジェクト共有用は
.claude/agents/、個人共通用は~/.claude/agents/にMarkdownファイルを保存します。 - frontmatterの
descriptionに、いつ呼び出すべきエージェントかを具体的に書きます。 - Claude Code起動後に「code-reviewerサブエージェントで現在の差分を確認して」と依頼します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
code-reviewerサブエージェントを使って、現在のブランチとmainの差分をレビューしてください。
セキュリティ、後方互換性、テスト不足の3観点で調べ、ファイルは変更せず重大度順に報告してください。注意点・よくあるエラーと対処法
サブエージェントは別コンテキストで動くため、親セッションの会話をすべて自動共有するとは限りません。
必要なファイル、目的、完了条件を依頼文に明記してください。
並列化は処理時間を短縮できる一方、複数エージェントが同じファイルを編集すると競合するため、調査系は並列、編集系は担当範囲を分離してください。