MCP

点将台 codex-cc-orchestrator：让 Codex 派发任务给 Claude Code 执行与审查

点将台最适合让 Codex 把编码任务派发给 Claude Code 执行并由独立只读会话审查，但前提是你必须显式传入可信的 project_root 并装好两套 Agent。

官方来源 · 点将台 codex-cc-orchestrator

安装

git clone https://github.com/zjgxkj/codex-cc-orchestrator.git && cd codex-cc-orchestrator && git checkout v0.4.0 && uv sync

点将台（codex-cc-orchestrator）适合需要让一个主控 Agent 把任务派发给执行者、再由独立只读会话审查的场景。开始前最重要的一点：你需要同时安装并配置好 Codex 和 Claude Code 两个本地 Agent，且每个任务必须显式传入可信的 project_root，服务不会根据当前目录猜测工作区。

适合谁

  • 已经在使用 Codex 并安装了 Claude Code 的用户，希望通过 MCP 把任务派发给 Claude Code 执行与审查，实现分层协作编排。
  • 需要任务派发、执行、续跑、独立审查、结果压缩和用量记录的开发工作流。
  • 不适合：没有同时具备 Codex 与 Claude Code 两端环境的人；证据未说明是否能单独使用其中一端，请以官方文档为准。
  • 使用前提：本机需要 Python 3.13+ 和 uv。完整中文安装步骤见官方 INSTALL.md。

3 分钟完成第一次尝试

前提：Python 3.13+、uv、以及已配置好的 Codex 和 Claude Code。

  1. 获取并安装（官方主路径）：
git clone https://github.com/zjgxkj/codex-cc-orchestrator.git
cd codex-cc-orchestrator
git checkout v0.4.0
uv sync
  1. 在 Codex 的 STDIO MCP 配置中注册服务（Windows 官方示例）：
[mcp_servers.codex-claude-agent]
command = 'D:\path\to\codex-claude-agent-mcp\.venv\Scripts\python.exe'
args = ['-m', 'codex_claude_agent_mcp']
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 7200
  1. 做一次低风险首试：服务暴露 ping 工具，用它确认 MCP 通道连通，不涉及任何文件写入。成功信号是 Codex 能列出服务工具并收到 ping 响应。注意 stdout 只承载 MCP 协议消息，日志和报错都在 stderr，排查启动问题看 stderr。

真实执行任务（execute_task 等）是另一回事：必须显式传入你信任的 project_root，执行会读写该目录内的文件，这不是只读操作，调用前请确认目标项目目录。

使用案例

案例一：派发并执行一个编码任务。在 Codex 会话中调用 execute_task，传入任务描述和你显式授权的 project_root。执行器会话使用受限工具集（Read/Grep/Glob/Edit/Write/Bash，允许联网，禁止嵌套 Agent 和 notebook 编辑）完成改动。可期待：任务被执行，状态持久化到本地 SQLite（~/.codex-claude-agent-mcp/state.db）。

案例二：独立审查与续跑。调用 review_task 会让一个全新只读会话审查执行结果并给出 PASS/FAIL；若 FAIL，可调用 continue_task 在保存的执行会话基础上携带反馈继续。可期待：只读审查不改动文件，续跑复用会话上下文。也可以用 run_job / run_jobs 编排多个任务，用 get_job_status 查询进度。

使用边界

  • 读写性质：ping 是只读探活；execute_task、run_job、run_jobs 会写入 project_root 下的文件，属真实副作用，调用前需确认目录正确；review_task 由只读会话完成审查。
  • 授权：每个任务可接收 project_root，Codex 必须显式传入可信 workspace root；服务不会根据自身进程 cwd 猜测。ALLOWED_PROJECT_ROOTS 是可选的长期信任列表。
  • 本地状态：执行会话等状态持久化在 ~/.codex-claude-agent-mcp/state.db。官方未说明该状态的删除或撤销路径。
  • 并发限制：CLAUDE_MAX_CONCURRENCY（默认 4）仅对单个 MCP server 进程生效。
  • 工具只读提示仅表明不执行写操作，不代表不会联网或没有隐私边界；官方未说明的部分（如凭证管理细节）不应被当作无风险。