精读：Codex 多 Agent 编排

Claude Code 有内置的 4 层多 Agent 层级（SubAgent → Coordinator → Swarm → Workflow）。Codex 走了完全不同的路线：以 MCP Server 模式 + Agents SDK 外部编排 + 桌面 App 原生并行三条路径实现多 Agent 协作。

设计哲学对比

维度	Claude Code	Codex CLI
路线	内置原生（一步 spawn）	外部编排（MCP + SDK）
隔离	逻辑隔离（独立上下文）	物理隔离（Git Worktree + 容器）
通用性	编码专用	通用 Agent 框架（超越编码）
可观测性	无官方 tracing	内置 tracing + evaluation

路径一：MCP Server 模式

工作原理

Codex CLI 可作为 MCP Server 节点运行，暴露标准化接口供外部编排器调度。

codex --mcp-server

暴露的工具：

工具	参数	功能
`codex()`	Config 结构体（model、instructions、sandbox 等）	创建新会话
`codex-reply()`	thread_id + prompt	在已有会话中继续对话

通信架构

┌─────────────────────────────────────────────┐
│           Agents SDK (Orchestrator)          │
│  ┌──────────────────────────────────────┐   │
│  │         Agent 定义 + 编排逻辑          │   │
│  └──────────┬───────────┬───────────┬───┘   │
│             │           │           │       │
│         stdio       stdio       stdio       │
│             │           │           │       │
│  ┌──────────▼──┐ ┌──────▼──────┐ ┌─▼─────┐ │
│  │ Codex Inst 1│ │ Codex Inst 2│ │ Inst 3│ │
│  │ (前端开发)   │ │ (后端开发)   │ │(测试)  │ │
│  └─────────────┘ └─────────────┘ └───────┘ │
└─────────────────────────────────────────────┘

每个 Codex 实例：

独立进程（stdio JSON-RPC 通信）
独立上下文窗口
独立沙箱策略
可配置不同模型（GPT-5.5 / codex-mini）

与 Agents SDK 集成示例

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

# 定义 Codex 作为 MCP Server
codex_server = MCPServerStdio(
    command="codex",
    args=["--mcp-server"],
    env={"CODEX_MODEL": "gpt-5.5"}
)

# 定义编排 Agent
orchestrator = Agent(
    name="Software Lead",
    instructions="分解复杂任务并委派给 Codex 实例",
    mcp_servers=[codex_server]
)

# 运行
result = await Runner.run(orchestrator, "重构用户认证模块")

Agents SDK 编排特性

特性	说明
Tracing	内置调用链追踪，可视化调试多 Agent 工作流
Handoffs	显式定义 Agent 间任务移交（A 完成 → 交给 B）
Guardrails	Agent 级别安全护栏（输入/输出验证）
State	编排器管理全局状态，Agent 间可共享上下文
Evaluation	内置评估工具，衡量 Agent 表现
Realtime	支持语音 Agent (gpt-realtime-2)

路径二：桌面 App 原生多 Agent

三层架构

2026 年 2-4 月发布的 Codex 桌面 App（macOS/Windows）内置多 Agent 并行支持：

┌─────────────────────────────────────────┐
│         Orchestrator Layer               │
│  ┌───────────┐ ┌──────────┐ ┌────────┐ │
│  │ Task      │ │ Scheduler│ │Aggreg- │ │
│  │ Decomposer│ │          │ │ ator   │ │
│  └───────────┘ └──────────┘ └────────┘ │
├─────────────────────────────────────────┤
│         Agent Pool Layer                 │
│  ┌────┐┌────┐┌────┐┌────┐┌────┐┌────┐ │
│  │Arch││FE  ││BE  ││Test││Rev ││Doc │ │
│  └────┘└────┘└────┘└────┘└────┘└────┘ │
├─────────────────────────────────────────┤
│         Context Layer                    │
│  ┌──────────┐ ┌──────────┐ ┌─────────┐ │
│  │ Shared   │ │ Private  │ │ Memory  │ │
│  │ Knowledge│ │ Context  │ │ System  │ │
│  └──────────┘ └──────────┘ └─────────┘ │
└─────────────────────────────────────────┘

并发能力

维度	参数
最大并行 Agent	10
隔离方式	每 Agent 独立 Git Worktree
角色类型	Architect / Frontend / Backend / Tester / Reviewer / Documenter
模型路由	主 Agent 用 GPT-5.5，子 Agent 可用 GPT-5.4 mini（成本优化）

冲突解决机制

多 Agent 并行修改同一代码库时的三层冲突解决：

