エージェントチームで大規模タスクを並列遂行する

エージェントチームで大規模タスクを並列遂行する

Claude Code のエージェントチーム機能を使うと、複数の独立した Claude Code セッションが協調して大規模タスクを遂行できます。サブエージェントとは異なり、各チームメイトは完全に独立したコンテキストウィンドウを持ちます。

有効化

エージェントチームは実験的機能です。settings.json の env ブロックで有効化します。

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

アーキテクチャ

Team Leader（調整役）
  ├── Teammate A（独立コンテキスト）
  ├── Teammate B（独立コンテキスト）
  └── Teammate C（独立コンテキスト）

• Team Leader: タスクの割り当て、結果の統合
• Teammates: 独立したコンテキストウィンドウで並列実行
• 直接通信: チームメイト同士は直接通信可能（リーダー経由不要）

チーム操作のツール

ツール	説明
TeamCreate	チームを作成（タスクリストも同時生成）
TeamDelete	チームとタスクリストを削除
TaskCreate	タスクをタスクリストに追加
TaskGet	タスクの詳細を取得
TaskList	タスクリストを表示
TaskUpdate	タスクのステータス、担当者、依存関係を更新
SendMessage	チームメイトにメッセージを送信

ワークフローの例

1. TeamCreate でチームを作成
2. TaskCreate でタスクを定義し、依存関係を設定
3. チームメイトをスポーンし、TaskUpdate で担当者を割り当て
4. 各チームメイトが独立してタスクを実行
5. 完了時に TaskUpdate でステータスを更新
6. 必要に応じて SendMessage で連携
7. 全タスク完了後に TeamDelete でクリーンアップ

表示モード

モード	説明	設定
in-process	全チームメイトがメインターミナル内で実行	デフォルト
auto/tmux	チームメイトが tmux の分割ペインに表示	teammateMode

{
  "teammateMode": "tmux"
}

Worktree との組み合わせ

チームメイトにワークツリーを使用させることができます。エージェント定義に isolation: worktree を設定するか、チームリーダーから指示を出します。

---
name: backend-dev
description: "Backend implementation agent"
isolation: worktree
---

ユースケース

ユースケース	説明
複数視点からの調査	セキュリティ、パフォーマンス、保守性を同時に分析
新モジュール開発	各チームメイトが独立した部分を担当
並行仮説デバッグ	異なる仮説を並列で検証し、より速く収束
クロスレイヤー連携	フロントエンド、バックエンド、テストを別々に担当

oh-my-claudecode のチームパイプライン

OMC は team-plan -> team-prd -> team-exec -> team-verify -> team-fix のステージドパイプラインを提供します。

> /team 5:executor "全てのTypeScriptエラーを修正して"

5つの coordinated エージェントが共有タスクリスト上で協調動作します。

---

あわせて読む

• カスタムエージェントで専門タスクを委任する - エージェント定義の基本
• サブエージェントを並列でスポーンしてタスクを分散する - 並列処理の基礎
• OMC team パイプライン - OMC のチームオーケストレーション機能