用途:CodexMCP 通过 MCP(Model Context Protocol)协议桥接 Claude Code 与 Codex,实现多智能体 AI 编程协作。Claude Code 侧重架构与规划,Codex 侧重实现与调试。
主要能力:支持 Claude Code 与 Codex 之间的多轮对话与会话管理;通过隔离的 SESSION_ID 并行执行任务;追踪推理轨迹以便调试;增强错误处理与工作区安全控制;会话可跨多次交互持久化。它提供单一 MCP 工具 codex,参数包括必填的 PROMPT(任务指令)和 cd(工作目录根路径),可选 sandbox(read-only 默认、workspace-write、danger-full-access)、SESSION_ID、skip_git_repo_check、return_all_messages、image、model、yolo、profile。成功返回 success、SESSION_ID、agent_messages,return_all_messages=True 时还返回 all_messages。
使用方式:需先安装 Claude Code v2.0.56+、Codex CLI v0.61.0+ 和 uv。安装 uv:Windows 用 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex",Linux/macOS 用 curl -LsSf https://astral.sh/uv/install.sh | sh。然后移除官方 Codex MCP:claude mcp remove codex;安装:claude mcp add codex -s user --transport stdio -- uvx --from git+https://github.com/GuDaStudio/codexmcp.git codexmcp;用 claude mcp list 验证。可选在 ~/.claude/settings.json 的 allow 列表加入 mcp__codex__codex 自动批准。
适用场景:代码审查、Bug 调查、重构、原型生成、并行任务、基于图片的上下文分析等。
限制:需满足版本与依赖前提;cd 建议用绝对路径;会话续接需保存并传回 SESSION_ID;默认只读沙箱,写操作需调整 sandbox;Git 仓库检查可用 skip_git_repo_check 绕过;yolo 与 danger-full-access 有风险。资料未提供收费、价格与效果数据。