10 10
11發現結果會以內聯評論的形式出現在相關的程式碼行上,並按[嚴重程度](/docs/zh-TW/code-review-pull-requests#severity-levels)排名,同時在 pull request 上提供摘要和檢查執行。審查永遠不會批准或阻止 pull request,因此是否合併的決定仍由您的團隊掌握。11發現結果會以內聯評論的形式出現在相關的程式碼行上,並按[嚴重程度](/docs/zh-TW/code-review-pull-requests#severity-levels)排名,同時在 pull request 上提供摘要和檢查執行。審查永遠不會批准或阻止 pull request,因此是否合併的決定仍由您的團隊掌握。
12 12
13<img src="https://mintcdn.com/claude-code/gLJVaPQEgKC8ZyUD/images/code-review-pipeline.svg?fit=max&auto=format&n=gLJVaPQEgKC8ZyUD&q=85&s=0351c96df9efa3105172eb00a672f130" className="dark:hidden" alt="四個階段審查的圖表。GitHub 上的 pull request 會交給多個在 Anthropic 基礎設施上並行搜尋的 agent。驗證步驟會移除誤判,其餘發現結果經過去重並按嚴重程度排名,審查會將內聯評論、摘要和檢查執行發佈回 GitHub。" width="760" height="300" data-path="images/code-review-pipeline.svg" />13
14 14
15<img src="https://mintcdn.com/claude-code/gLJVaPQEgKC8ZyUD/images/code-review-pipeline-dark.svg?fit=max&auto=format&n=gLJVaPQEgKC8ZyUD&q=85&s=9cf26bde98f4e999d0d9ff5bf5bdff40" className="hidden dark:block" alt="四個階段審查的圖表。GitHub 上的 pull request 會交給多個在 Anthropic 基礎設施上並行搜尋的 agent。驗證步驟會移除誤判,其餘發現結果經過去重並按嚴重程度排名,審查會將內聯評論、摘要和檢查執行發佈回 GitHub。" width="760" height="300" data-path="images/code-review-pipeline-dark.svg" />15> [!NOTE]
16 16>
17<Note>17> Code Review 使用 AI 審查程式碼,可能會遺漏錯誤、安全漏洞或其他問題。沒有發現結果的審查並不代表您的程式碼沒有錯誤或是安全的。
18 Code Review 使用 AI 審查程式碼,可能會遺漏錯誤、安全漏洞或其他問題。沒有發現結果的審查並不代表您的程式碼沒有錯誤或是安全的。
19</Note>
20
21<span id="review-a-diff-locally" />
22 18
23若要啟用 Code Review,您 Claude 組織的擁有者需依照[設定 Code Review](/docs/zh-TW/code-review-setup) 操作。Claude 也可以在不使用此服務的情況下審查程式碼。在任何方案上,於您的 Claude Code 工作階段中執行 [`/code-review`](/docs/zh-TW/code-review-local),或[比較所有選項](#compare-ways-to-get-a-review)。19若要啟用 Code Review,您 Claude 組織的擁有者需依照[設定 Code Review](/docs/zh-TW/code-review-setup) 操作。Claude 也可以在不使用此服務的情況下審查程式碼。在任何方案上,於您的 Claude Code 工作階段中執行 [`/code-review`](/docs/zh-TW/code-review-local),或[比較所有選項](#compare-ways-to-get-a-review)。
24 20
25<h2 id="availability">21## 可用性
26 可用性
27</h2>
28 22
29在設定 Code Review 之前,請確認您的組織符合資格:23在設定 Code Review 之前,請確認您的組織符合資格:
30 24
34* **加密金鑰**:Code Review 目前尚不適用於使用客戶管理加密金鑰(CMEK)的組織。28* **加密金鑰**:Code Review 目前尚不適用於使用客戶管理加密金鑰(CMEK)的組織。
35* **雲端供應商**:即使您的開發人員透過 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 使用 Claude Code,您仍需要一個使用上述方案之一的 Claude 組織29* **雲端供應商**:即使您的開發人員透過 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 使用 Claude Code,您仍需要一個使用上述方案之一的 Claude 組織
36 30
37<h2 id="set-up-and-use-code-review">31## 設定及使用 Code Review
38 設定及使用 Code Review
39</h2>
40
41<span id="set-up-code-review" />
42
43<span id="pricing" />
44
45<span id="manually-trigger-reviews" />
46
47<span id="customize-reviews" />
48
49<span id="troubleshooting" />
50 32
51請依您需要完成的事項選擇頁面:33請依您需要完成的事項選擇頁面:
52 34
53<CardGroup cols={2}>35> **[設定 Code Review](/docs/zh-TW/code-review-setup)**
54 <Card title="設定 Code Review" icon="toggle-on" href="/docs/zh-TW/code-review-setup">36>
55 檢查需求、安裝 Claude GitHub App,並選擇儲存庫、審查等級以及審查執行的時機37> 檢查需求、安裝 Claude GitHub App,並選擇儲存庫、審查等級以及審查執行的時機
56 </Card>
57
58 <Card title="自訂 Code Review" icon="sliders" href="/docs/zh-TW/code-review-customize">
59 使用儲存庫中的 `REVIEW.md` 和 `CLAUDE.md` 檔案調整要標記的內容
60 </Card>
61 38
62 <Card title="在 pull request 上閱讀及請求審查" icon="code-pull-request" href="/docs/zh-TW/code-review-pull-requests">39> **[自訂 Code Review](/docs/zh-TW/code-review-customize)**
63 閱讀發現結果及其嚴重程度,並透過評論請求另一次審查40>
64 </Card>41> 使用儲存庫中的 `REVIEW.md` 和 `CLAUDE.md` 檔案調整要標記的內容
65 42
66 <Card title="Code Review 疑難排解" icon="wrench" href="/docs/zh-TW/code-review-troubleshooting">43> **[在 pull request 上閱讀及請求審查](/docs/zh-TW/code-review-pull-requests)**
67 修正未啟動、失敗或因預算而略過的審查44>
68 </Card>45> 閱讀發現結果及其嚴重程度,並透過評論請求另一次審查
69 46
70 <Card title="Code Review 成本與使用量" icon="chart-line" href="/docs/zh-TW/code-review-costs">47> **[Code Review 疑難排解](/docs/zh-TW/code-review-troubleshooting)**
71 了解審查的計費方式、估算支出、設定每月支出上限,並追蹤審查活動48>
72 </Card>49> 修正未啟動、失敗或因預算而略過的審查
73</CardGroup>
74 50
75<h2 id="how-reviews-work">51> **[Code Review 成本與使用量](/docs/zh-TW/code-review-costs)**
76 審查的運作方式52>
77</h2>53> 了解審查的計費方式、估算支出、設定每月支出上限,並追蹤審查活動
78 54
79<span id="what-code-review-checks" />55## 審查的運作方式
80 56
81預設情況下,Code Review 專注於正確性:會破壞生產環境的錯誤,而不是格式偏好或缺少的測試涵蓋範圍。若要變更它標記的內容,請[新增指導檔案](/docs/zh-TW/code-review-customize)到您的儲存庫。57預設情況下,Code Review 專注於正確性:會破壞生產環境的錯誤,而不是格式偏好或缺少的測試涵蓋範圍。若要變更它標記的內容,請[新增指導檔案](/docs/zh-TW/code-review-customize)到您的儲存庫。
82 58
97 73
98擁有者啟用 Code Review 後,每個儲存庫都有一項設定決定[審查執行的時機](/docs/zh-TW/code-review-setup#set-when-reviews-run):在 pull request 開啟時執行一次、每次推送後執行,或僅在請求時執行。無論設定為何,對儲存庫具有寫入權限的人都可以在 pull request 上評論 `@claude review` 來[啟動審查](/docs/zh-TW/code-review-pull-requests#comment-commands)。74擁有者啟用 Code Review 後,每個儲存庫都有一項設定決定[審查執行的時機](/docs/zh-TW/code-review-setup#set-when-reviews-run):在 pull request 開啟時執行一次、每次推送後執行,或僅在請求時執行。無論設定為何,對儲存庫具有寫入權限的人都可以在 pull request 上評論 `@claude review` 來[啟動審查](/docs/zh-TW/code-review-pull-requests#comment-commands)。
99 75
100<h3 id="review-levels">76### 審查等級
101 審查等級
102</h3>
103 77
104審查等級決定每次審查的徹底程度,越徹底的審查成本越高:78審查等級決定每次審查的徹底程度,越徹底的審查成本越高:
105 79
109 83
110擁有者可以[為組織選擇一個等級](/docs/zh-TW/code-review-setup#set-the-default-review-level),並可為個別儲存庫指定自己的等級,例如為例行的程式碼庫使用 Quick,為關鍵的程式碼庫使用 Deep。關於影響每次審查成本的其他因素,請參閱 [Code Review 成本與使用量](/docs/zh-TW/code-review-costs)。84擁有者可以[為組織選擇一個等級](/docs/zh-TW/code-review-setup#set-the-default-review-level),並可為個別儲存庫指定自己的等級,例如為例行的程式碼庫使用 Quick,為關鍵的程式碼庫使用 Deep。關於影響每次審查成本的其他因素,請參閱 [Code Review 成本與使用量](/docs/zh-TW/code-review-costs)。
111 85
112<h3 id="what-a-review-can-access">86### 審查可以存取的內容
113 審查可以存取的內容
114</h3>
115 87
116審查透過擁有者[在設定期間安裝](/docs/zh-TW/code-review-setup#turn-on-code-review)的 Claude GitHub App 存取您的儲存庫:88審查透過擁有者[在設定期間安裝](/docs/zh-TW/code-review-setup#turn-on-code-review)的 Claude GitHub App 存取您的儲存庫:
117 89
119* **讀取和寫入的內容**:在審查中,對您儲存庫的存取是唯讀的,審查不會推送提交。在 pull request 上,它會發佈評論和[檢查執行](/docs/zh-TW/code-review-pull-requests#check-run-output)、解決自己先前的評論執行緒,並可以用 👀 回應評論命令。應用程式本身擁有由其他 Claude 功能共享的[更廣泛權限集](/docs/zh-TW/github-actions#github-app-permissions)。91* **讀取和寫入的內容**:在審查中,對您儲存庫的存取是唯讀的,審查不會推送提交。在 pull request 上,它會發佈評論和[檢查執行](/docs/zh-TW/code-review-pull-requests#check-run-output)、解決自己先前的評論執行緒,並可以用 👀 回應評論命令。應用程式本身擁有由其他 Claude 功能共享的[更廣泛權限集](/docs/zh-TW/github-actions#github-app-permissions)。
120* **檢查程式碼的方式**:審查透過閱讀差異和周圍程式碼進行,不會建置或執行您的程式碼。92* **檢查程式碼的方式**:審查透過閱讀差異和周圍程式碼進行,不會建置或執行您的程式碼。
121 93
122<h3 id="who-controls-a-review">94### 誰控制審查
123 誰控制審查
124</h3>
125 95
126* **誰可以啟動審查**:在自動執行審查的情況下,開啟 pull request 或推送到 pull request 會啟動審查,[草稿和分叉除外](/docs/zh-TW/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)。[評論命令](/docs/zh-TW/code-review-pull-requests#comment-commands)僅在來自對儲存庫具有寫入權限的人時才會啟動審查。96* **誰可以啟動審查**:在自動執行審查的情況下,開啟 pull request 或推送到 pull request 會啟動審查,[草稿和分叉除外](/docs/zh-TW/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)。[評論命令](/docs/zh-TW/code-review-pull-requests#comment-commands)僅在來自對儲存庫具有寫入權限的人時才會啟動審查。
127* **遵循哪些指示**:來自基礎分支或預設分支的 `REVIEW.md`,[絕不會來自 pull request 本身的變更](/docs/zh-TW/code-review-customize#which-branch-review-md-is-read-from)。97* **遵循哪些指示**:來自基礎分支或預設分支的 `REVIEW.md`,[絕不會來自 pull request 本身的變更](/docs/zh-TW/code-review-customize#which-branch-review-md-is-read-from)。
128 98
129<h2 id="compare-ways-to-get-a-review">99## 比較取得審查的方式
130 比較取得審查的方式
131</h2>
132 100
133若要找出您可使用的選項,請對照您的方案和程式碼託管檢查**誰可以使用**欄位:101若要找出您可使用的選項,請對照您的方案和程式碼託管檢查**誰可以使用**欄位:
134 102
140| 在您自己的 CI 中使用 Claude,搭配 [GitHub Actions](/docs/zh-TW/github-actions) 或 [GitLab CI/CD](/docs/zh-TW/gitlab-ci-cd) | 您管道的事件,例如每個 pull request 或 merge request | 您自己的 CI 執行器 | 在 GitHub 或 GitLab 上擁有 Claude API 金鑰或雲端供應商憑證的任何人 |108| 在您自己的 CI 中使用 Claude,搭配 [GitHub Actions](/docs/zh-TW/github-actions) 或 [GitLab CI/CD](/docs/zh-TW/gitlab-ci-cd) | 您管道的事件,例如每個 pull request 或 merge request | 您自己的 CI 執行器 | 在 GitHub 或 GitLab 上擁有 Claude API 金鑰或雲端供應商憑證的任何人 |
141| 您自己的審查者,作為 [subagent](/docs/zh-TW/sub-agents) 或 [skill](/docs/zh-TW/skills) | 您或 Claude 在工作階段中叫用它 | 您執行 Claude Code 的任何位置 | 任何自行撰寫的人 |109| 您自己的審查者,作為 [subagent](/docs/zh-TW/sub-agents) 或 [skill](/docs/zh-TW/skills) | 您或 Claude 在工作階段中叫用它 | 您執行 Claude Code 的任何位置 | 任何自行撰寫的人 |
142 110
143<h2 id="related-resources">111## 相關資源
144 相關資源
145</h2>
146 112
147* [GitHub Enterprise Server](/docs/zh-TW/github-enterprise-server):在自行託管的 GitHub 執行個體上使用 Code Review113* [GitHub Enterprise Server](/docs/zh-TW/github-enterprise-server):在自行託管的 GitHub 執行個體上使用 Code Review
148* [GitHub App 權限](/docs/zh-TW/github-actions#github-app-permissions):Claude GitHub App 請求的完整權限集114* [GitHub App 權限](/docs/zh-TW/github-actions#github-app-permissions):Claude GitHub App 請求的完整權限集