跳到主要內容
maxstudioNews
產品DEV Community (Claude Code)約 10 分鐘

Claude Code Review 不會阻擋合併:四種整合方式比較(GitHub App、Action、指令與本地閘道)

Anthropic 的 Claude Code Review 提供多種整合方式,包括 GitHub App、GitHub Action、`/code-review` 指令以及本地閘道。預設情況下,託管式程式碼審查不會自動阻擋程式碼合併,而是將決策權留給團隊。本文詳細比較了這些方法的啟動方式、執行環境、適用對象和程式碼修改能力。

Claude Code Review 不會阻擋合併:四種整合方式比較(GitHub App、Action、指令與本地閘道)
圖片來源:DEV Community (Claude Code)

Anthropic 的託管式程式碼審查(Managed Code Review)從不批准或阻擋拉取請求(pull request)。其檢查結果為中立或跳過,從不顯示失敗,且文件說明除非儲存庫有特殊規定,否則無需回應審查結果即可合併。因此,在選擇 Claude Code 如何審查程式碼之前,應先決定審查應具備何種阻擋能力。

您有四種途徑:透過 Claude GitHub App 進行託管式程式碼審查、Claude Code GitHub Action、/code-review 指令,以及在合併前執行測試並儲存第二個引擎判斷結果的本地閘道。以下關於前三種方法的資訊來自 Anthropic 截至 2026 年 11 月 9 日的文件。

第四種方法是 two-engines-gate,這是我在自己的專案中讓 Claude Code 和 Codex 相互檢查的免費 MIT 授權版本。

這四種方法在啟動方式、執行環境、適用對象和程式碼修改能力上有所不同。託管式程式碼審查由拉取請求活動或 @claude review 評論啟動,運行於 Anthropic 基礎設施,適用於團隊和企業用戶,且僅限讀取程式碼。

GitHub Action 可由 @claude 提及或自訂 GitHub 事件觸發,運行於您自己的 CI 執行器,任何擁有 Claude API 金鑰或雲端供應商憑證的人皆可使用,並能實作修改及推送提交。/code-review 指令則由您在自己的分支上啟動,運行於您的 Claude Code 工作階段,任何方案的用戶皆可使用,且在 --fix 模式下可修改程式碼。

最後,本地閘道由您在每次提交後於本機啟動,需要 Bash 4 或更新版本以及 Git,並搭配 Claude Code 和 Codex CLI 進行實際審查,它能讓建構者提交程式碼,而審查者則以唯讀模式運行。

託管式程式碼審查將合併決策權留給您的團隊。在託管式程式碼審查中,多個代理會閱讀每次變更,驗證步驟會檢查其發現,並以嚴重性排序的行內評論形式呈現結果,同時附帶摘要和名為「Claude Code Review」的檢查運行。

預設情況下,它會尋找可能導致生產環境中斷的錯誤,而忽略格式偏好和測試覆蓋率不足的問題。它會閱讀差異(diff)和周圍的程式碼,但「不建構或運行您的程式碼」,並遵循基礎或預設分支中的 REVIEW.md,而非拉取請求本身的變更。

您可以透過審查級別(快速、標準或深度)設定其徹底程度,Anthropic 表示「越徹底的審查成本越高」。詳細資訊可在成本頁面查詢。完成的審查不會導致必要的檢查失敗。若要讓審查結果阻擋合併,文件建議在您自己的 CI 中讀取檢查運行詳情,並在那裡設定合併閘道。

/code-review 在您自己的工作階段中運行。/code-review 從 Claude Code 內部發現您分支變更中的錯誤,其使用量會計入您的方案用量或 API 帳單,與工作階段的其他部分相同。

如果沒有指定目標,它會審查您分支中領先於上游的提交以及未提交的變更。您也可以將其指向拉取請求或路徑,而 /review 則是其別名。它遵循您的 CLAUDE.md,包括在非互動式 -p 運行中,且不讀取 REVIEW.md。

如果沒有 --fix,其指令只要求報告。如果帶有 --fix,則會要求它透過您的權限模式將發現應用到您的工作樹。若要在沒有託管式程式碼審查或工作流程檔案的情況下審查拉取請求,請將 /code-review 指向它並添加 --comment。審查結果將以行內評論的形式顯示在拉取請求上。

GitHub Action 可以推送提交。Claude Code GitHub Action 在您的 GitHub Actions 工作流程中運行 Claude Code。在拉取請求或議題評論中提及 @claude,它就可以分析程式碼、實作變更並推送提交。

託管式程式碼審查從不推送,而 Action 自己的文件則引導您使用 Code Review 進行無需工作流程檔案的自動審查。設定方式是執行 /install-github-app,或手動安裝 Claude GitHub App、一個密鑰和一個工作流程檔案,並且您需要儲存庫的管理員權限。

其審查工作流程會為每個問題在拉取請求上發布一個行內評論,如果沒有發現問題則發布一個摘要評論。如果您在互動模式下運行 Action,並使用其預設的 @claude 觸發詞與託管式程式碼審查同時運行,則 @claude review 評論會同時啟動兩者。設定 Action 的 trigger_phrase 輸入為不同的詞組以將它們區分開來。

本地閘道將測試通過和第二個引擎的判斷結果綁定到一個提交。本地閘道將測試通過和第二個引擎的判斷結果儲存在一個提交雜湊(commit hash)下,如果兩者皆無則拒絕合併。

