サブエージェント
タスク固有のワークフロー向けの特化したAIアシスタント
サブエージェントとは？
サブエージェントは、Claude Code内で特定のタイプのタスクを処理する特化したAIアシスタントです。各サブエージェントは独自のコンテキストウィンドウ、カスタムシステムプロンプト、特定のツールアクセス権を持っています。
特定の目的
各サブエージェントには定義された専門分野があります
独立したコンテキストウィンドウ
メイン会話とは分離されたコンテキスト
設定可能なツール
サブエージェントごとの特定ツールアクセス
カスタムシステムプロンプト
各エージェント向けにカスタマイズされた指示
新しいサブエージェント機能
非同期サブエージェント
Ctrl+Bでサブエージェントをバックグラウンドで非同期実行
コンテキストフォーク
スキルfrontmatterでcontext: forkを使用して分離実行
エージェントフック
エージェントfrontmatterでPreToolUse、PostToolUse、Stopフックを定義
エージェント無効化
disallowedToolsでTask(AgentName)構文を使用して特定エージェントを無効化
内蔵サブエージェント
Explore
コードベース検索・分析用の高速読み取り専用エージェント
Model: Haiku (fast)
Tools: Read-only
Plan
プランモードでコンテキストを収集するリサーチエージェント
Model: Inherits
Tools: Read-only
general-purpose
複雑なマルチステップタスク用の汎用エージェント
Model: Inherits
Tools: All tools
エージェント Frontmatter フィールド
| Field | Description | Example |
|---|---|---|
| model | Override model selection | opus, sonnet, haiku, inherit |
| skills | Enable specific skills | ["code-review", "testing"] |
| hooks | Define agent-specific hooks | ["pre-review"] |
| permissionMode | Permission handling mode | inherit, default, bypassPermissions |
| apiKeyEnvVar | Custom API key env variable | CUSTOM_API_KEY |
| enableUndo | Enable undo capability | true, false |
| tools | Restrict available tools | ["Read", "Edit", "Bash"] |
--- model: opus skills: - code-review hooks: - security-check permissionMode: inherit tools: - Read - Edit - Grep ---
クイックスタート
1. サブエージェントインターフェースを開く
/agents2. 新しいエージェントを作成
「新しいエージェントを作成」を選択し、プロジェクトレベルまたはユーザーレベルを選択
3. エージェントを定義
- エージェントの目的を説明する
- アクセス権を付与するツールを選択
- システムプロンプトをカスタマイズ
4. エージェントを使用
> Use the code-reviewer subagent to review my changesサブエージェントの例
コードレビュアー
品質、セキュリティ、ベストプラクティスのためのコードレビュー
Tools: Read, Grep, Glob, Bash
デバッガー
エラー分析と修正の実装
Tools: Read, Edit, Bash, Grep
テスト自動化
テストの自動生成と実行
Tools: Read, Write, Bash
ベストプラクティス
集中したエージェント設計
単一で明確な責任を持つサブエージェントを作成
詳細なプロンプトを書く
具体的な指示と例を含める
ツールアクセスを制限
セキュリティ向上のため必要なツールのみを付与
バージョン管理
プロジェクトサブエージェントをバージョン管理に含める