codex 提交前审查分三类：①未暂存修改用 codex review --unstaged，仅扫描未 add 的改动；②分支对比用 codex review --from a --to b 最稳妥，避免本地干扰；③已暂存内容用 codex review --staged，精准检查即将 commit 的快照。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在代码提交前就发现潜在问题，又不确定该用 Codex 审查未暂存的本地修改，还是对比两个 Git 分支——这两种场景触发条件不同、风险等级不同、输出结果也不同。
审查尚未 git add 的本地变更
这一步适用于你刚改完几行代码，还没运行 git add，想立刻知道有没有低级错误漏掉。
打开终端，进入项目根目录，直接执行：
codex review --unstaged
它会自动扫描所有未暂存（unstaged）的文件差异，跳过已 commit 或已 add 的内容。注意：如果当前工作区有大量未跟踪文件（比如新生成的日志、临时配置），Codex 默认不读它们，避免误审噪声。若你明确要包含，得加 --include-untracked 参数，但【加了之后可能触发误报，尤其当存在本地调试用的 mock 文件时】。
命令执行后，Codex 会在终端输出结构化报告，含问题类型（如空指针访问、硬编码密钥）、所在文件与行号、修复建议。不自动写回，只读分析。
对比两个分支做增量审查
当你准备提 MR，需要让 Codex 基于团队主干（如 main）评估你的功能分支改动是否安全可靠，就得走分支对比路径。
方法一：用 base 参数指定基准分支
codex review --base main --background
方法二：显式指定源和目标分支（更可控）
codex review --from feature/login-v2 --to main
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法三：结合 Git diff 管道调用（适合集成进 pre-commit）
git diff main...feature/login-v2 | codex exec "审查这段差异，指出所有可能引发运行时错误的点"
三种方式中，方法二最稳妥——它强制 Codex 只看两个分支间真实存在的差异，不会受本地未提交更改干扰。而方法一若当前分支 HEAD 和 main 有未 push 的本地 commit，Codex 仍会把那些 commit 算进去，容易扩大审查范围。
审查已暂存但未 commit 的变更
这个状态常被忽略：你已经 git add 了部分文件，但还没 git commit。此时 Codex 能精准定位“暂存区快照”里的问题。
第一步：确认暂存区内容
git status --cached
第二步：让 Codex 仅审查暂存区
codex review --staged
第三步：查看结果并决定是否继续 commit
codex result
这一步的关键在于，它比 --unstaged 更贴近最终提交内容，又比全量分支对比更轻量。如果你习惯分多次 add 再一次性 commit，--staged 就是你每次 add 后必跑的检查点。
注意：--staged 不会读取工作区未 add 的修改，哪怕它们和已暂存文件是同一份——这是设计使然，不是 bug。
