Claude Code Agent Teams 完全ガイド - マルチエージェント開発を一段引き上げる新機能の使い方と実践ポイント

Claude Codeに「Agent Teams（エージェントチーム）」と呼ばれる新機能が追加されました。
これは、1つのClaude Codeセッション内で複数のエージェントを同時に動かし、役割分担させながら協調作業を行わせる仕組みです。

実はこのアプローチ自体は、OpenClaw コミュニティがすでに先行して実装していました。
複数のClaude Codeセッションを連携させ、並列に作業させるという実践的な仕組みが、コミュニティ主導で生まれていたのです。

その考え方が、今回Anthropicによって公式機能としてClaude Code本体に組み込まれました。
プラグインやカスタムスキルは不要で、標準機能として利用できます。

OpenClaw 発のアイデアが公式機能になるまで

OpenClawコミュニティでは以前から、Claude Codeを単体で使うことの限界が意識されていました。
大規模な調査、設計、デバッグなどを1エージェントに任せると、どうしても探索が直線的になり、遠回りが発生します。

そこで生まれたのが、複数のClaude Codeセッションを同時に走らせ、それぞれに専門的な役割を持たせるという運用でした。
各エージェントは独立して作業しつつ、必要に応じて情報を共有し、結果を統合する形です。

この仕組みは実用的で、再現性もあり、実際の開発現場でも使われていました。
そして今回、その発想がそのままClaude Codeの正式機能として採用され、「Agent Teams」という名前で提供されています。

「優秀な個人」としてのClaude Code からチームとしての働きへ

これまでのClaude Codeは、非常に優秀ではあるものの、基本的には1人で作業する前提のツールでした。

タスクを与えると、
調査 → 実装 → 修正 → テスト
という流れを順番にこなしていきます。

この方式はシンプルで分かりやすい一方、次のような弱点もありました。

• 別の視点からの検証が入りにくい
• 仮説が外れた場合、最初からやり直しになる
• 並列化できる作業でも順番待ちが発生する

Agent Teamsは、この構造そのものを変えます。

Agent Teamsによって変わる作業モデル

Agent Teamsでは、最初に「リードエージェント」が立ち上がります。
このリードが、ユーザーから与えられたタスク全体を把握し、作業を分解します。

分解されたタスクごとに「チームメイト」と呼ばれるエージェントが生成され、それぞれが独立したClaude Codeセッションとして動作します。

重要なのは、各チームメイトが単なる補助ではない点です。

• 独自のコンテキストウィンドウを持つ
• 独立した作業空間を持つ
• 他のエージェントと直接会話できる

つまり、1人のエージェントが思考を分岐させるのではなく、複数の思考主体が同時に存在する状態を作ります。

リードエージェントは全体を監督し、タスクの進捗管理、成果物の統合、方向修正を行います。

サブエージェントとの本質的な違い

Claude Codeを使い慣れている人であれば、すでにサブエージェントを使った経験があるかもしれません。

サブエージェントは、特定の小さな作業を一時的に任せる用途に向いています。
調査結果を返してもらい、メインエージェントがそれを利用する、という構造です。

Agent Teamsは、ここが大きく異なります。

チームメイトは一時的な存在ではなく、一定時間「その役割の専門家」として動き続けます。
また、報告先がリードだけではなく、チームメイト同士で直接議論や確認が行われます。

結果として、

• 視点の偏りが減る
• 仮説検証が高速化する
• 作業の並列性が実質的に上がる

といった効果が生まれます。

Agent Teamsが効果を発揮する作業タイプ

Agent Teamsは万能ではありません。
特に効果が高いのは、作業を独立した単位に分けられるケースです。

例えば以下のような場面では、明確なメリットがあります。

• 技術調査や競合分析を複数視点で行う場合
• 新機能開発で、モジュールやレイヤーを分担できる場合
• バグの原因を複数の仮説から同時に検証したい場合
• フロントエンド、バックエンド、テストを分離できる場合

一方で、作業が完全に直列である場合や、同じファイルを複数人が触る必要がある場合は、かえって効率が落ちます。

Agent Teamsを使う前に、「並列化の意味があるか」を考えることが重要です。

Agent Teamsの有効化方法

Agent Teamsは実験機能のため、手動で有効化する必要があります。

最も簡単なのは、Claude Codeの settings.json に以下を追加する方法です。

Code
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

環境変数として直接設定することも可能ですが、設定ファイルに記述しておく方が再利用しやすくなります。

この設定が有効になると、Claude Codeはエージェントチーム関連の指示を解釈できるようになります。

最初のAgent Teamを立ち上げるときの考え方

特別な構文やコマンドを覚える必要はありません。
自然文で「チームを作ってほしい」と伝えるだけです。

ただし、重要なのは役割を明確に書くことです。

例えば、

• UX観点
• 技術設計観点
• 批判的・懐疑的観点

のように、視点や責務が被らない形で指定すると、リードエージェントが適切にタスクを割り振りやすくなります。

曖昧な指示を出すと、リードが構造設計から始める必要があり、その分トークン消費も増えます。

実行中のチームをどう扱うか

チームが起動すると、複数の操作が可能になります。

各チームメイトには直接話しかけることができ、リードを経由する必要はありません。
作業の方向修正や追加質問も、個別に行えます。

また、「デリゲートモード」を使うことで、リードエージェントを調整役に専念させることができます。
これにより、リードが自ら作業を始めてしまうのを防げます。

タスクは自動取得も可能ですが、明示的に割り当てることもできます。
作業完了後は、チームメイトを安全にシャットダウンし、最後にリードが全体をクリーンアップします。

トークン消費を抑えるための実務的な工夫

Agent Teamsは便利ですが、トークン消費は確実に増えます。

チームメイトはリードの会話履歴を引き継がないため、必要な前提情報は生成時の指示に含める必要があります。
この点を怠ると、何度も説明を繰り返すことになり、無駄が増えます。

また、タスクは「成果物が明確なサイズ」に分割するのが理想です。
小さすぎても調整コストが勝ち、大きすぎても方向ズレが起きやすくなります。

現時点での制限事項

研究プレビュー段階のため、いくつか注意点があります。

• セッション再開時にチームメイトは復元されない
• タスク完了ステータスが遅れることがある
• 1セッションにつき1チームのみ作成可能
• split-pane表示はtmuxまたはiTerm2限定

仕様を理解して使えば、大きな問題になることは少ないでしょう。

今後を見据えて

Agent Teamsは、Claude Codeを「単体ツール」から「協調作業環境」へと進化させる機能です。
まだ荒削りな部分はありますが、方向性は明確で、今後の改善も見込まれます。

今の段階から使い慣れておくことで、正式機能化されたときにスムーズに移行できます。
複雑な開発や調査を日常的に行う人にとって、Agent Teamsは今後欠かせない存在になっていくはずです。