관리 및 모니터링

Claude Code Analytics API

Claude Code Analytics Admin API를 사용하여 조직의 Claude Code 사용 분석 및 생산성 메트릭에 프로그래밍 방식으로 액세스합니다.

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 도구 비교: 메트릭을 내보내 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 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%입니다.

date 매개변수에 어떤 시간대가 사용되나요?

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

참고 항목

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

Admin API 개요
Admin API 참조
Claude Code Analytics 대시보드
사용량 및 비용 API - Anthropic 서비스 전체의 API 사용량 추적
Identity and access management
OpenTelemetry를 사용한 사용량 모니터링 - 사용자 정의 메트릭 및 경고

관리 및 모니터링

Claude Code Analytics API

Claude Code Analytics Admin API를 사용하여 조직의 Claude Code 사용 분석 및 생산성 메트릭에 프로그래밍 방식으로 액세스합니다.

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

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

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

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 도구 비교: 메트릭을 내보내 Claude Code와 Copilot, Cursor 같은 다른 AI 코딩 도구 비교
개발자 생산성 분석: 시간 경과에 따른 개별 및 팀 생산성 메트릭 추적
비용 추적 및 할당: 지출 패턴 모니터링 및 팀 또는 프로젝트별 비용 할당
도입 모니터링: Claude Code에서 가장 많은 가치를 얻고 있는 팀과 사용자 식별
ROI 정당화: Claude Code 도입을 정당화하고 확대하기 위한 구체적인 메트릭 제공

자주 묻는 질문

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

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

아니오, 이 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%입니다.

date 매개변수에 어떤 시간대가 사용되나요?

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

참고 항목

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

Admin API 개요
Admin API 참조
Claude Code Analytics 대시보드
사용량 및 비용 API - Anthropic 서비스 전체의 API 사용량 추적
Identity and access management
OpenTelemetry를 사용한 사용량 모니터링 - 사용자 정의 메트릭 및 경고