Claude Enterprise Analytics API 참고 가이드

코드

의미

400

쿼리 매개변수가 유효하지 않습니다. 일반적인 원인으로는 유효하지 않은 날짜, 1/1/26 이전의 날짜(첫 번째 가용성), 오늘 또는 미래의 날짜, 또는 (비용 및 사용량 엔드포인트에서) 현재 쿼리 매개변수와 일치하지 않는 페이지 커서가 있습니다.

401

API 키가 누락되었거나 유효하지 않습니다(비용 및 사용량 엔드포인트).

404

API 키가 누락되었거나 유효하지 않거나 read:analytics 범위가 없습니다.

410

페이지 커서가 더 이상 유효하지 않습니다. 첫 번째 페이지에서 페이지 매김을 다시 시작하세요.

429

속도 제한 초과. 너무 많은 요청입니다.

500

내부 오류(비용 및 사용량 엔드포인트).

504

요청 시간 초과.

필드

유형

필수

설명

date

문자열

예

메트릭을 검색할 날짜(YYYY-MM-DD 형식).

limit

정수

아니오

페이지당 레코드 수(기본값: 20, 최대: 1000).

page

문자열

아니오

다음 페이지를 검색하기 위한 이전 응답의 next_page 필드의 커서 토큰.

필드

설명

user.id

사용자의 고유 식별자.

user.email_address

사용자의 이메일 주소.

chat_metrics.distinct_conversation_count

Claude.ai 내에서의 고유 대화 수.

chat_metrics.message_count

Claude.ai 내에서 전송된 총 메시지 수.

chat_metrics.distinct_projects_created_count

Claude.ai 내에서 생성된 고유 프로젝트 수.

chat_metrics.distinct_projects_used_count

Claude.ai 내에서 사용된 고유 프로젝트 수.

chat_metrics.distinct_files_uploaded_count

Claude.ai 내에서 업로드된 고유 파일 수.

chat_metrics.distinct_artifacts_created_count

Claude.ai 내에서 생성된 고유 아티팩트 수.

chat_metrics.distinct_shared_artifacts_viewed_count

Claude.ai 내에서 조회된 공유 아티팩트 수.

chat_metrics.thinking_message_count

Claude.ai 내에서의 사고(확장) 메시지 수.

chat_metrics.distinct_skills_used_count

Claude.ai 내에서 사용된 고유 스킬 수.

chat_metrics.connectors_used_count

Claude.ai 내에서 호출된 총 커넥터 수.

chat_metrics.shared_conversations_viewed_count

Claude.ai 내에서 조회된 공유 대화 수.

claude_code_metrics.core_metrics.commit_count

Claude Code를 통해 생성된 git 커밋 수.

claude_code_metrics.core_metrics.pull_request_count

Claude Code를 통해 생성된 풀 요청 수.

claude_code_metrics.core_metrics.lines_of_code.added_count

추가된 총 코드 라인 수입니다.

claude_code_metrics.core_metrics.lines_of_code.removed_count

제거된 총 코드 라인 수입니다.

claude_code_metrics.core_metrics.distinct_session_count

서로 다른 Claude Code 세션의 수입니다.

claude_code_metrics.tool_actions.edit_tool

Edit 도구의 수락 및 거부 횟수입니다.

claude_code_metrics.tool_actions.multi_edit_tool

Multi-Edit 도구의 수락 및 거부 횟수입니다.

claude_code_metrics.tool_actions.write_tool

Write 도구의 수락 및 거부 횟수입니다.

claude_code_metrics.tool_actions.notebook_edit_tool

Notebook Edit 도구의 수락 및 거부 횟수입니다.

web_search_count

웹 검색 도구 호출의 총 횟수입니다. 이는 claude.ai와 조직 내 Claude Code 사용 모두에 적용됩니다.

필드

설명

office_metrics.[product].distinct_session_count*

서로 다른 Office Agent 세션의 수입니다.

