Claude Code Analytics API

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

Claude Code Analytics Admin API는 Claude Code 사용자의 일일 집계 사용 메트릭에 대한 프로그래밍 방식의 액세스를 제공하여 조직이 개발자 생산성을 분석하고 사용자 정의 대시보드를 구축할 수 있도록 합니다. 이 API는 기본 Analytics 대시보드와 복잡한 OpenTelemetry 통합 사이의 격차를 메웁니다. 이 API를 통해 Claude Code 채택을 더 잘 모니터링, 분석 및 최적화할 수 있습니다:

개발자 생산성 분석: Claude Code를 사용하여 생성된 세션, 추가/제거된 코드 라인, 커밋 및 풀 요청 추적
도구 사용 메트릭: 다양한 Claude Code 도구(Edit, Write, NotebookEdit)의 수락 및 거부율 모니터링
비용 분석: Claude 모델별로 분류된 예상 비용 및 토큰 사용량 확인
사용자 정의 보고: 데이터를 내보내 경영진 대시보드 및 관리 팀용 보고서 구축
사용 정당화: Claude Code 채택을 내부적으로 정당화하고 확대하기 위한 메트릭 제공

Admin API 키 필수이 API는 Admin API의 일부입니다. 이 엔드포인트는 표준 API 키와 다른 Admin API 키(sk-ant-admin...로 시작)가 필요합니다. 관리자 역할을 가진 조직 구성원만 Claude Console을 통해 Admin API 키를 프로비저닝할 수 있습니다.

빠른 시작

특정 날짜에 대한 조직의 Claude Code 분석 데이터 가져오기:

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"

통합을 위해 User-Agent 헤더 설정통합을 구축하는 경우 User-Agent 헤더를 설정하여 사용 패턴을 파악하는 데 도움을 주세요:

