Claude Code Analytics API

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

이 API를 통해 Claude Code 채택을 더 잘 모니터링, 분석 및 최적화할 수 있습니다:

• 개발자 생산성 분석: Claude Code를 사용하여 생성된 세션, 추가/제거된 코드 라인, 커밋 및 풀 요청 추적
• 도구 사용 메트릭: 다양한 Claude Code 도구(Edit, 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 고객용, 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는 많은 수의 사용자가 있는 조직을 위해 커서 기반 페이지 매김을 지원합니다:

1. 선택적 limit 매개변수를 사용하여 초기 요청 수행
2. 응답에서 has_more이 true이면 다음 요청에서 next_page 값 사용
3. 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를 사용한 사용 모니터링 - 사용자 정의 메트릭 및 경고