背景
近期,我大量借助AI辅助编写代码,工作流程通常是这样的:先在Claude中配合OpenSpec完成一段代码,然后转到Codex中,通过指令“帮我Review本次改动”获取审查结果。接着,将审查意见发回Claude,让它依据Codex的建议进行一轮修改,修改后再提交一次Review。如此反复迭代多次后,我不禁思考——能否将这个流程自动化串联起来:在Claude内直接调用Codex执行代码审查,拿到结果后自动修改,修改完毕再次自动审查?反之亦然,让Codex也能主动调用Claude进行代码审查。将这个想法变为现实,便诞生了下面这款工具。
安装
只需一条简洁的命令即可完成安装,推荐使用全局安装方式:
npx claude-codex-code-review install若希望将其安装到特定项目下,也可指定目标目录:
npx claude-codex-code-review install -- --target-dir /path/to/project使用
1. 在Claude中调用Codex进行代码审查
在Claude中,直接使用 /codex-review 命令即可触发审查流程:
# 默认读取项目根目录下的 .codex-review.yml 配置,若无则使用默认值/codex-review
# 也可在命令中指定本次审查的模式及自动修复级别/codex-review --mode severity --auto-fix-severities P0,P12. 在Codex中调用Claude进行代码审查
在Codex中,可使用 /claude-review skill,或直接告知它“用 Claude 审查我的代码”。推荐采用skill方式进行调用,稳定性更高。
自定义配置
如需调整工具行为,可在项目根目录下创建 .codex-review.yml 文件:
mode: severityreview_scope: uncommittedmax_fix_rounds: 2auto_fix_severities: [P0]各配置项说明如下:
mode— 工作模式ask:每次审查结束后,都向您确认是否需要修复问题auto:审查发现的问题将自动修复,不打扰您的工作severity:默认模式,仅对auto_fix_severities中指定级别的问题进行自动修复,其余级别仍会征询您的意见
review_scope— 审查范围。当前仅支持uncommitted,即审查所有未提交的变更,包括已暂存(staged)、未暂存(unstaged)以及未追踪(untracked)的文件max_fix_rounds— 最大修复轮次。在auto或severity模式下,完成一轮修复后可再次运行审查以确认效果。该值控制“审查-修复”循环的最大次数,防止陷入无限循环auto_fix_severities— 自动修复的严重级别列表,仅在mode: severity模式下生效。例如[P0, P1]表示P0和P1级别的问题会自动修复,而P2和P3级别仍需您手动确认
原理
1. Claude调用Codex进行审查的原理
通过Claude的自定义命令功能触发一个Shell脚本,脚本内部调用 codex 命令来启动Codex执行代码审查。
2. Codex调用Claude进行审查的原理
原理类似,通过Skill触发Shell脚本,随后在Shell中调用 claude -p 命令让Claude完成代码审查。
使用前,您的计算机上需要安装以下工具:
- Git
- Claude Code CLI — Anthropic 的命令行工具
- Codex CLI — OpenAI 的命令行工具
