Compliance API

Compliance API를 사용하면 Claude Enterprise 및 Claude Console 고객이 조직의 "Activity Feed"(활동 피드)에 프로그래밍 방식으로 접근할 수 있습니다. Claude Enterprise 조직의 경우 다음 항목도 포함됩니다. 연결된 모든 조직의 사용자, 역할 및 그룹 디렉터리, 각 조직에 적용 중인 유효 설정, claude.ai 조직의 기본 채팅, 파일 및 프로젝트, 그리고 Cowork, Claude Code, Claude Science, Claude for Microsoft 365 및 Claude in Chrome 세션입니다. 보안, 법무 및 규정 준수 팀은 이를 사용하여 활동을 감사하고, 콘텐츠를 조회하거나 삭제하고, 이벤트를 다운스트림 도구로 전달합니다.

다음 호출은 조직에서 가장 최근의 활동 이벤트를 반환합니다. read:compliance_activities 범위를 가진 모든 키로 이 호출을 수행할 수 있습니다. 키를 생성하고 해당 범위를 부여하려면 Compliance API 설정을 참조하세요.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=1" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01"

성공적인 응답은 data(Activity 레코드의 배열), has_more, first_id 및 last_id를 포함하는 JSON 객체를 반환합니다:

{
  "data": [
    {
      "id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
      "created_at": "2026-04-10T08:09:10Z",
      "organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8",
      "organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789",
      "actor": {
        "type": "user_actor",
        "email_address": "user@example.com",
        "user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4",
        "ip_address": "192.0.2.34",
        "user_agent": "Mozilla/5.0..."
      },
      "type": "claude_chat_created",
      "claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6",
      "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
    }
  ],
  "has_more": true,
  "first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
  "last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6"
}

Compliance API 작동 방식

모든 엔드포인트는 https://api.anthropic.com의 /v1/compliance/* 아래에 있으며, x-api-key 헤더를 통해 인증하고, 모든 요청에서 anthropic-version 헤더를 받습니다. 키를 발급하려면 Compliance API 설정을 참조하세요.

Activity Feed(GET /v1/compliance/activities)는 read:compliance_activities 범위를 가진 모든 키에서 사용할 수 있습니다. 필터, 페이지네이션 및 전체 Activity 객체에 대해서는 Activity Feed 쿼리를 참조하세요. 나머지 엔드포인트에는 관련 범위를 가진 Compliance Access Key가 필요합니다.

Claude Enterprise 테넌트에는 하나의 "parent organization"(상위 조직, ID를 중앙에서 관리하는 최상위 컨테이너)이 있으며, 여기에 두 종류의 연결된 조직이 있습니다. 사용자가 채팅하고 콘텐츠를 저장하는 claude.ai 조직과, 사용자가 Claude API 워크로드를 관리하는 Claude Console 조직입니다. 상위 조직을 대상으로 하는 키의 경우, 디렉터리 엔드포인트(조직, 사용자, 역할 및 그룹)는 두 종류 모두의 연결된 모든 조직에서 데이터를 반환합니다. 콘텐츠 엔드포인트(채팅, 파일, 프로젝트, 프로젝트 첨부 파일 및 세션)는 Claude Enterprise 데이터만 제공합니다. 채팅, 파일 및 프로젝트 엔드포인트는 claude.ai 채팅, 파일 및 프로젝트를 반환합니다. 세션 엔드포인트는 사용자가 Claude Enterprise 계정으로 로그인한 상태에서 캡처된, 사용자 컴퓨터에서 실행된 Cowork, Claude Code, Claude Science, Claude for Microsoft 365 및 Claude in Chrome 세션(로컬 세션)의 트랜스크립트를 반환합니다. 또한 claude.ai 웹 또는 모바일에서 시작되어 Anthropic이 관리하는 환경의 클라우드에서 실행되는 Cowork 세션(원격 세션)의 트랜스크립트도 반환합니다. 독립형 Claude Console 조직(상위 조직이 없는 조직)은 Claude Enterprise 테넌트에 속하지 않으며, Admin API 키를 사용하고 Activity Feed만 쿼리할 수 있습니다.

모든 /v1/compliance/* 엔드포인트는 상위 조직당(독립형 Claude Console 조직의 경우 조직당) 분당 600개 요청의 "rate limit"(속도 제한)을 공유합니다. 로컬 세션 엔드포인트는 해당 공유 제한에만 계산되며, 원격 세션 엔드포인트는 그 위에 두 번째 요청 예산이 추가로 적용됩니다. 응답 헤더 및 재시도 규약에 대해서는 429 Too Many Requests를 참조하세요.

버전 관리

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

Compliance API와 관련 기능 비교

몇 가지 인접 기능이 Compliance API와 겹칩니다. 선택 방법은 다음과 같습니다.

감사 로그 내보내기

감사 로그 내보내기는 claude.ai > 조직 설정 > 데이터 및 개인정보 보호에 있는 별도의 기능으로, 소유자 및 기본 소유자가 조직 이벤트의 CSV를 다운로드할 수 있게 합니다. 이는 Compliance API보다 훨씬 범위가 좁습니다. 조회 기간이 제한되어 있고, CSV 다운로드만 가능하며, 채팅, 파일 또는 프로젝트 콘텐츠에 액세스할 수 없습니다. 지속적인 프로그래밍 방식 사용에는 Compliance API로 표준화하세요.

Analytics API

Anthropic은 두 가지 분석 API를 제공합니다. Claude Enterprise Analytics API와 Claude Code Analytics API입니다. 둘 다 IT, FinOps 및 플랫폼 팀을 위해 집계된 사용량 및 비용 수치를 반환하는 반면, Compliance API는 보안, 법무 및 컴플라이언스 팀을 위해 이벤트별 레코드를 반환합니다. 두 API 제품군은 서로 다른 질문에 답하고, 서로 다른 키를 사용하며, 별도로 프로비저닝됩니다.

OpenTelemetry 로깅

Cowork의 OpenTelemetry 로깅 및 Claude Code 모니터링은 활동이 발생하는 즉시 토큰, 비용 및 호스트 메타데이터를 포함한 이벤트별 텔레메트리를 사용자가 운영하는 수집기로 스트리밍하는 반면, Compliance API는 요청 시 Anthropic에서 보존된 세션별 트랜스크립트를 반환하며 기존 Compliance Access Key로 작동합니다. OpenTelemetry 로깅도 프롬프트와 응답을 캡처할 수 있지만, Anthropic은 Cowork 및 Claude Code 세션의 콘텐츠를 검색하는 데 Compliance API를 권장합니다. 로컬 세션, 원격 세션 및 OpenTelemetry 로깅을 비교하는 표는 세션 트랜스크립트 검색의 소개 부분을 참조하세요.

추론 훅

추론 훅(베타)은 인라인으로 작동합니다. 조직의 AI 보안 서버가 추론 전에 각 관리 대상 프롬프트를 수신하고 실시간으로 거부할 수 있는 반면, Compliance API는 사후에 레코드를 검색하며 조직 설정 및 전체 비텍스트 파일과 같은 더 풍부한 데이터를 반환합니다.

이 섹션의 내용