Claude Code › 設定・拡張

Claude Codeサブエージェントの使い方|頼み方と作り方

Claude Code のサブエージェントは、自分で作らなくても今日から使えます。

私は Claude Code を、記事づくり・営業・情報集めといった仕事の運用に使っています。 コードはほとんど書きません。

手元には自分で作ったサブエージェントが6体いて、毎日のように動いています。

何体まで使うかを決めてからは、大きな作業も何回かに分けて回しています。

この記事では、サブエージェントの仕組みと使う目的、基本の頼み方、使う場面・使わない場面、作り方、呼ばれないときの直し方を順に紹介します。 最後に、私の「何体まで使うか」の決まりと、それで大きな作業を回した実録を載せます。

公式の説明は、2026年9月30日に Claude Code のドキュメントで確かめた内容です。

目次

  1. 結論:まずは「サブエージェントを使って」と頼むだけ
  2. Claude Code のサブエージェントとは
  3. サブエージェントを使う目的とメリット
  4. 最初から入っているサブエージェント
  5. 基本の使い方:3つの頼み方
  6. 使う場面・使わない場面
  7. サブエージェントの作り方
  8. 呼ばれないときの直し方
  9. 体数を決めて、大きな作業を分けて回した実録
  10. よくある質問
  11. まとめ
  12. 参考資料・出典

結論:まずは「サブエージェントを使って」と頼むだけ

初心者

サブエージェントって、自分で作らないと使えないんですか?

芝田

最初から入っているので、「サブエージェントを使って調べて」と頼むだけで使えます。

先に結論を言います。

サブエージェントは、別の机で調べて結論だけを持ち帰ってくれる助手です。 最初から数体が入っていて、普通の言葉で頼めば動きます。

要点は次の4つです。

  • サブエージェントは、別の会話で作業して、結果の要約だけを返す
  • 調べもの用などが最初から入っている。まずはそれで足りる
  • 使うのは「大量に読む作業」と「互いに関係ない作業を同時に進めるとき」だけ。体数は調べる対象の数に合わせる
  • 自分で作るのは、同じ役割を何度も頼むようになってから

Claude Code のサブエージェントとは

初心者

普通に頼むのと何が違うんですか?

芝田

別の机で調べて、結論だけを持ち帰ってくれる助手です。

別の机で作業して結論だけ返す

普通に頼むと、Claude はあなたとの会話の中で資料を読み、調べ、考えます。 読んだ中身は、すべて今の会話に積み上がっていきます。

サブエージェントに頼むと、読む作業は別の会話(別の机)で行われます。 今の会話に戻ってくるのは、まとめた結果だけです。

公式の説明でも、サブエージェントは自分用の会話で作業し、要約だけを返すものとされています。

スキル・CLAUDE.md との違い

仕組み 読まれるとき 向いているもの
CLAUDE.md 毎回の会話の最初 毎回守らせる決まり(言葉づかい・禁止事項)
スキル 使うときだけ、今の会話の中で 特定の作業の手順・チェックリスト
サブエージェント 呼ばれたとき、別の会話で 調べものなど、今の会話から切り離したい作業

スキルは手順書、サブエージェントは別の担当者と覚えると迷いません。 私の手元では、記事の要約係・Wiki の点検係・調査係など6体を置き、スキルの手順の中から呼んでいます。

スキルの作り方は、こちらの記事にまとめています。

サブエージェントを使う目的とメリット

初心者

使うと何がいいんですか?

芝田

一番は、メインの会話が散らからず、長い作業でも話がぶれにくくなることです。

メインの会話から依頼を受けたサブエージェントが別の机で大量に読み、要約だけを返す流れの図

目的:メインの会話をきれいに保つ

Claude が一度に覚えておける量(コンテキスト)には限りがあります。 資料やログを大量に読むと、それだけで会話がいっぱいになります。

すると、前に決めたことを取りこぼしやすくなります。

サブエージェントを使う目的は、大量に読む作業をメインの会話の外に出すことです。

