Claude Code サブエージェントとエージェントチーム：実践ガイド

サブエージェント、エージェントチーム、オーケストレーション：それが実際に何を意味するのか、いつ必要なのか、そしてそれが広がるときにどのように制御を保つか。

2026年6月1日

「サブエージェント」、「エージェントチーム」、「オーケストレーション」という言葉を見て、何か見逃しているのではと思うかもしれません。短い答え：ほとんどのタスクでは必要ありません。しかし、大きな作業では必要であり、理解する価値があります。

専門用語を使わずに解きほぐしてみましょう。

サブエージェントとは何か

サブエージェントは、それ自身のコンテキスト、プロンプト、ツールの権限を持つ専門のアシスタントです。

メインエージェントが明確に定義されたサブタスクに直面したとき、それをサブエージェントに委任します。そのサブエージェントは独自のコンテキストウィンドウで作業を行い、結果だけを返します。メインエージェントはその全履歴でコンテキストを汚染されることなく、結論を得ます。

ポイントは、メインエージェントのコンテキストをクリーンに保つことです。1つのエージェントが50,000トークンのファイル検索に溺れる代わりに、サブエージェントが検索を行い、有用な3行を報告します。

プロジェクトの.claude/agents/フォルダにサブエージェントを宣言します。それぞれに名前、使用時の説明、システムプロンプトがあります。

---
name: test-writer
description: テストが必要なときや修正が必要なときに使用
---
あなたはテストを書きます。エッジケースのカバレッジを目指し、
ハッピーパスには触れません。プロダクションコードには決して触れません。

エージェントチーム：次のステップ

エージェントチームはClaude Codeに組み込まれたマルチエージェントオーケストレーターです。まだ実験的で、デフォルトでは無効ですが、堅実なエントリーポイントです。

アイデアは：リードエージェントが大きなタスクを分割し、各部分を専門のエージェントに委任します（それぞれ独自のモデル、プロンプト、ツールを持つ）、専門家たちは共有ファイルシステムで並行して作業し、結果がリードに戻ります。

「専門家に委任する」と聞いてサブエージェントを思い浮かべるのは当然です。エージェントチームはそのアイデアをさらに進め、いくつかのエージェントを本当に並行して実行することに重点を置いています。

組み込みのもの以外にも、MulticlaudeやGas Townのようなサードパーティのオーケストレーターがあります。これらは意見が強く、始める際の良い出発点です：あなたが自分の習慣を築くまで、彼らが決定してくれます。

いつ必要か（そしていつ必要でないか）

はっきりさせましょう：マルチエージェントオーケストレーションは、エージェント支援タスクの95%にとって無意味です。日常の作業のほとんどでは、単一のエージェントの方が速くて簡単です。

現時点では、マルチエージェントは大規模プロジェクトに取り組むための高価で実験的な方法です。

必要なとき:

プロジェクトが異なるファイルに触れる独立した部分に分かれるとき。
単一のコンテキストウィンドウで全体を保持できないとき。
広範なリファクタリングやリポジトリ全体の移行を並行化したいとき。

バグ修正、集中した機能、または1人で収まるものには必要ありません。

罠は、1つのエージェントが5分でできることに対して10エージェントの「チーム」を立ち上げることです。タスクが要求しない並列処理に対して、トークンと複雑さを支払うことになります。

実際の問題：可視性

ここであまり語られないことがあります。複数のサブエージェントやエージェントチームを実行した瞬間に、スレッドを失います。

リードが5人の専門家に委任します。誰が作業中ですか？誰が終了しましたか？誰が決定を待っていますか？ターミナルではスクロールするテキストの壁が見え、誰が何をしているのか分かりません。

ここでビジュアルダッシュボードがすべてを変えます。AgentsRoomは各エージェントと各サブエージェントをタイルとして表示し、そのステータスを明示します。委任がどのように行われているかを見て、誰があなたの返信を待っているか、誰がクラッシュしたかを確認できます。テキストの壁が読みやすい地図になります。

そのビューがなければ、マルチエージェントオーケストレーションは日常的に管理できない印象的なデモにとどまります。それがあれば、実際に使えるツールになります。