用途:该集成作为 MCP 服务器,将 Claude Code、Cursor 等支持 MCP 的编辑器与 OpenAI Codex CLI 打通,链路为 编辑器 → Codex MCP Server → Codex CLI → OpenAI API,从而在编辑器内直接调用 AI 做代码分析、生成、审查和网页搜索。
安装与用法:先安装 Codex CLI,npm install -g @openai/codex 或 brew install codex,用 codex --version 确认版本(需 0.75.0 以上,0.87.0+ 支持 thread ID)。随后认证:codex login --api-key "$OPENAI_API_KEY",并用 codex ping 验证。安装 MCP 服务器:Claude Code 用 claude mcp add codex-cli -- npx -y codex-mcp-server;也可手动在 MCP 配置中声明 stdio 类型、command 为 npx、args 为 -y 和 codex-mcp-server,并可选设置环境变量 CODEX_MCP_CALLBACK_URI 指定回调地址。
主要工具:codex 用于问答与代码辅助,参数含 prompt(必填)、context 文件数组、sessionId、model、reasoningEffort、fullAuto、sandbox、callbackUri、structuredContent,返回 response、threadId、metadata;review 支持 uncommitted、base/head 分支或 commit 区间的代码审查;websearch 支持 query、numResults、searchDepth;另有 listSessions、ping、help。
适用场景:安全审计、性能优化、重构建议、提交前审查、调研最新实践等;可通过 sessionId 进行多轮会话,通过 sandbox 的 read-only 或 workspace-write 控制文件权限,配合 fullAuto 实现自主修改。
限制:会话随 MCP 服务器实例存在,重启即重置;部分模型需特定 API 访问权限;版本不匹配或认证失败会导致不可用。具体收费与价格暂未提供。