結論先說
codex review提供三種標準只讀範圍參數:--uncommitted、--base <分支>與--commit <SHA>。它們只審代碼不改源碼,分別對應「提交前自檢」「提 PR 前整分支對比」「單次提交審計」三個高頻節點。- 注意最容易踩的參數互斥坑:
--base等範圍參數不能直接和命令行[PROMPT]同時傳。在較新版 CLI 中混用會直接報cannot be used with '[PROMPT]',不要把兩者硬拼在同一條命令裏。 - 自定義審查重點有三條正確路徑,按複用頻率選一條即可。團隊長期規範寫進
AGENTS.md(配合--base/--uncommitted自動生效);單次專項檢查直接用codex review "在提示詞內寫明對比分支與重點";複雜管道過濾則交給git diff | codex exec --sandbox read-only。 - 先跑本地預審再提 PR,能大幅減少人工 Review 裏的低級返工。把空指針、邊界條件、SQL 拼接和漏清理的資源在本地消掉,讓團隊評審精力聚焦在架構設計與業務語義上。
- 每次提交與發版前高頻跑本地大分支代碼審查會消耗較多上下文額度。國內沒有外幣卡的用戶可在本站自助開通 ChatGPT Plus 或高配額的 ChatGPT Pro,團隊多人研發可了解 ChatGPT Business 團隊定製。

圖:本站根據 OpenAI Codex 官方文檔:Code review 整理的示意圖
本文根據 OpenAI Codex 官方文檔《Code review》《Command line options》《AGENTS.md》整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 希望在
git commit或提交 Pull Request 前,用一行本地命令先讓 Codex 替自己把高危缺陷攔下來的開發者; - 運行
codex review --base main "重點查並發問題"時遇到參數衝突報錯,不知道怎麼把範圍參數與自定審查重點結合起來的人; - 想把團隊統一的安全基線、接口兼容紅線沉澱成自動化預審流程的研發負責人。
一、--uncommitted、--base 與 --commit 三種原生範圍用法
相比自己手工拼複雜的 git diff 腳本,codex review 內置了面向代碼缺陷識別的專用評審流程(基礎入門介紹見 /guides/codex-code-review)。按開發階段選對參數即可一行開審:
| 命令寫法 | 審查覆蓋範圍 | 最佳觸發時機 |
|---|---|---|
codex review --uncommitted | 暫存區、未暫存改動與新增未追蹤文件 | 執行 git commit 前快速自查 |
codex review --base main | 當前特性分支相對目標主幹分支的完整差異 | 準備提 PR / MR 前做整分支體檢 |
codex review --commit <SHA> | 某一個指定歷史提交引入的改動 | 覆核線上緊急熱修或 Cherry-pick 提交 |
codex review "<審查指令>" | 按自定義提示詞中指定的目標與側重點審查 | 臨時專項排查(安全、性能或契約核對) |
日常高頻命令示範
bash
# 1. 提交前檢查本機所有未提交改動(含暫存、未暫存與新文件)
codex review --uncommitted
# 2. 提 PR 前對比當前分支相對 origin/main 或 main 的全部改動
codex review --base main
# 3. 單獨審查某一次線上熱修提交
codex review --commit a1b2c3d
二、繞開參數衝突:自定義審查重點的三種正確姿勢

