Codex CLI MCP Tool

Codex CLI MCP服务器

允许Claude Code与OpenAI Codex CLI交互的MCP服务器。如果您有ChatGPT订阅和claude代码订阅，您可以使用此工具同时获得两者的好处，因为20美元的ChatGPT订购可以让您在Codex CLI中免费访问GPT-5。

特性

• 完全的食品法典整合：通过MCP访问所有Codex CLI功能
• GPT-5型：由OpenAI最强大的模型提供支持
• 沙箱安全：可配置的执行模式（只读、工作区写入、完全访问）
• 进度跟踪：长时间运行操作的实时更新
• Git集成：将Codex生成的差异直接应用于存储库
• 灵活的配置：环境变量和配置文件支持

安装

1. 安装Codex CLI （必填）：

   npm install -g @openai/codex

1. 使用npx添加到Claude代码:

   claude mcp add codex-cli-mcp-tool -- npx -y codex-cli-mcp-tool

或者先全局安装：

   npm install -g codex-cli-mcp-tool

1. 配置身份验证:

   # Option 1: Use API key
   export OPENAI_API_KEY=your-api-key

   # Option 2: Login with ChatGPT account
   codex login

可用工具

询问codex

执行Codex，提供全面的参数支持，用于代码分析、生成和协助。

参数：

• prompt （必填）：您的询问或指示
• model （可选）：gpt-5（默认且仅支持型号）
• sandbox （可选）：只读、工作区写入、危险完全访问
• approval （可选）：不可信、失败、请求、从不
• image （可选）：要包含的图像文件路径
• config （可选）：配置覆盖
• timeout （可选）：最长执行时间

例子：

ask-codex "Explain this code: @main.py" sandbox="read-only"

执行代码

自动化工作流程的非交互式Codex执行。

参数：

• prompt （必填）：命令或指示
• model （可选）：始终为gpt-5
• sandbox （可选）：沙盒模式
• timeout （可选）：执行超时

应用diff

将最新的Codex生成的diff应用于您的git存储库。

参数：

• dryRun （可选）：预览更改而不应用
• validate （可选）：申请前验证

实用工具

• ping：测试MCP连接
• help：显示详细的帮助信息
• version：显示版本信息

配置

环境变量

OPENAI_API_KEY=sk-...           # OpenAI API key
CODEX_MODEL=gpt-5               # Default model
CODEX_SANDBOX_MODE=read-only    # Default sandbox mode

配置文件（~/.codex/Config.toml）

[model]
provider = "openai"
default = "gpt-5"
reasoning_effort = "medium"

[sandbox]
default_mode = "read-only"
permissions = ["disk-read-access"]

[approval]
policy = "untrusted"
trusted_commands = ["ls", "cat", "grep"]

沙盒模式

• 只读的：安全探索，无文件修改
• 工作区写入：项目内的有限修改
• 危险完全访问：完全系统访问权限（需要确认）

例子

代码分析

ask-codex "Review this function for security issues: @auth.py"

代码生成

ask-codex "Generate unit tests for the User class" sandbox="workspace-write"

调试

ask-codex "Fix the bug in login function" approval="on-request"

文件操作

ask-codex "Create a new React component for user profile" sandbox="workspace-write"

应用更改

ask-codex "Refactor this code to use async/await"
apply-diff validate=true

故障排除

常见问题

1. 未找到Codex CLI:

   npm install -g @openai/codex

1. 认证失败:

   # Set API key
   export OPENAI_API_KEY=your-key

   # Or login
   codex login

1. 权限不足:

- 使用适当的沙盒模式 - 检查审批策略设置 - 验证文件权限

1. 费率限制:

- 请稍候，然后重试 - 检查OpenAI帐户配额

调试模式

启用调试日志记录：

DEBUG=true codex-cli-mcp-tool

发展

设置

git clone 
cd codex-cli-tool
npm install
npm run build
npm run dev

测试

npm test
npm run lint

致谢

这个项目是基于优秀 Gemini MCP工具 由jamubc。我们调整了他们的架构和模式，以创建这种Codex CLI集成。

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 添加测试
5. 提交拉取请求

支持

• GitHub问题： 报告错误和功能请求
• OpenAI Codex：https://github.com/openai/codex