Claude Code の Agent Teams で、各工程を Opus と Codex に二重レビューさせる
Agent Teams（実験機能）で「Opus のリーダーは調整だけ、実装は Sonnet＋advisor、レビューは工程ごとに Opus と Codex のペア」というチームを組む。同じモデル同士だと見落としが重なるので、別系統のモデルに同じものを見せ、2人の判定の組み合わせで差し戻すかを決める。
どんな場面で使う？
- 仕様→計画→実装→テスト→ドキュメントを一気通貫でエージェントに回し、要所で品質を担保したい
- 1モデルのセルフレビューでは見落としが残ると感じている
チーム構成
| 役 | モデル | 役割 |
|---|---|---|
| Lead | Opus（opus[1m] 推奨） | 調整と判定だけ。自分では書かない |
| planner | Opus | plan.md を作る。Part 1 = 仕様（What）、Part 2 = 計画（How） |
| plan-reviewer | Codex のみ | planner が Opus なので、別系統だけで見る |
| 実装・テスト・ドキュメント担当 | Sonnet＋/advisor opus | 手を動かす |
| impl／test／doc／security reviewer | Opus と Codex のペア | 同じ成果物を両方が見る |
レビュー結果は docs/plans/<日付-slug>/reviews/<対象>-<モデル>.md に書かせる。
二重レビューの判定ルール
- 両方 ❌ → 差し戻し
- 片方だけ ❌ → Lead が中身を見て決める
- 両方 ⚠️ → 通す。ただし同じ箇所を指摘していたら直す
動かすときの要点
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1で有効化- CLAUDE.md に「『チームで』と言われたら
~/.claude/agents/README.mdを読む」と書き、Lead の手順書はそちらに置く - Phase 0 で
TeamCreate。以降のAgent()呼び出しには必ずteam_nameとnameを付ける（付け忘れると普通のサブエージェントとして動き、チームに入らない） - 各エージェント定義の冒頭は「あなたは〇〇を担当する teammate」で始める
- 実装フェーズは
run_in_backgroundで並列に出す - やり直しは
SendMessageで既存の teammate に頼む。新しく spawn すると「-2」の別人ができ、文脈が消える
注意点
- フルで回すと20〜30分かかる。普段は「計画＋計画レビューだけ」「実装＋impl レビューだけ」のような部分パターンで使う
- Codex レビュアーは openai-codex プラグイン内部のスキル（codex-cli-runtime など）を使う個人的なハックで、公式の使い方ではない。skills の frontmatter は teammate に効かないので、settings 側で有効にしておく必要がある
- 関連: Claude Code チームのコードレビュー運用を自分のチームに入れる（REVIEW.md・リスク階層・ラウンド上限）、CI の AI コードレビューは「専門レビュアー＋取りまとめ役」に分け、差分の大きさで人数を変える、Claude Code から Codex MCP を並列で呼ぶなら、Supergateway で Streamable HTTP の1プロセスにまとめる、DB 設計は「問い」に分けて壁打ちし、4人のペルソナのサブエージェントでレビューを回す
出典
- いいね: @wasabeef_jp · 2026-04-17 （ブログ「Claude Code Agent Teams × Codex で Cross-Model Review する」）