Claude Code Agent Teamsの使い方｜複数AIエージェントをチームで協働させる方法

Claude Code Agent Teamsは、1人の開発者が複数のAIエージェントをチームとして編成し、並列でタスクを実行させる機能です。チームリードがタスクを分配し、チームメイトが独立して作業を進め、完了後にリードが統合する——この仕組みにより、従来の3〜5倍の開発速度を実現できます。

この記事でわかること

Claude CodeのAgent Teams機能で複数エージェントを並列稼働させたい開発リーダーに向けた記事です。

• Agent Teamsの基本概念と、チームリード・チームメイトの役割分担 — ClaudeCodeAgentTeamsは、複数のClaudeCodeインスタンスを「チーム」として構造化し、協調動作させる機能です。
• tmuxベースのマルチペイン表示で全エージェントの進捗を一覧管理する方法 — AgentTeamsを起動するには、コマンドにフラグを付与します。
• タスク共有ファイル（AGENT_SYNC.md）による計画承認と同期プロトコル — AgentTeamsでは、チーム内の同期にファイルを使用します。
• HubSpotコンサルティングとブログ制作を並列で進める実務活用パターン — BtoBマーケティングでは、クライアント向けのHubSpot設定作業と自社ブログの制作を同時に進めたい場面が日常的に発生します。
• Agent Teamsの制約と、効果的なタスク分割の考え方 — AgentTeamsの効果を最大化するには、タスク分割の粒度が重要です。

Agent Teamsとは

Claude Code Agent Teamsは、複数のClaude Codeインスタンスを「チーム」として構造化し、協調動作させる機能です。単に複数ターミナルを開いて個別にClaude Codeを動かすのとは根本的に異なり、リード・チームメイト間の役割分担、タスクの委任と進捗追跡、成果物の統合までを一貫して管理できます。

従来のマルチエージェント開発では、開発者自身がオーケストレーターとして各エージェントに指示を出し、結果を手動で統合する必要がありました。Agent Teamsでは、チームリードエージェントがこのオーケストレーション自体を担当するため、開発者は「何を達成したいか」を伝えるだけで済みます。

基本的な使い方

チームの起動方法

Agent Teamsを起動するには、claude コマンドに --team フラグを付与します。

# 基本的なチーム起動（リード1 + チームメイト2の構成）
claude --team --teammates 2

# チームメイト数を指定して起動
claude --team --teammates 4

# 特定のCLAUDE.mdを使ったチーム起動
claude --team --teammates 3 --config .claude/team-config.md

起動すると、tmuxセッションが自動生成され、リードエージェントが上部ペイン、チームメイトが下部ペインに配置されます。

チーム構成の全体像

tmux表示の操作

Agent Teams起動後のtmuxセッションでは、以下のキーバインドで操作できます。

