註冊
Codex

Codex 代碼審查怎麼用：GitHub PR 裏 @codex review、自動審查與本地 /review 命令

Codex 代碼審查怎麼用？按官方文檔講清 GitHub PR 裏 @codex review 和自動審查怎麼開、桌面 App 的 Code Review、本地 /review 與 codex review 命令、用 AGENTS.md 寫審查規則，以及額度怎麼算。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-10-07 · 依據官方文檔與公開資料整理 Plus 帳號
本文根據 OpenAI 官方 Codex 文檔（learn.chatgpt.com）的《Review GitHub pull requests with Codex》《Code review》、幫助中心《Review pull requests with Codex》和命令參考整理，資料核對於 2026-10-07。

適用於誰

  • 團隊用 GitHub，想讓 Codex 在每個 PR 上先過一遍的人；
  • 想在提交前讓 Codex 審一下本地改動的個人開發者；
  • 搜「codex review 命令」「codex 代碼審查怎麼用」的人。

結論先說

  1. 三種用法：
  • GitHub 上的雲端審查：在 PR 評論裏寫 @codex review，或者在 Codex 設定裏打開自動審查，Codex 會像同事一樣在 PR 上發一條標準的 GitHub 代碼審查；
  • 桌面 App / 網頁的 Code Review 插件：集中查看 PR 的描述、改動、評論和 CI 檢查，在對話裏追問 Codex；
  • 本地審查：在 CLI、IDE 插件或桌面 App 裏輸入 /review，或在終端運行 codex review，審查未提交的改動、和基準分支的差異或某個提交。
  1. GitHub 上只報重要問題：官方說明 Codex 在 GitHub 裏只標 P0 和 P1 級別的問題，讓評論聚焦高優先級風險。
  2. 用 AGENTS.md 定製規則：在 AGENTS.md 裏加 ## Code Review Rules 一節，Codex 會按離改動最近的規則審查。
  3. 套餐：GitHub 代碼審查和自動 PR 審查 Plus 起提供；本地 /review 在官方功能表裏 Plus、Pro、Business、Enterprise 和 API Key 都標為可用（Free / Go 未單獨說明）。用 API Key 登入的沒有 GitHub 審查這類雲端功能。
  4. 它只是第二雙眼睛：官方明確說審查規則不能替代測試、分支保護和必需的人工審批。

一、在 GitHub PR 上讓 Codex 審查

開通

需要：一個已連接到 Codex 的 GitHub 倉庫，以及對該倉庫設定有 push 或 admin 權限。

  1. 把 GitHub 倉庫連接到 Codex（目前 GitHub 代碼審查仍走 Codex Cloud (Legacy) 的集成，設定入口在 Codex 設定裏）；
  2. 打開官方文檔給出的 Codex 代碼審查設定頁 https://app.chatgpt.com/settings/code-review ；
  3. 選擇倉庫，在 Review code 下打開 Automatic review。

手動請求一次審查

在 PR 的評論裏寫：

@codex review

Codex 會先回一個 👀 表情，然後發出審查。只想關注某一塊，可以直接寫在後面：

@codex review for issues in the database migration

打開自動審查

在設定頁的 Personal preferences（個人偏好）裏打開 Automatic review，用 Review trigger 選擇什麼時候觸發。之後啟用了代碼審查的倉庫裏，你的 PR 不用再評論 @codex review 也會自動審查。

讓 Codex 直接修

審查出問題後，可以在同一個 PR 裏繼續評論：

@codex fix the P1 issue

Codex 會以這個 PR 為上下文開一個（舊版）雲端任務，有權限時把修復推回分支。@codex 後面寫 review 以外的內容（例如 @codex fix the CI failures），也會開一個雲端任務。

安全審查（Security Review）

另有一個研究預覽中的 Security Review，比普通審查更深入地看安全問題；在設定的 Review security vulnerabilities 下打開 Auto security review，或在 PR 評論 @codex security review 手動觸發。可用範圍以官方說明為準。

二、用 AGENTS.md 寫審查規則