office_metrics.[product].message_count

전송된 메시지 수(완료된 에이전트 턴당 1개)입니다.

office_metrics.[product].skills_used_count

총 스킬 호출 수입니다. 한 번에 5번 사용된 스킬은 5로 계산됩니다.

office_metrics.[product].distinct_skills_used_count

사용된 서로 다른 스킬의 수입니다.

office_metrics.[product].connectors_used_count

총 커넥터 호출 수입니다. 한 번에 3번 사용된 커넥터는 3으로 계산됩니다.

office_metrics.[product].distinct_connectors_used_count

사용된 서로 다른 커넥터의 수입니다.

필드

설명

cowork_metrics.distinct_session_count

서로 다른 Cowork 세션의 수입니다.

cowork_metrics.message_count

Cowork에서 전송된 총 사용자 메시지 수입니다.

cowork_metrics.action_count

성공한 도구 호출(Bash, Read, Edit 등)입니다.

cowork_metrics.dispatch_turn_count

Dispatch(백그라운드 에이전트) 세션에서 완료된 에이전트 턴입니다.

cowork_metrics.skills_used_count

총 스킬 호출 수입니다. 한 번에 5번 사용된 스킬은 5로 계산됩니다.

cowork_metrics.distinct_skills_used_count

사용된 고유 기술의 수입니다.

cowork_metrics.connectors_used_count

총 커넥터 호출 수입니다. 한 번의 커넥터를 세 번 사용하면 3으로 계산됩니다.

cowork_metrics.distinct_connectors_used_count

사용된 고유 커넥터의 수입니다.

필드

유형

필수

설명

starting_date

문자열

예

데이터를 검색할 시작 날짜이며, YYYY-MM-DD 형식입니다. 데이터 가용성에는 3일의 지연이 있으므로, 액세스할 수 있는 가장 최근 데이터는 3일 전의 데이터입니다.

ending_date

문자열

아니오

데이터를 검색할 선택적 종료 날짜이며, YYYY-MM-DD 형식입니다. 이는 배타적입니다.

필드

설명

starting_date

메트릭이 집계된 첫 번째 날이며, UTC 날짜로 해석됩니다. 데이터 가용성에는 3일의 지연이 있으므로, 액세스할 수 있는 가장 최근 데이터는 3일 전의 데이터입니다.

ending_date

메트릭이 집계된 마지막 날(배타적)이며, UTC 날짜로 해석됩니다.

daily_active_user_count

지정된 날짜에 활성 사용자 수(토큰 소비량 기준)입니다.

weekly_active_user_count

지정된 날짜로 끝나는 7일 롤링 윈도우 내에서 활성 사용자 수입니다.

monthly_active_user_count

지정된 날짜로 끝나는 30일 롤링 윈도우 내에서 활성 사용자 수입니다.

assigned_seat_count

조직에서 현재 할당된 총 좌석 수입니다.

pending_invite_count

아직 수락되지 않은 보류 중인 초대 수입니다.

cowork_daily_active_user_count

그날 ≥1개의 Cowork 세션을 가진 사용자 수입니다.

cowork_weekly_active_user_count

7일 롤링 기간 내에 ≥1개의 Cowork 세션을 가진 사용자 수입니다.

cowork_monthly_active_user_count

30일 롤링 기간 내에 ≥1개의 Cowork 세션을 가진 사용자 수입니다.

필드

유형

필수

설명

date

문자열

예

메트릭을 검색할 날짜(YYYY-MM-DD 형식). 데이터 가용성에 3일의 지연이 있으므로 액세스할 수 있는 가장 최근 데이터는 3일 전의 데이터입니다.

limit

정수

아니오

페이지당 레코드 수(기본값: 100, 최대: 1000).

page

문자열

아니오

다음 페이지를 검색하기 위한 이전 응답의 next_page 필드의 커서 토큰.

필드

설명

project_name

프로젝트의 이름.

project_id