メリット1 長い作業でも話がぶれにくい

途中の読み物がメインの会話に入らないので、長い作業でも最初の決まりが残りやすくなります。 Claude に1日じゅう作業を頼む人ほど、差が出ます。

メリット2 別々の作業を同時に進められる

互いに関係のない調べものなら、複数のサブエージェントに分けて同時に進められます。 たとえば「料金」「使い方」「評判」を3体に分けて調べさせると、待ち時間が短くなります。

サブエージェントではなく、会話(セッション)ごと分けて並列に回す方法は、別の記事で比べています。

メリット3 使える道具を絞って安全に任せられる

サブエージェントごとに、使える道具を決められます。 「読むだけ」に絞った担当なら、ファイルを書き換えたり消したりする心配がありません。

メリット4 同じ役割を何度でも呼べる・安いモデルに回せる

一度作った担当は、どのプロジェクトからでも同じ指示で呼べます。 担当ごとにモデルも選べるので、単純な作業は軽いモデルに回すこともできます。

注意:使用量は同じ枠から減る

サブエージェントは、無料で増える助手ではありません。 公式の説明では、サブエージェントの利用もメインの会話と同じ使用制限にカウントされます。

10体を同時に動かせば、そのぶん枠は速く減ります。 私が枠を使い果たした話は、最後の節に書きました。

最初から入っているサブエージェント

Claude Code には、作らなくても使えるサブエージェントが入っています。 Claude が必要に応じて自分で使い分けます(2026年9月30日に公式の説明で確認)。

主な3つ

名前 役割 できること
Explore 探す係 ファイルや資料を読んで探すだけ。書き換えはできない
Plan 下調べ係 計画モードで、計画を立てる前の下調べをする。書き換えはできない
general-purpose 何でも係 調べて、直すところまでまとめて行う

調べものだけなら Explore が第一候補です。 書き換えができないので、安心して任せられます。

裏で動くもの

ほかにも、Claude Code の使い方の質問に答える係(claude-code-guide)や、画面下の表示を設定する係(statusline-setup)などがあります。 どれも自動で呼ばれるので、覚えておく必要はありません。

基本の使い方:3つの頼み方

初心者

どう頼めば使ってくれますか?

芝田

普通の言葉で頼むのが基本。確実に使わせたいときは @ で名前を指定します。

普通の言葉で頼む

いちばん簡単なのは、依頼の中に「サブエージェントを使って」と書くことです。 作った担当がいるなら「○○サブエージェントで」と名前を入れます。

使うかどうかの最後の判断は、Claude に任されます。

@ で名前を指定する

入力欄で @ を打つと、ファイルと並んでサブエージェントの一覧が出ます。 そこから選ぶと、その担当が必ず動きます。

手で打つなら @agent-担当の名前 の形です。

会話全体をその担当にする

claude --agent 担当の名前 で起動すると、会話全体がその担当の決まりと道具で動きます。 点検だけをする会話を開きたいときなどに使います。

コピーして使える頼み方

そのまま使える頼み方を4つ置いておきます。 〇〇の部分を書き換えてください。

サブエージェントを使って、〇〇フォルダの資料をすべて読み、決まったことと数字だけを10行以内でまとめてください。途中で読んだ中身は、この会話に持ち込まないでください。
次の3つを、別々のサブエージェントで同時に調べてください。それぞれの結果を、最後に1つの表にまとめてください。
1. 〇〇の料金
2. 〇〇の使い方
3. 〇〇の注意点
いま作った〇〇(文書・原稿)を、書いた本人ではない別のサブエージェントに読ませて、誤り・抜け・言い過ぎを点検させてください。直すのは点検の結果を見てから、この会話で行います。
Explore サブエージェントで、このフォルダの中から「〇〇」について書いてあるファイルを探し、ファイル名と該当箇所だけを一覧にしてください。

使う場面・使わない場面

初心者

何でもサブエージェントに任せた方が速いですか?

芝田

1つのファイルを探すくらいなら、普通に頼んだ方が速くて安いです。

