使用说明
codex mcp
MCP服务器公开 OpenAI Codex命令行界面 作为Claude Code的工具。
工具
| 工具 | 说明 |
|---|---|
codex_exec |
在任何提示下运行Codex |
codex_ask |
只读问题和代码分析 |
codex_review |
针对分支、提交或未提交的更改进行代码审查 |
codex_security_audit |
基于OWASP的安全审计 |
codex_brainstorm |
多视角设计探索 |
codex_resume |
继续之前的任何食典会议 |
先决条件
- Python 3.11+
- Codex CLI 已安装并位于PATH中
安装
git clone https://github.com/panuhen/codex-mcp.git
cd codex-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
在Claude代码中配置
添加到您的Claude Code MCP设置中(~/.mcp.json 或项目级别 .mcp.json):
{
"mcpServers": {
"codex": {
"command": "/absolute/path/to/codex-mcp/.venv/bin/codex-mcp"
}
}
}
替换 /absolute/path/to/codex-mcp 使用克隆仓库的实际路径。
使用Codex配置文件(例如Azure OpenAI)
如果您在中配置了配置文件 ~/.codex/config.toml (例如a azure 使用自定义模型提供商的配置文件),pass --profile 通过 args 并通过提供所需的API密钥 env:
{
"mcpServers": {
"codex": {
"command": "/absolute/path/to/codex-mcp/.venv/bin/codex-mcp",
"args": ["--profile", "azure"],
"env": {
"AZURE_OPENAI_API_KEY": "your-api-key-here"
}
}
}
}
如果API密钥已经在您的外壳配置文件中导出(例如。 export AZURE_OPENAI_API_KEY=... 在 ~/.bashrc),您可以跳过 env 完全封锁:
{
"mcpServers": {
"codex": {
"command": "/absolute/path/to/codex-mcp/.venv/bin/codex-mcp",
"args": ["--profile", "azure"]
}
}
}
您还可以通过以下方式设置配置文件 CODEX_PROFILE 环境变量而不是 args.
可以通过传递其他codex配置覆盖 -c:
{
"mcpServers": {
"codex": {
"command": "/absolute/path/to/codex-mcp/.venv/bin/codex-mcp",
"args": ["--profile", "azure", "-c", "model=\"o3\""]
}
}
}
重新启动Claude Code,Codex工具将可用。
使用示例
配置后,Claude Code可以直接使用这些工具:
- “查看我未提交的更改” --触发器
codex_review - “在src/上运行安全审核” --触发器
codex_security_audit - “集思广益缓存方法” --触发器
codex_brainstorm - “询问Codex身份验证模块是如何工作的” --触发器
codex_ask
会话可以继续 codex_resume 使用 session_id 由任何工具返回。
许可证
麻省理工学院