Claude Code エージェントチーム入門 — subagentとの違いから仕組み・セッティング方法・コマンド化まで

• URL: https://zenn.dev/tatsuqumo/articles/fa0343547eb257
• 日付: 2026-06-11
• Tier: Tier 2
• 要旨: Claude Code Agent Teamsの詳細解説。subagentとの決定的な違い（teammate同士が直接通信できる）を実機検証で明示。レビュアーが議論を通じて自説を撤回して相手案を採用するという「立場転向」現象を記録。コスト実測はレビュー1回約$10。

詳細

subagent vs agent team の核心差：

• subagent：結果を返して終わり、teammate同士の通信なし
• agent team：共有タスクリストとmailboxでteammate同士が直接メッセージを送り合う

アーキテクチャ：

• ~/.claude/tasks/{team-name}/: タスクJSON（pending/in_progress/completed + blockedBy/blocks で依存関係）
• タスクはファイルロックで競合を防止
• config.jsonは実行時に生成されるため手動編集不可

立場転向の実例：

• ロードマップの「スコア式の是非」でリスク担当とdevil’s advocate担当が対立
• 1往復の議論後、リスク担当が「devil’s advocateの指摘は本質的に正しい」と自説の弱点を認め、相手案を支持する方向に転換
• subagentでは独立した結果を返すだけなので、この種の協調的な意見更新は起きない

コスト実測（teammate 4名 Sonnet + リーダー Opus系）：

• teammate: 約$5.5（大半はキャッシュ読み書き）
• リーダー: 約$4.5
• 合計 ≒ $10 / レビュー1回（単一セッションの約3倍）

Skills化（/review コマンド）：disable-model-invocation: trueでClaude自動起動を防ぎ、人間が明示的に呼ぶ設計。allowed-toolsに事前承認ツールを指定して都度確認を削減。