「worktreeで並列開発やってるけど、タスク分解は結局人間がやってない...?」
Claude Codeのworktree並列開発で開発速度は上がった。でも、タスクの分解・割り当て・進捗管理はまだ人間の仕事。dev-decomposeで自動分解できるとはいえ、ワーカーのセットアップや統合の判断は手動です。
2026年2月、AnthropicがAgent Teamsをリリースしました。複数のClaude Codeインスタンスがチームとして自律的に協調する実験的機能です。
「え、勝手にタスク分けて、勝手に実装して、勝手に統合してくれるの...?」
半分正解で半分誤解です。この記事では、Agent Teamsの実態と実践的な使い方を解説します。
この記事で学べること
- Agent Teamsの仕組みとサブエージェント(Task tool)との決定的な違い
- セットアップ手順と実践的なチーム構成パターン
- コストを抑えるための「Plan → Execute」パターン
- Cowork・Workflow Studioとの混同を避けるための整理
- 既知の制限事項と回避策
前提知識
- Claude Codeの基本操作を理解している
- Skillsの基本概念を把握している
- worktree並列開発の概念があると理解しやすい
Agent Teams とは
Agent Teamsは、複数のClaude Codeインスタンスを1つのチームとして協調させる実験的機能です。1つのセッションが「チームリード」となり、チームメイトを生成・タスク割り当て・結果統合を行います。
サブエージェント(Task tool)との違い
「Task toolで既にサブエージェント使えるのに、何が違うの?」
これが最初の疑問でした。決定的な違いはコミュニケーション構造です。
| 観点 | Task tool(サブエージェント) | Agent Teams |
|---|---|---|
| 通信 | 親に結果を返すだけ(一方向) | チームメイト同士で直接メッセージ可能 |
| コンテキスト | 親のコンテキスト内で動作 | 完全に独立したコンテキストウィンドウ |
| 協調パターン | ハブ&スポーク(親が中心) | 自律分散(共有タスクリストで自己組織化) |
| コスト | 低い(親セッション内) | 高い(各メイトが完全なセッション) |
| 適した作業 | 調査・検索・単機能タスク | 複雑な実装・レビュー・デバッグ |
サブエージェントは**「ちょっと調べてきて」。Agent Teamsは「チームで開発しよう」**。
アーキテクチャ
┌─────────────────────────────────────────────────────┐
│ Team Lead(メインのClaude Codeセッション) │
│ ├── TeamCreate: チーム作成 │
│ ├── TaskCreate/TaskUpdate: タスク管理 │
│ └── SendMessage: メンバーへの指示 │
├─────────────────────────────────────────────────────┤
│ 共有タスクリスト: ~/.claude/tasks/{team-name}/ │
│ チーム設定: ~/.claude/teams/{team-name}/config.json │
├─────────────────────────────────────────────────────┤
│ Teammate A │ Teammate B │ ... │
│ (独立コンテキスト) │ (独立コンテキスト) │ │
│ ├── TaskList で │ ├── TaskList で │ │
│ │ タスク取得 │ │ タスク取得 │ │
│ ├── SendMessage で │ ├── SendMessage で │ │
│ │ 他メイトに連絡 │ │ 他メイトに連絡 │ │
│ └── TaskUpdate で │ └── TaskUpdate で │ │
│ 完了報告 │ 完了報告 │ │
└─────────────────────────────────────────────────────┘
各チームメイトは独立したコンテキストウィンドウを持ち、共有タスクリスト(JSON形式)とメッセージングで協調します。
セットアップ
Agent Teamsは実験的機能のため、明示的に有効化が必要です。
1. 環境変数を設定
~/.claude/settings.jsonに追加:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
2. チームを作成
Claude Codeセッション内で、チームリードがチームを作成します:
You: "このIssueをチームで開発しよう。フロントエンド、バックエンド、テストの3人体制で"
Claude Codeが内部でTeamCreateを呼び出し、チーム設定と共有タスクリストを初期化します。
3. チームメイトの表示
チームメイトの表示方法は2つ:
- インプロセス: 1つのターミナル内で
Shift+↓でメイト切り替え - 分割ペイン: tmuxまたはiTerm2で各メイトに独立ペイン
# tmuxの場合の推奨設定
tmux new-session -s agent-team
# 各ペインでClaude Codeセッションが起動
実践ワークフロー
パターン1: 新機能開発(3人チーム)
最も基本的な構成です。
Team Lead の指示:
"次の機能を実装してください:ユーザープロフィール編集機能
チーム構成:
- frontend: プロフィール編集フォーム(React)
- backend: API エンドポイント(Express)
- tester: 統合テスト
frontend と backend は並列で進めて、
tester は両方の完了を待ってからテストを書いてください"
チームリードはこの指示を受けて:
TeamCreateでチーム作成TaskCreateで各タスクを作成(依存関係をaddBlockedByで設定)Taskツールでチームメイトを生成- 各メイトが
TaskListでタスクを取得、実装開始 - frontendとbackendが完了したら、testerのブロックが解除されてテスト開始
- 全タスク完了後、チームリードが結果を統合
パターン2: コードレビュー(複数視点)
"このPRを3つの視点でレビューしてください:
- security: セキュリティ脆弱性の検出
- performance: パフォーマンスボトルネックの特定
- architecture: 設計パターンの評価
各レビュアーは発見事項を他のレビュアーと共有して、
最後にリードが統合レポートを作成"
レビュアー同士がSendMessageで発見を共有し、相互にフィードバックできるのがAgent Teamsの強みです。サブエージェントでは各レビュアーが独立して報告するだけですが、Agent Teamsでは「securityの指摘、performanceの観点からも同意。さらに...」という対話が可能です。
パターン3: 仮説競合デバッグ
"本番環境で断続的にタイムアウトが発生。原因を調査:
- investigator-a: データベースクエリのスロークエリ仮説
- investigator-b: ネットワークレイテンシ仮説
- investigator-c: メモリリーク仮説
有力な仮説が見つかったら他の調査員に共有して、
全員で有力仮説に集中してください"
コスト最適化:Plan → Execute パターン
Agent Teamsの最大の懸念はコストです。3人チームなら通常の3〜4倍のトークン消費。
推奨パターン: Plan Mode → Agent Teams
Phase 1: 計画(低コスト)
├── Plan Modeで全体設計
├── タスク分解と依存関係を確定
└── 各タスクの受け入れ基準を明確化
Phase 2: 実行(Agent Teams)
├── 計画に基づいてチーム構成
├── 各メイトは計画に沿って実装
└── 明確な計画があるので手戻り最小化
計画フェーズをPlan Mode(安価)で済ませ、実行フェーズだけAgent Teams(高額だが高速)を使う。計画が明確なほど、チームの手戻りが減ってコスト効率が上がります。
コスト目安
| チーム構成 | トークン消費(概算) | 適した場面 |
|---|---|---|
| 3人チーム | 通常の3〜4倍 | 中規模機能開発 |
| 5人チーム | 通常の5〜7倍 | 大規模リファクタリング |
| 3人レビュー | 通常の2〜3倍 | 多角的コードレビュー |
目安: メイト1人あたり5〜6タスクが最適。タスクが少なすぎると分割のオーバーヘッドが無駄になります。
よくある混同:Cowork と Workflow Studio
Google Trendsで「claude code cowork」「claude code workflow studio」の検索が急増していますが、この3つは全く別物です。
Claude Cowork(別プロダクト)
| 項目 | Agent Teams | Cowork |
|---|---|---|
| 対象ユーザー | 開発者 | 非エンジニア(ナレッジワーカー) |
| インターフェース | ターミナル(CLI) | デスクトップGUI(macOS) |
| 主な用途 | コーディング・デバッグ | ファイル整理・ドキュメント作成 |
| プラットフォーム | 任意のターミナル | Claude Desktopアプリ |
Coworkは2026年1月リリースの非開発者向けエージェント機能です。ファイルの整理、レポート作成、スプレッドシート生成など、コーディング以外のタスクをClaude Desktopアプリ上で自動化します。
「Claude Code for the rest of your work」という位置づけで、Agent Teamsとは対象ユーザーが完全に異なります。
CC Workflow Studio(サードパーティ)
CC Workflow Studioはコミュニティ製のVS Code拡張機能(GitHubスター4,100+)で、Anthropic公式製品ではありません。
ドラッグ&ドロップのキャンバスでAIエージェントのワークフローをビジュアルに設計し、.claudeファイルとしてエクスポートできます。ノーコードでワークフローを構築したい場合に便利ですが、Agent Teamsの代替ではなく補完的なツールです。
既知の制限事項
Agent Teamsは実験的プレビューです。以下の制限があります:
- セッション再開不可: インプロセスのチームメイトはセッション再開に対応していない
- タスクステータスの遅延: チームメイトがタスク完了マークを忘れることがある
- 1セッション1チーム: ネストしたチームは作成不可
- リード固定: チームリードはチームの存続期間中変更不可
- 分割ペインの制約: tmuxまたはiTerm2が必要(VS Codeターミナル、Windows Terminal、Ghosttyは非対応)
- 権限の継承: チームメイトはリードの権限設定を継承。個別の権限モード指定は未対応
worktree並列開発との使い分け
| 観点 | worktree + dev-decompose | Agent Teams |
|---|---|---|
| コスト | 低い(1セッション + サブエージェント) | 高い(メイト数 × セッション) |
| 制御性 | 高い(人間が分解・統合を管理) | 中(リードが管理、メイトは自律) |
| 対話 | ワーカー間の対話なし | メイト間で直接メッセージ可能 |
| 安定性 | 安定(本番向き) | 実験的(挑戦的タスク向き) |
| 適した場面 | 明確に分割できるタスク | 探索的・議論が必要なタスク |
結論: 「分割が明確ならworktree、対話が必要ならAgent Teams」が現時点での使い分けです。
まとめ
Agent Teamsは「複数のClaude Codeが自律的に協調する」という、worktree並列開発の次の段階です。
- サブエージェントとの違いはチームメイト間の直接通信
- Plan → Execute パターンでコストを最適化
- Cowork(非開発者向け)、Workflow Studio(サードパーティ)との混同に注意
- 実験的機能のため制限事項を理解した上で活用
まだ実験的プレビューですが、「レビューを3つの視点で同時に」「仮説を競合させてデバッグ」といったユースケースは既に実用的です。安定版リリースに向けて、今のうちにワークフローを試行錯誤しておく価値はあります。
あわせて読みたい
- 【2026年版】AIコーディングツール完全比較 — Claude Code・Codex・Antigravityの選び方
- 【Claude Code】worktree並列開発の自動タスク分解と統合 — Agent Teamsの前段階となるworktree並列開発パターン
- 【Claude Code】SKILL.mdの書き方完全ガイド — Agent Teamsと組み合わせるSkillsの設計
- 【Claude Code】auto-compact対策 完全ガイド — 長時間ワークフローでのコンテキスト管理
AIコーディングツール活用 完全ガイド — この記事を含む13本の記事で、AIコーディングツールの比較・導入から実践活用までを体系的に解説しています。



