如何在 Claude Code 中调用 Codex CLI?这篇文章分享一个实用的解决方案:通过 MCP(Model Context Protocol)将 Codex CLI 注册为 Claude Code 的工具,实现两个 AI 编程助手的协同工作。
苏米注:这个方案的核心思路很巧妙——让 Claude Code 作为"指挥官",Codex 作为"执行者",各自发挥优势。Claude Code 擅长理解和规划,Codex 擅长执行和验证。
整体架构
Claude Code
↓(MCP)
Tool Router(MCP Server)
↓
Codex CLI(已用 ChatGPT Plus 登录)
↓
本地代码仓库 / Shell / 文件系统

这个方案的技术依据:
- Claude Code 官方支持把本地 stdio 进程注册成 MCP server
- Codex CLI 支持 ChatGPT 登录,并且
codex exec默认会复用已缓存的登录认证 - Codex CLI 支持
-o/--output-last-message参数,适合被外部脚本包装 - MCP 官方 Python 示例使用 FastMCP,stdio server 通过
mcp.run(transport="stdio")启动
一、先决条件
确保以下几样都已经装好:
- Claude Code
- Codex CLI
- Python 3.10+
- 已在本机执行过一次 codex,并且用 ChatGPT Plus 登录成功
自检步骤
先检查版本:
codex --version
python --version
然后测试 Codex 登录是否可用:
codex exec "用一句话回复:Codex 登录正常"
如果这一步能正常返回,就说明后面 MCP 包装器能接上。Codex 的 exec 命令会复用已保存的认证,这是官方支持的行为。
二、安装 MCP Python 依赖
创建一个目录:
mkdir C:\mcp-codex
cd C:\mcp-codex
安装依赖:
py -m pip install "mcp[cli]>=1.2.0"

MCP 官方文档要求 Python 3.10+,且 Python MCP SDK 建议使用 1.2.0 或更高版本。
三、创建 MCP Server
新建文件 C:\mcp-codex\codex_mcp_server.py。这个脚本的核心逻辑:
- 暴露一个 MCP 工具:
codex_exec - Claude Code 调用这个工具时,脚本内部执行
codex exec - 使用
--output-last-message参数获取 Codex 的最终回答文本

四、本地测试 Server
在 PowerShell 里执行:
cd C:\mcp-codex
py .\codex_mcp_server.py
这时它会挂起等待 stdin/stdout 通信,这属于正常现象。MCP 官方示例里 stdio server 就是这样运行的。按 Ctrl+C 退出。

五、注册到 Claude Code
使用 Claude Code 官方命令注册:
claude mcp add --transport stdio codex-cli -- py C:\mcp-codex\codex_mcp_server.py
这是 Claude Code 官方支持的本地 stdio server 注册方式。选项必须放在 server 名称前面,-- 后面才是实际启动命令。
查看是否注册成功:
claude mcp list
claude mcp get codex-cli

六、在 Claude Code 里验证
启动 Claude Code:
claude
进入后输入 /mcp 查看状态。如果一切正常,你应该能看到 codex-cli。

给 Claude 一个测试提示:
请调用 codex-cli 的 codex_exec 工具,在当前项目目录执行:
prompt="先快速总结这个仓库是做什么的"
cwd="."
sandbox="read-only"
full_auto=true

七、常用场景与提示词模板
为了让 Claude 更稳定地调用 Codex,提示词建议采用以下格式:
当任务适合交给 Codex 时,调用
codex_exec。
默认参数:cwd="."、sandbox="workspace-write"、full_auto=true
先让 Codex 完成子任务,再把结果总结给我。
场景 1:让 Codex 分析仓库
调用 codex_exec,prompt="分析这个仓库结构,列出核心模块、入口文件和运行方式",cwd="."
场景 2:让 Codex 修改代码
调用 codex_exec,prompt="修复当前仓库中的 TypeScript 类型错误,并说明修改了哪些文件",cwd="."
场景 3:只读模式审查
调用 codex_exec,prompt="审查这个仓库里最可能出 bug 的 3 个点,并给出理由",cwd=".", sandbox="read-only"
Codex 官方文档里 --sandbox、--full-auto 都是正式参数。--full-auto 对应的是低摩擦自动化预设。
进阶用法:拆分专用工具
你也可以把 codex-exec 拆分成更具体的工具:
codex_plan:用来做方案、拆任务codex_review:用来审查、找风险codex_fix:修改代码- ……
总结
通过 MCP 将 Codex CLI 集成到 Claude Code 中,可以实现两个 AI 编程助手的优势互补:
- Claude Code:负责理解需求、规划任务、分析结果
- Codex:负责执行具体任务、修改代码、运行测试
苏米注:这个方案的价值在于它不是简单的"工具叠加",而是构建了一个分层协作系统。Claude Code 作为"大脑"负责决策,Codex 作为"双手"负责执行,这种架构值得在其他 AI 工作流中借鉴。