在循環中,Claude Code 編寫程式碼,在分支上提交每次變更並停止,然後 Codex 以唯讀模式審查該提交。三個腳本執行檢查:gate.sh 在乾淨的檢出(checkout)上運行您的測試指令,並且只有當指令通過、檢出未改變且未報告運行零個測試時,才會寫入 .ai/tests/<sha>.pass。

review.sh 將提交和差異發送給未編寫它們的引擎,並將判斷結果儲存為 .ai/reviews/<sha12>.md,其中包含一個 Head: 行,其中包含完整的雜湊。merge-check.sh 拒絕合併,除非檢出是乾淨的,並且 HEAD 具有通過記錄和來自非建構者的 ACCEPT。它從不合併。

Codex 透過 codex exec -s read-only 進行審查,因此它可以讀取檔案但不能寫入。BUILDER=codex 會交換角色,然後 Claude Code 僅使用 Read、Grep 和 Glob 作為其工具進行審查。以下這些行來自儲存庫演示的一次運行,其中一個替代表達者給出預設答案,沒有呼叫模型:

merge-check: REFUSED: no test pass record for 2cef9bbe04c3; run gate.sh

gate: PASS on 2cef9bbe04c3, record .ai/tests/2cef9bbe04c3dd4727d2455e07c0ec420ecec7af.pass

merge-check: REFUSED: no review verdict for 2cef9bbe04c3; run review.sh

Verdict: CHANGES REQUIRED - blocker, sum.sh:3: the loop starts at the second argument, so 'bash sum.sh 3 4' prints 4, not 7. test.sh only checks 'sum 0 4', where the bug cannot show.

merge-check: REFUSED: the verdict for 2cef9bbe04c3 is not a single ACCEPT

merge-check: REFUSED: no test pass record for 525000aeac20; run gate.sh

merge-check: OK: 525000aeac20 has a test pass and an ACCEPT from codex (builder claude)

測試在一個包含錯誤的提交上通過了。審查要求進行變更,而修復提交最初沒有證據,因此它需要自己的測試通過和自己的 ACCEPT。所有三個腳本也會拒絕不乾淨的檢出,因為測試可能在未提交的檔案上通過,而審查者可能打開一個與其判斷的提交不同的檔案:

gate: REFUSED: uncommitted changes, untracked files or flagged files (or git failed); commit, remove or unflag them first

為什麼判斷結果儲存在提交雜湊下,以及為什麼閘道拒絕不乾淨的工作樹,這些都透過每個檢查進行解釋。

閘道不具備的功能。它不能使程式碼正確無誤。審查可能會遺漏問題,而測試只檢查它們被設計檢查的部分。它旨在防止合併錯誤的提交,而非安全邊界:任何對儲存庫具有寫入權限的人都可以在 .ai/ 下寫入檔案。它不執行推送、合併或與 GitHub 溝通。

Claude Code 和 Codex 應該相互審查嗎?託管式程式碼審查選擇它所運行的 Claude 模型,因此 Claude Code 編寫的變更會由同一家公司的模型進行審查。對於我的閘道,我選擇了來自不同公司的審查者,因為它有不同的盲點,在一個拉取請求上,第一次 Codex 審查返回了 2 個阻擋性問題和 8 個建議修復的問題。

merge-check.sh 拒絕審查者與建構者是同一引擎的判斷結果,因此沒有引擎會批准自己的提交。我發送給 Codex 的提示詞在「如何讓 Codex 審查 Claude Code 的提交」中有說明。

哪種途徑適合您?如果您是團隊或企業用戶,希望在每個拉取請求上進行審查而無需維護工作流程:選擇託管式程式碼審查,將合併決策權留給您的團隊。

如果您希望在推送之前審查您的分支,且適用於任何方案:選擇 /code-review。如果您希望 Claude Code 回應 @claude 評論、實作變更並從您的 CI 推送提交:選擇 GitHub Action。

如果您希望在提交具有自己的測試通過和來自另一個引擎的 ACCEPT 之前拒絕合併:選擇本地閘道。本地閘道從不與 GitHub 溝通,因此您可以在推送之前運行它,並在拉取請求上保留託管式程式碼審查。

設定本地閘道。從免費閘道開始:複製 two-engines-gate 並運行 bash demo.sh。它不呼叫任何模型,也不需要帳戶或網路。

如果您希望合併本身受到閘道控制,Two Engines Kit 是我自己在專案中使用的自安裝路徑和工作流程。除了免費閘道之外,它還添加了 merge-pr.sh,該腳本在沒有精確提交和樹的本地通過記錄時拒絕呼叫 GitHub,然後推送、打開拉取請求,僅在 HEAD 沒有移動時才合併,並檢查合併後的樹是否與測試過的樹匹配。

當審查開關開啟(REQUIRE_REVIEW=1)時,它也會拒絕沒有儲存 ACCEPT 的提交。我在十月的一個晚上發現了四個只進行測試但從未審查的提交,其中一個已經合併,之後我添加了這個開關。該工具包是根據自第一個 Codex 和 Claude CLI 以來收集的資訊構建的。

如果您希望為您配置循環,那就是 Codex 審查設定。我將 Codex 設定為審查 Claude Code 在您最多三個儲存庫中的提交,每個儲存庫都是從頭開始編寫的,不包含工具包的任何檔案。您的測試會在每次合併前運行,並且在啟用審查強制執行時,Codex 拒絕的提交將不會合併。第一次審查會在您的一個真實分支上運行,並附帶發現結果的錄影演練。

Share

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

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

Newsletter

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

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

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