静态冲突检测（执行前）
- 分析文件依赖关系
- 标记潜在冲突区域
- 分配互斥写入范围
动态冲突解决（运行时）
- Three-Way Merge 自动合并
- 冲突标记 + 人工 review 升级
- CRDT 保证共享上下文一致性
代码契约（模块间）
- 显式接口约束
- 类型签名作为 Agent 间通信协议
- 变更需满足接口兼容性

上下文管理

类型	作用
私有上下文	每 Agent 独立对话历史（不互相干扰）
共享知识库	CRDT 保证一致性的全局知识
记忆系统	长期记忆 / 短期记忆 / 工作记忆三层

路径三：Subagents（正式 GA）

2026 年 6 月 Codex Subagents 正式 GA，补齐了”内置轻量子 Agent”能力：

与 Claude Code Task 工具对比

维度	Codex Subagents	Claude Code Task
状态	2026.6 GA	2026.2 随 Swarm 发布
spawn 方式	manager agent 委派	父 agent 通过 Task 工具
跨仓库	支持（独立 worktree）	通过 EnterWorktree 支持
上下文	独立（物理隔离）	独立（逻辑隔离）
深度限制	未明确	前台 5 层

与 Claude Code 多 Agent 的完整对比

架构对照

Claude Code 层级	对应 Codex 实现
SubAgent（Task 工具 spawn）	Subagents（GA）/ MCP Server 实例
Coordinator（路由分发）	Agents SDK Orchestrator Agent
Swarm（协作式网状）	桌面 App Agent Pool（星型）
Dynamic Workflow（JS 编排脚本）	Agents SDK Python/JS 编排代码

优劣势分析

Codex 优势：

Git Worktree 物理隔离更安全（无上下文泄漏风险）
Agents SDK 是通用框架（可超越编码场景）
内置 tracing 和 evaluation 工具链
桌面 App 可视化管理多 Agent 状态
角色专业化（预设 6 种角色模板）
模型路由可优化成本（主 Agent 用大模型，sub 用小模型）

Codex 劣势：

MCP Server 模式需要外部 SDK 编排，不像 Claude Code Task 一步到位
Worktree 方式资源开销大于 Claude Code 单进程内 spawn
缺乏 Claude Code 的 Agent 间实时协作（Swarm 网状 vs 星型）
编排逻辑在 SDK 层而非 Agent 内部，调试需跨层

Claude Code 优势：

内置原生，零配置即用
Swarm 模式下多 Agent 互相感知协作
Dynamic Workflow 编排脚本更灵活（5 原语 API）
并发上限更高（16 并发 / 1000 总 Agent）

Claude Code 劣势：

逻辑隔离存在上下文泄漏风险
无官方 tracing 和 evaluation
多 Agent 可视化管理较弱
封闭生态，无法在非 Anthropic 环境复用

典型使用场景

场景 1：微服务重构

Agents SDK Orchestrator
├── Codex (Architect)  → 设计新架构 + 接口定义
├── Codex (Backend 1)  → 重构用户服务
├── Codex (Backend 2)  → 重构订单服务
├── Codex (Frontend)   → 更新 API 调用
└── Codex (Tester)     → 编写集成测试

场景 2：全栈 Feature 开发

桌面 App（10 Agent 并行）
├── Agent 1: 数据库 migration
├── Agent 2: REST API 实现
├── Agent 3: GraphQL schema
├── Agent 4: React 组件
├── Agent 5: 单元测试
├── Agent 6: E2E 测试
├── Agent 7: API 文档
├── Agent 8: CI 配置
├── Agent 9: Docker 配置
└── Agent 10: 代码审查

场景 3：跨 Agent 混合编排

Agents SDK
├── Codex (MCP Server) → 快速实现
├── Claude Code (MCP Server) → 深度审查
└── Custom Agent → 领域知识注入

演进时间线

时间	里程碑
2025-04	Codex CLI 开源（单 Agent）
2025-09	Agents SDK 发布（Python）
2026-01	“Unrolling the Agent Loop” 博文（阐述 turn 模型）
2026-02	macOS 桌面 App（多 Agent 并行架构首发）
2026-03	Windows 桌面 App + Worktree 隔离
2026-04	“Codex for Everything”（企业多 Agent + 持久记忆）
2026-05	Agents SDK JS 版本 + 增强 handoff
2026-06	Subagents GA + Codex SDK + AgentKit 发布

交叉引用

Claude Code 多 Agent 编排 — 内置 4 层架构对比
Codex 总架构 — run_turn 与 Agent Pool 的关系
MCP 集成对比 — MCP Server 模式详解
Claude Code vs Codex 全维度对比 — 综合对比
Coding Agent 沙箱对照 — Worktree 隔离原理