15 15
16Code Review 有其專屬的儀表板。如需審查活動與支出,請參閱[檢視使用情況](/docs/zh-TW/code-review-costs#view-usage)。16Code Review 有其專屬的儀表板。如需審查活動與支出,請參閱[檢視使用情況](/docs/zh-TW/code-review-costs#view-usage)。
17 17
18<h2 id="access-analytics-for-team-and-enterprise">18## 存取 Team 和 Enterprise 的分析資料
19 存取 Team 和 Enterprise 的分析資料
20</h2>
21 19
22導覽至 [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code)。管理員和擁有者可以檢視儀表板。20導覽至 [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code)。管理員和擁有者可以檢視儀表板。
23 21
30 28
31如需每位使用者的權杖計數和成本估計,請設定 [OpenTelemetry 匯出](/docs/zh-TW/monitoring-usage),或從您組織的分析設定匯出 [支出報告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans),其中列出每位使用者和每個模型的權杖使用情況和估計使用額度支出。29如需每位使用者的權杖計數和成本估計,請設定 [OpenTelemetry 匯出](/docs/zh-TW/monitoring-usage),或從您組織的分析設定匯出 [支出報告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans),其中列出每位使用者和每個模型的權杖使用情況和估計使用額度支出。
32 30
33<h3 id="enable-contribution-metrics">31### 啟用貢獻指標
34 啟用貢獻指標
35</h3>
36 32
37<Note>33> [!NOTE]
38 貢獻指標處於公開測試版,可在 Claude for Teams 和 Claude for Enterprise 方案上使用。這些指標僅涵蓋您 claude.ai 組織內的使用者。透過 Claude Console API 或第三方整合的使用情況不包括在內。34>
39</Note>35> 貢獻指標處於公開測試版,可在 Claude for Teams 和 Claude for Enterprise 方案上使用。這些指標僅涵蓋您 claude.ai 組織內的使用者。透過 Claude Console API 或第三方整合的使用情況不包括在內。
40 36
41使用情況和採用資料適用於所有 Claude for Teams 和 Claude for Enterprise 帳戶。貢獻指標需要額外設定以連接您的 GitHub 組織。37使用情況和採用資料適用於所有 Claude for Teams 和 Claude for Enterprise 帳戶。貢獻指標需要額外設定以連接您的 GitHub 組織。
42 38
43您需要擁有者角色才能設定分析設定。GitHub 管理員必須安裝 GitHub 應用程式。39您需要擁有者角色才能設定分析設定。GitHub 管理員必須安裝 GitHub 應用程式。
44 40
45<Warning>41> [!WARNING]
46 貢獻指標不適用於啟用 [Zero Data Retention](/docs/zh-TW/zero-data-retention) 的組織。分析儀表板將僅顯示使用情況指標。42>
47</Warning>43> 貢獻指標不適用於啟用 [Zero Data Retention](/docs/zh-TW/zero-data-retention) 的組織。分析儀表板將僅顯示使用情況指標。
48 44
49<Steps>45**1. 安裝 GitHub 應用程式**
50 <Step title="安裝 GitHub 應用程式">
51 GitHub 管理員在您組織的 GitHub 帳戶上安裝 Claude GitHub 應用程式,位址為 [github.com/apps/claude](https://github.com/apps/claude)。
52 </Step>
53 46
54 <Step title="啟用 Claude Code 分析">47GitHub 管理員在您組織的 GitHub 帳戶上安裝 Claude GitHub 應用程式,位址為 [github.com/apps/claude](https://github.com/apps/claude)。
55 Claude 擁有者導覽至 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 並啟用 Claude Code 分析功能。
56 </Step>
57 48
58 <Step title="啟用 GitHub 分析">49**2. 啟用 Claude Code 分析**
59 在同一頁面上,啟用「GitHub 分析」切換。
60 </Step>
61 50
62 <Step title="使用 GitHub 進行驗證">51Claude 擁有者導覽至 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 並啟用 Claude Code 分析功能。
63 完成 GitHub 驗證流程並選擇要包括在分析中的 GitHub 組織。52
64 </Step>53**3. 啟用 GitHub 分析**
65</Steps>54
55在同一頁面上,啟用「GitHub 分析」切換。
56
57**4. 使用 GitHub 進行驗證**
58
59完成 GitHub 驗證流程並選擇要包括在分析中的 GitHub 組織。
66 60
67資料通常在啟用後的 24 小時內出現,並進行每日更新。如果沒有資料出現,您可能會看到以下其中一則訊息:61資料通常在啟用後的 24 小時內出現,並進行每日更新。如果沒有資料出現,您可能會看到以下其中一則訊息:
68 62
71 65
72貢獻指標涵蓋託管於 github.com 上的儲存庫。對於 [GitHub Enterprise Server](/docs/zh-TW/github-enterprise-server) 上的儲存庫,分析儀表板僅顯示使用情況指標。66貢獻指標涵蓋託管於 github.com 上的儲存庫。對於 [GitHub Enterprise Server](/docs/zh-TW/github-enterprise-server) 上的儲存庫,分析儀表板僅顯示使用情況指標。
73 67
74<h3 id="review-summary-metrics">68### 檢視摘要指標
75 檢視摘要指標
76</h3>
77 69
78<Note>70> [!NOTE]
79 這些指標刻意保守,代表對 Claude Code 實際影響的低估。只有在高度確信 Claude Code 參與的情況下,才會計算程式碼行和 PR。71>
80</Note>72> 這些指標刻意保守,代表對 Claude Code 實際影響的低估。只有在高度確信 Claude Code 參與的情況下,才會計算程式碼行和 PR。
81 73
82儀表板在頂部顯示這些摘要指標:74儀表板在頂部顯示這些摘要指標:
83 75
87* **建議接受率**:使用者接受 Claude Code 程式碼編輯建議的次數百分比,包括 Edit、Write 和 NotebookEdit 工具使用情況79* **建議接受率**:使用者接受 Claude Code 程式碼編輯建議的次數百分比,包括 Edit、Write 和 NotebookEdit 工具使用情況
88* **已接受的程式碼行**:Claude Code 撰寫且使用者在其工作階段中已接受的程式碼總行數。這不包括被拒絕的建議,也不追蹤後續刪除。80* **已接受的程式碼行**:Claude Code 撰寫且使用者在其工作階段中已接受的程式碼總行數。這不包括被拒絕的建議,也不追蹤後續刪除。
89 81
90<h3 id="explore-the-charts">82### 探索圖表
91 探索圖表
92</h3>
93 83
94儀表板包括多個圖表以視覺化一段時間內的趨勢。84儀表板包括多個圖表以視覺化一段時間內的趨勢。
95 85
96<h4 id="track-adoption">86#### 追蹤採用
97 追蹤採用
98</h4>
99 87
100採用圖表顯示每日使用趨勢:88採用圖表顯示每日使用趨勢:
101 89
102* **使用者**:每日活躍使用者90* **使用者**:每日活躍使用者
103* **工作階段**:每天的活躍 Claude Code 工作階段數91* **工作階段**:每天的活躍 Claude Code 工作階段數
104 92
105<h4 id="measure-prs-per-user">93#### 測量每位使用者的 PR
106 測量每位使用者的 PR
107</h4>
108 94
109此圖表顯示一段時間內的個別開發人員活動:95此圖表顯示一段時間內的個別開發人員活動:
110 96
113 99
114使用此功能可了解隨著 Claude Code 採用增加,個別生產力如何變化。100使用此功能可了解隨著 Claude Code 採用增加,個別生產力如何變化。
115 101
116<h4 id="view-pull-requests-breakdown">102#### 檢視提取要求細目
117 檢視提取要求細目
118</h4>
119 103
120提取要求圖表顯示已合併 PR 的每日細目:104提取要求圖表顯示已合併 PR 的每日細目:
121 105
124 108
125切換至**程式碼行**檢視以按程式碼行而非 PR 計數查看相同的細目。109切換至**程式碼行**檢視以按程式碼行而非 PR 計數查看相同的細目。
126 110
127<h4 id="find-top-contributors">111#### 尋找頂級貢獻者
128 尋找頂級貢獻者
129</h4>
130 112
131排行榜顯示按貢獻量排名的前 10 位使用者。在以下項目之間切換:113排行榜顯示按貢獻量排名的前 10 位使用者。在以下項目之間切換:
132 114
135 117
136按一下**匯出所有使用者**以下載所有使用者的完整貢獻資料為 CSV 檔案。匯出包括所有使用者,而不僅是顯示的前 10 位。118按一下**匯出所有使用者**以下載所有使用者的完整貢獻資料為 CSV 檔案。匯出包括所有使用者,而不僅是顯示的前 10 位。
137 119
138<h3 id="pr-attribution">120### PR 歸因
139 PR 歸因
140</h3>
141 121
142啟用貢獻指標後,Claude Code 會分析已合併的提取要求,以確定哪些程式碼是使用 Claude Code 協助撰寫的。這是透過將 Claude Code 工作階段活動與每個 PR 中的程式碼進行比對來完成的。122啟用貢獻指標後,Claude Code 會分析已合併的提取要求,以確定哪些程式碼是使用 Claude Code 協助撰寫的。這是透過將 Claude Code 工作階段活動與每個 PR 中的程式碼進行比對來完成的。
143 123
144<h4 id="attribution-process">124#### 歸因程序
145 歸因程序
146</h4>
147 125
148合併提取要求時:126合併提取要求時:
149 127
156 134
157包含 Claude Code 協助行的已合併提取要求在 GitHub 中會標籤為 `claude-code-assisted`。135包含 Claude Code 協助行的已合併提取要求在 GitHub 中會標籤為 `claude-code-assisted`。
158 136
159<h4 id="time-window">137#### 時間視窗
160 時間視窗
161</h4>
162 138
163PR 合併日期前 21 天至後 2 天的工作階段會被考慮用於歸因比對。139PR 合併日期前 21 天至後 2 天的工作階段會被考慮用於歸因比對。
164 140
165<h4 id="excluded-files">141#### 排除的檔案
166 排除的檔案
167</h4>
168 142
169某些檔案會自動從分析中排除,因為它們是自動產生的:143某些檔案會自動從分析中排除,因為它們是自動產生的:
170 144
174* 測試夾具:快照、錄製、模擬資料148* 測試夾具:快照、錄製、模擬資料
175* 超過 1,000 個字元的行,可能是縮小或產生的149* 超過 1,000 個字元的行,可能是縮小或產生的
176 150
177<h4 id="attribution-notes">151#### 歸因附註
178 歸因附註
179</h4>
180 152
181在解釋歸因資料時,請記住這些額外詳細資訊:153在解釋歸因資料時,請記住這些額外詳細資訊:
182 154
184* 不考慮 21 天視窗外的工作階段156* 不考慮 21 天視窗外的工作階段
185* 演算法在執行歸因時不考慮 PR 來源或目的地分支157* 演算法在執行歸因時不考慮 PR 來源或目的地分支
186 158
187<h3 id="get-the-most-from-analytics">159### 充分利用分析
188 充分利用分析
189</h3>
190 160
191使用貢獻指標來展示投資報酬率、識別採用模式,並找到可以幫助他人開始使用的團隊成員。161使用貢獻指標來展示投資報酬率、識別採用模式,並找到可以幫助他人開始使用的團隊成員。
192 162
193<h4 id="monitor-adoption">163#### 監控採用
194 監控採用
195</h4>
196 164
197追蹤採用圖表和使用者計數以識別:165追蹤採用圖表和使用者計數以識別:
198 166
200* 整個組織的整體採用趨勢168* 整個組織的整體採用趨勢
201* 可能表示摩擦或問題的使用情況下降169* 可能表示摩擦或問題的使用情況下降
202 170
203<h4 id="measure-roi">171#### 測量投資報酬率
204 測量投資報酬率
205</h4>
206 172
207貢獻指標有助於使用您自己程式碼庫中的資料回答「此工具值得投資嗎?」:173貢獻指標有助於使用您自己程式碼庫中的資料回答「此工具值得投資嗎?」:
208 174
210* 比較使用和不使用 Claude Code 發佈的 PR 和程式碼行176* 比較使用和不使用 Claude Code 發佈的 PR 和程式碼行
211* 與 [DORA 指標](https://dora.dev/)、衝刺速度或其他工程 KPI 一起使用,以了解採用 Claude Code 帶來的變化177* 與 [DORA 指標](https://dora.dev/)、衝刺速度或其他工程 KPI 一起使用,以了解採用 Claude Code 帶來的變化
212 178
213<h4 id="identify-power-users">179#### 識別超級使用者
214 識別超級使用者
215</h4>
216 180
217排行榜可幫助您找到具有高 Claude Code 採用率的團隊成員,他們可以:181排行榜可幫助您找到具有高 Claude Code 採用率的團隊成員,他們可以:
218 182
220* 提供有關運作良好的反饋184* 提供有關運作良好的反饋
221* 幫助新使用者上手185* 幫助新使用者上手
222 186
223<h4 id="access-data-programmatically">187#### 以程式設計方式存取資料
224 以程式設計方式存取資料
225</h4>
226 188
227在 Enterprise 方案上,[Claude Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) 會為您的組織返回每位使用者的參與度、使用情況和成本報告,涵蓋所有 Claude 表面,包括 Claude Code。主要擁有者在 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) 建立具有 `read:analytics` 範圍的金鑰。API 在 Teams 方案上不可用。189在 Enterprise 方案上,[Claude Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) 會為您的組織返回每位使用者的參與度、使用情況和成本報告,涵蓋所有 Claude 表面,包括 Claude Code。主要擁有者在 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) 建立具有 `read:analytics` 範圍的金鑰。API 在 Teams 方案上不可用。
228 190
229若要改為透過 GitHub 查詢貢獻資料,請搜尋標籤為 `claude-code-assisted` 的 PR。191若要改為透過 GitHub 查詢貢獻資料,請搜尋標籤為 `claude-code-assisted` 的 PR。
230 192
231<h2 id="access-analytics-for-api-customers">193## 訪問 API 客戶的分析
232 訪問 API 客戶的分析
233</h2>
234 194
235使用 Claude Console 的 API 客戶可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 訪問分析。您需要 UsageView 權限才能訪問儀表板,該權限授予開發人員、計費、管理員、所有者和主要所有者角色。若要以程式設計方式提取相同的每日每用戶指標,請使用 [Claude Code Analytics API](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-code-analytics-api) 搭配管理員 API 金鑰。195使用 Claude Console 的 API 客戶可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 訪問分析。您需要 UsageView 權限才能訪問儀表板,該權限授予開發人員、計費、管理員、所有者和主要所有者角色。若要以程式設計方式提取相同的每日每用戶指標,請使用 [Claude Code Analytics API](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-code-analytics-api) 搭配管理員 API 金鑰。
236 196
237<Note>197> [!NOTE]
238 GitHub 整合的貢獻指標目前不適用於 API 客戶。Console 儀表板僅顯示使用和支出指標。198>
239</Note>199> GitHub 整合的貢獻指標目前不適用於 API 客戶。Console 儀表板僅顯示使用和支出指標。
240 200
241Console 儀表板顯示:201Console 儀表板顯示:
242 202
245* **活動**:圖表上顯示的每日活躍用戶和會話。205* **活動**:圖表上顯示的每日活躍用戶和會話。
246* **支出**:每日 API 成本(以美元計)以及用戶計數。206* **支出**:每日 API 成本(以美元計)以及用戶計數。
247 207
248<h3 id="view-team-insights">208### 查看團隊洞察
249 查看團隊洞察
250</h3>
251 209
252團隊洞察表顯示每個用戶的指標:210團隊洞察表顯示每個用戶的指標:
253 211
255* **本月支出**:每個用戶當前月份的每用戶 API 成本總計。213* **本月支出**:每個用戶當前月份的每用戶 API 成本總計。
256* **本月代碼行**:每個用戶當前月份已接受代碼行的每用戶總計。214* **本月代碼行**:每個用戶當前月份已接受代碼行的每用戶總計。
257 215
258<Note>216> [!NOTE]
259 Console 儀表板中的支出數字是用於分析目的的估計值。有關實際成本,請參閱您的計費頁面。217>
260</Note>218> Console 儀表板中的支出數字是用於分析目的的估計值。有關實際成本,請參閱您的計費頁面。
261 219
262<h2 id="related-resources">220## 相關資源
263 相關資源
264</h2>
265 221
266* [使用 OpenTelemetry 進行監控](/docs/zh-TW/monitoring-usage):將實時指標和事件匯出到您的可觀測性堆棧222* [使用 OpenTelemetry 進行監控](/docs/zh-TW/monitoring-usage):將實時指標和事件匯出到您的可觀測性堆棧
267* [有效管理成本](/docs/zh-TW/costs):設置支出限制並優化令牌使用223* [有效管理成本](/docs/zh-TW/costs):設置支出限制並優化令牌使用