Claude Code Subagents
Claude Code のサブエージェントを“使い分ける”。
メインの文脈を汚さずに、調査・実装・レビューを別コンテキストの専門担当に分業する。作り方と、任せどころの設計をまとめます。
AI 駆動開発の相談をするChallenges
こんな場面に向いています
1 体の AI に何でも任せていると、文脈が膨らみ、視点もひとつに偏ります。役割で分けると、その状態を整理できます。
- 1 体の AI に全部やらせて、会話の文脈が膨らんでしまう
- 実装する視点とレビューする視点が同じになり、見落としを見落とす
- どこまでをエージェントに任せ、どこを人が持つかが決まっていない
What Is a Subagent
サブエージェントという考え方
サブエージェントは、メインの会話とは別のコンテキストで走る、特定タスクに特化した担当です。大きな調査や実装を、メインの文脈を膨らませずに分業でき、結果だけを受け取れます。Claude Code では .claude/agents 配下に Markdown で定義します。1 体に全部を背負わせるのではなく、役割ごとに分けることで、それぞれの視点を独立させられます。
How to Build
作り方の 3 ステップ
作り方の核は 3 つです。役割・権限・人格(手順)を順番に決めると、迷いません。定義ファイルの先頭(frontmatter)には name(識別子)・description(どんな依頼のとき呼ぶか)・tools(使える道具)・model(任意)を書き、本文に役割と手順を書きます。
役割を決める(description)
「どんな依頼のとき委譲すべきか」を description に書きます。親はここを読んで委譲先を選ぶため、最も重要な項目です。
権限を絞る(tools)
その役割に必要な道具だけを許可します。たとえばレビュー役は読み取り専用にすると、誤編集が原理的に起きません。
人格と手順を書く(system prompt)
定義ファイルの本文に、役割・進め方・禁止事項を書きます。ここがエージェントの判断基準になります。
Design
使い分けの設計
サブエージェントの価値は「分けること」から生まれます。作る役とレビュー役、読み取りと書き込み、文脈を継ぐか新規で始めるか。この 3 つの軸で設計すると、任せどころが定まります。
作る役 / レビュー役
実装した本人の文脈は実装を肯定しやすい。別コンテキストの初見レビュアーを立てると独立性が出ます。
read-only / 書き込み
調べる・確認するだけの役は読み取り専用に。触る役だけに書き込み権を渡します。
継続 / 新規
直前の文脈が要るなら同じエージェントに継続依頼。白紙の初見が欲しいなら新規で始めます。
任せる ≠ 投げっぱなしです。最終差分の確認と実動作確認は、人(またはオーケストレータ)が持ちます。
FAQ
よくある質問
サブエージェントとは何ですか?
メインの会話とは別のコンテキストで動く、特定タスクに特化した担当です。
どうやって作りますか?
.claude/agents に Markdown で定義し、役割・権限・手順を書きます。
何に使い分けますか?
作る役とレビュー役を分けたり、読み取り専用の調査役を立てたりします。
Contact
AI 駆動開発について相談する
サブエージェントの設計や、AI に任せる開発の進め方について、お気軽にご相談ください。
メールで相談するお問い合わせは [email protected] までお気軽にどうぞ。