Analytics API는 Enterprise 플랜의 Primary Owner에게 조직의 참여도, 채택률, 사용량 및 비용 데이터에 대한 프로그래밍 방식의 접근을 제공합니다. 이를 사용하여 내부 대시보드를 구축하고, 채택 추세를 추적하며, 월간 청구서에 대한 지출을 조정하고, Claude 데이터를 기존 보고 도구에 연결할 수 있습니다.
Analytics API는 Enterprise 플랜에서 사용할 수 있습니다. Primary Owner는 API 키를 생성하여 시작할 수 있습니다.
이것이 분석 대시보드 및 Compliance API와 어떻게 다른가요?
세 가지 옵션 모두 조직의 데이터에 대한 다양한 보기를 제공합니다:
Analytics 대시보드(Analytics를 통해 접근)는 제품에서 시각화된 사용 데이터를 표시합니다. 데이터를 다른 곳에 통합할 필요가 없을 때 일일 모니터링에 적합한 도구입니다.
Analytics API는 동일한 집계된 메트릭을 프로그래밍 방식으로 반환합니다. 따라서 BI 도구로 끌어올 수 있고, 조직도에 매핑하고, 보고 워크플로우를 자동화하며, 비용 데이터를 내부 기록과 조정할 수 있습니다. 참여도 및 채택 데이터는 조직별, 일별로 집계됩니다. 사용량 및 비용 데이터는 더 세분화된 사용자별 및 시간 단위 분석으로 사용할 수 있습니다.
Compliance API는 거버넌스 및 감사 사용 사례를 위한 것입니다. 개별 사용자 작업, 원본 활동 이벤트 및 대화 내용에 접근할 수 있습니다. 감사를 위한 원본 이벤트가 아닌 대시보드용 집계된 참여도 메트릭이 필요한 경우 Analytics API를 사용하세요.
시작하기
Analytics API에 접근하려면 Enterprise 조직에 대한 Primary Owner 접근 권한이 필요합니다.
다음 단계를 따르세요:
Analytics > API 키로 이동합니다.
Analytics API 아래의 접근 토글을 찾아 켭니다.
"+ 키 생성"을 클릭하여 새 API 키를 생성합니다. 이 키는 비공개로 유지하세요. 비밀번호처럼 취급하세요.
요청에서
x-api-key헤더와 함께 키를 사용합니다.
전체 인증 세부 정보, 엔드포인트 참조 및 코드 예제는 Claude Enterprise Analytics API 참조 가이드를 참조하세요.
어떤 데이터를 사용할 수 있나요?
Analytics API는 두 가지 범주에 걸쳐 9개의 엔드포인트를 포함합니다.
참여도 및 채택
이러한 엔드포인트는 조직별, 일별로 집계된 참여도 메트릭을 반환합니다. 데이터는 최대 지난 90일(2026년 1월 1일 이후)에 대해 사용할 수 있습니다.
사용자 활동: Claude 전체 표면에서의 사용자별 참여도 메트릭입니다. 대화 수, 전송된 메시지, 생성된 프로젝트, 업로드된 파일, 생성된 아티팩트, 사용된 스킬, 사용된 커넥터, 커밋, 풀 요청, 코드 라인 같은 Claude Code 메트릭, 시작된 세션, 도구 작업, 디스패치 턴, 스킬 및 커넥터 호출 같은 Cowork 메트릭을 포함합니다.
활동 요약: Claude, Claude Code 및 Cowork 전체의 조직 전체 일일, 주간 및 월간 활성 사용자 수와 좌석 사용률 및 대기 중인 초대 수입니다. 요청당 최대 31일의 날짜 범위를 지원합니다.
채팅 프로젝트 사용: Claude 프로젝트의 프로젝트별로 분류된 대화 및 사용자 수입니다.
스킬 사용: 각 스킬을 사용하는 사용자 수이며, Claude, Claude Code 및 Cowork 세션별로 분류됩니다.
커넥터 사용: 조직이 사용 중인 커넥터와 각 커넥터를 사용한 고유 사용자 수이며, Claude, Claude Code 및 Cowork 세션별로 분류됩니다.
사용량 및 비용
참고: 비용 및 사용량 엔드포인트는 사용량 기반 Enterprise 플랜에 적용됩니다. 좌석 기반 Enterprise 플랜의 경우 이러한 엔드포인트는 추가 사용량만 반영합니다.
이러한 엔드포인트(현재 베타로 사용 가능)는 Claude 전체 표면에서 토큰 사용량 및 USD 비용 데이터를 반환합니다. 이를 사용하여 월간 청구서 간 사용량을 추적하고, Anthropic 청구를 내부 비용 센터에 대해 조정하며, 실제 사용자 행동을 기반으로 지출 한도를 설정할 수 있습니다.
사용자별 토큰 사용량: 날짜 범위에 걸쳐 토큰 사용량으로 순위가 지정된 사용자이며, 제품, 모델, 컨텍스트 윈도우, 추론 영역 또는 속도별로 선택적으로 분류됩니다.
사용자별 비용: 날짜 범위에 걸쳐 USD 지출로 순위가 지정된 사용자이며, 제품, 모델, 비용 유형(토큰, 웹 검색, 코드 실행) 또는 토큰 유형별로 선택적으로 분류됩니다.
시간 경과에 따른 토큰 사용량: 분, 시간 또는 일 단위로 버킷된 토큰 사용량이며, 선택적으로 제품, 모델, 컨텍스트 윈도우, 추론 영역 또는 속도별로 분류됩니다.
시간 경과에 따른 비용: 분, 시간 또는 일 단위로 버킷된 USD 비용이며, 비용 유형 및 토큰 유형과 동일한 그룹화 옵션이 있습니다.
데이터는 4시간마다 새로 고쳐지며 최대 24시간이 걸릴 수 있습니다. 값은 늦은 이벤트가 조정되므로 최대 30일 동안 수정될 수 있으므로 청구 등급의 합계를 위해 최소 30일 전의 날짜를 쿼리하세요.
데이터 한도
참여도 및 채택 엔드포인트는 단일 날짜 또는 날짜 범위에 대한 데이터를 반환합니다. 데이터는 2026년 1월 1일 이후에만 사용할 수 있으며, 3일 이상 전의 날짜에 대해서만 사용할 수 있습니다.
사용량 및 비용 엔드포인트를 사용하면 최대 31일 윈도우를 쿼리할 수 있으며, 오늘부터 최대 365일까지 거슬러 올라갑니다. 청구 등급의 합계를 위해 최소 30일 전의 날짜를 쿼리하여 늦은 이벤트가 조정될 시간을 확보하세요.
API의 기본 속도 제한은 분당 60개 요청입니다. 이것이 조직의 요구를 충족하지 않으면 Anthropic 담당자 또는 영업팀에 문의하세요.
중요: Amazon Bedrock을 통해 Claude Code를 사용 중인 경우 Analytics API는 Claude Code와 관련된 데이터를 반환하지 않습니다.