Theo dõi usage với analytics

Claude Code cung cấp dashboard analytics giúp tổ chức hiểu pattern sử dụng của developer, theo dõi contribution metrics, và đo mức độ Claude Code tác động đến engineering velocity.

Gói	Dashboard	Bao gồm
Claude for Teams / Enterprise	claude.ai/analytics/claude-code	Usage metrics, contribution metrics (tích hợp GitHub), leaderboard, export dữ liệu
API (Claude Console)	platform.claude.com/claude-code	Usage metrics, spend tracking, team insights

Analytics cho Team và Enterprise

Truy cập claude.ai/analytics/claude-code. Chỉ Admin và Owner mới xem được dashboard.

Dashboard Team/Enterprise gồm:

• Usage metrics: dòng code được chấp nhận, tỷ lệ chấp nhận đề xuất, daily active user và session.
• Contribution metrics: PR và dòng code được ship với sự hỗ trợ của Claude Code (tích hợp GitHub).
• Leaderboard: top contributor xếp hạng theo mức dùng Claude Code.
• Export dữ liệu: tải contribution data dạng CSV.

Để có số token và ước tính chi phí theo từng user, cấu hình export OpenTelemetry, hoặc xuất spend report từ analytics settings của tổ chức.

Bật contribution metrics

Ghi chú

Contribution metrics đang ở public beta, chỉ dành cho gói Claude for Teams và Claude for Enterprise, và chỉ bao phủ user trong tổ chức claude.ai của bạn. Usage qua Claude Console API hoặc tích hợp bên thứ ba không được tính.

Bạn cần vai trò Owner để cấu hình analytics settings; một GitHub admin cần cài GitHub app.

Chú ý

Contribution metrics không khả dụng cho tổ chức đã bật Zero Data Retention - dashboard analytics chỉ hiển thị usage metrics.

Các bước thiết lập:

1. Cài GitHub app: GitHub admin cài Claude GitHub app tại github.com/apps/claude.
2. Bật Claude Code analytics: Claude Owner vào claude.ai/admin-settings/claude-code và bật tính năng.
3. Bật GitHub analytics: bật toggle “GitHub analytics” trên cùng trang.
4. Xác thực với GitHub: hoàn tất luồng xác thực và chọn GitHub organization muốn phân tích.

Dữ liệu thường xuất hiện sau 24 giờ, cập nhật hàng ngày. Nếu không thấy dữ liệu, có thể gặp thông báo “GitHub app required” (cần cài GitHub app) hoặc “Data processing in progress” (kiểm tra lại sau vài ngày). Hỗ trợ cả GitHub Cloud và GitHub Enterprise Server.

Các metric tổng hợp

Ghi chú

Các metric này cố tình đặt ở mức thận trọng - chỉ dòng/PR có độ tin cậy cao về sự tham gia của Claude Code mới được tính, nên con số thực tế thường cao hơn.

• PRs with CC: tổng số PR đã merge chứa ít nhất một dòng code viết cùng Claude Code.
• Lines of code with CC: tổng dòng code trong các PR đã merge được viết với sự hỗ trợ của Claude Code (chỉ tính “effective lines” - dòng có hơn 3 ký tự sau chuẩn hóa, bỏ qua dòng trống và dòng chỉ có dấu ngoặc).
• PRs with Claude Code (%): phần trăm PR merge có code hỗ trợ bởi Claude Code.
• Suggestion accept rate: tỷ lệ user chấp nhận đề xuất sửa code (Edit, Write, NotebookEdit).
• Lines of code accepted: tổng dòng code do Claude Code viết mà user đã chấp nhận (không tính đề xuất bị từ chối, không theo dõi xóa sau đó).

Các biểu đồ

• Adoption: xu hướng daily active users và số session hoạt động mỗi ngày.
• PRs per user: tổng PR merge/ngày chia cho daily active users - đo năng suất cá nhân thay đổi theo mức độ adoption.
• Pull requests breakdown: PR có/không có Claude Code theo ngày; chuyển sang view “Lines of code” để xem theo dòng code.
• Leaderboard: top 10 user theo contribution, toggle giữa Pull requests và Lines of code. Nút Export all users tải CSV đầy đủ (không chỉ top 10).

