관리자모니터링

Analytics API

Copy page



조직에 필요한 분석 API와 API 키가 무엇인지 이해한 다음, Claude Code 생산성 지표 또는 Claude Enterprise 참여 및 도입 데이터에 대한 액세스를 프로비저닝하세요.

Anthropic은 두 가지 분석 API를 제공하며, 어느 것을 사용할지는 조직이 관리하는 Claude 제품에 따라 달라집니다:

• Claude Code Analytics API는 Claude Platform을 사용하는 조직을 위해 일별 Claude Code 생산성 지표를 보고합니다. 이는 Admin API의 일부이며 Admin API 키를 사용합니다.
• Claude Enterprise Analytics API는 Claude Enterprise 조직을 위해 Claude 제품 전반(채팅, 프로젝트, Claude Code 등)에 걸친 조직 전체의 참여, 도입 및 비용 데이터를 보고합니다. 이는 claude.ai에서 생성한 Analytics API 키를 사용합니다.

두 API는 서로 다른 역할이 서로 다른 위치에서 생성하는 서로 다른 키 유형을 사용합니다. 이 페이지에서는 어떤 API가 조직에 적합한지, 그리고 올바른 키를 생성하는 방법을 설명합니다.

어떤 API가 필요한가요?

키 유형은 서로 호환되지 않습니다. Admin API 키로는 Claude Enterprise Analytics API를 호출할 수 없으며, Analytics API 키로는 Admin API를 호출할 수 없습니다. 두 API 모두 Admin API 레퍼런스 아래에 표시되지만, 별도의 키 유형을 가진 별도의 API입니다. 조직에서 Claude Platform과 Claude Enterprise를 모두 사용하는 경우, 두 키를 모두 프로비저닝하고 각 API를 해당 데이터에 사용할 수 있습니다.

Claude Code Analytics API 액세스 얻기

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

1. 1

   Admin API 키 생성

   Admin API 키 생성의 단계를 따르세요.

2. 2

   API 호출

   x-api-key 헤더에 키를 전달하세요:

   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: $ANTHROPIC_ADMIN_KEY"

   

사용 가능한 지표, 요청 매개변수 및 응답 스키마는 Claude Code Analytics API 가이드와 API 레퍼런스를 참조하세요.

Claude Enterprise Analytics API 액세스 얻기

Claude Enterprise Analytics API는 Claude Enterprise 조직에서 사용할 수 있습니다. 참여 및 도입 데이터는 모든 Enterprise 플랜에서 사용할 수 있습니다. 비용 및 사용량 엔드포인트는 사용량 기반 Enterprise 플랜에 적용되며, 시트 기반 Enterprise 플랜의 경우 사용량 크레딧만 반영합니다.

1. 1

   기본 소유자로 로그인

   조직의 기본 소유자만 API 액세스를 활성화하고 Analytics API 키를 생성할 수 있습니다.

2. 2

   API 액세스 활성화 및 키 생성

   claude.ai > Organization settings > API로 이동하여 공개 API 액세스를 활성화한 다음 Analytics API 키를 생성하세요. 키에는 read:analytics 범위가 부여됩니다. 표시된 시크릿을 복사하여 시크릿 관리자에 저장하세요.

3. 3

   API 호출

   x-api-key 헤더에 키를 전달하고, 모든 요청에 anthropic-version 헤더를 포함하세요. 엔드포인트는 https://api.anthropic.com/v1/organizations/analytics/ 아래에 있습니다. 요청 예시, 매개변수 및 응답 스키마에 대해서는 Claude Enterprise Analytics API 레퍼런스를 참조하세요.

Claude Enterprise Analytics API는 다음을 제공합니다:

• 사용자 활동: 채팅(대화, 메시지, 프로젝트, 파일, 아티팩트), Claude Code(세션, 커밋, 풀 리퀘스트, 코드 라인 수, 도구 작업) 및 기타 Claude 제품 전반에 걸친 사용자별 일별 지표
• 활동 요약: 조직 수준의 일별, 주별, 월별 활성 사용자, 시트 수 및 대기 중인 초대
• 프로젝트, 스킬 및 커넥터 사용량: 채팅 프로젝트, 스킬 및 커넥터에 대한 도입 세부 내역
• 비용 및 사용량 보고서: 시간 경과에 따른 사용자별 및 조직 수준의 토큰 사용량과 비용(사용량 기반 Enterprise 플랜)

엔드포인트 세부 정보, 매개변수 및 응답 스키마는 Claude Enterprise Analytics API 레퍼런스를 참조하세요. 다음 섹션에서는 해당 엔드포인트 전반에 적용되는 데이터 최신성, 지표 정의 및 운영 지침을 다룹니다.

