This page is also available in English.View in English

← ブログに戻る

Claude Code サブエージェントの使い方と3つの場面

更新日 2026-11:Claude Code サブエージェントとは何か、使うべき場面、作り方、並列実行、アドバイザーとの違いを実例でまとめました。

10分で読めます

Claude Code サブエージェントの使い方:使うべき3つの場面と作り方

更新日 2026-11

TL;DR: Claude Code サブエージェントとは、特定のタスクに特化した AI に仕事を任せる仕組みです。それぞれが自分のコンテキストとツールを持ち、結果の要約だけを返します。独立した作業を並列で進めたいときに強く、設計の流れをバケツリレーで渡す使い方は避けましょう。

Claude Code 公式ドキュメントのサブエージェントのページ

Claude Code 公式ドキュメントにあるサブエージェントのページのスクリーンショット。

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

Claude Code サブエージェントとは、特定のタスクに特化した専門家として動く AI のことで、2026年11月時点の公式ドキュメントでは、それぞれが自分のコンテキストウィンドウ、システムプロンプト、使えるツールを持つと説明されています。メインの会話を汚さず、終わったら要約だけを返します。

AI にいろいろな機能を追加していると、プロンプトが巨大化して動きが不安定になってしまうことがあります。何が原因なのでしょうか。

それは一人の AI に設計も開発もテストも全部やれと詰め込みすぎているからだよ。人間でも一人で全部完璧にこなすのは無理だろう。大切なのはサブエージェントという考え方による役割分担なんだ。

確かに特定のタスクに特化した専門家チームを作るようなイメージですね。

処理の正確性とメンテナンス性が劇的に上がるんだ。

各 AI は自分の任務に集中できるから、もっともらしい嘘をつくハルシネーションも減る。まさに業務の細分化だね。

サブエージェントを使うべき3つの場面

サブエージェントを使うべき場面とは、1つのエージェントに任せると混乱しやすい作業のことです。2026年11月の解説動画では、独立した作業を並列で進めたいとき、そして使うべき MCP ツールやスキルが多すぎるときが挙げられていました。逆に、順番に依存する作業には向きません。

3 つ目は、単一のエージェントでは、ツール選択や指示の衝突を解消しにくいときですね。

これも 1 番目と同じような感じで使うべき MCP ツールとかサブエージェントとか、スキルなんかの項目が多いときとかに、単一のエージェントだと、なかなかそれを適切に使い分けたり。呼び出したりすることが難しいときは、責務を分けて その作業をサブエージェントに任せるとか。

いずれにしてもこの 2 番目ですね。独立した作業を並列で進めたいという場合に使うのがいいかなと思います。

ただ注意点としては、設計計画を立てるっていう独立した作業でも、こういった サブエージェントにバケツリレーをするような使い方っていうのは避けるべきであるという点が注意ですね。

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

サブエージェントの作り方とは、Markdown ファイルを1つ用意することです。2026年11月時点の公式ドキュメントでは、上に YAML の設定(name、description、tools、model)、下にシステムプロンプトを書き、プロジェクト用は .claude/agents/、全プロジェクト用は ~/.claude/agents/ に置きます。Claude に頼んで作らせることもできます。

各エージェントに明確な役割と完了条件を与えれば、複雑なプロジェクトもスムーズに完遂できるようになるよ。

大事なのは技術力よりも人間の業務フローをどこまで具体的に言語化できるかだ。

まずは業務を可視化して、どの部分をサブエージェントに任せるか整理してみます。小さな成功を積み重ねるマインドで、まずはシンプルな 2 体構成から挑戦してみるといい。

並列で動かす:オーケストレーターとワーカー

オーケストレーターワーカーパターンとは、メインのエージェントが計画を立て、複数のサブエージェントに作業を配って並列で進める使い方です。2026年11月の解説では、作業時間を短くしながら作業範囲を広げられる方法として紹介されています。呼び出しは自然言語で頼むだけで大丈夫です。

そこからサブエージェントをファンアウトして並列でサブエージェント起動し。それらのサブエージェントにいろんな観点で並列で作業させる。

そうすることで、作業時間を短縮しつつ、作業範囲を広げることができる。なおかつ、メインのエージェントをできるだけ実作業ではなく、設計であったり、上流の部分に集中させることができます。

サブエージェントへの依頼を日本語でそのまま打ちます。

この30タスクを30のサブエージェントでやれとか言ったら、やってくれます。皆さんが話してるエージェントは、親エージェントです。で、サブエージェントは、子供を産み落として、子供に仕事させるみたいな感じが、イメージとしてあってます。

サブエージェントのベストプラクティスを解説する動画の画面

専用のサブエージェントに仕事を任せる流れを解説した動画の画面。

サブエージェントとアドバイザーの違い

