使用情境 · Codex

Codex 程式碼審查:/review、@codex review 和你的規則

Codex 在兩個地方審查程式碼。在 CLI、App 或 IDE 擴充功能裡,/review 會啟動專門的審查者,審查你簽出目錄裡的變更;codex review 則從腳本做同樣的事。在 GitHub 上,@codex review 審查一個 pull request,Automatic review 則不必開口就會審查。本頁說明每一種、Codex 從 AGENTS.md 讀取的審查規則,以及如何讓審查成為固定工作。

程式碼審查:Codex 能做什麼

  • 審查每個 pull request,找出 bug、缺少的測試和有風險的變更,並在 GitHub 上留下行內評論。
  • 遵循你寫下的審查規則,所以不會去評論 linter 已經檢查的東西。
  • 在交給人之前,先審查它自己和其他 agent 的變更。
  • 追蹤後續事項:需要修改的評論會變成 issue,不會不了了之。

程式碼審查:用得上的 Codex 功能

功能用途怎麼開始
/review審查相對於基準分支的變更,或尚未提交的變更,不會修改檔案在 CLI、App 或 IDE 擴充功能裡輸入 /review
codex review不開互動介面的同一種審查,給腳本和 CI 用codex review --base main
@codex review審查 GitHub pull request 並發出標準審查;標出 P0 和 P1 問題在 pull request 上留言,需要的話加上審查重點
Automatic review不必開口就審查 pull request在 Codex 設定裡逐一為儲存庫開啟

程式碼審查:如何設定 Codex

  1. 連接工具

    /review 只需要一個 Git 儲存庫。要在 GitHub 上審查,請把儲存庫連接到 Codex,並在 Codex 設定裡為它開啟程式碼審查。

    # 在 GitHub 的 pull request 評論裡
    @codex review
    @codex review for issues in the database migration
  2. 把規則寫進 AGENTS.md

    Codex 在開始任何工作前都會讀取 AGENTS.md:先讀 ~/.codex/AGENTS.md,再從儲存庫根目錄一路讀到它工作的資料夾。把這項工作的規則寫在那裡;規則很長的話,放進 .agents/skills/ 下的 skill。參見 AGENTS.md 指南。

    ## Code Review Rules
    - billing/ 和 auth/ 裡新增的分支如果沒有測試,要指出來。
    - 任何 SQL migration 都要有回滾;沒有的話要說出來。
    - 不評論格式問題,那交給 linter。
    - 只留評論:絕不核准、要求修改或合併。
  3. 不開互動介面也能執行

    codex exec 執行一個任務後就結束。進度輸出到 stderr,最終訊息輸出到 stdout;-o 會另外寫進檔案,--json 則以串流輸出事件。除非傳入 --sandbox workspace-write,否則沙箱是唯讀的。

    # 從腳本或 CI,把這個分支和 main 比較並審查
    codex review --base main
    
    # 或審查還沒提交的變更
    codex review --uncommitted
  4. 排入排程

    在 ChatGPT 桌面 App 或網頁版建立排程任務(CLI 無法管理排程任務),或從 cron 執行 codex exec。參見如何讓 Codex 主動工作。

來源:Codex 文件

限制與安全

  • 它負責評論,不負責這次變更。核准和合併留給人。
  • 審查會消耗你方案的用量。在有人要求或 pull request 準備好時再審查,而不是每次推送都審。
  • 它審查的是 diff 和儲存庫,無法用正式環境的資料測試。
  • Codex 預設會把指令放進沙箱:寫入只限於工作區,網路關閉。danger-full-access 只留給隔離的 runner 或容器使用。

程式碼審查,用 Claude Code 還是 Codex?

規則可以共用。在 AGENTS.md 寫一次,再把 @AGENTS.md 放進 CLAUDE.md,兩個 agent 就會讀同一份檔案。

另一個 agent 的逐步做法:Claude Code 程式碼審查。

Claude CodeCodex
規則檔CLAUDE.mdAGENTS.md
連接工具claude mcp addcodex mcp add 或 config.toml
你不在也能執行claude -pcodex exec
排程/schedule、桌面排程任務、/loopChatGPT App 的排程任務、cron
內建功能(程式碼審查)/code-review、/code-review ultra、@claude review/review、codex review、@codex review
使用 Crewmark

程式碼審查:讓它成為某個人的固定工作

指令只在有人記得時才會執行。Crewmark 把你自己的 Codex 變成 AI 員工,有職位、量化目標、工作時間和心跳,工作就會依排程完成,並出現在看板上。

  1. 從職位開始

    AI 軟體工程師:在職位說明裡寫上這些規則。

  2. 把工作放上它的看板

    把這項工作加成週期性 issue。員工依心跳醒來,做完後以評論回報。

  3. 相關內容

    每個 PR 都有 AI 程式碼審查比較了所有做法,資安審查則涵蓋漏洞。

常見問題

如何讓 Codex 審查 pull request?

在 pull request 上留言 @codex review,或在 Codex 設定裡開啟 Automatic review。儲存庫必須先啟用程式碼審查。

Codex 能在本機審查程式碼嗎?

可以。在 CLI、App 或 IDE 擴充功能裡輸入 /review,選擇基準分支或未提交的變更;也可以從腳本執行 codex review --base main。

怎麼把我們的審查規則交給 Codex?

在離受規範程式碼最近的 AGENTS.md 裡加一個 ## Code Review Rules 章節。寫明要標出什麼,格式問題交給 linter。

為什麼 Codex 只標出幾個問題?

在 GitHub 上,Codex 只標出 P0 和 P1 問題,讓評論保持聚焦。想讓它看特定的東西,就在 @codex review 後面加上審查重點。

已於 2026 年 11 月 13 日對照 Claude Code 文件和 OpenAI 的 Codex 文件查核。

程式碼審查,交給 Codex 上的 AI 員工。

Crewmark 把 Claude Code 和 Codex 工作階段變成有職位、目標、工作時間和心跳的 AI 員工。