【ClaudeCode】サブエージェント完全ガイド｜設定方法・活用例・メリットを徹底解説
「Claude Code を使っているけど、もっと開発効率を上げたい」
そんな悩みを一気に解決するのが、Claude Code のサブエージェント（Sub-agent）機能です。
2025年に登場したこの機能は、単なる AI アシスタントの枠を超え、専門特化した AI チームをターミナル上に構築できる画期的な仕組みです。本記事では、サブエージェントの概念から作成手順・実践的な活用例まで、すべてを網羅的に解説します。
テックジム東京本校では、情報科目の受験対策指導やAI駆動開発コースもご用意しております。
目次
Claude Code サブエージェントとは？
Claude Code サブエージェントとは、Claude Code のセッション内で動作する、タスク特化型の AI アシスタントです。
メインの Claude Code（オーケストレーター）から特定のタスクを委譲されることで、専門知識に特化した処理を独立して行います。コードレビュー担当、テスト専門家、セキュリティ監査役など、開発プロセスの各ステップに合わせた “AIチームメンバー” を好きなだけ作成できます。
公式ドキュメント（Anthropic Sub-agents）では、サブエージェントを次のように定義しています。
Claude Code がタスクを委任できる、事前設定された AI ペルソナ
サブエージェントの特徴と仕組み
サブエージェントには以下の4つの重要な特性があります。
1. 独立したコンテキストウィンドウ
各サブエージェントはメインの会話とは別のコンテキストウィンドウで動作します。これにより、長時間のセッションで主会話が肥大化しても、サブエージェントは常にクリーンな状態でタスクを処理できます。
2. カスタムシステムプロンプト
それぞれのサブエージェントに**専用の指示（システムプロンプト）**を設定できます。「セキュリティの観点でのみレビューせよ」「Google のコーディングガイドラインに従え」など、細かいルールを事前に定義可能です。
3. ツールアクセスの制限
サブエージェントごとに使用を許可するツールを限定できます。読み取り専用にしたり、特定のコマンドのみ実行可能にしたりと、セキュリティや用途に合わせた権限管理ができます。
4. プロジェクト・個人をまたいだ再利用
サブエージェントは Markdown ファイルとして保存されるため、チーム全体での共有やバージョン管理が容易です。
サブエージェントを使うメリット
メイン会話のコンテキストを汚染しない
長い開発セッションでは、コンテキストの肥大化が精度低下の原因になります。サブエージェントは独立したコンテキストで動くため、メインの会話に影響を与えません。
専門特化による品質向上
コードレビュー、テスト、セキュリティ、UI/UX など、専門観点に集中した深い分析が可能です。一つの AI に何でも頼むより、専門家に委ねた方が高品質な結果が得られます。
複数エージェントの並列実行
「すべてのレビュワーを使って、指摘事項をすべて修正してください」といった指示で、複数のサブエージェントを同時並行で動かすことができます。大規模なコードベースでも効率的に処理できます。
プロジェクト固有ルールの自動適用
Linter や静的解析では対応できない「このプロジェクトの命名規則」「このアーキテクチャパターン」といったチーム固有のルールを AI に覚えさせ、自動チェックに組み込めます。
サブエージェントの作成方法（手順付き）
方法1：/agents コマンドを使う（推奨）
Claude Code を起動して /agents を入力します。
> /agents
**「Create new agent」**を選択し、以下のステップを進めます。
Step 1：保存場所を選択
1. Project (.claude/agents/) ← プロジェクト専用
2. Personal (~/.claude/agents/) ← 全プロジェクトで共有
- プロジェクト固有のルールを使うエージェント →
.claude/agents/ - 汎用的なエージェント（コードレビューなど）→
~/.claude/agents/
Step 2：作成方法を選択
1. Generate with Claude（推奨）
2. 手動で設定
「Generate with Claude」を選択すると、エージェントの概要を入力するだけで Claude が自動生成します。
Step 3：エージェントの説明を入力
コードのユニットテストを書くのを手伝ってほしい。
特にエッジケースを見つけて、テーブル駆動テストを書くことが得意なエージェント。
詳細に書くほど、精度の高いエージェントが生成されます。
Step 4：確認して保存
名前・保存場所・ツール設定を確認して保存します。
方法2：Markdown ファイルを手動作成
.claude/agents/ または ~/.claude/agents/ に Markdown ファイルを直接作成します。
---
name: code-reviewer
description: >
最近書かれた、または変更されたコードをレビューする必要がある場合に
使用してください。新しい関数、リファクタリングされたコード、バグ修正、
コミット前の変更レビューが含まれます。
tools:
- Read
- Grep
- Glob
model: claude-sonnet-4-5
---
あなたはシニアエンジニアとしてコードレビューを専門に行います。
以下の観点でコードを評価してください：
1. **可読性**：変数名・関数名は意味が明確か
2. **パフォーマンス**：不要なループや計算がないか
3. **セキュリティ**：入力バリデーション・認証処理に問題はないか
4. **テスト容易性**：依存関係が適切に分離されているか
5. **チーム規約**：プロジェクト固有の命名規則・アーキテクチャに沿っているか
サブエージェントの呼び出し方
自然言語で指示する
Claude Code はタスクの内容を読み取り、適切なサブエージェントを自動選択します。
このファイルのコードをレビューしてください
エージェントを明示的に指定する
code-reviewer を使って authentication.ts をレビューしてください
@メンション で呼び出す
@ を入力するとタイプアヘッドでエージェントを選択できます。ファイルの @メンション と同じ操作感で使えます。
@code-reviewer でこの変更をチェックしてください
複数エージェントを同時起動する
code-reviewer と security-auditor の両方でこのプルリクエストをレビューし、
すべての指摘を修正してください
実践的な活用例 7 選
1. コードレビュー専門エージェント
品質・セキュリティ・スタイルを事前定義したチェックリストで自動レビューします。シニアエンジニアの工数を大幅に削減しつつ、チーム全体に均一な基準を適用できます。
Use the code-reviewer subagent to check my recent changes
2. テスト生成エージェント（test-runner）
実装コードを受け取り、テーブル駆動テストやエッジケースのカバレッジを自動で生成します。
Use the test-runner subagent to fix failing tests
3. GitHub PR 作成エージェント
コンベンショナルコミット形式に従ったプルリクエストを、テンプレート通りに自動生成します。
4. セキュリティ監査エージェント
脆弱性の検出、入力バリデーションのチェック、認証フローの問題を専門的な視点で洗い出します。
run comprehensive security audit on the auth module
5. UI/UX レビュー専門エージェント（apple-design-expert）
Apple デザインガイドラインや Core Web Vitals に基づき、フロントエンドの品質チェックを行います。
6. ブラウザテスト専門エージェント（Playwright連携）
MCP サーバーを経由して Playwright を活用し、実際のブラウザ上での E2E テストを自動実行します。
mcpServers:
- playwright:
type: stdio
command: npx
args: ["-y", "@playwright/mcp@latest"]
7. ドキュメント生成エージェント
コードを読み取り、API ドキュメントや README を自動生成します。
サブエージェント定義ファイルの書き方
YAML フロントマターで設定し、本文でシステムプロンプトを記述します。
---
name: security-auditor # エージェント名（必須）
description: > # いつ使うかの説明（必須・重要）
セキュリティ問題の検出が必要な場合に使用。
認証、入力バリデーション、依存関係の脆弱性チェックを含む。
MUST BE USED before any deployment.
tools: # 使用を許可するツール
- Read
- Bash
- Grep
model: claude-sonnet-4-5 # 使用モデル（省略可）
mcpServers: # MCP サーバー設定（省略可）
- github
---
# システムプロンプト（本文）
あなたはセキュリティの専門家です。以下の観点でコードを分析してください：
- SQLインジェクション・XSS・CSRF の脆弱性
- 認証・認可のロジックの妥当性
- 機密情報のハードコーディング
- 依存パッケージの既知の脆弱性
description の書き方が鍵
Claude Code は description を参照してエージェントの呼び出しタイミングを判断します。積極的に使わせたい場合は以下のキーワードを活用しましょう。
| 目的 | キーワード例 |
|---|---|
| 常に使わせたい | MUST BE USED, always use |
| 積極的に使わせたい | use PROACTIVELY |
| 条件付きで使わせたい | Use this agent when... |
使う上での注意点・制限事項
トークン消費量に注意
複数のサブエージェントを多用すると、トークン消費量が急増します。MCP や Subagent を多用する場合は、利用プランを見直す必要があります。Pro プランから Max プランへの移行が必要になるケースも報告されています。
サブエージェントのネスト不可
サブエージェントは他のサブエージェントを生成できません。ネストした起動はサポートされていないため、設計時に注意が必要です。
ファイル同期の問題
サブエージェントが古いファイル内容を読み込む可能性があります。重要な処理の前に最新状態の確認を促すプロンプトを入れておくと安心です。
シンプルなタスクには過剰
小規模な修正や単純なタスクにサブエージェントを使うと、オーバーヘッドが発生します。複雑・繰り返し・専門性が高いタスクに絞って活用するのが効果的です。
よくある質問（FAQ）
Q. サブエージェントはどこに保存すればいいですか？
A. プロジェクト固有のルールを持つエージェントは .claude/agents/、汎用的なエージェントは ~/.claude/agents/ に保存します。プロジェクトレベルのものはバージョン管理に含めてチームで共有するのがおすすめです。
Q. 既存の公開サブエージェントを使えますか？
A. はい。VoltAgent/awesome-claude-code-subagents などのリポジトリに多くのサブエージェントが公開されており、すぐに活用できます。コードレビューや原則チェック系は既存のものを流用し、プロジェクト固有のルールだけ自作するのが効率的です。
Q. サブエージェントを再開（Resume）することはできますか？
A. 実験的な機能として、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を有効にすることで SendMessage ツールが使用可能となり、エージェントの再開ができます。再開されたサブエージェントは前回のすべての会話履歴を保持します。
Q. MCP サーバーをサブエージェントに使えますか？
A. 使えます。mcpServers フィールドでインラインサーバーを定義するか、既存の設定を文字列で参照することで、サブエージェント専用の MCP 環境を構築できます。
まとめ
Claude Code サブエージェントは、AI を使ったコーディングの在り方を根本から変える機能です。
単一の AI アシスタントに何でも頼む時代から、専門家チームに仕事を委ねる時代へ。サブエージェントを活用することで、次のことが実現します。
- コードレビュー・テスト・セキュリティ監査を自動化・高品質化
- メイン会話を汚染せず長時間セッションでも安定した精度を維持
- チーム固有のルールを AI が学習し、一貫したコード品質を保証
- 複数エージェントの並列実行で大規模プロジェクトも効率的に処理
まずはシンプルなコードレビューエージェントを1つ作ることから始めてみましょう。徐々にチームのニーズに合わせて拡張していくことで、開発ワークフロー全体が劇的に変わるはずです。
参考リンク
- Claude Code 公式ドキュメント – Sub-agents
- awesome-claude-code-subagents（GitHub）
- Claude Code 公式ドキュメント – Overview
■ゼロから始めるClaudeCode講座のご案内
テックジム東京本校では「ClaudeCode」の体験講座を開催。
「その日のうちに動かす」 をゴールに、環境構築から実践まで。
毎週土曜日15時。参加は無料です。対面・ハンズオンだから初心者でも安心。
■らくらくPython塾 – 読むだけでマスター
共通テスト「情報I」対策解説講座
実践で学ぶPython速習講座
■テックジム東京本校
格安のプログラミングスクールといえば「テックジム」。
講義動画なし、教科書なし。「進捗管理とコーチング」で効率学習。
対面型でより早くスキル獲得、月額2万円のプログラミングスクールです。
情報科目の受験対策指導やAI駆動開発コースもご用意しております。
