古法编程

OpenAI Codex 可以在 GitHub Pull Request 上做 code review，适合想把严重问题先筛出来的团队。先为仓库配置 Codex cloud，再到 Codex settings 打开 Code review；需要自动审查时再启用 Automatic reviews，手动审查则在 PR 评论里输入 @codex review。

OpenAI Codex GitHub 代码审查设置

OpenAI Codex 可以在 GitHub Pull Request 上进行 code review，重点只标出高优先级问题，帮助你快速发现严重风险。你可以手动触发审查，也可以开启自动审查；如果仓库里有 AGENTS.md，Codex 会按其中的 Review guidelines 执行。

开始前需要准备什么

开始使用前，请确认以下条件已经满足：

怎么配置 OpenAI Codex code review

  1. 先为仓库设置 Codex cloud。
  2. 打开 Codex settings。
  3. 为对应仓库开启 Code review。
Codex settings showing the Code review toggle

怎么手动请求 Codex 代码审查

  1. 在 Pull Request 评论里输入 @codex review。
  2. 等待 Codex 产生反应（👀）并发布 review。
A pull request comment with @codex review

Codex 会像团队成员一样直接在 Pull Request 上留下 review。在 GitHub 中，Codex 只标记 P0 和 P1 问题，所以评论会集中在最关键的风险上。

Example Codex code review on a pull request

怎么开启自动审查

如果你希望每个 Pull Request 都自动经过 Codex 审查，可以在 Codex settings 中开启 Automatic reviews。开启后，只要有人打开新的 PR 进入 review 流程，Codex 就会自动发布审查，不需要再写 @codex review。

怎么自定义 Codex 审查内容

Codex 会在仓库中查找 AGENTS.md，并遵循其中的 Review guidelines。

如果要给整个仓库设置规则，可以在顶层 AGENTS.md 里添加或更新类似内容：

## Review guidelines

- Don't log PII.
- Verify that authentication middleware wraps every route.

Codex 会把离变更文件最近的 AGENTS.md 作为优先参考。对于某些包或目录需要更严格的检查时，可以把更具体的说明放到更深层的目录里。

如果只是想临时强调某个审查重点，可以直接写进 PR 评论：

@codex review for security regressions

如果你希望 Codex 也检查文档里的拼写错误，可以在 AGENTS.md 中加入相关说明，例如把文档拼写错误视为 P1。

审查结果出来后怎么处理

Codex 发布 review 后，你还可以在同一个 Pull Request 里继续评论，让它修复问题：

@codex fix the P1 issue

Codex 会把这个 Pull Request 作为上下文启动一个 cloud task；如果它有权限，还可以把修复直接推回分支。

还能让 Codex 做什么任务

只要在评论里写 @codex，并且内容不是 review，Codex 就会基于这个 Pull Request 启动一个 cloud task。

@codex fix the CI failures

OpenAI Codex code review 不生效怎么解决

如果 Codex 没有反应，或者没有发布 review，可以按下面顺序检查：

  • 确认你已经在 Codex settings 为仓库开启 Code review。
  • 确认这个 Pull Request 所属的仓库已经设置好 Codex cloud。
  • 确认你在 Pull Request 评论里使用的是精确触发词 @codex review。
  • 如果使用自动审查，检查是否已经开启 Automatic reviews，并确认该 Pull Request 事件符合审查触发条件。

常见问题

OpenAI Codex 怎么在 GitHub 上触发代码审查

在 Pull Request 评论里输入 @codex review，Codex 会在该 PR 上发起 review。前提是仓库已经完成 Codex cloud 设置，并且在 Codex settings 里打开了 Code review。

为什么 Codex 只提示 P0 和 P1 问题

在 GitHub 里，Codex 只标记 P0 和 P1 级别的问题，这样 review 评论会聚焦在最高优先级风险上，不会把讨论淹没在低优先级噪音里。

OpenAI Codex 自动审查不生效怎么排查

先确认仓库已开启 Code review，再确认 Automatic reviews 已打开。然后检查 PR 是否来自已经设置好 Codex cloud 的仓库，以及该 PR 事件是否符合自动审查触发条件。