圖:本站根據 OpenAI Codex 官方文檔:Command line options 整理的示意圖
不少教學會寫出 codex review --base main "重點查 SQL 注入",但在實際 CLI 參數解析裏,原生範圍開關(--base、--uncommitted、--commit)與位置提示詞 [PROMPT](含標準輸入 -)是互斥路徑,直接混傳會報參數衝突錯誤。想既控制範圍又定製關注點,按場景選下面三種標準做法即可:
方案 A:把團隊固定評審標準寫進 AGENTS.md(長期最省心)
codex review 在運行 --base、--uncommitted 或 --commit 時,會自動讀取倉庫中的 AGENTS.md(層級規則見 /guides/codex-agents-md-how-it-reads)。只要在倉庫根目錄的 AGENTS.md 裏新增一段審查細則,團隊成員每次只需敲極簡命令就能自動按統一口徑檢查:
markdown
## Code Review 重點規則
- 優先報告可能導致越權訪問、SQL 注入、資金重複扣減或並發競態的高危問題;
- 凡修改對外 HTTP 接口請求或響應字段,必須核查是否破壞舊版客戶端向後兼容;
- 忽略純代碼格式與個人命名偏好,每條結論必須給出精確文件路徑與復現條件。
儲存後直接運行 codex review --base main,模型便會嚴格套用這些紅線進行整分支預審。
方案 B:單次專項排查直接用獨立 [PROMPT] 或標準輸入
如果你不想改動倉庫的 AGENTS.md,只想臨時查一次特定風險,直接去掉 --base 等互斥開關,把對比範圍和審查重點一起寫進提示詞裏:
bash
# 直接通過獨立提示詞說明範圍與重點
codex review "請對比當前分支相對 main 分支的所有改動,僅聚焦檢查數據庫事務邊界、未捕獲異步異常與接口向後兼容性。"
# 或把本地專項核對清單文件通過標準輸入餵給 codex review
cat .github/security-review-checklist.md | codex review -
方案 C:需要高度定製輸出格式或過濾文件時改用管道 + codex exec
如果你只想審 src/payments/ 子目錄相對 main 的差異,或者希望把審查意見直接重定向儲存成 Markdown 報告文件,用 git diff 管道配 codex exec --sandbox read-only 最靈活(更多管道配方見 /guides/codex-cli-pipe-stdin-exec-recipes):
bash
git diff main...HEAD -- src/payments/ | codex exec --sandbox read-only \
"請僅從冪等性、並發鎖與錯誤重試三個維度審查以下支付模組改動,按高/中/低風險分級輸出。" > pay-review.md
訂閱與帳號準備提示:對包含數十個文件的大特性分支反覆執行--base整分支預審,加上修復後再二次複審,會顯著提升上下文配額消耗。若 Plus 檔在迭代發版周容易觸頂,可在本站升級 ChatGPT Pro 充值 或選用 ChatGPT Pro 5x iOS 可覆蓋檔;新註冊 OpenAI 帳號若卡在短訊驗證環節,可先查看 Codex 註冊手機驗證服務。
三、本站建議:提升本地預審信噪比的三個實操習慣
AI 審查最怕吐出一堆無關痛癢的風格建議,淹沒真正致命的邏輯缺陷。本站建議養成下面三個習慣(常用命令行搭配見 /guides/codex-cli-commands-cheatsheet):
- 大分支拆成「未提交小步審 + 合併前整分支審」兩段:每次寫完一個清晰子功能先跑一次
codex review --uncommitted及時清隱患,等全部提交整理完畢臨提 PR 前再跑一次codex review --base main查跨提交整體一致性。 - 明確排除噪音項:在
AGENTS.md或專項提示詞裏顯式寫明「跳過鎖文件、自動生成代碼與純格式調整,僅報告有明確觸發條件的缺陷」,能明顯降低誤報。 - 堅持人工核驗業務意圖:本地
codex review擅長捕捉漏判空值、越界、資源泄漏和常見安全漏洞,但無法替代你判斷需求本身是否合理;修完每條高風險意見後記得重跑對應單測再推送代碼。
常見問題
問:運行 codex review --base main 時提示找不到目標分支或差異不準怎麼辦?
答:先在本地執行 git fetch origin 同步遠端最新主幹,再改用 codex review --base origin/main 對比最新的遠端主幹提交,避免拿本地落後很久的舊 main 分支做參照。
問:運行 codex review 會不會趁機直接幫我修改本地源碼文件?
答:不會。codex review 是隻讀性質的審查子命令,只負責讀取倉庫與差異並輸出問題清單和修復建議,不會擅自改寫你的工作區源碼;確認某條建議合理後,再由你手工修改或開常規會話落盤修復。
問:國內沒有外幣信用卡,或者研發團隊需要開增值稅發票報銷,怎麼開通適合高頻跑本地代碼審查的 Codex 訂閱?
答:可通過本站 AI 會員充值總覽 辦理 ChatGPT Plus 卡密自助兌換 或高配額 ChatGPT Pro,多人研發團隊可直接選擇 ChatGPT Business 團隊定製。支持支付寶、微信支付及 AlipayHK 付款,無需提供帳號密碼,可開具增值稅發票;實時價格以商品頁為準,售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍的規則。
相關教學
- Codex 代碼審查(codex review)怎麼用
- Codex 怎麼讀取 AGENTS.md 與層級優先級
- Codex CLI 管道與標準輸入實戰:6 個實用命令配方
- Codex 命令行常用命令一頁看
參考資料
- OpenAI Codex 官方文檔:Code review — https://learn.chatgpt.com/docs/code-review
- OpenAI Codex 官方文檔:Command line options — https://learn.chatgpt.com/docs/developer-commands
- OpenAI Codex 官方文檔:AGENTS.md — https://learn.chatgpt.com/docs/agent-configuration/agents-md
0 條評論
還沒有評論,來搶沙發~