태그된 프로젝트 ID(예: "claude_proj_{ID}")

distinct_user_count

주어진 날짜에 이 프로젝트를 사용한 고유 사용자 수.

distinct_conversation_count

주어진 날짜에 이 프로젝트의 대화 수.

message_count

주어진 날짜에 이 프로젝트 내에서 전송된 총 메시지 수.

created_at

프로젝트 생성 타임스탬프.

created_by

프로젝트를 생성한 사용자의 {id, email_address}.

필드

유형

필수

설명

date

문자열

예

메트릭을 검색할 날짜(YYYY-MM-DD 형식). 데이터 가용성에 3일의 지연이 있으므로 액세스할 수 있는 가장 최근 데이터는 3일 전의 데이터입니다.

limit

정수

아니오

페이지당 레코드 수(기본값: 100, 최대: 1000).

page

문자열

아니오

다음 페이지를 검색하기 위한 이전 응답의 next_page 필드의 커서 토큰.

필드

설명

skill_name

스킬의 이름.

distinct_user_count

주어진 날짜에 이 스킬을 사용한 고유 사용자의 수.

chat_metrics.distinct_conversation_skill_used_count

채팅에서 스킬이 최소 한 번 이상 사용된 고유 대화의 수.

claude_code_metrics.distinct_session_skill_used_count

Claude Code에서 스킬이 최소 한 번 이상 사용된 고유 원격 세션의 수.

필드

설명

office_metrics.excel.distinct_session_skill_used_count

이 스킬이 사용된 Excel의 고유 Office Agent 세션 수.

office_metrics.powerpoint.distinct_session_skill_used_count

이 스킬이 사용된 PowerPoint의 고유 Office Agent 세션 수.

cowork_metrics.distinct_session_skill_used_count

이 스킬이 최소 한 번 이상 사용된 고유 Cowork 세션의 수.

필드

유형

필수

설명

date

문자열

예

메트릭을 검색할 날짜(YYYY-MM-DD 형식). 데이터 가용성에 3일의 지연이 있으므로 액세스할 수 있는 가장 최근 데이터는 3일 전의 데이터입니다.

limit

정수

아니오

페이지당 레코드 수(기본값: 100, 최대: 1000).

page

문자열

아니오

이전 응답의 next_page 필드의 커서 토큰으로 다음 페이지를 검색합니다.

필드

설명

connector_name

커넥터의 정규화된 이름입니다.

distinct_user_count

주어진 날짜에 이 커넥터를 사용한 고유 사용자의 수입니다.

chat_metrics.distinct_conversation_connector_used_count

채팅에서 커넥터가 최소 한 번 이상 사용된 고유 대화의 수입니다.

claude_code_metrics.distinct_session_connector_used_count

Claude Code에서 커넥터가 최소 한 번 이상 사용된 고유 원격 세션의 수입니다.

필드

설명

office_metrics.excel.distinct_session_connector_used_count

이 커넥터가 사용된 Excel의 고유 Office Agent 세션 수입니다.

office_metrics.powerpoint.distinct_session_connector_used_count

이 커넥터가 사용된 PowerPoint의 고유 Office Agent 세션 수입니다.

필드

설명

cowork_metrics.distinct_session_connector_used_count

이 커넥터가 최소 한 번 이상 사용된 고유 Cowork 세션의 수입니다.

형태

엔드포인트

반환

사용자별(사용자당 한 행, 정렬됨)

user_usage_report, user_cost_report

날짜 범위에 따라 토큰 또는 지출로 순위가 지정된 사용자입니다.

버킷 처리됨(시간 버킷당 한 행, 선택적으로 그룹화됨)

usage_report, cost_report

시간 경과에 따른 사용량 또는 비용으로, 제품, 모델 또는 기타 차원별로 분류됩니다.

필드

유형

설명

type

string

항상 "user_actor"입니다.

user_id

string