Codex 會在倉庫裏找 AGENTS.md，按其中的 ## Code Review Rules 一節審查。規則放在離代碼最近的那個文件裏：全倉庫通用的放根目錄，某個服務專用的放該服務目錄下（例如 services/payment/AGENTS.md），Codex 會把根目錄和更具體的規則疊加使用。

一個示例（自己寫的，按官方給的格式）：

md
## Code Review Rules

### 金額計算

- 金額一律用整數「分」存儲和計算，不要出現浮點數運算。
  正確做法：入口處把元轉成分，展示時再格式化。

### 數據庫遷移

- 遷移腳本不得直接刪除列；需要先標記棄用，至少保留一個發佈週期。

官方給的寫規則建議：

  • 先寫兩三條審查時經常要解釋的規則；
  • 寫清楚要攔什麼、為什麼，以及安全的做法或例外，幫 Codex 區分真問題和預期行為；
  • 寫結果而不是函數名，規則放在它管的代碼附近；
  • 格式、lint 這類機械檢查留給 CI，不要寫進審查規則；
  • 拿一個典型 PR 跑 @codex review，看結果再增刪規則，刪掉產生噪音的。

AGENTS.md 的其他寫法見 CLAUDE.md / AGENTS.md 教學。

三、在桌面 App 或網頁裏審 PR（Code Review 插件）

  1. 從側邊欄打開 Code Review，按提示連接你的代碼託管帳號（用能訪問該倉庫的帳號）；
  2. 從列表選 PR，或在搜尋框粘貼 PR 連結；桌面 App 還有個人收件箱，可按 Assigned to me、Assigned to my team、Authored by me 篩選；
  3. Summary 裏看描述、動態、評論和檢查結果，Changes 裏看改動的文件和行內評論；
  4. 在這個 PR 的對話裏追問，比如「說明這個改動對登入流程有什麼影響」「把支撐這條結論的代碼和測試給我看」；
  5. 桌面 App 裏點 Review with Codex 會在新對話裏發起一次審查，旁邊的齒輪 Review instructions 可以設定跨倉庫通用的審查要求（也可在 Settings → Code Review 修改）。

要注意：在對話裏審 PR 不會自動發評論、批准或合併；在 Summary 或 Changes 裏發的評論會立即發到 GitHub，不等你點 Submit review。正式提交審查時，用 Submit review 選 Comment、Approve 或 Request changes。

GitLab 的合併請求在 Code Review 裏是預覽功能，但 GitLab 的雲端自動審查在這個預覽裏不提供。

四、本地審查：/review 和 codex review

交互式：在 CLI、IDE 插件或桌面 App 的 Codex 輸入框裏輸入 /review，選擇範圍：

  • Review against a base branch：和基準分支比較，審查整個分支的改動；
  • Review uncommitted changes：審查暫存、未暫存和未跟蹤的文件；
  • Review a commit（CLI）：審查某個提交；
  • Custom review instructions（CLI）：按你給的標準審查。

Codex 會啟動一個專門的審查者，讀取選定的 diff，給出按優先級排序的問題，不會改動你的工作區。項目需要在 Git 倉庫裏（IDE 插件裏不是 Git 倉庫時不顯示 /review，桌面 App 會提示你先創建倉庫）。桌面 App 裏審查結果顯示為審查面板裏的行內評論，可以在 Settings → General → Code review 裏改成 Detached（另開一個對話審查）。

非交互式（適合腳本）：

bash
codex review --uncommitted          # 審查未提交的改動
codex review --base main            # 審查當前分支相對 main 的差異
codex review --commit <SHA>         # 審查某個提交
codex review "重點檢查 SQL 注入和權限校驗"   # 自定義審查要求

想讓審查用和當前會話不同的模型，可以在 config.toml 裏設 review_model。讓 Codex 按審查結果改代碼時，照常受沙箱和審批設定約束（見 Codex 權限與沙箱設定）。

額度怎麼算

