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 程序生效。
  • 工具唯讀提示僅表示不執行寫入操作，不代表不會連網或沒有隱私邊界；官方未說明的部分（如憑證管理細節）不應被視為無風險。