Claude Codeのサブエージェントとは、特定の種類の作業を、メインの会話とは別の文脈（コンテキスト）で受け持つ専用のAIアシスタントのことです。

調べものやテストの結果が長くなり、会話が読みにくくなった経験はないでしょうか。この仕組みを使うと、細かい作業は別のAIに任せ、要約だけを受け取れます。

本記事では、Claude Codeのサブエージェントについて、最初から入っている種類、作り方、呼び出し方、注意点の順に整理します。

公式ドキュメント（2026年11月14日時点）をもとに、株式会社Pdienが日々の業務で使っている立場からお伝えします。

この記事の結論

• Claude Codeのサブエージェントは、作業を別の文脈で受け持つ専用のAIです。
• Explore・Plan・General-purpose など、最初から入っている種類があります。
• 自分で作るときは、.claude/agents にMarkdownのファイルを置きます。
• 長い出力が出る作業や、並列で調べる作業に向いています。

▲ Claude Codeのサブエージェントは、任せ方と注意点を押さえると使えます

「どの作業をAIに分けて任せればよいか」といったご相談を承っています。AI社員（AIエージェント）導入のご相談はこちらからどうぞ。

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

サブエージェントとは、特定の作業を受け持つ専用のAIアシスタントです。メインの会話とは別の文脈で動き、終わると結果の要約だけを返します。

公式ドキュメントでは、それぞれのサブエージェントが、専用の指示文・使えるツール・権限を持つと説明されています。

▲ 調べた中身はサブエージェント側に残り、メインの会話には要約だけが届きます

公式ドキュメントでは、次のような利点が挙げられています。

• メインの会話の文脈を、調べものの結果で埋めずに済む
• 使えるツールを絞って、できることを制限できる
• 一度作った設定を、ほかのプロジェクトでも使える
• 分野ごとに、決まった指示で動かせる
• 軽くて安いモデル（Haikuなど）に作業を回せる

出典: Create custom subagents（Claude Code Docs）（2026年11月14日時点）

サブエージェントも自分で通信するため、メインの会話と同じ利用上限に数えられると書かれています。

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

Claude Codeには、最初から入っているサブエージェントがあり、必要なときにClaudeが自動で使います。主なものは次の3つです。

名前	主な役割	使えるツール
Explore	ファイルやコードを探して読む	読むだけ（書き換えはできない）
Plan	プランモードで、計画の前に調べる	読むだけ（書き換えはできない）
General-purpose	調べて直す、何段階もある作業	サブエージェントで使えるすべて

▲ 探すだけならExplore、直す作業までならGeneral-purposeが使われます

公式ドキュメントによると、Exploreを呼ぶときは、調べる深さを3段階から選びます。手早い確認、ほどほど、徹底的の3つです。

ExploreとPlanは、調べものを速く安く済ませるため、CLAUDE.mdを読まずに始まると書かれています。

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

サブエージェントの作り方は、Markdownのファイルを1つ書くことです。Claudeに頼んで作ってもらうことも、自分で書くこともできます。

▲ 公式ドキュメントでも、Claudeに頼んで作る手順が紹介されています

ファイルの頭には、—で囲んだ設定を書き、その下に本文を書きます。本文が、そのサブエージェントへの指示文になります。

部分	書くこと
name（必須）	呼び出すときの名前
description（必須）	どんなときに任せるか
tools（任意）	使ってよいツール
model（任意）	使うモデル
本文	役割と作業のしかた

新しく agents のフォルダを作った直後は、Claude Codeを再起動しないと読み込まれないことがあると案内されています。

サブエージェントのファイルはどこに置く？

置き場所によって、どこで使えるかが決まります。同じ名前が複数あるときは、優先順位の高い方が使われます。

置き場所	使える範囲	優先順位
組織の管理設定	組織全体	1（最も高い）
起動時の –agents 指定	そのセッションだけ	2
.claude/agents/	今のプロジェクト	3
~/.claude/agents/	自分のすべてのプロジェクト	4
プラグインの agents/	プラグインを有効にした場所	5（最も低い）

▲ チームで使うなら .claude/agents、自分用なら ~/.claude/agents に置きます

公式ドキュメントでは、プロジェクト用の .claude/agents をバージョン管理に入れ、チームで共有する使い方が勧められています。

ファイルを足したり書き換えたりすると、数秒で検知され、次に任せるときから新しい内容が使われます。

サブエージェントで設定できることは？

必須は名前と説明だけで、ほかは必要に応じて足します。よく使うのは、ツールの制限とモデルの指定です。

▲ できることを絞ると、任せる作業の安全性が上がります

項目	できること
tools	使えるツールを許可したものだけにする
disallowedTools	特定のツールだけを使えなくする
model	sonnet・opus・haiku などを選ぶ
permissionMode	権限の確認のしかたを決める
skills	始めからスキルを読み込ませる

