使用说明
Codex审查MCP服务器
MCP服务器,提供对GPT-5 Codex的访问,以便在自主的克劳德代码会话期间进行方法论审查。
特性
- 工具:
mcp__codex__codex_review-请求食典委方法审查 - 可配置的推理努力(低/中/高)
- 可选输出文件保存
- 处理API密钥管理
- 完整错误报告
安装
npm install
npm run build
配置
添加到 ~/.config/claude-code/mcp.json:
{
"mcpServers": {
"codex": {
"command": "node",
"args": ["/Users/YOUR_USERNAME/mcp-servers/build/index.js"],
"env": {
"OPENAI_API_KEY": "sk-proj-..."
}
}
}
}
替代的:从现有的加载API密钥 .env:
{
"mcpServers": {
"codex": {
"command": "bash",
"args": [
"-c",
"source ~/.env && node /Users/YOUR_USERNAME/mcp-servers/build/index.js"
]
}
}
}
Claude代码中的用法
配置后,Claude Code将可以访问 mcp__codex__codex_review 工具
(该名称结合了来自的服务器密钥 mcp.json — codex --使用工具名称 codex_review):
// Claude Code can call this automatically
mcp__codex__codex_review({
prompt: `# CODEX REVIEW REQUEST: Stage 1 SFT Training Gate
## Context
Reviewing Stage 1 SFT training plan...
## Request
GO / NO-GO for starting SFT training?`,
reasoning_effort: "high",
output_file: "reviews/autonomous/20251015_sft_gate.txt"
})
刀具参数
prompt(必填):审查请求文本reasoning_effort(可选):“低”|“中”|“高”(默认值:“高”)output_file(可选):保存响应的路径model(可选):Codex型号名称(默认:“gpt-5-Codex”)
需求
- Node.js 18+
codexCLI已安装并位于PATH中- 具有Codex访问权限的OpenAI API密钥
人工智能审查员作为强制预推门
食典委审查可以作为强制性的预推门来执行。所包含的钩子对您的分支diff运行Codex审查,解析 APPROVED:/BLOCKED: 裁决,失败关闭(除非审查批准,否则推送被拒绝)。
安装挂钩
cp hooks/pre-push .git/hooks/pre-push
chmod +x .git/hooks/pre-push
运作原理
- 上
git push,钩子计算您的分支与其跟踪分支之间的差异。 - 它将差异传递给
codex exec附有审查说明。 - 扫描响应以查找
APPROVED:或BLOCKED:在一条线的起点。- 批准 --推动前进。
- 已屏蔽 --推送被拒绝;请修复问题并重试。如果两个标记 出现,封锁获胜。
- 无判决 --被视为阻塞(出于安全考虑而关闭)。
- 评论已存档至
reviews/pre-push/如果目录存在。
要绕过(不建议): git push --no-verify.
发展
# Watch mode for development
npm run watch
# Build for production
npm run build
# Run the server tests
npm test
# Test the pre-push hook's verdict parsing (fail-closed contract)
hooks/pre-push.test.sh
许可证
麻省理工学院