官方定價頁的說法：只有通過 GitHub 跑的審查（PR 裏 @codex review 或倉庫開了自動審查）算 Code Review 用量；在本地或 GitHub 以外跑的審查計入你的普通 Codex 額度。普通額度的規則見 Codex 額度與使用限制。想先開通 Plus 用上 GitHub 審查，可以看 /chongzhi/chatgpt-plus。

常見問題

Q：評論了 @codex review，Codex 沒反應？

按官方排查清單：確認在 Codex 設定裏為這個倉庫打開了代碼審查；確認 PR 所在倉庫已連接到 Codex；評論內容必須是準確的 @codex review；自動審查的話，檢查倉庫設定和 Personal preferences 裏的 Automatic review，以及 PR 事件是否符合 Review trigger 的設定。

Q：Codex 的審查能代替人工審查嗎？

不能。它在 GitHub 上只報高優先級問題，結論也可能錯；每條發現都要對照 diff、預期行為和測試核實。

Q：新版 Codex Cloud 環境會接管原來的雲端審查嗎？

不會。幫助中心寫明這次更新不會把現有云端代碼審查遷到新的雲端環境，Code Review 繼續使用 Codex Cloud (Legacy)。

Q：沒有 GitHub，只想審本地代碼可以嗎？

可以，用 /review 或 codex review，不需要連接任何倉庫，只要項目在 Git 倉庫裏。

參考資料

  • 官方文檔：Review GitHub pull requests with Codex — https://learn.chatgpt.com/docs/third-party/github
  • 官方文檔：Code review — https://learn.chatgpt.com/docs/code-review
  • OpenAI 幫助中心：Review pull requests with Codex — https://help.openai.com/en/articles/20001552-review-pull-requests-with-codex
  • 官方文檔：命令行參考（codex review）— https://learn.chatgpt.com/docs/developer-commands
  • 官方文檔：Codex Cloud (Legacy) — https://learn.chatgpt.com/docs/environments/cloud-environment
  • Codex 官方定價頁（Code Review 用量）— https://learn.chatgpt.com/docs/pricing
  • OpenAI 幫助中心：ChatGPT Work and Codex — https://help.openai.com/en/articles/20001275-chatgpt-work-and-codex
需要開通或續費？ChatGPT Plus 充值 →

Nathaniel 的更多內容

  1. 01

    AI 學習路線：零基礎從哪開始，6 個階段、每階段該讀哪幾篇教學（2026）

    AI 學習路線怎麼走？給零基礎的人一條循序漸進的路徑：先選一個助手用順，再學提問，再用進日常工作，按需學做圖做影片，守住私隱與版權，最後進階自動化和編程。每個階段都配了本站對應的教學。

    其他 AI 工具0
  2. 02

    AI 瀏覽器有哪些：Perplexity Comet、Opera Neon、Dia、Brave Leo 與 Edge Copilot 的官方說法對照

    AI 瀏覽器有哪些？按官方頁面整理 Perplexity Comet、Opera Neon、Dia、Brave Leo 和 Edge 裏的 Copilot：官方自述的定位、支持的平台、免費還是訂閱，以及 Gemini、Claude 的 Chrome 方案和已停用的 ChatGPT Atlas。

    其他 AI 工具0
  3. 03

    即夢國際版 Dreamina 是什麼：官方站入口、能生成什麼、免費積分和模型（2026）

    即夢國際版 Dreamina 是什麼？官方站是 dreamina.capcut.com，是一個圖片、影片和數字人一體的 AI 創作平台。按官方首頁和 FAQ 講：能生成什麼、免費用戶每天 120 積分、列出的 Seedance 與 Seedream 模型，以及和國內即夢怎麼區分。

    其他 AI 工具0
  4. 04

    Kimi K3 Coding Plan 是什麼、怎麼用：Kimi Code 會員、模型 ID、套餐價格和額度規則

    Kimi K3 Coding Plan 是什麼？按 Kimi 官方文檔核對：官方現在叫 Kimi Code，是 Kimi 會員權益裏的編程服務，Plus 及以上才有；講 K3 等模型 ID、國內新套餐價格、三種客戶端、第三方工具接入和額度規則。

    Kimi0
  5. 05

    DeepSeek V4 Pro 和 Flash 的區別與 API 價格：官方價格頁逐項對照（高峰與空閒時段）

    DeepSeek V4 Pro 和 Flash 有什麼區別、API 怎麼收費？按 DeepSeek 官方價格頁（2026-10-19 查詢）列出兩個模型的版本、上下文、圖像理解、並發和每百萬 token 價格，說明高峰與空閒時段的計費差別和舊模型名怎麼處理。

    其他 AI 工具0
  6. 06

    GPT-6 Pro（Astra）怎麼用、哪些套餐有：怎麼選到 Pro 檔、用量限制和 Pro 三檔價格

    GPT-6 Pro（Astra）怎麼用、哪些套餐有？按 OpenAI 幫助中心核對：聊天裏 Pro 檔給 Pro 100、Pro 200、Business 和 Enterprise；Plus 在 Work 和 Codex 裏含 Astra。講怎麼選到、用量上限和官方 Pro 價格。

    ChatGPT0