데이터 가용성 및 최신성

Claude Enterprise Analytics API 데이터는 2026년 1월 1일 이후 날짜에 대해 사용할 수 있습니다.

참여 및 도입 엔드포인트(사용자 활동, 요약, 프로젝트, 스킬, 커넥터)는 지정한 날짜의 일별 스냅샷을 반환합니다. 특정 날짜의 데이터는 일반적으로 다음 날 약 17:00 UTC부터 제공되며(1일 지연), 그 전까지는 가장 최근에 제공되는 날짜가 보통 현재 UTC 날짜보다 이틀 전입니다. 데이터가 더 늦게 도착하는 경우도 있으며 정확한 최신성은 쿼리에 따라 다르므로, 고정된 시간을 가정하기보다는 오류 응답을 확인하세요. 아직 제공되지 않는 날짜를 요청하면 가장 최근에 제공되는 날짜를 명시한 400 오류가 반환됩니다. 일반적인 지연 시간을 훨씬 넘어서도 데이터가 제공되지 않는다면, 이는 대개 Anthropic 측의 데이터 파이프라인 장애를 의미합니다. 공백이 지속되면 지원팀에 문의하세요.

비용 및 사용량 엔드포인트는 다른 최신성 모델을 따릅니다. 데이터는 일반적으로 기반이 되는 사용 발생 후 4시간 이내에 사용할 수 있지만 최대 24시간이 걸릴 수 있습니다. 특정 날짜의 값은 지연된 이벤트가 도착하고 조정 작업이 실행됨에 따라 최대 30일 동안 수정될 수 있습니다. 청구서 수준의 합계가 필요한 경우 최소 30일 이전의 날짜를 쿼리하세요.

지표 정의 방식

활성 사용자. 다음 중 하나라도 해당하면 사용자는 해당 날짜에 활성 사용자로 집계됩니다: Claude에서 채팅 메시지를 하나 이상 보낸 경우, Claude Enterprise 조직과 연결된 Claude Code 세션(로컬 또는 원격) 중 도구 사용 또는 git 활동이 포함된 세션이 하나 이상 있는 경우, 또는 도구 사용이나 메시지 활동이 있는 Cowork 세션이 하나 이상 있는 경우.

제품별 지표 블록. 제품별 지표 객체(예: 사용자 활동 레코드의 Office Agent 또는 Cowork 지표)는 모든 레코드에 항상 존재합니다. 해당 제품을 사용하지 않는 조직에는 null 대신 모두 0인 값이 표시됩니다.

커넥터 이름. 커넥터 이름은 소스 전반에 걸쳐 정규화됩니다. 예를 들어 Atlassian MCP server, mcp-atlassian, atlassian_MCP는 모두 커넥터 사용량 엔드포인트에서 atlassian으로 표시됩니다.

API 사용하기

페이지네이션 커서는 이를 발급한 쿼리에 바인딩됩니다. 비용 및 사용량 엔드포인트에서는 시퀀스 중간에 쿼리 매개변수를 변경하지 마세요. products[], group_by[], order_by, 날짜 범위 또는 필터를 변경하고 이전 커서를 전달하면 요청은 400 오류를 반환합니다. 매개변수를 변경하려면 커서 없이 첫 페이지부터 다시 시작하세요.

목록 매개변수는 대괄호 표기법을 사용합니다. 각 값에 대해 매개변수를 반복하세요. 예: products[]=chat&products[]=claude_code.

금액 필드는 센트 단위의 십진수 문자열입니다. 통화 금액은 "41280.000000"($412.80을 나타냄)과 같은 십진수 문자열로 반환됩니다. 달러로 변환하려면 십진수로 파싱한 후 100으로 나누세요. 수백만 달러를 초과할 수 있는 값에는 이진 부동소수점 파싱을 피하세요.

속도 제한은 조직 수준에서 적용되며, 키별로 적용되지 않습니다. 이 API의 모든 엔드포인트에 걸쳐 기본값은 분당 60개 요청입니다. 사용 사례에 충분하지 않은 경우 Anthropic 계정 팀에 문의하여 제한 조정을 논의하세요.

버전 관리

모든 요청에 anthropic-version 헤더를 보내세요. 사용 가능한 버전은 API 버전을 참조하세요.

알려진 제한 사항

조직에서 Amazon Bedrock을 통해 Claude Code를 사용하는 경우, Claude Enterprise Analytics API는 해당 사용에 대한 Claude Code 활동을 반환하지 않습니다.

다음 단계