Blog

Hướng Dẫn Sử Dụng Claude Code Analytics Qua API

Ashley Goolam

Ashley Goolam

12 tháng 9 2025

Hướng Dẫn Sử Dụng Claude Code Analytics Qua API

Trí tuệ nhân tạo đang thay đổi cách các nhóm lập trình và việc có cái nhìn rõ ràng về việc sử dụng công cụ cũng như năng suất là một yếu tố thay đổi cuộc chơi. Đó là lúc **Claude Code Analytics API**, một công cụ mạnh mẽ từ Anthropic, mở ra những hiểu biết sâu sắc về cách một tổ chức tận dụng Claude Code, trợ lý lập trình được hỗ trợ bởi AI của họ. API này không chỉ về những con số—mà là về việc trao quyền cho các nhóm theo dõi hoạt động của nhà phát triển, tối ưu hóa quy trình làm việc và quản lý chi phí một cách chính xác. Dù bạn là trưởng dự án đảm bảo nhóm của mình tối đa hóa các công cụ AI hay là CTO đang biện minh cho các khoản đầu tư, **Claude Code Analytics API** đều cung cấp dữ liệu có thể hành động để đưa ra các quyết định sáng suốt. Trong hướng dẫn này, chúng ta sẽ khám phá API này làm gì, các tính năng cốt lõi của nó, cách sử dụng và tại sao nó là công cụ không thể thiếu đối với các tổ chức đang mở rộng quy mô lập trình được hỗ trợ bởi AI. Hãy cùng tìm hiểu và xem **Claude Code Analytics API** có thể thay đổi năng suất của nhóm bạn như thế nào!

💡
Bạn muốn một công cụ kiểm thử API tuyệt vời có thể tạo ra Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, tất cả trong một cho Nhóm phát triển của mình để làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi yêu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!
nút

Claude Code Analytics API là gì

**Claude Code Analytics API** giống như một cửa sổ nhìn vào việc sử dụng Claude Code của tổ chức bạn, trợ lý lập trình AI của Anthropic. Nó cung cấp quyền truy cập theo chương trình vào các phân tích sử dụng chi tiết và các chỉ số năng suất, mang lại cho bạn cái nhìn rõ ràng về cách các nhà phát triển tương tác với Claude Code. Dù là theo dõi số dòng mã được tạo, giám sát việc sử dụng API hay phân tích chi phí, API này là công cụ chính của bạn để đảm bảo tính minh bạch. Có sẵn dưới dạng một điểm cuối chuyên dụng trên nền tảng Anthropic (/v1/organizations/usage_report/claude_code), nó được thiết kế cho các tổ chức sử dụng Claude Code để mở rộng nỗ lực phát triển của họ. Với **Claude Code Analytics API**, bạn có thể trả lời các câu hỏi quan trọng như: Các nhà phát triển có đang tận dụng tối đa Claude Code không? Họ đang sử dụng công cụ nào nhiều nhất? Chúng ta đang chi bao nhiêu cho các mô hình AI? Mức độ hiểu biết này là vô giá để điều chỉnh việc áp dụng AI với các mục tiêu kinh doanh.

API Phân tích Mã Claude

Các tính năng và khả năng cốt lõi của API phân tích của Claude

Điều gì làm cho **Claude Code Analytics API** trở nên nổi bật? Nó được tích hợp nhiều tính năng phục vụ cả nhu cầu kỹ thuật và kinh doanh. Dưới đây là tóm tắt:

Những tính năng này biến **Claude Code Analytics API** thành một công cụ mạnh mẽ để hiểu và tối ưu hóa việc sử dụng Claude Code, dù bạn đang quản lý một nhóm nhỏ hay một doanh nghiệp lớn.

Chi tiết kỹ thuật và cách sử dụng

Bạn đã sẵn sàng bắt tay vào sử dụng **Claude Code Analytics API** chưa? Đây là một API REST, vì vậy rất dễ sử dụng nếu bạn quen thuộc với các yêu cầu HTTP. Điểm cuối là /v1/organizations/usage_report/claude_code, và bạn sẽ cần một khóa API quản trị (bắt đầu bằng sk-ant-admin...) để truy cập. Bạn có thể tạo khóa này trong Bảng điều khiển Anthropic dưới mục Cài đặt > Khóa API, nhưng chỉ quản trị viên mới có thể làm điều này—vì vậy hãy đảm bảo tổ chức của bạn được thiết lập trong Bảng điều khiển > Cài đặt > Tổ chức.

