
Claude Codeのサブエージェントの使い方。使う場面と使わない場面の分け方
2026/11/16
執筆:寺田昇平
AI Portalize株式会社 代表取締役/AI Digital Community 代表理事
仕組みとコンサルティング伴走支援の両面で、組織のAI活用の加速を支援。
Claude Codeのサブエージェントは、メインの会話とは別の文脈で調べものや点検をして、結果の要約だけを返すAIの助手です。
作るときは、Claude Codeに役割と保存先を伝えて、「.claude/agents/」にファイルを作ってもらうのが手軽です。
使うのは、大量のファイルやログを読む作業や、書き換えさせずに点検させたい作業です。
何度もやり取りしながら直す作業や、前後の話を共有する作業は、メインの会話のまま進めます。

ただ、サブエージェントは自分の分のトークンを使うので、増やすほど利用の枠も多く使います。
製品の事実は、2026年11月11日にClaude Codeの公式ドキュメントで確かめた内容です。
公式ドキュメントには、日本語版のページもあります。
Claude Codeのサブエージェントを作るまでの5つの操作
いちばん手軽なのは、作りたいサブエージェントをClaude Codeに文章で説明し、ファイルを作ってもらう方法です。
公式ドキュメントのクイックスタートも、この形で案内しています。
1. 作業するフォルダでClaude Codeを開く
2. 役割・保存先・使ってよい道具・モデルを文章で伝える
3. できたファイルを開き、名前と説明が意図どおりか確かめる
4. 「draft-checkerのサブエージェントで点検して」のように頼んで動かす
5. 見つからないと言われたら、Claude Codeを開き直す
2で伝える文は、例えば「.claude/agents/ に、原稿の表記ゆれを点検するサブエージェントを作って、ファイルは書き換えさせず、Haikuで動かして」のようになります。
開いた時点で保存先のフォルダがなかったときは、開き直すまで新しいサブエージェントが見つかりません。

以前の版(v2.1.197まで)では、「/agents」と打つと作るための画面が開きました。
今の版の「/agents」は、Claudeに頼むか、フォルダのファイルを直接書くよう案内する表示に変わっています。
サブエージェントのファイルに書く項目
できあがるのは、先頭に設定を書き、その下に役割の説明を書いたMarkdownのファイルです。
先ほどの例なら、次のようなファイルになります。
---
name: draft-checker
description: 原稿の表記ゆれと数字の食い違いを点検する。原稿を書き終えたあとに使う
tools: Read, Grep, Glob
model: haiku
---
あなたは原稿の点検役です。
渡されたファイルを読み、表記ゆれと数字の食い違いを探します。
ファイルは書き換えません。
見つけた所は、ファイル名・行・直し方の案を1行ずつ返します。
必ず書くのは「name」と「description」の2つだけで、ほかは書かなければ初期の設定で動きます。
項目 | 書く中身 | 書かないとどうなるか |
|---|---|---|
name | ほかと重ならない名前 | 書く必要がある |
description | どんなときに任せるか | 書く必要がある |
tools | 使ってよい道具 | サブエージェントで使える道具をすべて使える |
model | haiku・sonnet・opus など | メインの会話と同じモデルで動く |
本文 | 役割と、結果の返し方 | 何をどう返すかがあいまいになる |
descriptionは、Claudeがそのサブエージェントに任せるかどうかを決める材料です。
公式は、「use proactively」のような言葉を入れると、Claudeが進んで任せやすくなるとしています。
また、作ったサブエージェントのdescriptionの合計が15,000トークンを超えると、起動したときに警告が出ます。
本文は、そのサブエージェントへの指示として読まれます。
書き換えさせたくない点検役なら、toolsに「Read」「Grep」「Glob」のような読むための道具だけを書いておきます。
読む道具だけにする方法のほかに、仕組みで止める安全設定を作る手順は、Claude Codeのhooksとは。お願いではなく仕組みで止める安全設定の作り方で説明しています。

作ったサブエージェントを呼び出す3つの方法
作ったサブエージェントは、Claudeが自分で選んで使うほか、名前を指定して呼び出せます。
公式ドキュメントにある呼び出し方は、次の3つです。
自動:頼んだ内容とdescriptionが合えば、Claudeがそのサブエージェントに任せる
名前を書いて頼む:「draft-checkerのサブエージェントで、この原稿を点検して」のように書く
「@」で指定する:入力欄で「@」に続けてサブエージェントを指定すると、そのサブエージェントが必ず動く
作らなくても使える、組み込みのサブエージェントもあります。
ファイルを探して読むだけの「Explore」、プランモードで下調べをする「Plan」、調べてから手を動かす「General-purpose」などです。
ExploreとPlanは読むための道具だけを使い、CLAUDE.mdを読まずに始まります。
英語の公式ドキュメントでは、この機能を「Subagents」と呼んでいます。

