複数の専門アシスタントに仕事を分担する様子のイラスト
約 3 分

Claude Codeのサブエージェント設計｜調査・実装・レビューを安全に分ける方法

サブエージェントに任せる仕事を増やす前に、成果物・権限・親エージェントの確認責任を決めるための実践ガイドです。

Claude Codeのサブエージェント完全解説｜使いどころ・作り方・安全な分担の考え方

大きなリポジトリの調査、ログの読み込み、レビュー観点の洗い出しを主会話に全部流すと、重要な前提が埋もれます。そんな時に使うのがClaude Codeのサブエージェントです。

サブエージェントは「仕事を丸投げする仕組み」ではなく、脇仕事を別のコンテキストで処理して、要点だけ戻す仕組みです。

サブエージェントとは

サブエージェントは、特定の仕事を担当する専門AIです。主エージェントとは別のコンテキストでファイルやログを読み、結果を要約して返します。Claude Codeには探索や計画などの組み込みエージェントがあり、必要に応じて独自のエージェントも定義できます。

最大の利点は、調査結果を主会話に大量に残さないことです。主エージェントは設計判断や実装に集中し、サブエージェントはコード探索、依存関係調査、テスト観点の列挙などを受け持ちます。

使うべき仕事・使わないほうがよい仕事

向いているのは、検索結果・ログ・ファイル内容が多いが、最終的に短い要約だけが必要な仕事です。

  • 影響範囲の調査
  • セキュリティやテストの観点チェック
  • 複数案の比較調査
  • 大量ログからの原因候補抽出

一方、1ファイルの小修正や、すぐ確認できる質問には不要です。分担そのものに時間と追加コストがかかるため、作業を小さく分けすぎないことが大切です。

主エージェントとの分担

良い依頼は、サブエージェントに「調べる範囲」「返す形式」「してよい操作」を渡します。

src/auth/の認証更新処理を調査してください。
実装は変更せず、以下を箇条書きで返してください。
- 関連ファイル
- 現在の処理の流れ
- 変更時のリスク
- 追加すべきテスト

主エージェントは、この結果をもとに設計・実装・検証を行います。サブエージェント自身の結論をそのまま採用せず、根拠となるファイルやコマンド結果を確認する役割を主側に残します。

カスタムサブエージェントの作り方

サブエージェントはMarkdownファイルとYAML frontmatterで定義します。個人向けは~/.claude/agents/、プロジェクト共有なら.claude/agents/に置きます。

---
name: code-reviewer
description: 変更差分を読み、品質・安全性・テスト不足を指摘する。
tools: Read, Grep, Glob
model: sonnet
---

あなたは読み取り専用のコードレビュアーです。
指摘には根拠のファイルと行、影響、改善案を添えてください。

最初は読み取り専用に絞るのがおすすめです。変更権限を与えるのは、出力品質と停止条件を十分に確認してからにしましょう。

安全な運用ルール

  • 調査・レビュー用は読み取りツールだけにする
  • 秘密情報を含むディレクトリや外部ツールへのアクセス範囲を最小化する
  • サブエージェントの要約に、根拠と不確実な点を含めさせる
  • 主エージェントが最終的な変更と検証を担う
  • 同時並行で同じファイルを編集させない

サブエージェントは、Skillsとも相性が良い機能です。繰り返す調査手順はClaude Skills完全解説の考え方で型にし、そのSkillを専門エージェントに持たせると、役割分担が安定します。

今日の一歩

次に複雑な作業をする時、実装前に「影響範囲調査だけ」をサブエージェントへ切り出してみましょう。返却形式を4項目に限定すると、主会話の文脈を汚さず効果を実感できます。

参照した一次情報

この記事で追加した実務メモ

この記事は、サブエージェントを増やすこと自体を目的にせず、主担当が判断しやすくなる分担に焦点を当てて更新しました。

各担当には「調べる範囲」「返す形式」「変更してよい場所」を一文ずつ渡します。曖昧な依頼ほど、結果の確認コストが上がります。

あわせて読みたい