如果您的方案不包含 Code Review,您仍可從 Claude Code 工作階段讓 Claude 審查您的分支:請參閱使用
/code-review 在本機審查。嚴重性等級
Claude 會將每個發現項目以行內留言形式發佈在相關的程式碼行上,並以三種嚴重性等級之一加以標示:
當審查記錄了其推理過程時,該發現項目會有一個收合的 Why this was flagged 區段。展開即可閱讀 Claude 指出此問題的原因,以及它如何驗證該問題。
若要變更 Claude 在您的儲存庫中指出的內容或其嚴重性排序方式,請參閱自訂 Code Review。
回應發現項目
除非您儲存庫本身的規則有所要求,否則您可以不回應發現項目就直接合併。如果其分支保護要求解決對話,請在合併前解決每個發現項目的討論串。 若要清除發現項目,請解決其討論串或推送修正。- 不修改程式碼而駁回:在 GitHub 上自行解決該討論串。僅回覆並不會駁回發現項目。
- 修正問題:修改程式碼並推送。pull request 的下一次審查若判定問題已修正,就會解決先前的討論串,無論該審查是在您推送時自動執行,還是由您請求執行。
- 說明或提出異議:回覆該留言。Claude 不會立即回應,且回覆不會啟動審查。pull request 的下一次審查會讀取對先前發現項目的回覆,並可能解決該討論串或發佈一則後續回覆。如果同類型的發現項目不斷出現,請請維護者在
REVIEW.md中新增規則。
@claude review。
Check run 輸出
Claude Code Review check run 上的 Details 連結會以單一表格開啟依嚴重性排序的發現項目,包括 GitHub 未接受其行內留言的任何發現項目:
具有行號但未以行內留言形式發佈的發現項目,會以註解形式出現在 Files changed 分頁中的相關程式碼行上。Important 發現項目以紅色顯示、nit 以黃色顯示,pre-existing 錯誤則以灰色顯示。
Check run 的結論為 neutral;當自動審查因推送未變更任何檔案而未執行時,結論則為 skipped。其結論永遠不會是失敗,因此已完成的審查不會使必要檢查失敗。如果您沒有看到發現項目,或審查未執行,請參閱疑難排解 Code Review。
從指令碼讀取結果
若要從您自己的 CI 控管合併或發佈摘要,請使用gh 和 jq 剖析 Details 文字的最後一行。該行是一則機器可讀的註解。
1
找出 check run ID
從您的 shell 列出該提交的 check run,並取得
Claude Code Review 執行的 id。將 OWNER 和 REPO 替換為您的儲存庫擁有者和名稱,並將 <commit-sha> 替換為 pull request 的 head 提交:2
讀取嚴重性計數
從該 check run 讀取計數,並將 這會印出一個 JSON 物件,其中包含每種嚴重性的計數,且鍵依字母順序排列,例如
CHECK_RUN_ID 替換為該 ID:{"nit": 1, "normal": 2, "pre_existing": 0}。這些計數包含 pull request 先前審查中、其討論串仍未解決的發現項目。3
依結果採取行動
讓您的指令碼處理以下情況:
normal大於零:如果您想控管合併,請讓該作業失敗。normal鍵存放的是 Important 發現項目的計數,因此表示 Claude 至少發現了一個值得在合併前修正的錯誤。- 缺少該行:將其視為沒有判定結果,而非零個發現項目。失敗、逾時、被取消或被較新審查取代的審查,其 check run 不會有這一行,而某些已完成的審查也沒有。
請求審查
如果您的 pull request 是草稿或來自 fork,自動審查會略過它,因此請使用留言命令請求審查。若要讓您的 pull request 獲得審查,請執行下列其中一項:- 開啟或標記為就緒:在設定為 Once after PR creation 或 After every push 的儲存庫中,當您開啟或重新開啟 pull request,或將草稿標記為可供審查時,就會啟動審查。
- 留言命令:在 pull request 上發佈
@claude review。 - 推送提交:在設定為 After every push 的儲存庫中,或在您已使用
@claude review always訂閱的 pull request 上,推送會啟動審查。 - 點擊 Re-run:在非來自 fork 的 pull request 上,審查失敗或逾時後,可從 check run 再次執行。
- 等待自動重試:工作階段被中斷的審查會自動重試一次。Check run 的摘要會說明何時正在進行重試。
留言命令
在 pull request 上以留言形式發佈下列其中一個命令:
若要讓這些命令中的任何一個啟動審查,必須同時符合下列所有條件:
- 以新的頂層 pull request 留言形式發佈,而不是差異行上的行內留言,也不是審查的內文。編輯先前的留言不算數。
- 將命令放在留言開頭,且
always必須與命令的其餘部分位於同一行。大小寫不影響。 - 您需要具備儲存庫的 write、maintain 或 admin 權限。Claude 會向 GitHub 檢查每位留言者的權限,而來自 bot 的留言不會啟動審查。
- Pull request 必須處於開啟狀態。
在 2026 年 7 月的更新之前,
@claude review 會讓 PR 訂閱由推送觸發的審查。如果您依賴該行為,請改為留言 @claude review always。後續審查涵蓋的範圍
自行啟動的後續審查(例如在推送之後)會著重於自上次審查以來的變更,並發佈較少的 nit 和 pre-existing 發現項目。其摘要會在一行以 “found and not posted” 或 “outside the scope of this re-review and not posted.” 結尾的文字中,計算它省略的項目數量。 若要取得不省略任何這些項目的審查,請留言@claude review。它會再次涵蓋整個 pull request。
審查草稿與來自 fork 的 pull request
自動審查會略過這兩者,因此請使用留言命令請求審查:- 草稿 pull request:留言命令可在草稿上執行,因此您可以在將 pull request 標記為就緒之前請求審查。對草稿的推送不會啟動審查,即使在
@claude review always之後也一樣。訂閱會在您將 pull request 標記為就緒後生效。 - 來自 fork 的 pull request:無論儲存庫的 Review runs 設定為何,Claude 都不會自動審查來自 fork 的 pull request。若要啟動審查,請在 pull request 上留言
@claude review。留言命令的條件仍然適用,且您需要的 write 存取權限是針對基礎儲存庫,而非 fork。
@claude review always 也可以使用,但不會讓 pull request 訂閱之後推送的審查。在該處點擊 check run 上的 Re-run 不會啟動審查。
搭配 Claude Code GitHub Action 使用 Code Review
如果儲存庫也以互動模式執行 Claude Code GitHub Action,並使用其預設的@claude 觸發詞,@claude review 留言也會啟動該 Action。若要將兩者區隔開來,請將該 Action 的 trigger_phrase 輸入設定為不同的詞語。
相關資源
- 疑難排解 Code Review:未啟動、失敗或因預算而被略過的審查
- Code Review:此服務是什麼,以及審查如何執行
- 設定 Code Review:供 Owner 使用,啟用 Code Review 並選擇審查的執行時機與等級
- 自訂 Code Review:使用
REVIEW.md和CLAUDE.md變更 Claude 指出的內容 - Code Review 費用與使用量:審查如何計費,以及支出上限的設定位置
- 使用
/code-review在本機審查:從 Claude Code 工作階段對您的分支執行審查