Cách attribution PR hoạt động

Khi contribution metrics được bật, Claude Code phân tích PR đã merge để xác định phần code nào viết với sự hỗ trợ của Claude Code, bằng cách khớp hoạt động session với code trong PR.

• Tiêu chí gắn nhãn: PR được gắn “with Claude Code” nếu chứa ít nhất một dòng viết trong session Claude Code, dùng matching thận trọng.
• Quy trình: khi PR merge - trích dòng thêm từ diff → xác định session Claude Code đã sửa file khớp trong khung thời gian → khớp dòng PR với output Claude Code bằng nhiều chiến lược → tính metric cho dòng AI-assisted và tổng dòng. Trước khi so sánh, dòng được chuẩn hóa: cắt khoảng trắng, gộp nhiều space, chuẩn hóa dấu ngoặc kép, chuyển chữ thường. PR chứa dòng Claude Code-assisted được gắn nhãn claude-code-assisted trên GitHub.
• Khung thời gian: session từ 21 ngày trước tới 2 ngày sau ngày merge PR được xét attribution.
• File loại trừ: lock file (package-lock.json, yarn.lock, Cargo.lock…), code sinh tự động (Protobuf output, build artifact, file minified), thư mục build (dist/, build/, node_modules/, target/), test fixture, và dòng dài trên 1.000 ký tự (thường là minified/generated).
• Lưu ý: code bị viết lại đáng kể bởi developer (khác biệt hơn 20%) không được attribute cho Claude Code; session ngoài khung 21 ngày không được xét; thuật toán không xét nhánh nguồn/đích của PR.

Tận dụng analytics

• Theo dõi adoption: xem biểu đồ Adoption và số user để tìm active user có thể chia sẻ best practice, xu hướng adoption chung, và các đợt sụt giảm có thể do vướng mắc.
• Đo ROI: theo dõi thay đổi PR/user theo thời gian, so sánh PR/dòng code có và không có Claude Code, kết hợp với DORA metrics hoặc sprint velocity.
• Tìm power user: leaderboard giúp tìm người có thể chia sẻ kỹ thuật prompting, phản hồi, và giúp onboard user mới.
• Truy cập lập trình: trên gói Enterprise, Claude Enterprise Analytics API trả về báo cáo engagement/usage/cost theo user trên các môi trường Claude, bao gồm Claude Code (yêu cầu key scope read:analytics do Primary Owner tạo; không có trên gói Teams). Có thể tìm PR gắn nhãn claude-code-assisted qua GitHub để truy vấn contribution data.

Analytics cho khách hàng API

Khách hàng dùng Claude Console truy cập analytics tại platform.claude.com/claude-code - cần permission UsageView, cấp cho vai trò Developer, Billing, Admin, Owner, Primary Owner.

Ghi chú

Contribution metrics tích hợp GitHub hiện chưa có cho khách hàng API - Console dashboard chỉ hiển thị usage và spend metrics.

Console dashboard hiển thị: Lines of code accepted, Suggestion accept rate, Activity (DAU và session theo biểu đồ), Spend (chi phí API hàng ngày kèm số user).

Xem team insights

Bảng team insights hiển thị metric theo từng user: Members (tất cả user đã xác thực - API key hiển thị theo key identifier, OAuth hiển thị theo email), Spend this month, Lines this month.

Ghi chú

Số liệu spend trong Console dashboard chỉ mang tính ước tính cho mục đích phân tích. Với chi phí thực tế, tham khảo trang billing.

Xem thêm

• Giám sát với OpenTelemetry: export metric và event real-time vào observability stack riêng.
• Quản lý chi phí hiệu quả: đặt spend limit và tối ưu token usage.

Nguồn

Dịch và biên soạn từ Track team usage with analytics.