claude-codex-code-review

Claude Code 和 Codex CLI 之间的交叉代码审查工具。

• 在 Claude Code 中：用 /codex-review 调用 Codex CLI 审查代码，再由 Claude 修复问题。
• 在 Codex CLI 中：用 claude-review skill 调用 Claude 审查代码，再由 Codex 修复问题。

典型流程（Claude Code → Codex 审查）：

1. 你在 Claude Code 里让 Claude 写代码。
2. 写完后手动运行 /codex-review。
3. Codex CLI review 当前项目的未提交改动。
4. review 结果保存到 .ai-review/codex-review.md。
5. Claude 读取结果，列出问题，并询问你要修复哪些。
6. 你确认后，Claude 只修复选中的问题。

典型流程（Codex CLI → Claude 审查）：

1. 你在 Codex CLI 里让 Codex 写代码。
2. 写完后触发 claude-review skill。
3. Claude 审查当前项目的未提交改动。
4. review 结果保存到 .ai-review/claude-review.md。
5. Codex 读取结果，列出问题，并询问你要修复哪些。
6. 你确认后，Codex 只修复选中的问题。

安装

全局安装（默认）

安装后所有项目都可以直接使用 /codex-review，无需逐个项目安装。

使用 npx：

npx claude-codex-code-review install

使用 curl：

curl -fsSL https://raw.githubusercontent.com/lkkwxy/claude-codex-claude-codex-review-claude/main/scripts/install.sh | bash

全局安装会：

• 将 /codex-review 斜杠命令安装到 ~/.claude/commands/（Claude Code 使用）
• 将 claude-review skill 安装到 ~/.codex/skills/claude-review/（Codex CLI 使用）
• 将 .ai-review/ 加入全局 gitignore，确保中间文件不会被任何项目提交

如果某个项目需要自定义配置，在该项目根目录创建 .codex-review.yml 即可。

项目级安装

如果只想在单个项目中使用，可以在项目根目录执行：

使用 curl

在目标项目根目录执行：

curl -fsSL https://raw.githubusercontent.com/lkkwxy/claude-codex-claude-codex-review-claude/main/scripts/install.sh | bash -s -- --local

注意：curl | bash 必须使用 raw.githubusercontent.com 地址，不能使用 GitHub 页面里的 blob/main 地址。

使用 npx

在目标项目根目录执行：

npx claude-codex-code-review install -- --local

也可以指定安装目录：

npx claude-codex-code-review install -- --target-dir /path/to/project

使用

在 Claude Code 中（用 Codex 审查）

安装后，在任意项目里打开 Claude Code，运行：

/codex-review

也可以临时传入策略参数：

/codex-review --mode severity --auto-fix-severities P0,P1

在 Codex CLI 中（用 Claude 审查）

安装后，在任意项目里打开 Codex CLI，Codex 会自动发现 claude-review skill。你可以：

• 直接告诉 Codex「用 Claude 审查我的代码」
• 通过 /skills 菜单选择 claude-review

安装内容

全局安装会写入这些文件：

~/.claude/commands/codex-review.md
~/.claude/scripts/codex-review.sh
~/.codex/skills/claude-review/SKILL.md
~/.codex/skills/claude-review/claude-review.sh

项目级安装会写入这些文件：

.claude/commands/codex-review.md
scripts/codex-review.sh
.codex-review.yml
.gitignore

运行审查后，会生成：

.ai-review/codex-review.md    (Codex 审查结果)
.ai-review/claude-review.md   (Claude 审查结果)
.ai-review/*.log
.ai-review/effective-config.env

.ai-review/ 会被加入 .gitignore。

配置

默认配置文件是 .codex-review.yml：

mode: severity
review_scope: uncommitted
max_fix_rounds: 2
auto_fix_severities: [P0]

配置优先级：

1. /codex-review 命令参数
2. .codex-review.yml
3. 内置默认值

如果没有 .codex-review.yml，也没有传任何参数，会使用以下默认值：

mode: severity
review_scope: uncommitted
max_fix_rounds: 2
auto_fix_severities: [P0]

参数说明

--mode ask|auto|severity
--review-scope uncommitted
--max-fix-rounds 1
--auto-fix-severities P0,P1

mode 含义：

• ask：默认模式。每次 review 后都询问你是否修复、修复哪些。
• auto：自动修复 Codex 明确指出的 actionable findings。
• severity：只自动修复 auto_fix_severities 中指定级别的问题，其他问题继续询问。

当前 review_scope 只支持 uncommitted，也就是 review staged、unstaged 和 untracked changes。

依赖

使用前需要本机已经安装并登录：

• Git
• Claude Code
• Codex CLI

可以用下面的命令检查 Codex CLI：

codex --help

设计原则

• 审查阶段只审查，不修改代码（无论 Codex 审查还是 Claude 审查）。
• 修复阶段只处理审查方明确指出的问题。
• 默认不自动修复，先由用户判断。
• 不自动 commit，最终提交仍由开发者确认。
• 最多执行配置允许的修复轮次，避免自动循环。

发布到 npm

包名：

claude-codex-code-review

发布前检查：

npm test
npm pack --dry-run

发布：

npm publish

如果 npm 要求 2FA 或 token，请按 npm 当前账号策略配置 security key 或 granular access token。