Claude Codeを使っていると、「調べものを頼んだら、会話が長くなって動きが重くなった」と感じることがあります。ログや検索結果のような大量の文字が、会話の中にどんどん積み上がっていくためです。
こうした場面で役に立つのが「サブエージェント」というしくみです。この記事では、公式ドキュメントの内容にもとづいて、サブエージェントとは何か、どんな種類があるのか、自分用に作るにはどうするのかを整理します。結論を先に言うと、サブエージェントは「別の作業スペースで調べものや作業を任せ、結果の要点だけを持ち帰ってもらう助手」です。
サブエージェントとは?
公式ドキュメントでは、サブエージェントを「特定の種類のタスクを担当する専門のAIアシスタント」と説明しています。それぞれが次のものを独自に持っています。
- 独自のコンテキストウィンドウ(AIが一度に覚えておける作業スペースのようなもの)
- 独自のシステムプロンプト(その助手への基本の指示)
- 使えるツールの範囲
- 独立した権限
たとえて言うと、自分(メインの会話)が机で作業している横で、別の机に座った助手に「この件を調べておいて」と頼むイメージです(あくまでイメージです)。助手が広げた資料はその机の上に残り、自分の机には「調べた結果のまとめ」だけが届きます。

どんなときに便利なのか
公式ドキュメントが挙げている主な利点は、次のとおりです。
| 利点 | 内容 |
|---|---|
| コンテキストの節約 | 調べものなどの作業を本体の会話の外に置き、要約だけを返してもらう |
| ツールの制限 | 「読むだけ」など、使える道具を絞れる |
| 設定の再利用 | 一度作った助手を、ほかのプロジェクトでも使える(ユーザー用の保存場所に置いた場合) |
| 専門的な振る舞い | 特定の用途に合わせた指示を持たせられる |
| コストの管理 | 軽いモデル(Haikuなど)に振り分けることもできる |
特に向いているのは、検索結果やログのように、あとで見返さない大量の出力が出る作業です。公式ドキュメントも、こうした副次的な作業で主会話が埋まりそうなときに使うよう案内しています。
最初から入っている「組み込み」のサブエージェント
自分で作らなくても、Claude Codeにはあらかじめ用意された助手がいます。公式ドキュメントの表のうち、主なものは次のとおりです。
| 名前 | 役割 | 特徴 |
|---|---|---|
| Explore | ファイルの探索・検索、調査 | 読み取り専用(ファイルの編集・作成はできない) |
| Plan | plan mode(計画だけ立てるモード)中の調査 | 読み取り専用 |
| general-purpose | 調べることと変更の両方が必要な、複数ステップの作業 | 使えるツールは広い |
このうちExploreとPlanは、CLAUDE.mdなどを読み込まず、起動を軽くしている旨が書かれています。多くの場合、これらはClaudeが必要に応じて自動で使います。ふだんは意識しなくても、調べものの場面で裏側で働いていることがあります。
自分用のサブエージェントを作るには
用途が決まっているなら、自分専用の助手を作れます。方法は主に次の3つです。
- Claudeに頼んで作ってもらう:「こういう役割の助手を作って」と説明すると、Claudeが必要なファイルを書いてくれます。
- ファイルを自分で書く:Markdown形式のファイルを所定の場所に置きます。
- 起動時に一時的に指定する:`–agents` というオプションで指定します。この場合、そのセッションだけの設定で、保存されません。
ファイルで作る場合、上のほうに設定(YAML形式の「frontmatter」)を書き、その下に助手への指示文を書きます。公式ドキュメントの例は次の形です。
“` — name: code-reviewer description: Reviews code for quality and best practices tools: Read, Glob, Grep model: sonnet — (ここに、その助手への指示文を書く) “`
必須なのは `name`(名前)と `description`(どんなときに使うかの説明)の2つです。ほかに、使えるツールを絞る `tools`、使うモデルを決める `model` などを任意で指定できます。
保存場所は、使う範囲によって次のように分かれます。
| 場所 | 範囲 |
|---|---|
| `.claude/agents/` | 今のプロジェクトだけ |
| `~/.claude/agents/` | 自分のすべてのプロジェクト |
同じ名前の助手が複数あるときは、公式ドキュメントの優先順位(組織の管理設定、`–agents`、プロジェクト、ユーザーの順)で、優先度の高いものが使われます。
呼び出し方
Claudeは、各サブエージェントの `description` を見て「この作業は任せよう」と判断します。そのため、説明文は「どんなときに使う助手か」が伝わるように書くことが大切です。
自分から指定したいときは、「code-improverエージェントを使って、このプロジェクトの改善点を提案して」のように、名前を出して頼めます。
知っておきたい注意点
権限は親の設定を引き継ぐ
公式ドキュメントによると、サブエージェントは親の会話の権限ルールを引き継ぎます。「サブエージェントなら何でもできる」というわけではありません。権限の考え方は、Claude Codeの「権限」とは?で整理しています。
使用量はふつうに消費される
サブエージェントが送るリクエストも、メインの会話と同じ使用量の制限に数えられます。会話が軽くなるからといって、使用量が減るとは限りません。
ファイルが読み込まれないことがある
自作したのに使われない場合、`name` や `description` が抜けている、設定部分の書き方が崩れている、といった理由で、エラーが出ないまま読み込みがスキップされることがあります。まず書き方を見直してみてください。
やり取りの多い作業は、本体の会話のほうが向く
公式ドキュメントでは、何度も行き来しながら進める作業や、すぐに返事が欲しい作業は、メインの会話で行うほうが適しているとされています。サブエージェントは「まとまった調べものを任せる」場面に向いています。
プラグインのサブエージェントは一部の設定が使えない
プラグインとして配られるサブエージェントでは、安全上の理由から `hooks`・`mcpServers`・`permissionMode` の設定が無視されます。
よくある疑問
サブエージェントを使わないと、Claude Codeは使えませんか?
いいえ。使わなくても、Claude Codeの基本的な使い方はできます。会話が長くなって困ったときや、同じ種類の作業を繰り返し任せたいときに、あとから取り入れる機能です。
設定ファイルの書き方が不安です。
最初から自分で書く必要はありません。「こういう用途の助手が欲しい」とClaudeに説明して、作ってもらう方法があります。
どんな助手を作るべきか、そもそも何を任せるべきかが分かりません。
当社では、Claude Codeの説明から導入までをサポートしています。やりたいことを伝えていただければ、設定は当社で行います。見積りはヒアリングのうえ、個別に対応します。何を任せるかの考え方は、AIエージェントに任せやすい仕事、任せにくい仕事の見分け方でも整理しています。
まとめ
サブエージェントは、独立した作業スペースで調べものや作業を任せ、要点だけを持ち帰ってもらうしくみです。会話が大量の文字で埋まるのを防ぎ、使える道具や使うモデルを絞った専門の助手を作ることもできます。
一方で、権限は親から引き継がれ、使用量も消費されます。最初は組み込みの助手が裏側で働くままにして、「同じ種類の調べものを何度も頼んでいる」と感じたときに、自分用の助手を作ってみるのが無理のない進め方です。


