Claude Codex Review

克劳德食品法典评论

一个MCP（模型上下文协议）服务器，负责协调Claude和OpenAI Codex之间的迭代代码审查。这实现了双AI审查工作流程，Claude创建计划/实施，Codex提供关键的审查反馈。

特性

• 计划评审：克劳德制定了一个计划→ 食品法典审查→ 迭代直到批准
• 实施审查：克劳德实施→ 食品法典委员会根据计划进行审查→ 迭代直到批准
• 会话保持：使用Codex CLI的本地会话恢复实现真正的对话连续性
• 历史回顾：跟踪所有迭代，包括关注点、建议和响应
• 可配置的：自定义代码库约定、超时和迭代限制

先决条件

• Python 3.10+
• Codex CLI 已安装并验证
• Claude Code CLI（或任何兼容MCP的客户端）

Codex配置

确保您的 ~/.codex/config.toml 已配置模型：

model = "gpt-5.2-codex"
model_reasoning_effort = "high"

安装

来自PyPI（发布时）

pip install claude-codex-review

来源

git clone https://github.com/goharanwar/claude-codex-review.git
cd claude-codex-review
pip install -e .

使用uvx（建议用于MCP）

uvx claude-codex-review

配置

环境变量

Claude代码集成

添加到您的 ~/.claude.json:

{
  "mcpServers": {
    "claude-codex-review": {
      "command": "uvx",
      "args": ["claude-codex-review"],
      "env": {
        "CODEX_REVIEW_MAX_ITERATIONS": "5",
        "CODEX_REVIEW_TIMEOUT": "300",
        "CODEX_REVIEW_SAVE_PATH": "/path/to/save/plans",
        "CODEX_REVIEW_CODEBASE_CONTEXT": "- Python with PEP8\n- Use type hints\n- Prefer composition over inheritance"
      }
    }
  }
}

或者从本地来源运行：

{
  "mcpServers": {
    "claude-codex-review": {
      "command": "python",
      "args": ["-m", "claude_codex_review.server"],
      "cwd": "/path/to/claude-codex-review/src",
      "env": {
        "CODEX_REVIEW_MAX_ITERATIONS": "5"
      }
    }
  }
}

可用工具

start_plan_review

启动食品法典委员会计划审查会议。

参数：

• plan （必填）：需审查的计划内容
• user_request：用户的原始请求
• qa_context：规划过程中的问答
• context：附加项目背景
• focus_areas：重点审查的具体领域
• max_iterations：覆盖默认最大迭代次数

start_implementation_review

启动Codex实施代码审查会议。

参数：

• code （必填）：实施代码
• original_plan （必填）：正在实施的计划
• user_request：用户的原始请求
• qa_context：问答背景
• file_paths：正在审查的文件路径列表
• max_iterations：覆盖默认最大迭代次数

continue_review

继续进行现有的审查会议，并附上克劳德的回复。

参数：

• session_id （必填）：食典会议ID
• claude_response （必填）：克劳德对反馈的回应

get_review_status

获取审核会话的当前状态。

get_review_summary

获取整个评论对话的降价摘要。

save_plan

将最终确定的计划保存到配置的路径。

参数：

• plan_content （必填）：计划内容
• filename （必填）：文件名（不带扩展名）
• session_id：包括审查摘要（如有）

end_review_session

清理复习环节。

用法示例

User: "Create a plan for adding user authentication"

Claude: [Creates authentication plan]
Claude: [Calls start_plan_review with plan and context]

Codex Response:
- Status: CHANGES_REQUESTED
- Concerns: ["Missing password hashing details", "No session timeout specified"]

Claude: [Updates plan to address concerns]
Claude: [Calls continue_review with updates]

Codex Response:
- Status: APPROVED
- Summary: "All concerns addressed. Plan approved."

Claude: [Calls save_plan to persist the reviewed plan]

运作原理

1. 初步审查：用途 codex exec --output-schema 用于结构化JSON响应
2. 会话恢复：用途 codex exec resume 用于后续跟进（保留上下文）
3. 响应解析：支持JSON和 STATUS: 前缀格式
4. 历史跟踪：记录所有迭代以生成审核摘要

发展

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run server locally
python -m claude_codex_review.server

许可证

MIT许可证-请参阅 许可证 了解详情。