---
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。