アドバイザーとは、作業中の Claude が要所でより強いモデルに相談する機能で、2026年11月時点の公式ドキュメントでは /advisor コマンドで設定する実験的な機能とされています。サブエージェントとよく混同されますが、見ているものも役割も違います。

相談役は会話を全部読むの。でも手は出さない。返すのは助言だけ。

相談しがちな場面は 3 つ。やり方を決める前、同じエラーが続くとき、終わったという前、いつ相談するかはクロードが決めるわ。

相談役は会話を全部、サブエージェントは依頼文だけなのだ。

違い、やること。相談役は口だけ。サブエージェントは仕事を丸ごとなのだ。長い作業ほど、会話を覚えている相談役が効くのだ。調べ物はサブエージェント、迷うお仕事は相談役なのだ。

Pachat で別の視点を足す

Pachat とは pachat.ai で使えるウェブ製品で、公式サイトでは「Different personal AI agents, in one group chat.」と紹介されています。サブエージェントが1つのツールの中の分業なら、Pachat は違う AI 同士に同じ問いを投げる場所です。

  1. サブエージェントの設計案や、作業の分け方の案をまとめます。
  2. pachat.ai を開き、Claude、Grok Bot、Muse、ChatGPT のドットを1つのグループチャットに入れます。
  3. 案を貼って、分け方に無理がないか聞きます。お互いの事実を確かめ合い、議論し、最後はあなたが決めます。

あわせて Claude Code の使い方、Claude Code エージェントチーム、Claude Code のリモートコントロールも読んでみてください。

よくある質問

Claude Code サブエージェントとエージェントチームの違いは?

サブエージェントは1つのセッションの中で動き、仕事を終えると要約だけをメインに返します。2026年11月時点の公式ドキュメントでは、互いにやり取りしながら協力する複数のセッションが必要ならエージェントチーム、独立した並列セッションならバックグラウンドエージェントを使うよう案内されています。

サブエージェントはどこに保存しますか?

Markdown ファイルとして保存します。今のプロジェクトだけで使うなら .claude/agents/、すべてのプロジェクトで使うなら ~/.claude/agents/ に置きます。2026年11月時点では、Claude Code がこのフォルダを監視しているので、編集は数秒で反映され、再起動は不要です。チームで使うならプロジェクト側をバージョン管理に入れましょう。

/agents コマンドはまだ使えますか?

2026年11月時点の公式ドキュメントでは、v2.1.197 以前の /agents は対話形式の作成画面を開きますが、新しいバージョンでは Claude に頼むか、.claude/agents/ を直接編集するよう促すメッセージを表示します。一番簡単なのは「読み取り専用のコードレビュー用サブエージェントを作って」と Claude に頼むことです。

サブエージェントに使えるツールを制限できますか?

できます。YAML の tools 項目に、例えば Read、Grep、Glob のように許可するツールだけを書けば、読み取り専用のサブエージェントになります。公式ドキュメントには、探索用の Explore、計画用の Plan、汎用の General-purpose という3つの組み込みサブエージェントもあり、2026年時点では Explore が読み取り専用です。

サブエージェントはいくつ同時に動かせますか?

タスクを分けて頼めば、複数を並列で動かせます。2026年10月の解説動画では「30タスクを30のサブエージェントでやれ」と日本語で頼む例が紹介されていました。ただし、前の結果に依存する作業を順番に渡すバケツリレー型の使い方は避け、独立した作業だけを並列にしましょう。

Pachat はサブエージェント設計に役立ちますか?

役立ちます。Pachat は pachat.ai で使えるウェブ製品で、Claude、Grok Bot、Muse、ChatGPT のドットを1つのグループチャットに入れられます。サブエージェントの役割分担の案を貼り、3つ以上の視点から抜けや重複がないか聞いてみましょう。お互いの事実を確かめ合い、議論し、最後はあなたが決めます。

異なる AI を1つのグループチャットに入れてみませんか? pachat.ai から始めましょう。

References

  • Claude Code Docs, "Create custom subagents," fetched 2026-11-18: https://code.claude.com/docs/en/sub-agents
  • Claude Code Docs, "Escalate hard decisions with the advisor tool," fetched 2026-11-18: https://code.claude.com/docs/en/advisor
  • @kee11nig, 2025-07-30: https://x.com/kee11nig/status/1950352602660520410
  • @akalink_soma, 2026-04-27: https://x.com/akalink_soma/status/2048561651532837346
  • @papaneco_life, 2026-10-01: https://x.com/papaneco_life/status/2105642379437060530
  • @starriver0513, 2026-10-29: https://x.com/starriver0513/status/2115763904882032831
  • @msyn_ai, 2026-11-07: https://x.com/msyn_ai/status/2119091969737855382
  • @msyn_ai, 2026-11-12: https://x.com/msyn_ai/status/2120762814990340136
シェアXLinkedInFacebookRedditWhatsAppメール

ほかの記事

すべての記事 →

いま決めたいことから始めましょう。