Claude Codeのサブエージェントを使う場面と使わない場面
「作業を分けるほど、精度が上がるのでは?」と考える人もいます。
公式ドキュメントには、どちらで進めるかの目安が、作業の様子ごとに載っています。
作業の様子 | 進める場所 |
|---|---|
何度もやり取りしながら直す | メインの会話 |
計画・作る・試すの段階で、同じ前提を使う | メインの会話 |
1か所だけを手早く直す | メインの会話 |
すぐに返事がほしい | メインの会話 |
結果の量が多く、要約だけあればよい | サブエージェント |
使う道具や権限を絞りたい | サブエージェント |
ほかと切り離せて、要約を返せば済む | サブエージェント |
すぐに返事がほしい作業がメインの会話に向くのは、サブエージェントが前提を集めるところから始めるためです。
公式の例では、テストの実行、ドキュメントの取得、ログの処理が、サブエージェントに向く作業として挙げられています。
業務に当てはめると、例えば数十本の原稿から表記ゆれを探す点検や、長いログから誤りの行を拾う作業が近い形です。
一方で、企画書を相談しながら少しずつ直していく作業は、前の話を覚えているメインの会話のほうが向いています。
Claudeを業務で使うときの全体の考え方は、Claudeを業務で使う。Geminiとの使い分けと、組織に入れるときの考え方にまとめています。
サブエージェントの費用と精度の見方
「サブエージェントに分ければ、費用も抑えられるのでは?」という声もあります。
実際には、サブエージェントはメインの会話とは別に、自分でAIへのリクエストを送ります。
公式によると、そのリクエストもメインの会話と同じ利用の上限に数えられます。
つまり、サブエージェントを増やすほど、使うトークンも増えます。
公式は、多くのサブエージェントが詳しい結果を返すと、メインの会話の文脈も大きく使うと注意しています。
費用を抑える方法として、公式は簡単な作業のサブエージェントに「model: haiku」を指定するよう案内しています。
また、Pro・Max・Team・Enterpriseなどのプランなら、「/usage」でサブエージェントが使った割合も確かめられます。
精度の面では、サブエージェントが今までの会話を見ていない点に気をつけます。
公式によると、サブエージェントは新しい文脈で始まり、メインの会話の履歴や、Claudeがすでに読んだファイルを見ていません。
受け取るのは、自分の指示、Claudeが書いた作業の依頼文、CLAUDE.mdなどです。
そのため当社では、条件と返してほしい形を、依頼文にはっきり書くのを目安にしています。
「点検は第2章だけ、見つけた所はファイル名と行で返して」のように書いておくと、メインの会話で確かめ直す手間が減ります。
前の話を知っていてほしい作業には、「フォーク」という形もあります。
フォークは今までの会話をすべて引き継いだサブエージェントで、入力欄で「/subtask」に続けて作業を書くと始められます。
公式は、同じ前提が要る作業なら、フォークのほうが新しいサブエージェントより費用が少ないとしています。

チームでサブエージェントを共有するときの決まり
作ったサブエージェントは、置く場所によって使える範囲が変わります。
プロジェクトの「.claude/agents/」に置くとそのプロジェクトで使え、「~/.claude/agents/」に置くと自分のすべてのプロジェクトで使えます。
公式は、プロジェクトのサブエージェントをバージョン管理に入れて、チームで共有するよう案内しています。
同じ名前のサブエージェントが重なったときは、組織の管理設定(managed settings)に置いたものがいちばん優先されます。
チームで共有する設定として、複数の道具で共通に使える指示ファイルの書き方は、AGENTS.mdとは。Claude Code・Codex・Cursorで共通に使える指示ファイルの書き方で整理しています。
社内で配る前に決めておく項目は、当社では次の4つを目安にしています。

共有するサブエージェントの置き場所と、直す人
書き換えまで許すものと、読むだけのものの分け方
使うモデル(簡単な作業はHaikuにするか)
descriptionの書き方(ほかと役割が重ならないか)
決まった手順を毎回同じように進めさせたいだけなら、別の文脈を使わないスキルのほうが向く場合もあります。
スキルの書き方と配り方は、SKILL.mdとは。Claudeのスキルの書き方と、作ったスキルを社内に配る手順に書いています。
なお、Claude Codeは、無料のプランでは使えません。
公式の案内では、Pro・Max・Ultra・Team・EnterpriseかClaude Consoleのアカウントが要ります。
作業させるフォルダの決め方は、Claude Codeを社内で使い始める。初期設定と安全設計にあります。
CLAUDE.mdと禁止設定の分担は、Claude Codeを非エンジニアに配る。CLAUDE.mdと禁止設定の分担が参考になります。
作ったサブエージェントやスキルが社内で使われないときは、AIツールやプロンプトが、社内で共有されないのページもご覧ください。
業務への当てはめから一緒に考えるAIパーソナルトレーニング
サブエージェントに任せる作業を選ぶ前に、そもそも自社の業務のどこからAIを使うかで迷う方もいます。
私たちのAIパーソナルトレーニングは、経営者・役員・AI担当者の方に向けた、マンツーマンの2時間の場です。
1回だけの利用もでき、事業や業務の内容をうかがったうえで、最初に取り組む領域を助言します。
内容の例には、AIボットを一緒に作る時間や、Claude Coworkなどを使ったブラウザ操作とAIワークフロー化の体験があります。
始める前に今の課題をうかがい、そのうえで進め方のプランをご提案します。
Claude Codeのサブエージェントは、分ける理由がある作業にだけ使う
Claude Codeのサブエージェントは、役割と保存先を伝えてClaude Codeにファイルを作ってもらう形が、いちばん始めやすい作り方です。
結果の量が多い作業や読むだけの点検に絞って使い、やり取りの多い作業はメインの会話で進めます。
参照した情報(2026年11月11日に確認)
すぐ使える業務アプリが300以上
開いてそのまま使えて、AIで自社用にも直せます。15の分野から、やりたい作業で探せます。業務アプリを見る
執筆:寺田昇平
AI Portalize株式会社 代表取締役/AI Digital Community 代表理事
仕組みとコンサルティング伴走支援の両面で、組織のAI活用の加速を支援。
お知らせ・組織AI推進ノウハウ一覧