同產品的其他教學

  1. 01

    Codex CLI 怎麼安裝、怎麼更新：官方 4 種安裝命令（腳本、npm、Homebrew）、查看版本和 codex update

    Codex CLI 怎麼裝、怎麼更新？官方有 macOS/Linux 與 Windows 的安裝腳本、npm、Homebrew 四種方式，更新多是重跑同一條命令。本文原樣列出官方命令，講查版本、codex update 和首次登入。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 寫代碼怎麼用：代碼塊的複製、編輯、預覽、運行 Python，報錯了怎麼辦

    用 ChatGPT 寫代碼：代碼放進代碼塊，可複製、編輯；HTML、React、SVG、Mermaid 點 Preview 預覽，支持的 Python 點 Run 運行。講各按鈕用法、沒有按鈕怎麼辦、何時換 Codex。

    ChatGPTCodex0
  3. 03

    ChatGPT 更新日誌在哪看、怎麼知道現在最新的模型和功能：官方發佈說明怎麼讀

    ChatGPT 更新了什麼、最新模型是哪個？官方答案在幫助中心的發佈說明裏：ChatGPT release notes、Model Release Notes、Business 和 Enterprise 的更新日誌、桌面 App 和 Codex 的更新記錄。本文講各份日誌看什麼、怎麼讀、怎麼確認自己帳號有沒有。

    ChatGPTCodex0
  4. 04

    Codex 無法登入、無法發送消息、無法連接怎麼辦：ChatGPT 帳號還是 API 密鑰登入，官方排查步驟

    Codex 登入不了或發不出消息？按官方文檔：它支持 ChatGPT 帳號和 API 密鑰兩種登入，雲端只能用 ChatGPT；電郵密碼帳號要先開 MFA；退出登入、被管理員限制、網絡不放行 WebSocket 都會導致連不上。本文按順序對照排查，並附 CLI 的安裝和更新命令。

    ChatGPTCodex0
  5. 05

    Codex 怎麼刪除對話、清理任務：桌面 App 先歸檔再刪除，CLI 用 /archive 和 /delete

    Codex 的對話沒有「直接刪除」，要先歸檔再刪除。按 OpenAI 幫助中心和 Codex 文檔：桌面 App 在 Settings → Archived chats 裏點垃圾桶，CLI 用 /archive、/delete。本文講步驟、刪除後多久清除、能不能恢復，以及找不到舊對話時怎麼查。

    ChatGPTCodex0
  6. 06

    ChatGPT 桌面版打不開、更新後打不開、更新失敗怎麼辦：官方給出的更新、重置和網絡排查步驟

    ChatGPT 桌面版打不開、空白轉圈、更新後出問題？官方沒有「打不開」專門文章，但幫助中心有這些依據：Menu → Check for Updates 要反覆檢查並完全重啟、Windows 可以重置、Mac 的 SSL 報錯先升級再查網絡、系統要求。本文按順序整理。

    ChatGPTCodex0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～