Dưới đây là một ví dụ nhanh để lấy phân tích cho một ngày cụ thể bằng curl:

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08&limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY" \
  --header "User-Agent: MyApp/1.0.0 (https://myapp.com)"

Hãy cùng phân tích:

Phản hồi là một đối tượng JSON với các trường như user_id, sessions, lines_added, lines_removed, commits, tool_usage và cost_usd, cung cấp cho bạn một cái nhìn chi tiết về hoạt động. Để biết chi tiết đầy đủ về schema, hãy kiểm tra tài liệu tham khảo API của Anthropic tại docs.anthropic.com.

Kiểm thử điểm cuối API với Apidog

Trước khi tích hợp **Claude Code Analytics API** vào quy trình làm việc của bạn, việc kiểm thử các điểm cuối API là một bước thông minh để đảm bảo mọi thứ hoạt động trơn tru. Đó là lúc Apidog phát huy tác dụng—một công cụ tuyệt vời để thiết kế, kiểm thử và gỡ lỗi API. Apidog đặc biệt hữu ích cho các nhà phát triển làm việc trên các dự án dựa vào API như Claude Code Analytics. Đây là cách bạn có thể sử dụng nó:

nút
sử dụng apidog để kiểm thử các điểm cuối api

Kiểm thử với Apidog đảm bảo tích hợp **Claude Code Analytics API** của bạn vững chắc, giúp bạn tránh khỏi những bất ngờ khi mở rộng sang các bảng điều khiển hoặc công cụ báo cáo. Đây là điều bắt buộc đối với bất kỳ dự án nào liên quan đến phân tích dựa trên API.

Bảng điều khiển do cộng đồng xây dựng với Claude Code Analytics API

Claude Code Analytics API đã khơi dậy sự sáng tạo trong cộng đồng nhà phát triển, dẫn đến việc tạo ra các bảng điều khiển tùy chỉnh để trực quan hóa việc sử dụng. Một ví dụ điển hình là dự án **Claude Code Templates**, một bảng điều khiển mã nguồn mở chạy cục bộ để giám sát tất cả các phiên Claude Code của bạn trong thời gian thực.

Bắt đầu: Cài đặt và chạy trực tiếp bằng lệnh npx claude-code-templates@latest --analytics. Thao tác này sẽ khởi động một bảng điều khiển cục bộ tại localhost:3333—đảm bảo không có dữ liệu nào rời khỏi máy của bạn. Bảng điều khiển có các biểu đồ sử dụng token, phân tích hoạt động dự án và khả năng xuất dữ liệu. Đây là một công cụ mạnh mẽ để các nhà phát triển có được những hiểu biết tức thì, riêng tư về các mẫu quy trình làm việc AI và chi phí của họ.

Bảng điều khiển do cộng đồng xây dựng với Claude Code Analytics API

Các dự án cộng đồng này cho thấy **Claude Code Analytics API** linh hoạt như thế nào. Bạn có thể triển khai các bảng điều khiển này trên máy chủ của mình hoặc các nền tảng đám mây như Vercel hoặc Render, cung cấp cho nhóm của bạn thông tin chi tiết theo thời gian thực về việc sử dụng Claude Code.

Tích hợp và Trải nghiệm nhà phát triển

**Claude Code Analytics API** được thiết kế để tích hợp liền mạch. Bản chất RESTful và phản hồi JSON nhất quán của nó giúp dễ dàng kết nối vào các bảng điều khiển, hệ thống thanh toán hoặc công cụ tùy chỉnh. Dưới đây là cách bạn có thể tận dụng nó:

Ví dụ, một tập lệnh Python để lấy và xử lý dữ liệu có thể trông như thế này:

import requests

def fetch_claude_analytics(api_key, date, limit=20, cursor=None):
    url = "https://api.anthropic.com/v1/organizations/usage_report/claude_code"
    headers = {
        "anthropic-version": "2023-06-01",
        "x-api-key": api_key,
        "User-Agent": "MyApp/1.0.0 (https://myapp.com)"
    }
    params = {"starting_at": date, "limit": limit}
    if cursor:
        params["cursor"] = cursor
    
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()

# Example usage
api_key = "your-admin-api-key"
data = fetch_claude_analytics(api_key, "2025-09-08")
for record in data["records"]:
    print(f"User: {record['user_id']}, Sessions: {record['sessions']}, Cost: ${record['cost_usd']:.2f}")

Tập lệnh này lấy dữ liệu cho một ngày nhất định và in ra các chỉ số chính. Bạn có thể mở rộng nó để lưu trữ kết quả vào cơ sở dữ liệu hoặc tạo biểu đồ cho nhóm của mình.

Những hạn chế và cân nhắc của API phân tích của Claude

Mặc dù **Claude Code Analytics API** rất mạnh mẽ, nhưng nó có một vài điểm cần lưu ý:

Những cân nhắc này không làm giảm giá trị của API mà giúp bạn lập kế hoạch sử dụng nó một cách hiệu quả.

Kết luận

**Claude Code Analytics API** là công cụ không thể thiếu đối với các tổ chức đang áp dụng lập trình được hỗ trợ bởi AI với Claude Code. Nó cung cấp khả năng hiển thị vô song về hoạt động, năng suất và chi phí của nhà phát triển, biến nó thành nền tảng cho các quyết định dựa trên dữ liệu. Dù bạn đang xây dựng bảng điều khiển, tối ưu hóa ngân sách hay biện minh cho các khoản đầu tư AI, API này đều cung cấp những thông tin chi tiết bạn cần. Cam kết về tính minh bạch của Anthropic tỏa sáng, và với những cải tiến tiềm năng trong tương lai—như dữ liệu thời gian thực hoặc tích hợp sâu hơn—**Claude Code Analytics API** được thiết lập để phát triển hơn nữa. Vì vậy, hãy lấy khóa API của bạn, khởi động lệnh curl và bắt đầu khai thác toàn bộ tiềm năng sử dụng Claude Code của nhóm bạn ngay hôm nay!

nút
tải apidog

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống