Analytics API

Anthropic은 두 가지 Analytics 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에 액세스할 수 있는 모든 조직에서 사용할 수 있으며 무료입니다.

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



Claude Enterprise Analytics API 액세스 얻기

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

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

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

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



데이터 가용성 및 최신성

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

참여 및 도입 엔드포인트(사용자 활동, 요약, 프로젝트, 스킬, 커넥터)는 지정한 날짜에 대한 일별 스냅샷을 반환합니다. 특정 날짜의 데이터는 다음 날 10

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



지표 정의 방식

활성 사용자. 다음 중 하나라도 해당하면 사용자는 해당 날짜에 활성으로 간주됩니다: Claude에서 채팅 메시지를 하나 이상 보냈거나, 도구 사용 또는 git 활동이 포함된 Claude Enterprise 조직과 연결된 Claude Code 세션(로컬 또는 원격)이 하나 이상 있었거나, 도구 사용 또는 메시지 활동이 포함된 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 계정 팀에 문의하여 제한 조정에 대해 논의하세요.



알려진 제한 사항

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



다음 단계