跳到主要內容
maxstudioNews
AI 自動化DEV Community (Codex)約 7 分鐘

我如何運用 Claude Code 與 Codex 進行程式碼撰寫與審核,並強制審核結論

本文作者分享他如何利用 Claude Code 撰寫程式碼,並由 Codex 進行嚴格的程式碼審核。這套系統要求審核結果必須明確指出「接受」或「需要修改」,確保程式碼品質與開發流程的嚴謹性。透過讓兩個 AI 引擎輪流扮演寫作者與審核者,並強制執行特定規則,有效提升了開發效率與程式碼可靠性。

我如何運用 Claude Code 與 Codex 進行程式碼撰寫與審核,並強制審核結論
圖片來源:DEV Community (Codex)

Codex 會在一個唯讀的沙盒環境中審核每個 Claude Code 的提交(commit),任何沒有以「Verdict: ACCEPT」或「Verdict: CHANGES REQUIRED」結尾的審核都會被視為失敗,程式崩潰亦同。我的自由閘道(free gate)中的合併檢查也會拒絕由撰寫程式碼的引擎所發出的「接受」判決。

寫作者會回應每個發現的問題,每次新的提交都會得到全新的審核,之後角色會互換,讓每個引擎都能在差異(diff)的兩端花費時間。這是我在自己的專案中使用的設定,CLI 旗標取自官方的 Claude Code 和 Codex 文件。我之所以同時使用 Claude Code 和 Codex 的原因,在之前的文章中已有說明。

1. 讓每個引擎負責一項工作

Claude Code 是預設的寫作者。寫作是上下文(context)累積的地方:計畫、涉及的檔案、執行的測試。審核所需的上下文要少得多,只需要差異和專案規則。由不同公司訓練的審核者也有不同的盲點,這就是為什麼我使用兩個引擎,而不是要求一個引擎自行檢查。

在它自己的 Git 工作樹中啟動寫作者,這樣它的編輯永遠不會觸及你進行審核的檢出(checkout):claude -w feature-auth。-w 旗標會在 <repo>/.claude/worktrees/<name> 啟動一個隔離的工作樹中的 Claude Code。審核總是針對提交運行,而不是針對零散的編輯,所以要告訴寫作者在完成每次更改後提交並停止。

2. 將 Codex 作為唯讀審核者運行

codex exec 是 Codex CLI 的非互動模式,其預設沙盒是唯讀的。我仍然傳遞沙盒旗標,這樣就沒有人需要記住預設值:codex exec -s read-only -c model_reasoning_effort = high \ --color never --output-last-message .ai/last-review.md \ - < review-prompt.md。

-s read-only 讓 Codex 可以讀取檔案並運行唯讀命令,例如 git diff,但不能寫入。-c 會在一次運行中覆寫任何配置鍵。這裡它將文件中的 model_reasoning_effort 鍵設為 high。Two Engines Kit 中的審核腳本預設為 xhigh,高一個級別。

--output-last-message 旗標只會將最終訊息保存到 .ai/last-review.md,審核結果會從該檔案中讀取。最後一行的 - 讓 Codex 從標準輸入讀取提示詞。如果 ~/.codex/config.toml 中的 MCP 伺服器可以更改沙盒外部的事物,請在其表格中將 enabled = false 設定為審核運行。

3. 強制要求審核結果行

我的審核提示詞要求 Codex 以以下兩行中的一行結尾:Verdict: ACCEPT 或 Verdict: CHANGES REQUIRED。它設定了另外四條規則:

每個發現的問題都帶有嚴重性(阻礙性、應修復或小問題)、檔案和行號,以及具體的失敗情境。阻礙性和應修復的問題需要具體、可重現的失敗。風格偏好保持在小問題級別。

Codex 會在這次單一的審核中列出所有發現的問題,這樣下一輪就不會出現舊問題。審核內容保持在 600 字以下。審核腳本只從保存的最終訊息中讀取審核結果,而不是從日誌中讀取。

