Codex审查MCP服务器
一个MCP服务器,允许Claude Code访问OpenAI的Codex模型,以进行跨模型代码审查。Codex在您的存储库中作为完整代理运行——读取文件、探索依赖关系和理解上下文——与在Codex UI中手动运行它相同。
使用Codex CLI和ChatGPT订阅身份验证。不需要API密钥计费。
它的作用
三种工具,与自然的审查工作流程相匹配:
| 工具 | 模式 | 发生了什么 |
|---|---|---|
codex_review_and_fix | 审查+自动修复 | Codex审查更改,自动修复P0-P2问题,报告有问题的模糊问题,列出P3以提高认识 |
codex_review | 仅审查 | 相同的审查,没有修复。只读。当你首先想要发现的时候。 |
codex_fix | 仅修复 | 应用特定的已批准发现。经过人工审核后的第二次通过。 |
优先级方案
- P0(临界):安全漏洞、数据丢失、崩溃、绕过身份验证
- P1(高):重大错误、逻辑错误、竞争条件、缺少错误处理
- P2(中等):边缘案例,特定条件下的潜在问题
- P3(低):细微改进、建议(从不自动修复)
自动修复规则
对于P0-P2发现:
- 明确的 (自信、明显的解决方案)→ 自动修复
- 有问题 (歧义、权衡、需求背景)→ 报告了食品法典委员会的问题,未解决
P3的发现总是只报告,从不固定。
先决条件
1.Python 3.10或更高版本
python3 --version # must be 3.10+
# macOS
brew install python@3.142.Codex CLI
# macOS
npm i -g @openai/codex
# Verify
codex --version看 对于其他平台。
3.ChatGPT订阅
Codex CLI通过您的ChatGPT帐户进行身份验证(外加每月20美元或Pro每月200美元)。不需要单独的API密钥。
codex login # opens browser, sign into ChatGPT凭据存储在 ~/.codex/config.toml.重新运行 codex login 如果您的会话到期。
4.克劳德密码
从以下位置安装 claude.ai/code 如果你还没有。
安装
第一步:克隆
git clone https://github.com/bdouble/codex-review-server.git ~/.claude/mcp/codex-review-server步骤2:设置虚拟环境
cd ~/.claude/mcp/codex-review-server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
deactivate步骤3:使用Claude Code注册
# Global (available in all projects — recommended)
claude mcp add --scope user codex-review-server -- \
~/.claude/mcp/codex-review-server/.venv/bin/python3 \
~/.claude/mcp/codex-review-server/server.py
# Or project-scoped (current repo only)
claude mcp add codex-review-server -- \
~/.claude/mcp/codex-review-server/.venv/bin/python3 \
~/.claude/mcp/codex-review-server/server.py步骤4:验证
开始a 新 Claude Code会话(MCP服务器在会话开始时加载)并询问:
What MCP tools are available from codex-review-server?克劳德应该列出 codex_review_and_fix, codex_review,以及 codex_fix.
配置
所有设置都是可选的。默认值开箱即用。
cd ~/.claude/mcp/codex-review-server
cp .env.example .env
# Edit .env as needed配置为 实时重新加载 每次工具调用。编辑 .env 会话中期和下一次调用使用新值,无需重新启动。
您还可以在中设置值 .claude/settings.json (环境变量覆盖 .env):
{
"env": {
"CODEX_REVIEW_MODEL": "gpt-5.3-codex",
"CODEX_REVIEW_REASONING": "xhigh"
}
}配置参考
| 变量 | 默认值 | 描述 |
|---|---|---|
CODEX_REVIEW_HOME | ~/.codex | Codex CLI主目录(config.toml+凭据) |
CODEX_REVIEW_MODEL | gpt-5.3-codex | OpenAI模型ID(必须以开头 gpt- 或 o) |
CODEX_REVIEW_REASONING | xhigh | 推理努力: none, low, medium, high, xhigh |
CODEX_REVIEW_TIMEOUT | 1500 | 超时时间(秒)(默认值为25分钟——支持回购的审查是彻底的) |
CODEX_REVIEW_FOCUS | all | 评审重点: bugs, security, performance, all |
推理努力水平
| 级别 | 使用时间 |
|---|---|
none | 快速语法检查 |
low | 简单、明显的问题 |
medium | 通用代码审查 |
high | 复杂的逻辑、安全 |
xhigh | 深入分析,发现细微的错误(默认) |
“成本”是ChatGPT速率限制消耗,而不是计费。所有使用均由您的订阅支付。
多个Codex账户
如果您维护多个ChatGPT订阅,请设置 CODEX_REVIEW_HOME 指向其他凭据目录:
# In .env
CODEX_REVIEW_HOME=/path/to/other/.codex每个目录都应该有自己的 config.toml 从跑步 CODEX_HOME=/path/to/other/.codex codex login.
用法
直接工具调用
在任何Claude Code会话中:
Use codex_review_and_fix to review and fix the changes on this branchClaude使用项目目录和基分支调用MCP工具。Codex作为一个完整的代理运行——读取文件,运行git命令,探索代码库。
使用pm vibecode操作流程
如果你使用 下午维贝科德行动 工作流:
/codex-review [ticket-id]--采用线性积分的独立跨模型评审/execute-ticket [ticket-id]--包括法典审查作为第5.5阶段(介于法典审查和安全审查之间)/epic-swarm [epic-id]--在每个并行工单的工作流程中包括食品法典委员会审查
没有此MCP服务器
pm vibecode操作工作流在没有此服务器的情况下完全正常工作。 /execute-ticket 跳过第5.5阶段并添加注释,以及 /codex-review 提供安装说明。
运作原理
Claude Code
│ (MCP tool call over stdio)
▼
server.py (FastMCP)
│
▼
codex exec --model gpt-5.3-codex -c reasoning.effort=xhigh --sandbox read-only
│ (runs IN the project directory with full file access)
│ (authenticates via CODEX_HOME/config.toml — ChatGPT subscription)
▼
Codex agent explores repo, reviews changes, applies fixes
│
▼
Output captured via -o flag, returned to Claude CodeCodex在您的实际存储库中运行,而不是针对diff blob。它可以读取任何文件、运行git命令、跟踪代码路径和探索依赖关系——与手动使用Codex UI完全相同。
服务器永远不会看到或存储您的ChatGPT凭据。身份验证完全由Codex CLI处理。
故障排除
“未找到Codex CLI”
which codex # check if installed
npm i -g @openai/codex # install“Codex CLI身份验证失败”
codex login # re-authenticate“已达到速率限制”
您已达到订阅的速率限制(Plus为30-150条消息/5小时,Pro为300-1500条消息)。工作流程在没有食品法典委员会审查的情况下继续进行。等待几分钟,然后重试,或运行 /codex-review 稍后独立。
要在会话中期切换到其他订阅,请编辑 .env:
CODEX_REVIEW_HOME=/path/to/other/.codex下一次工具调用将使用新凭据(实时重新加载)。
MCP服务器未出现在克劳德代码中
# Check registration
claude mcp list
# Re-register
claude mcp remove codex-review-server
claude mcp add --scope user codex-review-server -- \
~/.claude/mcp/codex-review-server/.venv/bin/python3 \
~/.claude/mcp/codex-review-server/server.py开始a 新 session——MCP服务器在会话开始时加载。
“找不到与mcp匹配的分发”
Python太旧或不使用虚拟环境:
~/.claude/mcp/codex-review-server/.venv/bin/python3 --version # needs 3.10+审核超时
具有Repo意识的评论 xhigh 对大差异进行推理可能需要10-20分钟。增加超时时间:
# In .env
CODEX_REVIEW_TIMEOUT=2400 # 40 minutes独立测试组件
# 1. Test Codex CLI
codex exec "Reply with just hello" --sandbox read-only --skip-git-repo-check --color never
# 2. Test server imports
~/.claude/mcp/codex-review-server/.venv/bin/python3 -c "
import sys; sys.path.insert(0, '$HOME/.claude/mcp/codex-review-server')
from server import server
print(f'Server: {server.name} — OK')
"卸载
claude mcp remove codex-review-server
rm -rf ~/.claude/mcp/codex-review-server