Ctrl+b → o      : ペイン間の移動
Ctrl+b → z      : 現在のペインを全画面表示/復帰
Ctrl+b → [      : スクロールモード（qで終了）
Ctrl+b → :      : tmuxコマンド入力

リードペインには全チームメイトのステータスサマリーがリアルタイムで表示されるため、各エージェントの進捗を一目で確認できます。

タスク分配の流れ

Agent Teamsの動作フローは以下の通りです。

1. 計画フェーズ: リードが指示を分析し、タスク分割案を作成する
2. 承認フェーズ: 開発者がタスク分割案を確認し、承認または修正を指示する
3. 実行フェーズ: 承認されたタスクが各チームメイトに自動分配される
4. 同期フェーズ: チームメイトが完了報告し、リードが成果を統合する
5. レビューフェーズ: リードが統合結果を検証し、開発者に最終報告する

計画承認のステップが入ることで、「AIが勝手に間違った方向に全力で走り出す」リスクを排除できます。

実務での活用パターン

パターン1: HubSpotコンサル×ブログ制作の並列作業

BtoBマーケティングでは、クライアント向けのHubSpot設定作業と自社ブログの制作を同時に進めたい場面が日常的に発生します。

Before（Agent Teams導入前）:

1. HubSpotのプロパティ設定スクリプトを作成（1時間）
2. 完了を待ってからブログ記事の執筆に着手（2時間）
3. 記事のHTML変換とレビュー（30分）
4. 合計: 3.5時間（直列処理）

After（Agent Teams導入後）:

開発者: 「HubSpotのスコアリング設定とブログ記事DD-10の制作を並列で進めて」

チームリード → タスク分割:
├── チームメイトA: HubSpotスコアリングプロパティの設定スクリプト作成
├── チームメイトB: ブログ記事DD-10のMD原稿執筆
└── チームメイトC: 既存記事の内部リンク整合性チェック

→ 合計: 1.5時間（並列処理）

AGENT_SYNC.mdファイルを使った同期により、チームメイトBが記事を書きながらチームメイトCが関連記事の内部リンクを確認し、執筆中の記事に最適なリンク先をフィードバックする——といった協調動作が実現します。

パターン2: フルスタックアプリケーションの機能追加

Next.js + Supabase構成のWebアプリに新機能を追加する場合、フロントエンド・バックエンド・テスト・ドキュメントの4つのタスクが発生します。

Before:

各タスクを順番に処理。API設計→バックエンド実装→フロントエンド実装→テスト→ドキュメントで、合計8時間。

After:

チームリード → 計画承認後に自動分配:
├── チームメイトA: Supabase RLS設計 + APIエンドポイント実装
├── チームメイトB: React コンポーネント + 画面実装
├── チームメイトC: E2Eテスト + ユニットテスト作成
└── チームメイトD: APIドキュメント + 変更履歴更新

ポイントは、チームリードがファイル所有権を明確に分離することです。チームメイトAは src/app/api/ 配下のみ、チームメイトBは src/components/ と src/app/(routes)/ 配下のみ、というように作業領域を分けることで、Git上のコンフリクトを防ぎます。

パターン3: 大規模リファクタリングとテスト並行

既存コードベースのリファクタリングでは、「コードを変更する作業」と「変更が正しいことを検証する作業」を並列化できます。

Before:

リファクタリング→テスト→修正→再テストのサイクルを逐次実行。修正のたびにテストを回し直すため、待ち時間が発生。

After:

チームリード → タスク分割:
├── チームメイトA: モジュールXのリファクタリング実行
├── チームメイトB: モジュールYのリファクタリング実行
└── チームメイトC: テストウォッチャーとして常駐
    （A/Bの変更を検知するたびに自動テスト実行→結果をリードに報告）

チームメイトCが「テスト専門エージェント」として常駐し、他のチームメイトの変更をリアルタイムで検証することで、問題の早期発見が可能になります。

AGENT_SYNC.mdによるタスク管理

AGENT_SYNC.mdの基本構造

Agent Teamsでは、チーム内の同期に AGENT_SYNC.md ファイルを使用します。このファイルはチームリードが自動生成し、全チームメイトが参照・更新します。

# AGENT_SYNC

## 現在のタスク分配

<img src="https://start-link.jp/hubfs/blog/h2-kv/DD-10_h05.png" alt="現在のタスク分配" style="width:100%;max-width:1200px;height:auto;margin:24px 0;border-radius:12px;box-shadow:0 4px 16px rgba(0,0,0,0.08);"/>

### チームメイトA（HubSpot設定）
- 状態: 作業中
- 担当: スコアリングプロパティ設定
- ファイル所有権: 06_dev/scoring/
- 開始: 14:00
- 備考: API rate limit注意（100 req/10sec）

### チームメイトB（記事制作）
- 状態: 完了
- 担当: DD-10記事執筆
- ファイル所有権: 01_marketing/blog/articles/ai/claude-code-practice/
- 完了: 14:45
- 成果物: article_DD-10.md（3,200文字）

## 共有ルール

<img src="https://start-link.jp/hubfs/blog/h2-kv/DD-10_h06.png" alt="共有ルール" style="width:100%;max-width:1200px;height:auto;margin:24px 0;border-radius:12px;box-shadow:0 4px 16px rgba(0,0,0,0.08);"/>
- article_to_post_map.jsonへの同時書き込み禁止
- HubSpot APIは10秒間に100リクエスト以内

計画承認プロトコル

Agent Teamsの重要な安全機構が「計画承認」です。チームリードがタスク分割案を作成した時点で、必ず人間の承認を求めます。

承認フローの具体例を見てみます。

[チームリード] 以下のタスク分割を提案します:

タスク1: HubSpotカスタムプロパティの一括作成（チームメイトA）
  - 所要時間見積: 20分
  - 必要権限: HubSpot API書き込み
  - リスク: 既存プロパティとの名前衝突

タスク2: ブログ記事5本のMD生成（チームメイトB）こうした取り組みの詳細は、[経営データの可視化](https://start-link.jp/service/claude-code/business-intelligence)や[コンテンツマーケティングの支援](https://start-link.jp/service/claude-code/content-marketing)のページでもご紹介しています。
  - 所要時間見積: 40分
  - 必要権限: ファイルシステム書き込み
  - リスク: 記事IDの重複

承認しますか？ [Y/n/修正指示]

この承認ステップにより、AIが想定外のAPI呼び出しを大量実行したり、ファイルを誤って上書きしたりするリスクを事前に排除できます。

関連コマンドとの組み合わせ

Hooksとの連携

Claude Code HooksとAgent Teamsを組み合わせると、チームメイトの作業完了をトリガーにしてlintやテストを自動実行できます。たとえば、チームメイトがファイルを書き込んだタイミングで PostToolUse フックが発火し、自動的にESLintを実行する——という構成が可能です。

カスタムコマンドとの連携

カスタムコマンド（/commands）を定義しておくと、チームリードがチームメイトに対して標準化されたタスクを委任できます。たとえば /review-article コマンドを定義しておけば、リードは「チームメイトBに /review-article DD-10 を実行させる」という形で、一貫したレビュープロセスを適用できます。

マルチエージェント開発との違い

マルチエージェント開発は手動で複数セッションを管理するアプローチですが、Agent Teamsはその上位互換として、チーム構成・タスク分配・同期プロトコルを自動化したものです。小規模タスクには従来のマルチエージェント開発、中〜大規模のプロジェクトにはAgent Teamsが適しています。

Agent Teamsを効果的に使うためのベストプラクティス

タスク分割の粒度

Agent Teamsの効果を最大化するには、タスク分割の粒度が重要です。

目安として、1つのタスクが「10〜30分で完了する独立した作業単位」になるように分割するのが効果的です。

コンフリクト回避の鉄則

Agent Teamsで最も注意すべきは、複数のチームメイトが同じファイルを同時に編集するコンフリクトです。

1. ファイル所有権の明確化: 各チームメイトが触れるファイル/ディレクトリを事前に定義する
2. 共有ファイルへの排他制御: article_to_post_map.json のような共有データは、1つのチームメイトのみがアクセスする
3. worktreeによるブランチ分離: 各チームメイトを独立したGit worktreeで動作させ、物理的にコンフリクトを防ぐ

まとめ

Claude Code Agent Teamsは、AIエージェントをチームとして構造化し、リードによるタスク分配と計画承認を通じて安全に並列作業を実行する仕組みです。tmuxベースの統合表示で全エージェントの進捗を一覧管理でき、AGENT_SYNC.mdによる同期プロトコルでファイル競合を防止します

実践にあたっては、以下のポイントを押さえておくことが大切です。

• HubSpotコンサルとブログ制作の同時進行、フルスタック開発の並列化、大規模リファクタリングとテスト並行など、タスクの独立性が高い業務で特に大きな効果を発揮します
• *Claude Codeの全コマンド一覧はClaude Codeチートシートをご覧ください
• AI活用の全体像はAI活用完全ガイドで解説しています

よくある質問（FAQ）

Q1. Agent Teamsのチームメイト数は最大何人まで設定できますか？

現時点では最大7チームメイトまで設定できます。ただし、チームメイト数を増やすほどトークン消費が増加するため、実用的には2〜4チームメイトが最もコストパフォーマンスに優れます。タスクの独立性が十分に確保できない場合は、チームメイト数を増やしても並列度が上がらず、逆にオーバーヘッドが増えるだけになります。

Q2. Agent Teamsとサブエージェント（Agentツール）はどう使い分けますか？

サブエージェント（Agentツール）は、メインエージェントが1つの会話の中で子タスクを委任する仕組みです。一方、Agent Teamsは複数の独立したClaude Codeインスタンスをチームとして編成する仕組みです。短時間で完了する調査・確認タスクにはサブエージェント、30分以上かかる本格的な開発タスクの並列実行にはAgent Teamsが適しています。

Q3. Agent Teamsの利用にはClaude Maxプランが必要ですか？

Agent Teamsは複数のClaude Codeインスタンスを同時に動作させるため、APIトークンの消費量が通常の2〜5倍になります。Claude Max（$100/月）またはClaude Max 5x（$200/月）プランであれば、トークン上限を気にせず利用できます。API課金モデルの場合は、チームメイト数に応じたコスト増を事前に見積もることを推奨します。

Q4. チームメイト間で直接コミュニケーションは取れますか？

チームメイト同士が直接やり取りすることはなく、必ずチームリードを経由します。これは意図的な設計で、情報の一貫性を担保し、矛盾した指示がチームメイトに届くことを防いでいます。チームメイト間のデータ共有が必要な場合は、AGENT_SYNC.mdを通じてリードが調整します。