Claude Code Agent Teams コラボレーションガイド
Claude Code Agent Teamsは複数のClaudeインスタンスが並列で複雑なエンジニアリングタスクを協調処理。1つのLeadエージェントが統括し、複数のTeammateエージェントがサブタスクを並列実行 — 効率3〜5倍向上。
Agent Teams vs サブエージェント
2つのマルチエージェントモード — Agent Teamsを選ぶタイミングと軽量サブエージェントを使うタイミング。
| 項目 | Agent Teams | サブエージェント |
|---|---|---|
| 協調モード | マルチセッション並列、Lead統括 | 同一セッション逐次呼び出し |
| 規模 | 大規模プロジェクト（>1000行変更） | 小中規模タスク、素早い委任 |
| 通信方式 | 共有タスクリスト + メールボックス | 直接関数呼び出し |
| モデル要件 | LeadはOpus 4.6+必須 | 任意モデル |
協調アーキテクチャ
LeadエージェントがPMとしてタスク分解と結果集約を担当。Teammateエージェントがサブタスクを並列実行。
Lead（統括）
Lead Agent (Opus 4.7)
共有タスクリスト
全エージェントが読み書き
メールボックス
エージェント間メッセージング
Teammate 1
フロントエンドタスク
Teammate 2
バックエンドタスク
Teammate 3
テストタスク
Leadエージェント
チームの「プロジェクトマネージャー」。Opus 4.7を使用し、要件理解、タスク分解、Teammateへの割り当て、結果集約を担当。
Teammateエージェント
特定サブタスクを実行する専任エージェント。コスト節約のためSonnet 4.6を使用可能。完了後に共有タスクリストに結果を書き込む。
共有タスクリスト
全エージェントが共有する構造化タスクリスト。Leadがタスクを作成し、Teammateが引き受けてステータスを更新 — 競合なしの協調。
メールボックス通信
エージェント間の非同期メッセージングシステム。複雑なコンテキストの受け渡し、確認要求、中間報告に使用。
有効化と設定
CLAUDE.mdでAgent Teamsモードを宣言すれば、Claude Codeが適切なシナリオで自動的にマルチエージェント協調を有効化。
前提条件
- Claude Code v2.1.32以降
- LeadエージェントはClaude-opus-4-7モデルを使用
- QCode.cc APIキー（Opus 4.7対応）
QCode.cc経由での利用
QCode.ccはAgent Teamsに必要なすべてのモデル（Opus 4.7/Sonnet 4.6）を完全サポート。並列マルチセッションリクエストに制限なし。
CLAUDE.md設定例
# CLAUDE.md — 启用 Agent Teams 模式
# 告知 Claude 允许启动多 Agent 协作
## Agent Teams 配置
- 复杂任务自动拆解为子任务
- 最多 5 个并行 Teammate Agent
- Lead Agent 使用 claude-opus-4-7
- Teammate Agent 使用 claude-sonnet-4-6
## 任务分配原则
- 前端/后端/测试可并行执行
- 需要共享上下文时通过 mailbox 通信
- 每个 Teammate 完成后更新共享任务列表Custom Subagents（@メンション）
Claude Code v2.1.32+は@構文で専門サブエージェントの定義と呼び出しをサポート。
Custom Subagentsとは
`.claude/agents/`にMarkdownファイルを作成して専用ロール、能力境界、行動ガイドラインを定義。@呼び出し時、サブエージェントが特定タスクを専門家の視点で処理。
使用例
@security-auditor
セキュリティ脆弱性監査に特化
@perf-optimizer
パフォーマンスボトルネック分析と最適化
@doc-writer
APIドキュメントとコメント生成
カスタムサブエージェントの定義
# .claude/agents/security-auditor.md
---
name: security-auditor
description: 专职安全审计 Agent，分析代码漏洞
model: claude-opus-4-7
tools: [read_file, bash]
---
你是一名资深安全工程师，专注于：
- OWASP Top 10 漏洞检测
- SQL 注入与 XSS 防护
- 认证与授权逻辑审查
- 依赖库安全扫描
收到代码后，输出结构化的漏洞报告。