---
title: "用 Codex 做 GitHub 代码审查"
description: "Codex code review 可以为 GitHub pull requests 增加一轮 high-signal review。"
verifiedAt: "2026-05-05"
---

Codex code review 可以为 GitHub pull requests 增加一轮 high-signal review。

Codex 会 review pull request diff，遵循 repository guidance，并发布标准 GitHub code review，重点关注严重问题。

演示视频：

[https://www.youtube.com/watch?v=HwbSWVg5Ln4](https://www.youtube.com/watch?v=HwbSWVg5Ln4)

## Before You Start

开始前，确认你已经具备：

- 已为需要 review 的 repository 设置 [Codex cloud](https://developers.openai.com/codex/cloud)。
- 可以访问 [Codex code review settings](https://chatgpt.com/codex/settings/code-review)。
- 如果希望 Codex 遵循 repository-specific review guidance，请准备 `AGENTS.md` file。

## Set Up Codex Code Review

1. 设置 [Codex cloud](https://developers.openai.com/codex/cloud)。
2. 打开 [Codex settings](https://chatgpt.com/codex/settings/code-review)。
3. 为你的 repository 打开 **Code review**。

截图：

[https://developers.openai.com/images/codex/code-review/code-review-settings.png](https://developers.openai.com/images/codex/code-review/code-review-settings.png)

## Request a Codex Review

1. 在 pull request comment 中 mention `@codex review`。
2. 等 Codex 先 reaction（👀），再发布 review。

截图：

[https://developers.openai.com/images/codex/code-review/review-trigger.png](https://developers.openai.com/images/codex/code-review/review-trigger.png)

Codex 会像 teammate 一样在 pull request 上发布 review。

在 GitHub 中，Codex 只标记 P0 和 P1 issues，让 review comments 保持聚焦，集中在 high-priority risks 上。

示例截图：

[https://developers.openai.com/images/codex/code-review/review-example.png](https://developers.openai.com/images/codex/code-review/review-example.png)

## Enable Automatic Reviews

如果希望 Codex 自动 review 每一个 pull request，请在 [Codex settings](https://chatgpt.com/codex/settings/code-review) 中打开 **Automatic reviews**。

打开后，只要有人打开新的 PR for review，Codex 就会发布 review，不再需要 `@codex review` comment。

## Customize What Codex Reviews

Codex 会在 repository 中搜索 `AGENTS.md` files，并遵循其中的 **Review guidelines**。

要为 repository 设置 guidelines，请添加或更新 top-level `AGENTS.md`，加入类似 section：

```md

## 审查建议

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

Codex 会对每个 changed file 使用距离它最近的 `AGENTS.md` 中的 guidance。

如果某些 packages 需要额外审查，可以在 tree 更深处放更具体的 instructions。

如果只是单次 review 想临时聚焦某个方向，可以写在 pull request comment 中：

```md
@codex review for security regressions
```

如果你希望 Codex 标记 documentation 中的 typos，请在 `AGENTS.md` 里添加 guidance，例如：

```md
Treat typos in docs as P1.
```

## Act on Review Findings

Codex 发布 review 后，你可以在同一个 pull request 里再留一条 comment，让它修复问题：

```md
@codex fix the P1 issue
```

Codex 会以该 pull request 作为 context 启动 cloud task。如果它具备对应 permission，也可以把 fix push 回该 branch。

## Give Codex Other Tasks

如果你在 comment 中 mention `@codex`，但内容不是 `review`，Codex 会用该 pull request 作为 context 启动一个 [cloud task](https://developers.openai.com/codex/cloud)。

```md
@codex fix the CI failures
```

## Troubleshoot Code Review

如果 Codex 没有 reaction，也没有发布 review：

- 确认已在 [Codex settings](https://chatgpt.com/codex/settings/code-review) 中为该 repository 打开 **Code review**。
- 确认 pull request 所属 repository 已设置 [Codex cloud](https://developers.openai.com/codex/cloud)。
- 在 pull request comment 中使用精确 trigger：`@codex review`。
- 对 automatic reviews，检查是否已打开 **Automatic reviews**，以及 pull request event 是否匹配 review trigger settings。
