codex review
通过 CLI 对改动执行 Review。
codex review 通过命令行非交互式地执行代码审查,也就是说不会打开一个正在运行的 TUI 会话。
根据文档,你需要恰好选择一个审查目标:--uncommitted(已暂存、未暂存以及未跟踪的改动)、--base <branch>(与某个基准分支的差异)、--commit <SHA>(某个特定提交的改动),或者以自由文本形式给出自己的审查指令 PROMPT(也可用 - 从 stdin 读取)——根据文档,这些选项彼此互斥。--title 用于设置审查摘要中显示的提交标题,但只有配合 --commit 使用时才生效。此外还有 --strict-config,当 config.toml 中包含未知字段时会触发报错。需要与独立的 codex review 调用区分开的是斜杠命令 /review,根据 Codex 源码,它是在已经运行中的交互式会话内使用的,同样可以接受内联参数作为指令。
✅ 什么时候用?
提交前审查未提交的改动
codex review --uncommitted
审查带标题的特定提交
codex review --commit a1b2c3d --title "修复登录 Bug"
⛔ 什么时候不该用?
同时指定多个审查目标
根据文档,--uncommitted、--base、--commit 和自定义的 PROMPT 彼此互斥——只允许选择一个选项。
更好的选择: 只选择一个目标选项,例如仅使用 --base main
希望审查是正在进行的交互式会话的一部分
codex review 是一个独立的、非交互式的 CLI 调用,在运行中的 TUI 会话之外执行。
更好的选择: 在运行中的会话内改用 /review
来源
- Codex CLI 文档:Reference ↗ learn.chatgpt.com
更多命令 · Codex CLI