Claude Code Agent Teams実践ガイド｜マルチエージェント開発入門

Claude CodeのAgent Teams機能をご存知でしょうか？従来のサブエージェント（/agentsコマンド）が「1つのタスクを分割して並列処理する」機能だとすると、Agent Teamsは**「複数のエージェントが役割を分担し、チームとして協調する」**ための新しいパラダイムです。

本記事では、Agent Teamsの概要から実践的な設定方法、大規模プロジェクトでの活用事例まで、マルチエージェント開発の全体像を解説します。

Claude Code Agent Teamsとは？サブエージェントとの違い

Agent Teamsは、Claude Codeの中でも最もパワフルな機能の一つです。まずはその仕組みを理解しましょう。

セッション間連携の仕組み

Agent Teamsでは、複数のClaude Codeセッションが共有コンテキストを持ちながら並列で動作します。各エージェントは独立したセッションで実行されますが、以下のメカニズムで連携します。

• 共有ファイルシステム: 同一リポジトリ上で作業し、変更をリアルタイムで共有
• メッセージパッシング: エージェント間で状態や進捗を通知
• オーケストレーター: 全体の進行を管理する中央エージェント
• コンフリクト解決: 同一ファイルへの競合変更を自動検出・解決

この仕組みにより、人間のチーム開発に近い協調作業をAIエージェントだけで実現できます。

サブエージェント vs Agent Teams の使い分け

機能	サブエージェント	Agent Teams
実行モデル	親セッションからのタスク委譲	独立セッションの協調
並列数	3〜5程度	10以上も可能
状態共有	限定的（出力の受け渡し）	リアルタイム共有
適したタスク	単一リポジトリ内の分割作業	複数リポジトリ・大規模プロジェクト
コスト	比較的安い	高い（複数セッション分）

小〜中規模のタスクにはサブエージェント、大規模で複雑なタスクにはAgent Teamsを使うのが基本的な使い分けです。

Agent Teamsの基本設定と構成方法

Agent Teamsを使い始めるための設定方法を解説します。

チームメンバーの役割定義

Agent Teamsでは、各エージェントに明確な役割を割り当てます。.claude/teams.jsonに定義します。

{
  "team": "feature-development",
  "members": [
    {
      "role": "architect",
      "model": "opus",
      "responsibilities": ["設計レビュー", "アーキテクチャ決定", "技術選定"],
      "files": ["docs/", "*.md"]
    },
    {
      "role": "frontend",
      "model": "sonnet",
      "responsibilities": ["UIコンポーネント実装", "スタイリング", "E2Eテスト"],
      "files": ["src/components/", "src/pages/", "tests/e2e/"]
    },
    {
      "role": "backend",
      "model": "sonnet",
      "responsibilities": ["API実装", "DB設計", "ユニットテスト"],
      "files": ["src/api/", "src/models/", "tests/unit/"]
    },
    {
      "role": "reviewer",
      "model": "haiku",
      "responsibilities": ["コードレビュー", "リンティング", "ドキュメント更新"],
      "files": ["**/*"]
    }
  ]
}

ポイントは、各メンバーの責任範囲を明確に分離し、担当ファイルの重複を最小限にすることです。

オーケストレーターの設定

オーケストレーターは、チーム全体の作業を管理する特別なエージェントです。

claude teams start --config .claude/teams.json --orchestrator opus

オーケストレーターの主な役割は以下の通りです。

• タスクの分解と各メンバーへの割り当て
• 依存関係のある作業の順序制御
• コンフリクトの検出と解決指示
• 全体の進捗モニタリングと完了判定

並列処理による大規模開発の実践

Agent Teamsの真価は、大規模プロジェクトでの並列開発にあります。

タスク分解のベストプラクティス

効果的なタスク分解には以下のルールがあります。

1. ファイルレベルで分離可能なタスクに分ける: 同じファイルを複数のエージェントが編集するとコンフリクトが発生する
2. インターフェースを先に定義する: APIの型定義やインターフェースを最初にarchitectが決め、その後frontend/backendが並列実装
3. テストは実装と同時進行: reviewerがテストを書きながらfrontend/backendが実装を進める
4. 小さく頻繁にコミットする: 各エージェントが細かくコミットすることでコンフリクトを防止

複数リポジトリにまたがる実装例

Agent Teamsはモノレポだけでなく、複数リポジトリにまたがるプロジェクトでも活用できます。例えば：

• フロントエンドリポジトリ: React/Next.jsのSPA
• バックエンドリポジトリ: Go/PythonのAPIサーバー
• インフラリポジトリ: Terraform/CDKの構成管理

各リポジトリに専任のエージェントを配置し、API仕様をコントラクトとして共有することで、並列開発が可能になります。

コスト管理とモデル最適化

Agent Teamsは複数セッションを並列実行するため、コスト管理が重要です。

Opus / Sonnet / Haikuの使い分け戦略

役割	推奨モデル	理由
オーケストレーター	Opus	全体の設計判断に高い推論能力が必要
設計・アーキテクチャ	Opus	技術選定の品質がプロジェクト全体に影響
実装	Sonnet	コスパのバランスが良い
テスト生成	Sonnet	パターン認識で効率的に生成
レビュー・リンティング	Haiku	定型的なチェックはHaikuで十分

この戦略により、全てOpusを使う場合と比べてコストを約60%削減できます。詳しくは「Claude Codeコスト最適化」を参照してください。

人間による監視とガバナンス

Agent Teamsを本番運用する際には、人間の監視体制が不可欠です。

• 承認ゲート: 重要な設計決定や本番環境への変更は人間の承認を必須にする
• 進捗ダッシュボード: 各エージェントの状態・トークン消費・エラー率をリアルタイム監視
• 自動停止条件: コスト上限やエラー率閾値を超えたら自動停止
• ログ監査: 全エージェントの操作ログを保存し、事後レビュー可能にする

# コスト上限の設定例
claude teams start --max-cost $50 --auto-stop-on-error 3

Agent Teams活用事例｜大規模リファクタリング成功の裏側

実際にAgent Teamsを使って大規模リファクタリングを実施した事例を紹介します。

プロジェクト概要:

• Java（Spring Boot）のモノリスアプリケーション（約15万行）
• マイクロサービスへの分割リファクタリング
• 従来見積もり: 3人月 → Agent Teams活用: 2週間

チーム構成:

• Orchestrator（Opus）: 分割戦略の策定
• Domain Analyzer（Opus）: ドメイン境界の分析
• Service Extractor × 4（Sonnet）: 各サービスの抽出・実装
• Test Generator × 2（Sonnet）: テストの移行・追加
• API Gateway Designer（Opus）: サービス間通信の設計
• Documentation Writer（Haiku）: API仕様書・ADRの作成

この10エージェント体制により、約15万行のコードを2週間でマイクロサービス化することに成功しました。

詳しくは「Claude Code完全ガイド」や「Claude Codeサブエージェント活用」も参考にしてください。

まとめ｜Agent Teamsで変わる開発ワークフロー

Claude Code Agent Teamsは、AIを活用した開発の新しいパラダイムです。

• 複数エージェントが役割を分担し、チームとして協調する
• 大規模プロジェクトで3〜5倍の開発速度向上が実現可能
• モデルの使い分けでコストを60%削減できる
• 人間の監視体制を整備することで安全に運用

Agent Teamsはまだ進化途中の機能ですが、早期に習得しておくことで、SES現場での競争力を大きく高めることができるでしょう。