サブエージェント — シニア開発者のように委任する
専用の Claude インスタンスに集中タスクを委任する
⏱ 想定 ~6 分
01 · 読む
シニア開発者は何もかも自分でやりません — 委任します。ジュニア開発者がシニアにバグ調査を頼むとき、シニアは今の作業を放り出したりしません。誰かを送って調査させ、報告を受けるのです。
サブエージェントを使えば、Claude Code でも同じことができます。1 つの大きな会話ですべて — ファイルを読む、テストを走らせる、アーキテクチャを調べる — をこなそうとせず、専用のサブエージェントに集中タスクを委任して、それぞれが自分のコンテキストウィンドウで作業してくれます。
大きなメリットは、サブエージェントのおかげでメインの会話がクリーンに保たれることです。1 つのサブエージェントが検証システムを理解するために 50 ファイル読んでも、戻ってくるのは短い要約だけ — あなたのコンテキストウィンドウには余計な情報が入りません。
💡 想像してみてくださいサブエージェントは、調査アシスタントを図書館に派遣するようなものだと考えてください。自分が出向いて机を本だらけにする代わりに、彼らが行って全部読み、1 ページの要約を持ち帰ってくれます。あなたの机はクリーンに保たれ、本当に重要な作業のために空けておけます。
ポイントまとめ
- サブエージェントはメインの会話とは別のコンテキストウィンドウで動く
- 独立して調査、分析、タスク実行を行う
- コンテキストに戻ってくるのは要約だけ — 読んだファイル全体ではない
- メインの会話は実装に集中したまま保てる
02 · 読む
Claude Code にはいくつかの組み込みサブエージェントタイプがあり、それぞれ特定のタスク用に設計されています。- Explore — read-only のリサーチ。ファイル検索、コード読み込み、コードベースに関する質問への回答。編集はできません。 - Plan — アーキテクチャ設計。コードベースを探索し、実装プランを提案します。あなたが承認するまでは read-only です。 - Bash — コマンドのスペシャリスト。ターミナルコマンドを実行します。テスト実行、ビルド、システムチェックに使います。
Claude は隔離すべきタスク — 大きなコードベースの調査やテストスイートの実行など — を認識すると、自動的にサブエージェントを生成します。明示的に依頼することもできます。
ポイントまとめ
- Explore : read-only のリサーチとコードベース分析
- Plan : アーキテクチャ設計と実装プランニング
- Bash : ターミナルコマンドとシステム操作
- Claude は適切なときに自動でサブエージェントを生成する
03 · コード例
Claude にサブエージェントを使うよう直接頼むこともできます。以下はサブエージェント委任を引き出すプロンプトです。
サブエージェントを呼び出すプロンプト
"Use a subagent to investigate how auth works in this codebase"
"Explore the database schema and summarize what tables we have"
"Run the test suite and report which tests fail"
"Analyze the API routes and list all endpoints"
Claude に「調査して」「探索して」「分析して」「テストを走らせて」と頼むと、よく自動的にサブエージェントへ委任します。サブエージェントは自分のコンテキストで重い作業をこなし、あなたの会話には簡潔な要約だけを返します。
04 · 読む
YAML フロントマター付きの SKILL.md を書くことで、自分専用のカスタムサブエージェントを作れます。これは、独自の指示、ツール制限、モデル選択を持つ専門エージェントを定義します。
カスタムエージェントが強力なのは、その能力を絞り込めるからです。コードレビュアーはファイルを読むだけでいい — 編集やコマンド実行は不要です。テストランナーは Bash が必要ですが Edit は要りません。ツール制限により、エージェントはより安全で集中したものになります。
ポイントまとめ
- カスタムエージェントは YAML フロントマター付き SKILL.md で定義する
- tools: フィールドでエージェントができることを制限する
- レビュアーには Read/Grep/Glob が必要 — Edit や Bash ではない
- 制限によりエージェントはより安全で集中する
05 · コード例
以下はカスタムの code-reviewer サブエージェントの作り方です。YAML フロントマターでその挙動を設定します。
.claude/skills/code-reviewer/SKILL.md
---
name: code-reviewer
description: Expert code review specialist. Use after code changes.
tools: Read, Grep, Glob
model: sonnet
---
Review code for:
1. Bug risks and logic errors
2. Security vulnerabilities (injection, auth bypass)
3. Performance issues (N+1 queries, unnecessary loops)
4. Style inconsistencies with the existing codebase
Provide specific line references and severity ratings.
このエージェントはコードを読むことしかできません — ファイル編集もコマンド実行もできません。tools: Read, Grep, Glob の制限により、レビューに集中します。model: sonnet は、メインの会話で使うモデルではなく Sonnet (速くてコスト効率が良い) を使うことを意味します。
06 · クイズ
新機能を実装中で、既存の検証システムがどう動いているか理解する必要があります。これは 20 以上のファイルを読む作業です。最もコンテキスト効率の良い方法はどれですか?
- メインの会話で 20 ファイル全部を自分で読む
- ファイルを読まずに Claude に検証を説明させる
- 調査のために新しい Claude セッションを開く
- サブエージェントに調査させ、要約を返してもらう
07 · 対応づけ
それぞれのサブエージェントタイプを最適な用途と結びつけてください。
(このセクションはインタラクティブです — JavaScript を有効にしてください。)
⚠ 全機能のインタラクティブ体験には JavaScript が必要です。JavaScript を有効にして再読み込みしてください。
※ このサイトは独立した教育プロジェクトで、Anthropic の公式製品ではありません。Claude™ は Anthropic, PBC の商標です。