playpark
ホーム会社概要サービスソリューションブログお知らせ気軽に相談する
playpark

あらゆる仕事を楽しむ

会社概要サービスソリューション気軽に相談する特定商取引法に基づく表記

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

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

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

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

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

Claude Code エージェント・安全設計 完全ガイド

(10記事)
  1. 1.【Claude Code】Agent Teams 実践ガイド — マルチエージェント並列開発でタスクを自動分解する
  2. 2.【Claude Code】worktree並列開発の自動タスク分解と統合 - dev-decomposeで「分けて、束ねる」を設計する
  3. 3.【Claude Code Hooks】テスト自動化で品質を仕組み化 - テスト忘れゼロ件を実現する設定ガイド
  4. 4.【Claude Code Hooks 安全設計】170超のdenyルールとPreToolUseフックで「やらかし」を防ぐ実践パターン
  5. 5.【Claude Code 安全設計】HooksからPermissionsへ — 3つのPythonスクリプトを捨てた理由と移行ガイド
  6. 6.【Claude Code】バグ調査・コード監査を並列で回すAgent Team協調設計 — 収束型マルチエージェントの実装パターン
  7. 7.AIエージェントが同じミスを繰り返さない3つの設計パターン【Claude Code実装例】
  8. 8.AIエージェントが夜中にコードを巡回・修正する「night-patrol」の設計と実践【Claude Code Skills】
  9. 9.【OpenClaw × Slack】AIアシスタント構築実践 - Local LLMからGeminiハイブリッド構成まで
  10. 10.【OpenClaw Docker セキュリティ】CVE対策で学ぶコンテナハードニング実践 — cap_drop ALL から始める安全運用
シリーズ一覧ページを見る

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

あわせて読みたい

AIエージェントが夜中にコードを巡回・修正する「night-patrol」の設計と実践【Claude Code Skills】
技術Tips18分

AIエージェントが夜中にコードを巡回・修正する「night-patrol」の設計と実践【Claude Code Skills】

AIエージェントが深夜にコードベースを自律巡回し、lint警告・テスト失敗・未対応issueを検出→修正→PRまで自動化する「night-patrol」スキルの設計パターンと安全策を解説。

読む

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

あわせて読みたい

AIエージェントが同じミスを繰り返さない3つの設計パターン【Claude Code実装例】
技術Tips34分

AIエージェントが同じミスを繰り返さない3つの設計パターン【Claude Code実装例】

Claude Codeが同じエラーを繰り返す? 構造化ログ・8軸パターン検出・SKILL.md自動修正の3パターンで解決。CLAUDE.mdへの3行追記から始められる実装例付き。

読む

セットアップ

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タスクが最適。タスクが少なすぎると分割のオーバーヘッドが無駄になります。

あわせてチェック

15分で課題を整理しませんか?

記事の内容について質問や相談があれば、営業トークなしの15分ヒアリングで整理します。

15分ヒアリングを予約気軽に相談する

よくある混同: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つの視点で同時に」「仮説を競合させてデバッグ」といったユースケースは既に実用的です。安定版リリースに向けて、今のうちにワークフローを試行錯誤しておく価値はあります。

あわせて読みたい

  • 【Claude Code】Agent Teamで複数AIを同時に動かす — 並列協調の設計パターン — バグ調査・コード監査・インシデント対応の3つの実例
  • 【2026年版】AIコーディングツール完全比較 — Claude Code・Codex・Antigravityの選び方
  • 【Claude Code】worktree並列開発の自動タスク分解と統合 — Agent Teamsの前段階となるworktree並列開発パターン
  • 【Claude Code】SKILL.mdの書き方完全ガイド — Agent Teamsと組み合わせるSkillsの設計
  • 【Claude Code】auto-compact対策 完全ガイド — 長時間ワークフローでのコンテキスト管理

Claude Code エージェント・安全設計 完全ガイド — この記事を含む10本の記事で、エージェント活用・Hooks安全設計・並列開発を体系的に解説しています。

1 / 10 記事
次の記事
【Claude Code】worktree並列開発の自動タスク分解と統合 - dev-decomposeで「分けて、束ねる」を設計する
シリーズ一覧を見る

この技術が解決した業務課題

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

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

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

事例を読む

【AI採用管理】Gemini API × Next.jsで書類選考を自動化した受託開発事例

Gemini APIとNext.jsで採用書類選考を自動化。中小企業の採用DXをplayparkが受託開発で支援した事例をご紹介します。

事例を読む

【業務自動化】外注と内製どっちが正解? — 費用・品質・スピードで比較する判断基準

業務自動化を外注するか内製するか迷っていませんか?費用・品質・スピードの3軸で比較し、従業員10〜100名の中小企業が失敗しない判断基準をお伝えします。

事例を読む

関連ソリューション

この記事に関連するplayparkのソリューション

業務自動化ソリューション

Excel脱却・API連携で手作業を自動化。作業時間を大幅に削減します。

ソリューションを見るSHITATEYAを見る
AI開発の導入支援

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

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

関連記事

すべての記事
【Claude Code×営業管理】SFA不要。Git+YAML+Skillで営業パイプラインを自動化した話
実験レポート
2026年4月1日23分で読める
【Claude Code×営業管理】SFA不要。Git+YAML+Skillで営業パイプラインを自動化した話

SFA/CRMを使わず、Claude Code SkillでGitリポジトリの営業パイプラインを自動化。Gmail同期・議事録生成・企業分析・メール下書きまで14サブコマンドで完結する設計と実運用を紹介します。

Claude CodeClaude Code Skills業務自動化+3
【Claude Code Skills】1記事 → 7プラットフォーム自動配信パイプラインの設計
技術Tips
2026年3月23日26分で読める
【Claude Code Skills】1記事 → 7プラットフォーム自動配信パイプラインの設計

記事を書いたら、Zenn・Qiitaへの転載とSNS 5媒体への告知を自動化。記事転載(cross-post)とSNS配信の2つのパイプライン設計を解説します。

Claude CodeClaude Code Skillsskills+3
【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

この技術、実際の現場ではこう使われています

記事で紹介した技術が、実際のビジネス課題をどう解決したか。導入事例で具体的なイメージをつかめます。

導入事例を見る気軽に相談する