Codex マルチエージェント機能
AIを「個人」から「専門チーム」へ

なぜマルチエージェントが必要なのか？
単一エージェントの3つの限界

1つのAIエージェントに全てを任せると、コンテキスト汚染・デグレッション・幻覚ループという根本的な問題が発生します。

戦略的転換：「関心事の分離」という解法

人間のチーム開発と同じ原理 ― 調査・実装・レビューを専門のエージェントに分離し、それぞれに適切な権限とモデルを割り当てることで、品質と速度を飛躍的に向上させます。

3つの専門ロールによるチーム編成

各ロールは明確に分離された権限を持ち、人間の開発チームのように協調して動作します。

黄金サイクル：Investigate → Build → Verify

3つのロールが固定フォーマットの計画書（PLAN.md）をハンドオーバーポイントとして、調査→構築→検証のサイクルを回します。

Explorer の5つの必須出力（PLAN.md）

Explorerは以下の5セクションを含む構造化された計画書を出力します。これが後続エージェントへの「設計書」となります。

Worker と Reviewer の行動原則

config.toml 階層的設定システム

マルチエージェントは config.toml で有効化・制御します。設定は3段階の優先度で解決されます。

# マルチエージェント機能を有効化
[features]
multi_agent = true

# 並列スレッド数（推奨: 4から開始）
[performance]
max_threads = 4

# Explorer ロールの定義
[agents.explorer]
description = "コードベース調査専用"
config_file = "agents/explorer.toml"

# Worker ロールの定義
[agents.worker]
description = "実装・テスト作成"
config_file = "agents/worker.toml"

ガバナンス：サンドボックスと非対話型承認

サブエージェントは親のサンドボックス設定を継承し、権限外の操作は自動的にブロックされます。人間の介在なしに安全を保証する仕組みです。

インテリジェンス・ティアリング：コストと速度の最適化

親エージェント（Orchestrator）には高い推論能力のモデル、子エージェント（Sub-agents）には高速・軽量モデルを割り当て、コストとパフォーマンスを両立します。

運用インターフェース：CLI と macOS App

マルチエージェントは2つのインターフェースで運用でき、設定ファイルは両者で共有されます。

トラブルシューティングと監査

実践ユースケース：マイクロサービスの契約変更

「変更境界＝サービス境界」。複数サービスにまたがるAPI契約変更を、マルチエージェントが安全に管理する例です。

プラン別利用ガイド

開発スタイルに合わせた最適なプランの選択ガイド。マルチエージェント機能はPro以上で最大限活用できます。