사용자의 ID입니다. user_ids[]에서 허용하는 동일한 값입니다.

name

string 또는 null

사용자의 이름입니다. 사용자가 삭제된 경우 "Deleted User"입니다.

email

string 또는 null

사용자의 이메일 주소입니다. 사용자가 삭제된 경우 Null입니다.

deleted

boolean

계정이 삭제된 경우 True입니다.

필드

유형

필수

기본값

설명

starting_at

RFC 3339 datetime

예

—

범위의 시작(포함). UTC의 시간 시작으로 내림. 지난 365일 이내여야 합니다.

ending_at

RFC 3339 datetime

아니요

now

범위의 끝(제외). 범위는 최대 31일까지 걸칠 수 있습니다.

products[]

chat, claude_code, cowork, office_agent, claude_in_chrome, claude_design 중 하나 이상

아니요

모든 시트 기반 제품

시트 기반 제품 표면만 해당합니다. 여러 값의 경우 매개변수를 반복합니다.

models[]

문자열, 최대 100개 항목

아니오

모두

특정 모델 이름으로 필터링 (예: claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5-20251001).

user_ids[]

문자열, 최대 100개 항목

아니오

모두

특정 사용자로 필터링. 전체 조직을 페이지 매김하지 않고 알려진 사용자 집합을 조회할 때 유용합니다.

context_windows[]

0-200k, 200k-1M 중 하나 이상

아니오

모두

특정 컨텍스트 윈도우 가격 책정 계층으로 필터링. group_by[]=context_window를 사용하여 계층별 값을 분류합니다.

inference_geos[]

global, us, not_available 중 하나 이상

아니오

모두

특정 추론 지역으로 필터링. not_available은 지역이 설정되지 않은 행과 일치합니다. group_by[]=inference_geo를 사용하여 지역별 값을 분류합니다.

speeds[]

fast, standard 중 하나 이상

아니오

모두

빠른 또는 표준 추론 모드로 필터링. group_by[]=speed를 사용하여 모드별 값을 분류합니다.

group_by[]

product, model, context_window, inference_geo, speed 중 하나 이상

아니오

없음

각 사용자의 행을 주어진 차원으로 분류합니다. 차원이 있으면 한 사용자가 여러 행에 걸쳐 있을 수 있습니다.

order_by

total_tokens, output_tokens, uncached_input_tokens

아니오

total_tokens

정렬 기준 메트릭.

exclude_deleted_users

부울

아니오

거짓

참일 때 삭제된 사용자의 행이 생략됩니다.

order

desc, asc

아니오

desc

정렬 방향.

limit

정수 1–1000

아니오

20

페이지당 행 수.

페이지

불투명 커서 문자열

아니오

—

이전 응답의 next_page 값입니다.

필드

설명

organization_id

API 키가 속한 조직의 ID입니다.

data

order_by에 따라 정렬된 항목 배열입니다.

data[].actor

사용량을 생성한 사용자의 Actor 객체입니다.

data[].product

group_by[]에 product가 포함되면 제품 표면입니다. 그렇지 않으면 null입니다.

data[].model

group_by[]에 model이 포함되면 모델 이름입니다. 그렇지 않으면 null입니다.

data[].context_window

group_by[]에 context_window가 포함되면 컨텍스트 계층(0-200k 또는 200k-1M)입니다. 그렇지 않으면 null입니다.

data[].inference_geo

group_by[]에 inference_geo가 포함되면 추론 영역입니다. 그렇지 않으면 null입니다.

data[].speed

group_by[]에 speed가 포함되면 fast 또는 standard입니다. 그렇지 않으면 null입니다.

data[].uncached_input_tokens

프롬프트 캐시에서 제공되지 않은 입력 토큰입니다.

data[].cache_creation.ephemeral_5m_input_tokens

5분 프롬프트 캐시에 기록된 토큰입니다.

data[].cache_creation.ephemeral_1h_input_tokens