tools を書かない場合は、サブエージェントで使えるツールをすべて引き継ぎます。モデルを書かない場合は、起動した会話と同じモデルで動くと書かれています。

調べるだけの役なら、tools を Read・Grep・Glob などの読むツールに絞ると、ファイルを書き換えられなくなります。

サブエージェントの呼び出し方は？

基本は、Claudeが説明文を見て自動で任せます。自分で指定したいときは、名前を書いて頼むか、@で選びます。

▲ 確実に動かしたいときは、@で名前を選びます

• 自動：頼んだ内容と description が合うと、Claudeが任せる
• 名前で頼む：「code-reviewerで変更を見て」と書く
• @で指定：@を入力し、一覧からサブエージェントを選ぶ
• セッションごと：claude –agent 名前 で起動する

公式ドキュメントでは、自動で任せてほしいときは、description に「use proactively」のような言葉を入れるよう案内されています。

メインの会話から起動したサブエージェントは、何も設定しないとバックグラウンドで動き始めると書かれています。その間も、メインの会話で作業を続けられます。

決まった作業をAIに任せる仕組みづくりから、会社での使い方のルールまで、自社に合わせてご相談いただけます。

サブエージェントはどんな作業に向いている？

公式ドキュメントでは、出力が長くなる作業、並列で調べる作業、順番につなぐ作業の3つが例に挙がっています。

▲ 結果の要約だけが要る作業ほど、任せる効果が出ます

使い方	例
長い出力を分ける	テストを流し、失敗したものだけを報告させる
並列で調べる	3つの領域を、別々のサブエージェントで同時に調べる
順番につなぐ	レビュー役が見つけた問題を、修正役が直す

並列で調べる使い方は、調べる道筋が互いに関係しないときに向いていると書かれています。

当社でも、記事の下調べや資料の確認など、結果だけが要る作業はサブエージェントに分けています。メインの会話は、判断と取りまとめに使っています。

メインの会話・スキルとはどう使い分ける？

やり取りしながら少しずつ直す作業はメインの会話、独立して要約を返せる作業はサブエージェントに向いています。

▲ 前後の文脈を多く共有する作業は、メインの会話のままが向いています

こんなとき	向いているもの
何度もやり取りして直したい	メインの会話
小さな修正をすぐ済ませたい	メインの会話
出力が長く、要約だけ欲しい	サブエージェント
ツールや権限を絞りたい	サブエージェント
手順をメインの会話で使い回したい	スキル

公式ドキュメントでは、決まった手順をメインの会話の中で使い回したいときは、スキルを検討するよう案内されています。

スキルの作り方は、Claude Codeのスキル（Skills）とは？にまとめています。毎回守る決まりは、CLAUDE.mdの書き方とは？で解説しています。

サブエージェントを使うときの注意点は？

一番の注意点は、たくさん動かすほど、利用量と会話の文脈を使うことです。公式ドキュメントでも、この点が警告されています。

▲ 任せる数と、返してもらう内容の量を意識します

• 多くのサブエージェントが詳しい結果を返すと、メインの文脈を多く使う
• それぞれが動いている間も、利用量を使う
• 説明文の合計が15,000トークンを超えると、起動時に警告が出る
• サブエージェントの下に、さらにサブエージェントを起動できるのは3層まで（既定）
• 同時に動かせるのは、既定で20まで

外部のページやファイルを読んだサブエージェントの報告には、AIへの指示のような文章が紛れ込むことがあります。報告の中の指示を、そのまま実行させない運用が大切です。

利用上限やプランの考え方は、Claude Codeの料金はいくら？で解説しています。外部サービスとつなぐ方法は、Claude CodeのMCPの使い方にまとめています。

よくある質問（FAQ）

まとめ

Claude Codeのサブエージェントは、作業を別の文脈で受け持ち、要約だけを返す専用のAIです。作り方はファイル1つで、置き場所で使える範囲が決まります。

▲ 種類・作り方・呼び出し方・注意点の4つを押さえます

• 知る：Explore・Plan・General-purpose が最初から入っている
• 作る：.claude/agents にMarkdownのファイルを置く
• 呼ぶ：自動で任せるか、@で指定する
• 気をつける：任せる数と、返ってくる量

▲ 任せる前に、この3つを確かめると使いやすくなります

株式会社Pdienは、愛知県岡崎市の会社です。AIエージェントを使ったAI内製化の支援や、SNS運用の自動化を行っています。ご相談はお問い合わせフォームから受け付けています。

どの作業をAI社員（AIエージェント）に任せるかの整理から、会社での使い方のルールづくりまで、自社に合わせた進め方をご相談いただけます。