项目简介

Codex MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，专门为 OpenAI Codex CLI v0.75.0+ 版本设计。它通过标准化的 JSON-RPC 协议，让 Claude Code 等 AI 客户端能够调用 Codex 的功能进行代码开发、分析和审查。

主要功能

代码助手：通过 Codex CLI 执行代码分析、解释和生成任务
智能会话管理：支持多轮对话上下文，自动管理会话状态
代码审查：对 Git 仓库进行 AI 驱动的代码审查，支持未提交变更、分支对比和特定提交分析
模型选择：支持多种 OpenAI 模型，包括 gpt-5.2-codex、gpt-4o、gpt-4 等
沙盒模式：提供三种安全级别（只读、工作区写入、完全访问）
全自动模式：启用沙盒化自动执行，无需人工确认
会话列表：查看所有活跃会话及其元数据
连接测试：提供 ping 工具验证服务器连接状态

安装步骤

前置要求

安装 OpenAI Codex CLI v0.75.0+：'npm i -g @openai/codex' 或 'brew install codex'
配置 Codex：运行 'codex login --api-key "你的OpenAI API密钥"'

快速安装

VS Code：点击仓库中的安装链接一键安装
Cursor：通过专用安装链接快速配置
手动安装：在 Claude Desktop 配置文件中添加 MCP 服务器设置

服务器配置

在 Claude Desktop 配置文件中添加以下设置：

{
  "mcpServers": {
    "codex-cli": {
      "command": "npx",
      "args": ["-y", "codex-mcp-server"]
  }
}

配置说明：

服务器名称：codex-cli
启动命令：使用 npx 直接运行最新版本
参数说明：'-y' 表示自动确认，'codex-mcp-server' 是要执行的包名

基本使用方法

在 Claude Code 中可以使用以下工具：

代码分析：

使用 codex 工具分析这个 TypeScript 函数并建议改进

会话式开发：

使用 codex 工具，设置会话ID为 "auth-refactor"，来分析这个认证系统

代码审查：

使用 review 工具审查我未提交的更改

查看会话：

使用 listSessions 查看所有活跃的开发会话

关键词