1시간 프롬프트 캐시에 기록된 토큰입니다.

data[].cache_read_input_tokens

프롬프트 캐시에서 제공된 입력 토큰입니다.

data[].output_tokens

생성된 출력 토큰입니다.

data[].total_tokens

위의 모든 토큰 구성 요소의 합계입니다. 기본 order_by=total_tokens은 이 값으로 정렬됩니다.

data[].server_tool_use.web_search_requests

웹 검색 도구 호출 수입니다.

data[].requests

API 요청 수

has_more

다른 페이지가 존재하는지 여부입니다.

next_page

다음 페이지의 불투명 커서입니다. has_more이 false일 때 null입니다.

data_refreshed_at

이 응답이 제공된 데이터 내보내기의 타임스탬프입니다.

필드

유형

필수

기본값

설명

order_by

amount, list_amount

아니요

amount

정렬 기준 메트릭입니다.

group_by[]

product, model, context_window, inference_geo, speed, cost_type, token_type 중 하나 이상

아니요

없음

각 사용자의 행을 주어진 차원으로 분류합니다. cost_type은 비용 구성 요소(토큰, 웹 검색, 코드 실행)당 하나의 행을 반환하고, token_type은 토큰 유형당 하나의 행을 반환합니다.

필드

설명

organization_id

API 키가 속한 조직의 ID입니다.

data

order_by에 따라 정렬된 항목의 배열입니다.

data[].actor

비용을 발생시킨 사용자의 Actor 객체입니다.

data[].product, data[].model, data[].context_window, data[].inference_geo, data[].speed

해당 group_by[] 값이 설정된 경우 차원 값입니다. 그렇지 않으면 null입니다.

data[].currency

항상 "USD"입니다.

data[].amount

분수 센트 단위의 금액 — 협상된 할인 후 실제 소비 비용입니다. 예를 들어, "41280.000000"은 $412.80입니다. 이 값은 products[] 필터의 모든 제품에 걸쳐 합산됩니다.

data[].list_amount

정가(할인 전) 금액(분수 센트 단위, 동일한 형식)입니다.

data[].cost_type

group_by[]에 cost_type이 포함된 경우: tokens, web_search, code_execution 중 하나입니다. 설정되지 않은 경우 null입니다.

data[].token_type

group_by[]에 token_type이 포함된 경우: uncached_input_tokens, output_tokens, cache_read_input_tokens, cache_creation.ephemeral_5m_input_tokens, cache_creation.ephemeral_1h_input_tokens 중 하나입니다. cost_type이 tokens인 행에서만 null이 아닙니다.

data[].requests

API 요청 수

has_more

다른 페이지가 존재하는지 여부입니다.

next_page

다음 페이지의 불투명 커서입니다.

data_refreshed_at

이 응답이 제공된 데이터 내보내기의 타임스탬프입니다.

필드

유형

필수

기본값

설명

starting_at

RFC 3339 datetime

예

—

범위의 시작(포함). 최근 365일 이내여야 합니다. UTC의 가장 가까운 bucket_width 경계로 내림됩니다.

ending_at

RFC 3339 datetime

아니오

현재

범위의 끝(제외). 범위는 최대 31일까지 걸칠 수 있습니다. UTC의 가장 가까운 bucket_width 경계로 내림됩니다.

bucket_width

1m, 1h, 1d

아니오

1d

시간 버킷 세분성: 분, 시간 또는 일.

group_by[]

product, model, context_window, inference_geo, speed 중 하나 이상

아니오

없음

각 버킷 내에서 분류할 차원입니다. 버킷당 단일 집계의 경우 생략하세요.

products[]

chat, claude_code, cowork, office_agent, claude_in_chrome, claude_design 중 하나 이상

아니오

모두

특정 제품 표면으로 필터링합니다.

models[]

문자열, 최대 100개 항목

아니오

모두

특정 모델 이름으로 필터링합니다.

context_windows[]

0-200k, 200k-1M 중 하나 이상

아니오

모두

특정 컨텍스트 윈도우 가격 책정 계층으로 필터링합니다. group_by[]=context_window를 사용하여 계층별 값을 분류하세요.

inference_geos[]

global, us, not_available 중 하나 이상

아니오

모두

특정 추론 지역으로 필터링합니다. not_available은 지역이 설정되지 않은 행과 일치합니다. group_by[]=inference_geo를 사용하여 지역별 값을 분류하세요.

speeds[]

빠름 또는 표준 중 하나 이상

아니오

모두

빠른 또는 표준 추론 모드로 필터링합니다.

user_ids[]

문자열, 최대 100개 항목

아니오

모두

특정 사용자로 필터링합니다.

limit

정수

아니오

다양함

페이지당 버킷 수입니다. 기본값과 최대값은 bucket_width에 따라 다릅니다: 1d → 7 (최대 31); 1h → 24 (최대 168); 1m → 60 (최대 256).

page

불투명 커서 문자열

아니오

—

이전 응답의 next_page 값입니다.

필드

설명

organization_id

API 키가 속한 조직의 ID입니다.

data

시간 버킷당 하나씩 항목의 배열입니다.

data[].starting_at

버킷 시작입니다.

data[].ending_at

버킷 끝입니다.

data[].results

버킷 내 그룹당 하나씩 항목의 배열입니다. group_by[]가 생략되면 모든 차원 필드가 null인 단일 항목입니다.

data[].results[].product, .model, .context_window, .inference_geo, .speed

해당 group_by[] 값이 설정되면 차원 값입니다. 그렇지 않으면 null입니다.

data[].results[].uncached_input_tokens

프롬프트 캐시에서 제공되지 않은 입력 토큰입니다.

data[].results[].cache_creation.ephemeral_5m_input_tokens

5분 프롬프트 캐시에 기록된 토큰입니다.

data[].results[].cache_creation.ephemeral_1h_input_tokens

1시간 프롬프트 캐시에 기록된 토큰입니다.

data[].results[].cache_read_input_tokens

프롬프트 캐시에서 제공된 입력 토큰입니다.

data[].results[].output_tokens

생성된 출력 토큰입니다.

data[].results[].server_tool_use.web_search_requests

웹 검색 도구 호출 수입니다.

has_more

더 많은 버킷이 존재하는지 여부입니다.

next_page

다음 페이지의 불투명 커서입니다.

data_refreshed_at

이 응답이 제공된 데이터 내보내기의 타임스탬프입니다.

필드

설명

organization_id

API 키가 속한 조직의 ID입니다.

data

시간 버킷당 하나의 항목으로 구성된 배열입니다.

data[].starting_at

버킷 시작.

data[].ending_at

버킷 끝.

data[].results

버킷 내 그룹당 하나의 항목으로 구성된 배열입니다.

data[].results[].product, .model, .context_window, .inference_geo, .speed

해당 group_by[] 값이 설정되면 차원 값입니다. 그렇지 않으면 null입니다.

data[].results[].cost_type

group_by[]에 cost_type이 포함되면: tokens, web_search 또는 code_execution입니다. 설정되지 않으면 null입니다.

data[].results[].token_type

group_by[]에 token_type이 포함되면: 엔드포인트 7의 Cost 엔드포인트에 나열된 토큰 유형 중 하나입니다. Cost 엔드포인트 전용 — token_type은 usage_report에서 거부됩니다.

data[].results[].currency

항상 "USD"입니다.

data[].results[].amount

소수 센트 단위의 금액 — 협상된 할인 후 원시 소비 비용입니다.

data[].results[].list_amount

정가(할인 전) 소수 센트 단위입니다.

has_more

더 많은 버킷이 존재하는지 여부입니다.

next_page

다음 페이지의 불투명 커서입니다.

data_refreshed_at

이 응답이 제공된 데이터 내보내기의 타임스탬프입니다.