Multi-agent V2 (マルチエージェント)

コードベースの調査や、複数ステップにわたる機能実装の計画のように、並列に進めやすい複雑な作業に向いています。探索・テスト・ログ分析などをサブエージェントに任せ、生の途中出力ではなく要約をメインのスレッドに返すことで、メインのエージェントが本筋の作業に集中できます。

ChatGPT Work では、多くの知能レベルで委任を明示的に頼む必要があります。Ultra を選ぶと、並列のエージェントが速度や品質を大きく高める場面で、ChatGPT が自発的に作業を委任する場合があります。ChatGPT Work はサブエージェントをホスト環境で動かし、サブエージェントは親のチャットで使えるツールを使います。

ChatGPT Work では、独立した作業をサブエージェントに任せるよう依頼し、Subagents (サブエージェント) を開くと読み取り専用の Active (実行中) と Done (完了) の一覧を見られます。完了したサブエージェントを選ぶと、その詳細と結果を確認できます。web のサイドバーはサブエージェントの動作状況を表示しますが、個別のサブエージェントを停止したり方向を修正したりする操作はありません。

IDE 拡張では、バックグラウンドエージェントの UI が使える場合、実行中のサブエージェントがコンポーザーの上に表示されます。パネルを展開すると、状態の確認、実行中のサブエージェントすべての停止、個別のサブエージェントのスレッドを開く操作ができます。

カスタムエージェントは次の手順で定義します。

• 個人用は ~/.codex/agents/、プロジェクト単位は .codex/agents/ に、独立した TOML ファイルとして置きます。
• 各ファイルには name、description、developer_instructions を定義します。
• 必要に応じて model、model_reasoning_effort、model_reasoning_summary、model_verbosity でモデルの振る舞いを調整します。

Codex はカスタムエージェントを name フィールドで識別し、ファイル名ではなくこのフィールドが基準です。カスタムエージェントの名前が explorer などの組み込みエージェントと同じ場合は、カスタムエージェントが優先されます。機能を絞りたい場合は、features.shell_tool、features.apps、features.plugins、features.memories、features.request_permissions_tool などのキーを false にします。

サブエージェントのモデルと推論の強さは、プロンプトでの指定、config.toml の [agents] での既定値、カスタムエージェントのファイルでの model と model_reasoning_effort の指定のいずれかで選べます。モデルや model_reasoning_effort を設定しない場合、サブエージェントは親エージェントのモデルと推論の強さを引き継ぎます。

ローカルの Codex クライアントでは、サブエージェントは現在のサンドボックスのポリシーを引き継ぎます。CLI では、/permissions や --yolo で変えた内容も含めて親のターンのサンドボックスと承認の設定を引き継ぎ、カスタムエージェントのファイルでこれらを置き換えることはできません。カスタムエージェントは権限、プロバイダー、MCP サーバーも親から引き継ぎ、ファイルで上書きできません。カスタムエージェントの指示で編集を避けるよう求めることはできますが、それによって別の読み取り専用サンドボックスが作られるわけではありません。

対話型の CLI セッションでは、非アクティブなエージェントスレッドから承認リクエストが届く場合があります。承認のオーバーレイには発信元スレッドのラベルが表示され、o を押すと、承認・却下・回答の前にそのスレッドを開けます。非対話型の流れや、新たな承認を表示できない実行では、新しい承認が必要な操作は失敗し、Codex がそのエラーを親のワークフローに返します。

• agents.enabled の既定値は true で、false にするとマルチエージェントのツールが無効になります。
• agents.max_concurrent_threads_per_session で、メインのスレッドを除き、同時に開いておける生成済みエージェントのスレッド数に上限を設けられます。
• 各サブエージェントが独自にモデルとツールの処理を行うため、同等の単一エージェントでの実行よりトークンの消費が多くなります。Ultra 推論を選ぶと、マルチエージェントの並列度が高い場合に使用量が急に増える場合がある旨の警告が表示されます。
• Multi-agent V2 のダイレクトメッセージを無効にするオプションがあります。
• 対象となるプランは、公式のリリースノートには記載がありません。

1. ローカルの Codex クライアントで、サブエージェントの利用や並列でのエージェント作業を直接依頼します。該当する AGENTS.md やスキルの指示が求める場合にも、Codex はサブエージェントに作業を任せます。
2. CLI では /subagents を使い、動作中のエージェントスレッドを切り替えて、進行中のスレッドの内容を確認します。
3. 実行中のサブエージェントの方向を修正したいとき、止めたいとき、完了したサブエージェントのスレッドを閉じたいときは、Codex にそのまま依頼します。