Codex CLI 多代理协同方式与工程化落地

• 状态：已验证
• 来源：对话整理
• 更新时间：2026-03-12

关键结论

• Codex CLI 官方已支持实验性的 multi_agent 功能，可由主代理自动拉起子代理并汇总结果。
• 两个独立 codex_cli 默认不会自动共享上下文，手工协同时应采用“分工 + 独立 worktree + 文件同步”。
• 更工程化的方案是将 Codex CLI 作为 MCP Server，由外部 orchestrator 或 Agents SDK 统一调度。

详细分析

• 内建 multi_agent 适合快速并行分析，配置简单，但属于实验性能力。
• 手工双 CLI 协作不应追求代理间直接对话，而应通过仓库内共享文档同步状态。
• 若两个代理同时修改同一工作目录，容易发生覆盖、冲突和上下文污染，因此应使用独立 git worktree。
• MCP Server 方案适合长期复用，可扩展到 planner / analyst / patch / verifier / reporter 等多角色体系。

可执行步骤

1. 在 ~/.codex/config.toml 中启用 multi_agent，或通过 codex --enable multi_agent 开启。
2. 若采用手工双 CLI 协作，为每个代理创建独立 git worktree。
3. 在仓库中建立 coordination/ 目录，使用 task.md、findings_a.md、findings_b.md、decision.md 作为共享协议。
4. 固定职责：一个代理偏分析，一个代理偏实现，主控代理负责审阅和汇总。
5. 若后续需要长期自动化，将 Codex CLI 以 codex mcp-server 方式接入外部编排系统。

命令 / 配置 / 代码

~/.codex/config.toml：

[features]
multi_agent = true

或：

codex --enable multi_agent

worktree 示例：

git worktree add ../proj_agent_a feature/agent-a
git worktree add ../proj_agent_b feature/agent-b

MCP Server 启动：

codex mcp-server

建议的共享目录：

coordination/
  task.md
  findings_a.md
  findings_b.md
  decision.md

风险与注意事项

• multi_agent 当前为实验性功能，行为和界面可能继续变化。
• 两个独立 CLI 不会天然共享记忆，必须自行设计同步机制。
• 不建议两个代理同时修改同一批文件。
• 最终必须由主控代理或人工进行 diff review 和合并决策。