User-Agent: YourApp/1.0.0 (https://yourapp.com)

Claude Code Analytics API

/v1/organizations/usage_report/claude_code 엔드포인트를 사용하여 조직 전체의 Claude Code 사용, 생산성 메트릭 및 개발자 활동을 추적하세요.

주요 개념

일일 집계: starting_at 매개변수로 지정된 단일 날짜에 대한 메트릭 반환
사용자 수준 데이터: 각 레코드는 지정된 날짜에 대한 한 사용자의 활동을 나타냄
생산성 메트릭: 세션, 코드 라인, 커밋, 풀 요청 및 도구 사용 추적
토큰 및 비용 데이터: Claude 모델별로 분류된 사용량 및 예상 비용 모니터링
커서 기반 페이지 매김: 불투명한 커서를 사용한 안정적인 페이지 매김으로 대규모 데이터 세트 처리
데이터 신선도: 메트릭은 일관성을 위해 최대 1시간의 지연으로 사용 가능

전체 매개변수 세부 정보 및 응답 스키마는 Claude Code Analytics API 참조를 참조하세요.

기본 예제

특정 날짜에 대한 분석 데이터 가져오기

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

페이지 매김을 사용하여 분석 데이터 가져오기

# 첫 번째 요청
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"

# 응답의 커서를 사용한 후속 요청
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

요청 매개변수

매개변수	유형	필수	설명
`starting_at`	문자열	예	YYYY-MM-DD 형식의 UTC 날짜. 이 단일 날짜에 대한 메트릭만 반환
`limit`	정수	아니오	페이지당 레코드 수(기본값: 20, 최대: 1000)
`page`	문자열	아니오	이전 응답의 `next_page` 필드의 불투명한 커서 토큰

사용 가능한 메트릭

각 응답 레코드는 단일 사용자의 단일 날짜에 대한 다음 메트릭을 포함합니다:

차원

date: RFC 3339 형식의 날짜(UTC 타임스탬프)
actor: Claude Code 작업을 수행한 사용자 또는 API 키(email_address가 있는 user_actor 또는 api_key_name이 있는 api_actor)
organization_id: 조직 UUID
customer_type: 고객 계정 유형(api API 고객용, subscription Pro/Team 고객용)
terminal_type: Claude Code가 사용된 터미널 또는 환경 유형(예: vscode, iTerm.app, tmux)

핵심 메트릭

num_sessions: 이 행위자가 시작한 고유 Claude Code 세션 수
lines_of_code.added: Claude Code에 의해 모든 파일에 추가된 총 코드 라인 수
lines_of_code.removed: Claude Code에 의해 모든 파일에서 제거된 총 코드 라인 수
commits_by_claude_code: Claude Code의 커밋 기능을 통해 생성된 git 커밋 수
pull_requests_by_claude_code: Claude Code의 PR 기능을 통해 생성된 풀 요청 수

도구 작업 메트릭

도구 유형별 도구 작업 수락 및 거부율 분석:

edit_tool.accepted/rejected: 사용자가 수락/거부한 Edit 도구 제안 수
write_tool.accepted/rejected: 사용자가 수락/거부한 Write 도구 제안 수
notebook_edit_tool.accepted/rejected: 사용자가 수락/거부한 NotebookEdit 도구 제안 수

모델 분석

사용된 각 Claude 모델에 대해:

model: Claude 모델 식별자(예: claude-sonnet-4-5-20250929)
tokens.input/output: 이 모델의 입력 및 출력 토큰 수
tokens.cache_read/cache_creation: 이 모델의 캐시 관련 토큰 사용량
estimated_cost.amount: 이 모델의 예상 비용(USD 센트)
estimated_cost.currency: 비용 금액의 통화 코드(현재 항상 USD)

응답 구조

API는 다음 형식으로 데이터를 반환합니다:

{
  "data": [
    {
      "date": "2025-09-01T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "[email protected]"
      },
      "organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
      "customer_type": "api",
      "terminal_type": "vscode",
      "core_metrics": {
        "num_sessions": 5,
        "lines_of_code": {
          "added": 1543,
          "removed": 892
        },
        "commits_by_claude_code": 12,
        "pull_requests_by_claude_code": 2
      },
      "tool_actions": {
        "edit_tool": {
          "accepted": 45,
          "rejected": 5
        },
        "multi_edit_tool": {
          "accepted": 12,
          "rejected": 2
        },
        "write_tool": {
          "accepted": 8,
          "rejected": 1
        },
        "notebook_edit_tool": {
          "accepted": 3,
          "rejected": 0
        }
      },
      "model_breakdown": [
        {
          "model": "claude-sonnet-4-5-20250929",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

페이지 매김

API는 많은 수의 사용자가 있는 조직을 위해 커서 기반 페이지 매김을 지원합니다:

선택적 limit 매개변수를 사용하여 초기 요청 수행
응답에서 has_more이 true이면 다음 요청에서 next_page 값 사용
has_more이 false가 될 때까지 계속

커서는 마지막 레코드의 위치를 인코딩하고 새 데이터가 도착해도 안정적인 페이지 매김을 보장합니다. 각 페이지 매김 세션은 일관된 데이터 경계를 유지하여 레코드를 놓치거나 중복하지 않도록 합니다.

일반적인 사용 사례

경영진 대시보드: Claude Code가 개발 속도에 미치는 영향을 보여주는 고수준 보고서 작성
AI 도구 비교: Copilot 및 Cursor와 같은 다른 AI 코딩 도구와 Claude Code를 비교하기 위해 메트릭 내보내기
개발자 생산성 분석: 시간 경과에 따른 개별 및 팀 생산성 메트릭 추적
비용 추적 및 할당: 지출 패턴 모니터링 및 팀 또는 프로젝트별 비용 할당
채택 모니터링: Claude Code에서 가장 많은 가치를 얻고 있는 팀 및 사용자 식별
ROI 정당화: Claude Code 채택을 정당화하고 내부적으로 확대하기 위한 구체적인 메트릭 제공

자주 묻는 질문

분석 데이터는 얼마나 최신인가요?

Claude Code 분석 데이터는 일반적으로 사용자 활동 완료 후 1시간 이내에 나타납니다. 일관된 페이지 매김 결과를 보장하기 위해 1시간 이상 된 데이터만 응답에 포함됩니다.

실시간 메트릭을 얻을 수 있나요?

아니오, 이 API는 일일 집계 메트릭만 제공합니다. 실시간 모니터링을 위해 OpenTelemetry 통합을 사용하는 것을 고려하세요.

데이터에서 사용자는 어떻게 식별되나요?

사용자는 actor 필드를 통해 두 가지 방식으로 식별됩니다:

user_actor: OAuth를 통해 인증하는 사용자의 email_address 포함(가장 일반적)
api_actor: API 키를 통해 인증하는 사용자의 api_key_name 포함

customer_type 필드는 사용량이 api 고객(API PAYG)인지 subscription 고객(Pro/Team 플랜)인지 나타냅니다.

데이터 보존 기간은 어떻게 되나요?

과거 Claude Code 분석 데이터는 API를 통해 보존되고 액세스할 수 있습니다. 이 데이터에 대한 지정된 삭제 기간은 없습니다.

어떤 Claude Code 배포가 지원되나요?

이 API는 Claude API(1차)에서의 Claude Code 사용만 추적합니다. Amazon Bedrock, Google Vertex AI 또는 기타 타사 플랫폼에서의 사용은 포함되지 않습니다.

이 API를 사용하는 데 비용이 드나요?

Claude Code Analytics API는 Admin API에 액세스할 수 있는 모든 조직에서 무료로 사용할 수 있습니다.

도구 수락률을 계산하려면 어떻게 하나요?

도구 수락률 = 각 도구 유형에 대해 accepted / (accepted + rejected)입니다. 예를 들어, edit 도구가 45개 수락 및 5개 거부를 표시하면 수락률은 90%입니다.

날짜 매개변수에 사용되는 시간대는 무엇인가요?

모든 날짜는 UTC입니다. starting_at 매개변수는 YYYY-MM-DD 형식이어야 하며 해당 날짜의 UTC 자정을 나타냅니다.

참고 항목

Claude Code Analytics API는 팀의 개발 워크플로우를 이해하고 최적화하는 데 도움이 됩니다. 관련 기능에 대해 자세히 알아보세요:

Admin API 개요
Admin API 참조
Claude Code Analytics 대시보드
사용 및 비용 API - Anthropic의 모든 서비스에서 API 사용 추적
ID 및 액세스 관리
OpenTelemetry를 사용한 사용 모니터링 - 사용자 정의 메트릭 및 경고

​빠른 시작

​Claude Code Analytics API

​주요 개념

​기본 예제

​특정 날짜에 대한 분석 데이터 가져오기

​페이지 매김을 사용하여 분석 데이터 가져오기

​요청 매개변수

​사용 가능한 메트릭

​차원

​핵심 메트릭

​도구 작업 메트릭

​모델 분석

​응답 구조

​페이지 매김

​일반적인 사용 사례

​자주 묻는 질문

​분석 데이터는 얼마나 최신인가요?

​실시간 메트릭을 얻을 수 있나요?

​데이터에서 사용자는 어떻게 식별되나요?

​데이터 보존 기간은 어떻게 되나요?

​어떤 Claude Code 배포가 지원되나요?

​이 API를 사용하는 데 비용이 드나요?

​도구 수락률을 계산하려면 어떻게 하나요?

​날짜 매개변수에 사용되는 시간대는 무엇인가요?

​참고 항목

빠른 시작

Claude Code Analytics API

주요 개념

기본 예제

특정 날짜에 대한 분석 데이터 가져오기

페이지 매김을 사용하여 분석 데이터 가져오기

요청 매개변수

사용 가능한 메트릭

차원

핵심 메트릭

도구 작업 메트릭

모델 분석

응답 구조

페이지 매김

일반적인 사용 사례

자주 묻는 질문

분석 데이터는 얼마나 최신인가요?

실시간 메트릭을 얻을 수 있나요?

데이터에서 사용자는 어떻게 식별되나요?

데이터 보존 기간은 어떻게 되나요?

어떤 Claude Code 배포가 지원되나요?

이 API를 사용하는 데 비용이 드나요?

도구 수락률을 계산하려면 어떻게 하나요?

날짜 매개변수에 사용되는 시간대는 무엇인가요?

참고 항목