啟用 Code Review 所需條件
首先確認您的組織符合 Code Review 的使用資格。接著確認您本身具備以下存取權,或有具備這些存取權的人員協助:啟用 Code Review
1
點選 Allow code review 開關
前往 Admin settings > Claude Code 的 Code review 區段,然後點選 Allow code review 開關。如果 Code Review 立即啟用且未出現任何對話方塊,表示您的組織已連結 Claude GitHub App 或已新增儲存庫。請前往新增更多儲存庫,再回來執行最後一個步驟。
2
連接您的 GitHub 帳戶
如果開啟了 Connect GitHub 對話方塊,請點選 Connect。如果您的組織使用 GitHub Enterprise Server,請先在對話方塊中選擇您的執行個體。GitHub 會要求您授權 Claude,然後將您帶回管理頁面,並開啟 Add a repository 對話方塊。如果直接開啟了 Add a repository,表示您的帳戶已連接,請繼續下一個步驟。
3
安裝 Claude GitHub App
如果您想要的儲存庫已列在 Add a repository 對話方塊中,或可在其中搜尋到,請繼續下一個步驟。對話方塊只會列出 Claude GitHub App 可存取的儲存庫,因此如果找不到,請安裝此應用程式:
- 點選 Install GitHub App。若未列出任何儲存庫,它會是對話方塊中的一個按鈕;否則,它位於對話方塊中 GitHub 組織篩選選單的底部。GitHub 的安裝頁面會在新分頁中開啟。
- 選擇擁有這些儲存庫的 GitHub 組織。
- 選擇應用程式可存取的儲存庫。
- 核准所要求的權限。這組權限的範圍比審查實際使用的更廣,並與其他 Claude 功能共用,例如 GitHub Actions。請參閱審查可存取的內容以及完整權限清單。
- 安裝完成後,該分頁會返回 Claude。如果顯示 Finish connecting GitHub 按鈕,請點選它,將此安裝連結至您的 Claude 組織。
- 回到管理頁面的分頁,對話方塊中的清單會重新整理。
4
選擇儲存庫
選擇您要進行審查的儲存庫,然後點選 Continue。新增儲存庫需要您所連接的 GitHub 帳戶對該儲存庫具有寫入存取權。您之後可以新增更多儲存庫。
5
點選 Finish
接著會出現 Code review is set up 對話方塊。點選 Finish 即可啟用 Code Review。如果以其他方式關閉此對話方塊,您的儲存庫仍會保持已新增狀態,但 Allow code review 會維持關閉,您需要透過該開關將其開啟。每個儲存庫一開始都設定為在每次推送後進行審查,這會執行最多次審查。若要減少審查次數,請設定審查的執行時機。
6
以測試 pull request 驗證
在您新增的其中一個儲存庫中開啟一個測試 pull request,且不要將其標示為草稿。幾分鐘內會出現名為 Claude Code Review 的 check run。如果您已將該儲存庫設定為 Manual (@claude review),請在 pull request 上留言
@claude review 以啟動第一次審查。如果沒有出現 check run,請參閱 No check run appears on the test pull request。審查結果出現後,請將在 pull request 上閱讀及請求審查提供給您的開發人員,其中涵蓋嚴重程度等級、留言命令,以及如何回應審查發現。為您的組織設定預設值
身為 Owner,您可以決定審查的詳盡程度及執行頻率。這兩項都位於 Admin settings > Claude Code 的 Code review 區段中。設定預設審查等級
審查等級決定每次審查的詳盡程度,越詳盡的審查費用越高。您可以為組織設定一個預設值,並針對個別儲存庫進行覆寫。- 組織預設值:在 Review level 下選擇一個等級,並以 Change level 確認。除非您為某個儲存庫另行設定,否則所有儲存庫都會使用此等級。
- 單一儲存庫:點選該儲存庫所在列的 Edit,然後在其中選擇 Review level。第一個選項 Default 會沿用組織設定。選擇後等級會立即儲存。
設定審查的執行時機
每個儲存庫都有各自的 Review runs 設定,用於決定其 pull request 何時接受審查。- Once after PR creation:當 pull request 被開啟、重新開啟或標示為可供審查時,執行一次審查
- After every push:每次推送至 pull request 分支時執行審查,隨著 pull request 的演進發現新問題,並在您修正所指出的問題時自動解決討論串
- Manual (@claude review):開啟 pull request 或推送至 pull request 不會啟動審查。留言
@claude review以請求審查,或留言@claude review always,讓該 pull request 在後續推送時也會接受審查。
- 草稿及來自 fork 的 pull request:無論您選擇哪個選項,自動審查都會略過這兩者
- 新儲存庫:從 Add a repository 對話方塊新增的儲存庫一開始設定為 After every push。如果其 GitHub 組織已整體涵蓋,則會改為採用該組織列的設定。
開啟或關閉提示留言
提示留言是當審查未啟動時,Claude 在 pull request 上發布的簡短留言,說明原因及後續步驟。Show tips on pull requests 預設為開啟。開啟時,Claude 會在下列各情況發布提示,說明:- 儲存庫設定為 Manual:如何透過留言請求審查
- pull request 來自 fork:維護者可以請求審查
- 機器人或沒有寫入存取權的人留言
@claude review:未啟動審查,以及誰可以請求審查 - GitHub 組織未連結至您的 Claude 組織:審查已暫停,以及如何進行連結
開發人員可以變更的項目
開發人員若要變更審查等級、Review runs 設定,或哪些儲存庫接受審查,需要向您提出。在沒有 Owner 角色的情況下,他們可以在 GitHub 上執行以下操作:- 請求審查:在 pull request 上留言
@claude review。這需要對該儲存庫具有寫入存取權,且適用於自動審查會略過的草稿及來自 fork 的 pull request。 - 讓單一 pull request 在每次推送時接受審查:在非草稿或非來自 fork 的 pull request 上留言
@claude review always,例如在設定為 Manual 的儲存庫中 - 變更審查所指出的問題:將
REVIEW.md和CLAUDE.md檔案提交至儲存庫,例如新增一項檢查
管理儲存庫
您可以逐一新增儲存庫,或一次涵蓋整個 GitHub 組織,並在不需要審查的地方停止審查。新增更多儲存庫
若要在設定完成後新增儲存庫,請點選 Code review 區段中 Repositories 表格上方的 Add。Add a repository 對話方塊會開啟。選擇儲存庫並點選 Continue。- 某個儲存庫未列出:請參閱 A repository isn’t listed in Add a repository。
- 您想要 GitHub 組織中的所有儲存庫:請涵蓋該組織,而非逐一選擇儲存庫
涵蓋整個 GitHub 組織
若要為 GitHub 組織中的所有儲存庫啟用 Code Review,請在 Repositories 表格中該組織所在的列設定 Review runs。這會涵蓋該組織中 Claude GitHub App 可存取的所有儲存庫,包括之後新增的儲存庫。這可能會大幅增加花費。需要滿足以下所有條件:- 您連接至 Claude 的 GitHub 帳戶是該 GitHub 組織的 owner。
- 該組織位於 github.com 上。GitHub Enterprise Server 執行個體及個人 GitHub 帳戶不符合資格。
- 已為您的 Claude 組織或 Code Review 設定每月花費上限。
- 涵蓋範圍:每個儲存庫會從其下一個 pull request 開始受到涵蓋。如果 Claude GitHub App 是安裝在選定的儲存庫而非全部儲存庫上,Claude 會審查那些儲存庫;請在 GitHub 上變更應用程式的儲存庫存取權以涵蓋其餘儲存庫。
- 現有設定:該 GitHub 組織中的每個儲存庫都會採用您選擇的選項,包括您先前個別設定的儲存庫。再次設定該列也會產生相同效果。您在其各自所在列上關閉的儲存庫會維持關閉。
- 之後的個別變更:您之後設定為與其組織不同的儲存庫,會在表格中標示為 Custom。
- 審查等級:組織列本身沒有審查等級。
關閉 Code Review 或移除儲存庫
在 Admin settings > Claude Code 的 Code review 區段中,選擇與您要停止的項目相符的控制項:- 單一儲存庫,保留在清單中:點選其所在列的 Edit,然後關閉 Code review。表格會將該儲存庫顯示為 Off。
- 單一儲存庫,將其移除:點選其所在列的 Edit,然後點選對話方塊底部的 Remove repository。該儲存庫的審查會停止,之後其他 Claude 組織便可以設定該儲存庫。當該儲存庫的 GitHub 組織被整體涵蓋時,您無法將其移除;請改為關閉其 Code review 開關。
- 整個 GitHub 組織:點選該組織所在列的 Edit,然後選擇 Off。這也會關閉該組織中您逐一新增的儲存庫。
- 全部:關閉 Allow code review。所有儲存庫都不會再啟動新的審查,而您的儲存庫清單會保留,以便您之後重新開啟。
相關資源
- Code Review 費用與使用量:審查等級及審查執行時機如何影響花費、如何設定花費上限,以及在哪裡查看使用量
- 在 pull request 上閱讀及請求審查:開發人員在 pull request 上看到的內容及留言命令
- 自訂 Code Review:使用
REVIEW.md和CLAUDE.md調整 Claude 所指出的問題 - GitHub Enterprise Server:在設定之前連接自行託管的 GitHub 執行個體