它還會檢查 Codex 是否以代碼 0 退出,以及之後的檢出是否未更改。崩潰或缺少審核結果行都會被視為審核失敗。結果會保存在它所審核的提交雜湊(commit hash)下,這樣後續的提交就不能借用舊的「接受」判決。

4. 讓寫作者回應每個發現的問題

審核者除了其發現的問題之外,對於合併的內容沒有發言權。寫作者和運行循環的人決定。對於每個發現的問題,寫作者要麼在新提交中修復它,要麼提供證據反駁它:一個通過的測試、一個顯示該情況已處理的檔案和行號,或者一個其輸出與主張矛盾的命令。

不要讓它預設接受每個發現的問題。審核者可能會出錯,而修復一個不存在的問題本身就會增加風險。我遵循工具包工作流程中的三輪規則:第一輪列出所有問題。第二輪確認修復已落地。從第三輪開始,只有阻礙性和安全性問題才會阻止合併。小問題則會放入後續處理檔案中,稍後處理。我在「我如何指導 Codex 審核 Claude Code 提交」中寫了更多關於簡報和異議的內容。

5. 互換角色

在我的自由閘道 two-engines-gate 中,設定 BUILDER=codex 會互換角色,讓 Claude Code 進行審核,而 Codex 進行寫作。作為寫作者,Codex 需要一個允許在工作區內編輯的沙盒:codex exec --sandbox workspace-write \ - < task.md。

作為審核者,Claude Code 會在列印模式下運行,並帶有簡短的唯讀工具列表。閘道會進行此呼叫:claude -p "Do the review described on standard input." --restricted --strict-mcp-config \ --permission-mode dontAsk --tools "Read,Grep,Glob" --allowedTools "Read,Grep,Glob" \ --disallowedTools "Bash,Edit,MultiEdit,Write,NotebookEdit,WebFetch,WebSearch,Task,Agent"。

由於只有 Read、Grep 和 Glob 可用,Claude Code 無法運行命令(包括 Git),也無法編輯或寫入檔案。這就是為什麼閘道將提交和完整的差異放入提示詞本身。嚴格的 MCP 配置旗標在沒有 MCP 配置的情況下不會載入任何 MCP 伺服器,而 permission-mode dontAsk 會拒絕任何原本會要求批准的操作。我開頭提到的合併檢查會拒絕來自撰寫程式碼的引擎的「接受」判決。

6. 為兩個引擎保留一套規則手冊

Claude Code 讀取 CLAUDE.md,而 Codex 讀取 AGENTS.md。在兩者中放入相同的簡短部分:提交每次更改並停止。永不合併。審核時保持唯讀。不要動審核記錄資料夾。

Codex 限制了它載入 AGENTS.md 的位元組數(project_doc_max_bytes 設定),所以請保持該部分簡短,並將長篇參考資料放在其他地方。

循環無法取代的部分

你的測試必須在獲得「接受」判決的確切提交上運行。我的自由閘道在允許合併之前,會檢查該提交的測試是否通過以及是否獲得「接受」判決。一個高推理能力的審核者會發現很多問題,但它只會讀取你給它的差異。

在你的儲存庫上運行它

如果你想讓它運行而無需自己進行連接,我會設定 Codex 在你的 Claude Code 提交合併之前進行審核。Codex 審核設定是為每個儲存庫、其堆疊和其慣例從頭編寫的,然後第一次審核會在你的真實分支之一上運行。沒有任何東西是從模板或 Two Engines Kit 複製的。

要從我使用的檔案開始並自行連接,請獲取 Two Engines Kit。它包含了本文中的審核腳本、閘道、合併檢查、審核提示詞和工作流程規則,適用於 WSL2、Linux 和 macOS。這是我在自己的專案中運行的設定,建立在自第一個 Codex 和 Claude CLI 以來收集的資訊之上。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Codex) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。