サブエージェントに向く作業と、普通に頼む方がよい作業を左右に仕分けた図

向いている作業

  • 大量に読む作業(長い資料・たくさんのファイル・記録の山から要点を抜く)
  • 互いに関係のない調べものを、同時に進めたいとき
  • 作った本人とは別の目で点検させたいとき

3つ目は、私がいちばん大事にしている使い方です。 開発記録には、点検役を別に立てる理由を「答案を書いた人に自己採点させない考え方」と書いています。

向いていない作業

公式の説明では、次の作業はメインの会話で行う方がよいとされています。

  • 何度もやり取りしながら直していく作業
  • 計画・作業・確認で、同じ前提を使い回す作業
  • 小さな修正や、すぐに答えがほしいとき(サブエージェントは下調べから始めるので、時間がかかる)

1つのファイルを探す・1か所を直すといった作業には使いません。 普通に頼んだ方が速く、枠も減りません。

体数は調べる対象の数に合わせる

何体使うかは、調べる対象の数で決めます。 資料が5つなら5体まで、テーマが1つなら1体です。

1つのテーマを深く調べたいからといって、体数を増やしてはいけません。 同じテーマを何体もが調べると、結果が重なって枠だけが減ります。

私がこの決め方に落ち着くまでの流れは、最後の節に書きます。

サブエージェントの作り方

初心者

自分用の担当を作るのは難しいですか?

芝田

作りたい担当を Claude に説明すれば、ファイルを書いてくれます。

作るのは同じ役割を何度も頼むとき

最初から入っている担当で足りるうちは、作らなくて構いません。 「資料の要約を毎回同じ形で頼んでいる」「点検を毎回同じ観点で頼んでいる」と気づいたら、作りどきです。

置き場所は2つ

種類 置き場所 使いどころ
自分用 ~/.claude/agents/ どのフォルダでも使いたい担当
プロジェクト フォルダの .claude/agents/ そのフォルダの作業だけで使う担当。チームで共有できる

中身は、1体につき Markdown のファイル1枚です。

サブエージェントの定義ファイルの4項目(名前・説明文・使える道具・モデル)が何を決めるかを示した図

定義ファイルの基本形

資料の要約係の例です。 ~/.claude/agents/doc-summarizer.md として保存すると、どのフォルダからでも呼べます。

---
name: doc-summarizer
description: 長い資料(PDF・議事録・Web ページの保存)を読んで要点をまとめる。「資料を要約して」「この PDF の要点」と頼まれたときに使う。
tools: Read, Glob, Grep
model: sonnet
---

あなたは資料の要約係です。

1. 指定された資料を最後まで読む
2. 結論・数字・決まったことを、箇条書き10行以内にまとめる
3. 資料に書いていないことは書かない
4. 読めなかった資料があれば、その名前を最後に挙げる

上の4項目の役割は次のとおりです。 必須なのは name と description だけです。

  • name:担当の名前(英小文字とハイフン)
  • description:どんな依頼のときに使うか。Claude はここを見て呼ぶかを決める
  • tools:使える道具。書かないと、すべての道具を使える
  • model:使うモデル。sonnet・opus・haiku・fable か inherit(今の会話と同じ)

tools は必要な道具だけに絞るのが安全です。 私の6体のうち4体は、道具の欄が tools: Read, Glob, Grep で、読むことしかできません。

残りの2体も、足しているのは Web を検索する・読む道具だけです。

Claude に作らせるプロンプト

自分で書かなくても、次のように頼めば Claude が作ってくれます。

いつも私が頼んでいる「〇〇(例:資料の要約)」を、Claude Code のサブエージェントにしたいです。

条件
- 保存先は ~/.claude/agents/〇〇.md(〇〇は英小文字とハイフンの名前)
- description には「何をするか」と「どんな頼み方のときに使うか」を書き、私がふだん使う言い方を3つ以上入れる
- tools は、この作業に必要な道具だけにする。ファイルを書き換える必要がなければ Read, Glob, Grep だけにする
- 本文には、手順を番号付きで書き、最後に「何を返すか」(形・長さ)を書く
- 判断に迷う点は、書く前に私に質問する
- 保存する前に、全文を見せて私の確認を待つ

