Claude Code Analytics API

Claude Code Analytics Admin API는 Claude Code 사용자의 일일 집계 사용량 지표에 대한 프로그래밍 방식의 액세스를 제공하여, 조직이 개발자 생산성을 분석하고 맞춤형 대시보드를 구축할 수 있도록 지원합니다. 이 API는 기본 Analytics 대시보드와 복잡한 OpenTelemetry 통합 사이의 간극을 메웁니다.

이 API를 통해 Claude Code 도입을 더 효과적으로 모니터링, 분석 및 최적화할 수 있습니다:

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

빠른 시작

특정 날짜에 대한 조직의 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: 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"

요청 매개변수

사용 가능한 지표

각 응답 레코드에는 단일 날짜의 단일 사용자에 대한 다음 지표가 포함됩니다:

차원

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

핵심 지표

• num_sessions: 이 actor가 시작한 고유 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 도구 제안 수
• multi_edit_tool.accepted/rejected: 사용자가 수락/거부한 MultiEdit 도구 제안 수
• write_tool.accepted/rejected: 사용자가 수락/거부한 Write 도구 제안 수
• notebook_edit_tool.accepted/rejected: 사용자가 수락/거부한 NotebookEdit 도구 제안 수

모델별 분류

사용된 각 Claude 모델에 대해:

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

응답 구조

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

{
  "data": [
    {
      "date": "2025-09-08T00: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-opus-4-8",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

페이지네이션

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

1. 선택적 limit 매개변수와 함께 초기 요청을 보냅니다
2. 응답에서 has_more가 true인 경우, 다음 요청에서 next_page 값을 사용합니다
3. has_more가 false가 될 때까지 계속합니다

커서는 마지막 레코드의 위치를 인코딩하며, 새 데이터가 도착하더라도 안정적인 페이지네이션을 보장합니다. 각 페이지네이션 세션은 일관된 데이터 경계를 유지하여 레코드가 누락되거나 중복되지 않도록 합니다.

일반적인 사용 사례

• 경영진 대시보드: 개발 속도에 대한 Claude Code의 영향을 보여주는 고수준 보고서를 생성합니다
• AI 도구 비교: 지표를 내보내 Claude Code를 Copilot 및 Cursor와 같은 다른 AI 코딩 도구와 비교합니다
• 개발자 생산성 분석: 시간 경과에 따른 개인 및 팀 생산성 지표를 추적합니다
• 비용 추적 및 할당: 지출 패턴을 모니터링하고 팀 또는 프로젝트별로 비용을 할당합니다
• 도입 모니터링: 어떤 팀과 사용자가 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)에서 발생한 것인지 subscription 고객(Pro/Team 플랜)에서 발생한 것인지를 나타냅니다.

데이터 보존 기간은 어떻게 됩니까?

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

어떤 Claude Code 배포가 지원됩니까?

이 API는 Claude API에서의 Claude Code 사용량만 추적합니다. AWS의 Claude Platform, Microsoft Foundry의 Claude, Amazon Bedrock의 Claude 또는 Vertex AI의 Claude를 통한 사용량은 포함되지 않습니다.

이 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 대시보드
• Usage and Cost API - 모든 Anthropic 서비스에서 API 사용량 추적
• Compliance API - 감사 및 활동 데이터 검색
• ID 및 액세스 관리
• 맞춤형 지표 및 알림을 위한 OpenTelemetry로 사용량 모니터링