「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セッションが起動
Agent Team の基本的な使い方
セットアップが完了したら、実際にチームを起動してタスクを実行してみましょう。
TypeScript SDK でチームを操作する
Claude Code Agent Teams は、@anthropic-ai/claude-code SDK からプログラムで操作できます。
import { ClaudeCodeAgentTeam } from '@anthropic-ai/claude-code';
// チームを作成してタスクを割り当てる
const team = await ClaudeCodeAgentTeam.create({
name: 'feature-dev',
lead: { model: 'claude-opus-4-7' },
members: [
{ role: 'frontend', model: 'claude-sonnet-4-6' },
{ role: 'backend', model: 'claude-sonnet-4-6' },
{ role: 'tester', model: 'claude-haiku-4-5' },
],
});
// タスクを作成して依存関係を設定
const frontendTask = await team.createTask({
assignee: 'frontend',
description: 'プロフィール編集フォーム（React）を実装',
});
const backendTask = await team.createTask({
assignee: 'backend',
description: 'プロフィール更新 API エンドポイント（PUT /users/:id）を実装',
});
const testTask = await team.createTask({
assignee: 'tester',
description: '統合テストを実装',
blockedBy: [frontendTask.id, backendTask.id], // 前2タスクの完了を待つ
});
// チームを実行して結果を受け取る
const result = await team.run();
console.log(result.summary);
// 使用後はチームを解散してコストを抑える
await team.dissolve();
Bash から起動する場合
SDK を使わず、ターミナルから直接チームを起動することもできます。
# 環境変数を確認
echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS # "1" であること
# チームリードとして Claude Code を起動
claude --team feature-dev
# tmux で3ペインに分割してメンバーを起動
tmux new-session -s agent-team \; \
send-keys 'claude --team feature-dev --role frontend' Enter \; \
split-window -h \; \
send-keys 'claude --team feature-dev --role backend' Enter \; \
split-window -v \; \
send-keys 'claude --team feature-dev --role tester' Enter
チームメンバーはそれぞれ独立したコンテキストで動作し、共有タスクリスト（~/.claude/tasks/feature-dev/）を参照してタスクを取得します。SendMessage ツールでメンバー間の直接通信も可能です。
なお、Agent Teams の前提となる Skills 共有の仕組みは Claude Code Skills 共有管理 で詳しく解説しています。
実践ワークフロー
パターン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つの視点で同時に」「仮説を競合させてデバッグ」といったユースケースは既に実用的です。安定版リリースに向けて、今のうちにワークフローを試行錯誤しておく価値はあります。
あわせて読みたい
- 【Claude Code】Agent Teamで複数AIを同時に動かす — 並列協調の設計パターン — バグ調査・コード監査・インシデント対応の3つの実例
- Claude Code Skills 共有管理 — 4つのAIツールを1リポジトリで統一する方法 — マルチエージェント環境でのSkills統一管理
- 【2026年版】AIコーディングツール完全比較 — Claude Code・Codex・Antigravityの選び方
- 【Claude Code】worktree並列開発の自動タスク分解と統合 — Agent Teamsの前段階となるworktree並列開発パターン
- 【Claude Code】SKILL.mdの書き方完全ガイド — Agent Teamsと組み合わせるSkillsの設計
- 【Claude Code】auto-compact対策 完全ガイド — 長時間ワークフローでのコンテキスト管理
最終更新: 2026-04-27（モデル世代を最新化: Opus 4.7 / Sonnet 4.6 / Haiku 4.5）
Claude Code エージェント・安全設計 完全ガイド — この記事を含む10本の記事で、エージェント活用・Hooks安全設計・並列開発を体系的に解説しています。
AI開発 完全ガイド — AI開発の入門から運用設計までを10本の記事で俯瞰できます。