/agents の画面は無くなった

ネットの記事には、/agents と打って出る画面で作る手順がよく載っています。 公式の説明では、v2.1.198 以降、その作成画面は開かなくなりました。

今は、上のように Claude に頼むか、ファイルを直接書きます。 私の手元の Claude Code も、それより新しい版です。

呼ばれないときの直し方

初心者

作ったのに、ちっとも呼ばれません。

芝田

説明文を直すより、呼ぶ側で名前を指定する方が確実です。

説明文に「どんな依頼で使うか」を書く

Claude は、依頼の中身と説明文(description)を見比べて、担当に回すかを決めます。 説明文には、何をする担当かと、どんな頼み方のときに使うかの両方を書きます。

公式の説明では、「use proactively」(積極的に使う)のような言葉を入れると、自分から回しやすくなります。

確実に使わせるなら @ か、呼ぶ手順に組み込む

説明文を直しても、使うかどうかの判断は Claude に残ります。 必ず使わせたいなら、@ で名前を指定するか、スキルの手順の中に「○○サブエージェントに渡す」と書きます。

私も6月に、「6人のスタッフのうち2人が呼ばれない問題」に当たりました。 最初は2体の説明文に「いつ呼んでほしいか」を書き足しました。

ところが開発記録には、それでは「本体AIが文脈から判断する手がかり」を強化しただけ、と書いています。 見逃しは残りました。

そこで、その2体を呼び出すスキルを作りました。 「コードが整合しているか見て」と頼むとスキルが動き、スキルの手順の中で担当を呼ぶ形です。

呼ばれない担当には、呼び出し役を用意するのが確実でした。

新しく作った直後は再起動

作った担当が一覧に出ないときは、Claude Code を起動し直します。 公式の説明では、これが要るのは agents のフォルダを初めて作ったときだけです。

フォルダが前からあれば、数秒で新しい担当を読み込みます。

体数を決めて、大きな作業を分けて回した実録

初心者

何体まで使っていいんですか?

芝田

私は、調べる対象の数に合わせて、1回に同時10体までと決めています。

ここからは私の記録です。 この決まりにしてからは、大きな作業も何回かに分けて回しています。

6月の106体から、7月の3回の失敗を経て、同時10体までの決まりに落ち着くまでを時系列で並べた図

今の決まり:対象の数に合わせ、同時10体まで

今の決まりは2つです。

  • 体数は、調べる対象(資料・テーマ)の数に合わせる。1つのテーマを深くするために増やさない
  • どんな作業でも、1回に同時に動かすのは10体まで。超えるなら何回かに分ける

大きな点検を、何回かに分けて動かしたこともあります。 調整の記録には、そのときのことが「5ラウンド分割で事故ゼロ」と残っています。

起動する前に、何体になりそうかを先に見積もってもらうのもコツです。 自分の決まりには「9体以上はユーザーの明示的許可必須。迷ったら少ない方。」と書いています。

つまずき:決まりが無いと、106体まで増えた

この決まりができるまでには、つまずきもありました。

6月15日、1つのテーマの資料を取り込む作業で、調査用の仕組みが裏でエージェントを次々に起動しました。 失敗の記録には「1タスクで106体のエージェントを起動し利用枠を大量消費」と書いています。

開発記録には「本来1〜3体で済む作業だった。」とあります。

当時の記録では、これを「1人で運べる荷物のためにトラック10台を呼んでしまうようなことが起きていました」とたとえています。 原因は、何体まで使ってよいかの決まりが無かったことでした。

