---
title: Claude Code Analytics API
url: https://platform.claude.com/docs/ko/manage-claude/claude-code-analytics-api
description: Claude Code Analytics Admin API를 사용하여 조직의 Claude Code 사용량 분석 및 생산성 지표에 프로그래밍 방식으로 액세스하세요.
---
**Admin API는 개인 계정에서는 사용할 수 없습니다.** 팀원과 협업하고 멤버를 추가하려면 Claude Console의 [Organization](https://platform.claude.com/settings/organization) 페이지(`platform.claude.com/settings/organization`)에서 조직을 설정하세요.
Claude Code Analytics Admin API는 Claude Code 사용자의 일별 집계 사용량 지표에 대한 프로그래밍 방식의 액세스를 제공하여, 조직이 개발자 생산성을 분석하고 맞춤형 대시보드를 구축할 수 있도록 합니다. 이 API는 OpenTelemetry 통합의 복잡성 없이 기본 [Analytics 대시보드](https://platform.claude.com/claude-code)보다 더 자세한 정보를 제공합니다.
이 API를 사용하면 Claude Code 도입을 더 효과적으로 모니터링, 분석 및 최적화할 수 있습니다:
* **개발자 생산성 분석:** Claude Code를 사용하여 생성된 세션, 추가/삭제된 코드 라인 수, 커밋 및 풀 리퀘스트를 추적합니다
* **도구 사용 지표:** 다양한 Claude Code 도구(Edit, MultiEdit, Write, NotebookEdit)의 수락률 및 거부율을 모니터링합니다
* **비용 분석:** Claude 모델별로 분류된 예상 비용 및 토큰 사용량을 확인합니다
* **맞춤형 보고:** 데이터를 내보내 경영진을 위한 임원용 대시보드 및 보고서를 구축합니다
* **사용 정당화:** 내부적으로 Claude Code 도입을 정당화하고 확대하기 위한 지표를 제공합니다
**Admin API 자격 증명이 필요합니다.** 이 엔드포인트들은 Admin API의 일부입니다. [Admin API 키](https://platform.claude.com/docs/ko/manage-claude/admin-api-keys), `org:admin` 범위를 가진 OAuth 토큰, 또는 워크스페이스로 범위가 제한되지 않은 개인 또는 서비스 계정 키를 사용하여 접근할 수 있습니다. 워크스페이스 API 키는 작동하지 않습니다. 자세한 내용은 [인증](https://platform.claude.com/docs/ko/manage-claude/admin-api#authentication)을 참조하세요.
**Claude Platform on AWS:** Claude Code Analytics API는 현재 사용할 수 없습니다. 대신 Claude Console의 **Usage** 페이지에서 Claude Code 사용량을 확인하세요.
**Claude Enterprise 조직:** claude.ai 사용자의 Claude Code 활동은 Claude Enterprise Analytics API를 통해 보고되며, 이 API는 Admin API 키 대신 Analytics API 키를 사용합니다. 조직에 필요한 API 및 키 유형을 확인하려면 [Analytics API](https://platform.claude.com/docs/ko/manage-claude/analytics-api)를 참조하세요.
## 빠른 시작
특정 날짜에 대한 조직의 Claude Code 분석 데이터를 가져옵니다:
```bash cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
**통합을 위한 User-Agent 헤더 설정**
통합을 구축하는 경우, Anthropic이 사용 패턴을 이해할 수 있도록 User-Agent 헤더를 설정하세요:
```text wrap
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 레퍼런스](https://platform.claude.com/docs/ko/api/beta/organization/usage_report/retrieve_claude_code)를 참조하세요.
### 기본 예제
#### 특정 날짜의 분석 데이터 가져오기
```bash cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
#### 페이지네이션을 사용하여 분석 데이터 가져오기
```bash cURL
# 첫 번째 요청
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# 응답에서 받은 커서를 사용하는 후속 요청
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
### 요청 매개변수
| 매개변수 | 타입 | 필수 | 설명 |
| ------------- | ------- | --- | -------------------------------------------- |
| `starting_at` | string | 예 | YYYY-MM-DD 형식의 UTC 날짜. 이 단일 날짜에 대한 지표만 반환합니다 |
| `limit` | integer | 아니요 | 페이지당 레코드 수(기본값: 20, 최대: 1000) |
| `page` | string | 아니요 | 이전 응답의 `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`, 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-5`)
* **tokens.input/output:** 이 모델의 입력 및 출력 토큰 수
* **tokens.cache\_read/cache\_creation:** 이 모델의 캐시 관련 토큰 사용량
* **estimated\_cost.amount:** 이 모델의 예상 비용(USD 센트 단위)
* **estimated\_cost.currency:** 비용 금액의 통화 코드(현재는 항상 `USD`)
### 응답 구조
API는 다음 형식으로 데이터를 반환합니다:
```json
{
"data": [
{
"date": "2025-09-08T00:00:00Z",
"actor": {
"type": "user_actor",
"email_address": "developer@company.com"
},
"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-5-5",
"tokens": {
"input": 100000,
"output": 35000,
"cache_read": 10000,
"cache_creation": 5000
},
"estimated_cost": {
"currency": "USD",
"amount": 113
}
}
]
}
],
"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 통합](https://code.claude.com/docs/en/monitoring-usage) 사용을 고려하세요.
### 데이터에서 사용자는 어떻게 식별되나요?
사용자는 `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 사용량만 추적합니다. [Amazon Bedrock의 Claude](https://platform.claude.com/docs/ko/build-with-claude/claude-in-amazon-bedrock), [Microsoft Foundry의 Claude](https://platform.claude.com/docs/ko/build-with-claude/claude-in-microsoft-foundry), [Google Cloud의 Claude](https://platform.claude.com/docs/ko/build-with-claude/claude-on-vertex-ai) 또는 [Claude Platform on AWS](https://platform.claude.com/docs/ko/build-with-claude/claude-platform-on-aws)를 통한 사용량은 포함되지 않습니다.
### 이 API를 사용하는 데 비용이 얼마나 드나요?
Claude Code Analytics API는 Admin API에 액세스할 수 있는 모든 조직에서 무료로 사용할 수 있습니다.
### 도구 수락률은 어떻게 계산하나요?
도구 수락률 = 각 도구 유형에 대해 `accepted / (accepted + rejected)`입니다. 예를 들어, edit 도구가 45건 수락, 5건 거부를 나타내면 수락률은 90%입니다.
### date 매개변수에는 어떤 시간대가 사용되나요?
모든 날짜는 UTC 기준입니다. `starting_at` 매개변수는 YYYY-MM-DD 형식이어야 하며 해당 날짜의 UTC 자정을 나타냅니다.
## 참고 항목
Claude Code Analytics API는 팀의 개발 워크플로를 이해하고 최적화하는 데 도움이 됩니다. 관련 기능에 대해 자세히 알아보세요:
* [Admin API](https://platform.claude.com/docs/ko/manage-claude/admin-api)
* [Admin API 레퍼런스](https://platform.claude.com/docs/ko/api/beta/organization)
* [Claude Code Analytics 대시보드](https://platform.claude.com/claude-code)
* [Usage and Cost API](https://platform.claude.com/docs/ko/manage-claude/usage-cost-api) - 모든 Anthropic 서비스 전반의 API 사용량 추적
* [Compliance API](https://platform.claude.com/docs/ko/manage-claude/compliance-api) - 감사 및 활동 데이터 조회
* [ID 및 액세스 관리](https://code.claude.com/docs/en/iam)
* 맞춤형 지표 및 알림을 위한 [OpenTelemetry를 사용한 사용량 모니터링](https://code.claude.com/docs/en/monitoring-usage)