概要
- Claude Code のAgent Teamsは複数インスタンスの協調作業を実現
- チームリード が全体を指揮し、各Teammateが独立して作業
- Subagentsとの違いは 直接コミュニケーション や独立性
- 並列探索や協調作業 に最適、トークン消費は多め
- 有効化手順や操作方法、ベストプラクティスを解説
Agent Teamsの概要と用途
- Agent Teams は複数のClaude Codeインスタンスを連携させる機能
- チームリード が指示・タスク割り当て・結果統合を担当
- 各 Teammate は独自のコンテキストウィンドウで独立作業
- Teammate同士で 直接メッセージ送信、リードを介さず個別指示も可能
- Subagents との違いは、同一セッション内動作・リードのみへの報告制限
- 並列探索が価値を生むタスク (リサーチ、レビュー、複数モジュール開発、仮説検証など)に最適
- 順次処理や依存度が高い作業 は単一セッションやSubagentsが適する
Subagentsとの比較
| 項目 | Subagents | Agent Teams | |-----------------|--------------------------------|---------------------------------------------| | コンテキスト | 各自独立、結果はリードへ報告 | 各自独立、完全独立動作 | | 通信 | リードのみ | Teammate間で直接通信可能 | | 調整 | リードが全作業を管理 | 共有タスクリストで自己調整 | | 適用例 | 結果のみ重要な単純作業 | 議論・協調が必要な複雑タスク | | トークン消費 | 低(結果のみ要約) | 高(各Teammateが独立Claudeインスタンス) |
- 迅速な単純作業 はSubagents、 協調が必要な作業 はAgent Teams推奨
Agent Teamsの有効化と起動
- デフォルトでは 無効、有効化には環境変数設定が必要
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1をシェルまたはsettings.jsonに設定
- 有効化後、 自然言語でチーム作成指示 (例:「UX・技術・デビルズアドボケートでチーム作成」)
- Claudeが タスクリスト作成・Teammate生成・役割分担 を自動実施
- リードのターミナル で全Teammateと作業内容を一覧表示
表示モードと操作
- In-processモード :全Teammateがメインターミナル内で動作
- Shift+Up/DownでTeammate選択、直接メッセージ送信
- Split panesモード :各Teammateが独立ペインを持つ
- tmuxまたはiTerm2+it2 CLIが必要
- すべての出力を同時表示、ペインをクリックし個別操作可能
- モードは settings.json やCLIフラグで切替可能
Teammate・モデル指定とプラン承認
- Claudeが 自動でTeammate数決定、または明示指定可能
- 例:「4人チームで並列リファクタ」「各TeammateにSonnet使用」
- プラン承認モード :リードがTeammateの作業計画を承認するまで実装不可
- 承認基準もプロンプトで指定可能(例:「テストカバレッジ必須」)
デリゲートモードと直接指示
- Delegateモード :リードは調整専用、実装作業せず
- Shift+Tabで切替、分担・統合に専念
- 各Teammateは 独立セッション、個別に追加指示や質問可能
タスク管理と終了処理
- 共有タスクリスト で進捗管理、リード割当または各自セルフクレーム
- タスク状態:pending / in progress / completed
- 依存関係も自動管理、ファイルロックで競合防止
- Teammateの シャットダウン はリード経由でリクエスト
- チームクリーンアップ は全Teammate終了後に実行
アーキテクチャと内部構造
- 構成要素
- Team lead:メインセッション、チーム生成・調整担当
- Teammates:独立Claude Codeインスタンス
- タスクリスト:共有作業項目リスト
- メールボックス:エージェント間メッセージング
- チーム・タスク情報は ローカル保存 (例:~/.claude/teams/)
- パーミッション はリード設定を継承、個別変更も可能
- 各Teammateのコンテキスト は独立、プロジェクト情報・スキルも個別ロード
- 自動メッセージ配信、タスク進捗・完了通知も自動
- ブロードキャスト はチームサイズに比例しコスト増
トークン消費とコスト
- Agent Teamsは 単一セッションより大幅に多くのトークン を消費
- 並列リサーチや新機能開発にはコストに見合う価値
- ルーチン作業は 単一セッションが効率的
代表的なユースケース例
- 並列コードレビュー
- セキュリティ・パフォーマンス・テストカバレッジなど、各観点ごとにTeammateを割当
- 独立視点で同時レビュー、結果を統合
- 複数モジュールの並列リファクタ
- 各Teammateが異なるモジュールを担当、干渉せず進行
- 仮説検証型デバッグ
- 複数の仮説を同時検証、迅速な原因特定
- フロント・バック・テストのクロスレイヤー調整
- それぞれ専任Teammateで効率分担
ベストプラクティス
- Teammateの独立性 が高いタスクで最大効率
- 依存関係や逐次処理が多い場合 は単一セッション推奨
- タスク分割・役割明確化 が重要
- トークンコスト を考慮、目的に応じて最適モード選択
Agent Teamsを活用することで、 複雑な協調作業や並列探索 が大幅に効率化。用途やコストに応じて 最適な構成・運用 を心掛けることが重要。