上限の表を作ったあとも、7月に3回、同じ規模になりました。 どれも、見つけた主張を1つずつ3体に確かめさせる調査の仕組みを使ったときです。

  • 7月7日:確認役の75体が全て、5時間の利用上限に当たって失敗した
  • 7月14日:頼み方を長く詳しく書いたら、確かめる主張が増えて「106 体まで膨らみ」、確認役の84体が上限で止まった
  • 7月16日:止まった調査を再開させるたびに枠を使い、記録には「MAX×5 の 5 時間セッション枠を 3 回消費」とある

頼み方を詳しく書くほど、体数が増える仕組みもあると、このとき知りました。 抜け方は、上の「対象の数に合わせ、同時10体まで」と「起動前の見積もり」の2つです。

決まりを作ってからも、はみ出したことはあります。 8月の振り返りには「8/1 の技術調査12体=1ラウンド10体の上限超え」と書きました。

今は、自作の担当が終わるたびに自動で記録を残し、月の振り返りで体数が多すぎなかったかを見直しています。

よくある質問

サブエージェントのモデルは指定できる?

できます。 定義ファイルの model に、sonnet・opus・haiku・fable か、inherit(今の会話と同じ)を書きます。

書かなければ、基本は今の会話と同じモデルで動きます。 頼むときに「この調べものは Sonnet で」と伝えれば、その回だけ別のモデルで動かしてもらうこともできます。

同時に何体まで動かせる?

公式の説明では、初期の設定で同時に20体までです。 20体が動いている間は、21体目を起動できません(設定で変えられます)。

ただ、上限まで使うと枠の減りも速くなります。 私は、上の実録のとおり10体までにしています。

エージェントチームとの違いは?

エージェントチームは、複数の Claude Code が「チーム」として、お互いに直接やり取りしながら進める仕組みです。 2026年9月30日の時点では実験的な機能で、初期の設定では無効です。

サブエージェント エージェントチーム
やり取り 結果を呼び出し元に返す メンバー同士が直接やり取りする
向いている作業 結果だけがほしい調べもの 議論や分担が要る大きな作業
使用量 少なめ(要約だけが戻る) 多い(メンバーごとに1つの Claude)

公式の説明でも、まずはより軽いサブエージェントで足りないかを確かめるよう書かれています。

Codex にもサブエージェントはある?

あります。 今の Codex では初期の設定で使えますが、動くのは頼んだとき、またはプロジェクトやスキルの指示があるときです(2026年9月30日に公式の説明で確認)。

自分用の担当は ~/.codex/agents/ に TOML という形式のファイルで作ります。 Claude Code と同じく、サブエージェントを使うと1人で進めるより多く使用量を使う、と書かれています。

Codex との使い分けは、こちらの記事にまとめています。

まとめ

  • サブエージェントは、別の机で調べて結論だけを持ち帰る助手。最初から入っているので、「サブエージェントを使って」と頼むだけで使える
  • 使うのは、大量に読む作業と、互いに関係ない作業を同時に進めるときだけ。体数は調べる対象の数に合わせ、私は同時10体までにしている
  • 自分で作るのは、同じ役割を何度も頼むとき。道具を絞り、説明文に使う場面を書く。呼ばれないなら、@ で名前を指定するか、呼び出す手順に組み込む

まずは、次に長い資料を読ませるときに「サブエージェントを使って、要点だけ返して」と一言足すところから始めてください。

参考資料・出典

2026年9月30日に確認しました。

企業・事業者のかたへ

自社の業務に AI エージェントを取り入れたい企業・事業者のかた向けに、無料の AI 業務診断を行っています。

無料のAI業務診断を申し込む

個人で学びたいかたへ

Claude Code を自分の仕事で使えるようになるまで、1対1で伴走します。

個別伴走の申込ページへ

この記事を書いた人

芝田拓望のイラスト芝田拓望DevAIse 代表

DevAIse(ディバイズ)代表。毎日5〜15時間、Claude Code と Codex を使い、記事づくり・情報の整理・毎朝のまとめを AI の仕組みにしています。コードを書かずに作ってきたやり方を、1対1の個別伴走でもお伝えしています。

著者ページへ

関連記事

URL をコピーしました