playpark
ホーム会社概要サービスソリューションブログお知らせお問い合わせ
playpark

あらゆる仕事を楽しむ

会社概要サービスソリューションお問い合わせ特定商取引法に基づく表記

© 2019-2026 合同会社playpark All Rights Reserved.

  1. ホーム
  2. ブログ
  3. AIコーディングツール活用 完全ガイド
  4. 【Claude Code】Agent Teams 実践ガイド — マルチエージェント並列開発でタスクを自動分解する
ブログ一覧に戻る
技術TipsAIコーディングツール活用 完全ガイド

【Claude Code】Agent Teams 実践ガイド — マルチエージェント並列開発でタスクを自動分解する

Claude Code Agent Teamsでマルチエージェント並列開発を実践。セットアップから実践的なワークフロー、コスト最適化まで。Cowork・Workflow Studioとの違いも解説します。

2026年3月11日20分で読める
Claude CodeAgent TeamsマルチエージェントAI開発並列開発DevOps
【Claude Code】Agent Teams 実践ガイド — マルチエージェント並列開発でタスクを自動分解する

AIコーディングツール活用 完全ガイド

(13記事)
  1. 1.AIコーディング入門2026 — 非エンジニアでもわかるAI開発の始め方
  2. 2.【2026年版】AIコーディングツール完全比較 — Claude Code・Codex・Antigravity の選び方
  3. 3.【Claude Code】Skillsの設計思想と自作ガイド - 開発ワークフローを再利用可能にする
  4. 4.【Claude Code】SKILL.mdの書き方完全ガイド - Skills設計パターンと肥大化87%削減の実践
  5. 5.【Claude Code】Skillオーケストレーション設計 - 複数Skillを連携させる実践パターン
  6. 6.【Claude Code】auto-compact対策 完全ガイド - コンテキスト消失を防ぐ状態管理の設計パターン
  7. 7.【Claude Code】settings.json完全ガイド - CLAUDE.mdとの使い分けで最適なAI開発環境を構築
  8. 8.【Claude Code Hooks】テスト自動化で品質を仕組み化 - テスト忘れゼロ件を実現する設定ガイド
  9. 9.【Claude Code × Codex × Antigravity】AIコーディングツールのSkillsを統一管理する方法
  10. 10.【Claude Code】worktree並列開発の自動タスク分解と統合 - dev-decomposeで「分けて、束ねる」を設計する
  11. 11.【Claude Code Hooks 安全設計】170超のdenyルールとPreToolUseフックで「やらかし」を防ぐ実践パターン
  12. 12.【Claude Code】Agent Teams 実践ガイド — マルチエージェント並列開発でタスクを自動分解する
  13. 13.【Claude Code 安全設計】HooksからPermissionsへ — 3つのPythonスクリプトを捨てた理由と移行ガイド
シリーズ一覧ページを見る

「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並列開発の概念があると理解しやすい

あわせて読みたい

【Claude Code 安全設計】HooksからPermissionsへ — 3つのPythonスクリプトを捨てた理由と移行ガイド
技術Tips26分

【Claude Code 安全設計】HooksからPermissionsへ — 3つのPythonスクリプトを捨てた理由と移行ガイド

Claude Codeの安全設計をHooksベース(Pythonスクリプト3本)からPermissions+deny rulesベースに移行した経緯・判断理由を解説。Before/After比較と移行判断フローチャート付き。

読む

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形式)とメッセージングで協調します。

あわせて読みたい

【Claude Code Hooks 安全設計】170超のdenyルールとPreToolUseフックで「やらかし」を防ぐ実践パターン
技術Tips32分

【Claude Code Hooks 安全設計】170超のdenyルールとPreToolUseフックで「やらかし」を防ぐ実践パターン

Claude Code Hooksのprotect-branches.pyによるブランチ保護、auto-approve設計、170超のdenyルール分類を実コード付きで解説。PreToolUse・PostToolUse・Notificationの使い分けも紹介します。

読む

セットアップ

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 は両方の完了を待ってからテストを書いてください"

チームリードはこの指示を受けて:

  1. TeamCreateでチーム作成
  2. TaskCreateで各タスクを作成(依存関係をaddBlockedByで設定)
  3. Taskツールでチームメイトを生成
  4. 各メイトがTaskListでタスクを取得、実装開始
  5. frontendとbackendが完了したら、testerのブロックが解除されてテスト開始
  6. 全タスク完了後、チームリードが結果を統合

パターン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 TeamsCowork
対象ユーザー開発者非エンジニア(ナレッジワーカー)
インターフェースターミナル(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-decomposeAgent 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コーディングツールの比較・導入から実践活用までを体系的に解説しています。

12 / 13 記事
前の記事
【Claude Code Hooks 安全設計】170超のdenyルールとPreToolUseフックで「やらかし」を防ぐ実践パターン
次の記事
【Claude Code 安全設計】HooksからPermissionsへ — 3つのPythonスクリプトを捨てた理由と移行ガイド
シリーズ一覧を見る

この技術を活用した事例

記事の技術が実際のプロジェクトでどう活かされているかをご紹介します

【自社導入事例】ブログ運用を完全自動化 - GitHubリポジトリから記事・サムネイル・SNS投稿まで

「ブログ書くのしんどい」「SNS投稿めんどくさい」を解決。GitHubリポジトリから記事生成、サムネイル作成、SNS投稿文まで自動化した、playpark自身の導入事例を紹介します。

事例を読む
AI開発の導入支援

Claude CodeやAIコーディングツールの導入・カスタマイズでお困りですか?playparkでは、AI開発環境の構築から運用まで、実践に基づいた技術支援を行っています。

サービス
AI開発について相談する
ブログ一覧に戻る

関連記事

すべての記事
【Claude Code】worktree並列開発の自動タスク分解と統合 - dev-decomposeで「分けて、束ねる」を設計する
技術Tips
2026年3月5日30分で読める
【Claude Code】worktree並列開発の自動タスク分解と統合 - dev-decomposeで「分けて、束ねる」を設計する

Claude Code worktree並列開発のボトルネックだったタスク分解と統合を自動化。dev-decomposeのファイル境界分析、contract branchパターン、dev-integrateの自動マージパイプラインを解説します。

Claude CodeAI並列開発+3
【実測比較】Claude Code vs Codex — 実プロジェクトで使い比べてわかった選び方
技術Tips
2026年3月16日20分で読める
【実測比較】Claude Code vs Codex — 実プロジェクトで使い比べてわかった選び方

Claude CodeとCodexを実プロジェクトで使い比べて比較。開発速度・品質・コスト・拡張性の4軸で実測データに基づく選び方を解説します。

Claude CodeCodexAIコーディングツール+3
【Claude Code 安全設計】HooksからPermissionsへ — 3つのPythonスクリプトを捨てた理由と移行ガイド
技術Tips
2026年3月13日26分で読める
【Claude Code 安全設計】HooksからPermissionsへ — 3つのPythonスクリプトを捨てた理由と移行ガイド

Claude Codeの安全設計をHooksベース(Pythonスクリプト3本)からPermissions+deny rulesベースに移行した経緯・判断理由を解説。Before/After比較と移行判断フローチャート付き。

Claude CodeClaude Code Hooksセキュリティ設定+3

この技術を活用したサービス

記事の技術を使って、業務課題を解決しませんか?playparkのソリューションをご覧ください。

ソリューション一覧へ