Claude Codeのサブエージェントで作業を分ける──1つの会話に全部やらせない。レビュー役・テスト役・調査役の定義と渡す道具

この記事は、Claude Codeのサブエージェントを、制作会社の実務で「役割ごとに作業を分ける」ために使う方法を扱います。

1つの会話で、書かせて、確かめさせて、調べさせていないか

「実装して、ついでにレビューもして、テストも書いておいて」

Claude Codeに1つの会話で全部を頼むと、書いた本人が自分の答案を採点する形になります。
人のチームなら、書いた人とレビューする人を分けるはずです。

AIにも、同じ線を引けます。
その道具が、サブエージェントです。

サブエージェントとは、決めた役割と道具だけを持たせ、本体の会話とは別の文脈で作業させ、結果を要約で返させる、専用の助手である

黒字化の外科医です。サブエージェントを、制作会社のチームの役割分担に写す方法を解剖します。

以下の機能の説明は、Claude Codeの公式ドキュメント（code.claude.com/docs の「Subagents」と「Permissions」のページ）で、2026年10月27日に確認した内容です。版によって変わるため、使う前に必ず公式で確かめてください。

役割を分けるべき理由は、三つあります。

第一に、サブエージェントは、本体とは別の文脈で動くから。
公式ドキュメントでは、サブエージェントは自分の文脈で動き、本体の会話の履歴を見ず、結果は要約として本体に返る、と説明されています。書いた経緯を知らない目でレビューさせられます。

第二に、役割ごとに使える道具を絞れるから。
定義ファイルの `tools` に許す道具を並べると、その役はそれ以外を使えません。レビュー役に、ファイルを書き換える道具を渡さない、という線が引けます。

第三に、定義をファイルにすれば、チームで同じ役を使えるから。
プロジェクトの `.claude/agents/` に置いた定義は、リポジトリで共有できます。個人用は `~/.claude/agents/` に置きます。

Claude Codeのサブエージェントの定義ファイル：公式の形式

定義は、YAMLの前置き（frontmatter）つきのMarkdownファイルです。
公式ドキュメントでは、必須の項目は `name` と `description` で、本文がその役の指示（システムプロンプト）になると説明されています。

公式の例にならった、レビュー役の定義です。

---
name: code-reviewer
description: 変更したコードを、品質・セキュリティ・社内の書き方の決まりの観点でレビューする。実装が終わったら使う。
tools: Read, Glob, Grep
model: inherit
---

あなたは、Web制作会社のコードレビュー担当です。
変更されたファイルを読み、次の観点で指摘してください。
・社内の書き方の決まりに反していないか
・入力値の検証、秘密情報の扱いに問題がないか
・お客様の確認が必要な変更が含まれていないか
指摘は「ファイル名・行・理由・直し方の案」で示すこと。
ファイルは書き換えないこと。

`tools` を書かないと、使える道具を広く引き継ぐと公式で説明されています。
役を分ける目的なら、`tools` は必ず書いてください。逆に「書き換えだけ外す」なら `disallowedTools` が使えます。

`model` は `sonnet`・`opus`・`haiku` などの別名か、`inherit`（本体と同じ）を指定できます。

今すぐ試せる：自社の作業を3つの役に分けるプロンプト

私はWeb制作会社の経営者です。Claude Codeのサブエージェントに任せる役割を整理してください。

【前提】
・主な案件の種類：〔例：WordPressの保守、LP制作、既存サイトの改修〕
・社内で、人が分けて担当している作業：〔例：実装、レビュー、テスト、調査〕
・AIに書き換えさせたくないもの：〔例：本番の設定、お客様の原稿〕

1. 「レビュー役」「テスト役」「調査役」の3つについて、それぞれの仕事を3行で書く。
2. 各役に必要な道具を、読むだけ／書く／コマンドを実行する、の3段で示す。
3. 各役のdescription（いつ使うか）を、1文で書く。
4. 人が必ず確認する点を、各役ごとに2つ挙げる。

道具は、必要な最小限にすること。

役割分担工場：3つの役と、渡す道具

役        仕事                              道具（tools）の考え方
──────────────────────────────────────────
レビュー役  変更を読み、指摘を返す            読むだけ（Read, Glob, Grep）
テスト役    テストを書き、実行して結果を返す  読む・書く・テストのコマンド
調査役      既存のコードを調べ、構造を報告    読むだけ

テスト役に実行のコマンドを渡すときは、本体の権限の設定（`permissions`）で、許すコマンドを決めておきます。
権限の共有設定の作り方は、導入ルールの記事にまとめています。

▶ AIコーディングの社内ルール、導入から運用までの型一式──利用規程のひな形、権限表と共有設定の例、変更の記録テンプレート、4週の教育計画、続けるかを決める評価シートと計算例

使い分けの決まり（社内ルールの例）

□ 実装は本体の会話で行い、レビューは必ずレビュー役に回す
□ レビュー役・調査役には、書き換えの道具を渡さない
□ サブエージェントの結果は要約なので、指摘の根拠は人が元のファイルで確かめる
□ 定義ファイルを変えたら、変更の理由を記録に残す
□ 承認するのは人。AIのレビューは、人のレビューの代わりにしない

役が増えたら、定義ファイルと社内の決まりをまとめて管理します。CLAUDE.md・Skills・サブエージェント定義・MCPの許可表を一式にした雛形は、こちらに置きました。

▶ Claude Code社内標準化キット──CLAUDE.md・Skills・サブエージェント定義の雛形、MCPの許可表と権限設定、点検表

構造的なリスク

逆説を指摘しておきます。

役を分けると、AIの作業は増えます。
公式ドキュメントでは、サブエージェントの利用も同じ利用の上限に数えられる、と説明されています。分けた分だけ、使用量は増えると考えてください。

もう一つの落とし穴は、権限の引き継ぎです。
公式では、本体が権限の確認を省くモードで動いていると、サブエージェントもそのモードで動く、と注意されています。定義で道具を絞っても、本体の設定がゆるければ意味が薄れます。

よくあるQ&A

Q. 何人分の役を作ればよいか？

最初はレビュー役の1つで十分です。2週間使い、指摘が役に立つと分かってから、テスト役と調査役を足してください。

Q. サブエージェントは、自動で呼ばれるのか？

公式では、`description` をもとに本体が任せるかを判断し、名前を指定して呼ぶこともできる、と説明されています。確実に使わせたいときは、名前で呼んでください。

Q. AIのレビューがあれば、人のレビューは減らせるか？

減らすのは「見落としを探す時間」です。承認の責任は人に残ります。レビュー体制の決め方は、こちらで扱っています。

▶ AIコードレビューの体制、制作会社は「誰が何を見るか」を先に決める──書いた人・確かめる人・承認する人の役割分担と、レビュー工数を月の予定に確保する計算例

最後に

サブエージェントは、AIの作業を「書く役」と「確かめる役」に分ける道具です。

役ごとに道具を絞り、最後の承認を人に残した会社だけが、AIの速さを品質の事故に変えずに済むのです。

これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。

#Web制作会社 #ClaudeCode #サブエージェント #AI駆動開発 #コードレビュー #AIエージェント #制作会社経営 #中小企業 #生成AI活用 #業務効率化