Claude Platform Docs
관리자인증

Admin API 키 생성

Claude Console 또는 Claude Enterprise 조직을 위한 Admin API 키를 생성합니다.

Admin API 키는 이 가이드의 Admin 섹션에 있는 모든 API를 인증합니다: Admin API, Analytics API, Compliance API, Spend Limits API, Usage and Cost API, Rate Limits API. 각 API마다 별도의 키가 필요하지 않습니다. 한 가지 예외는 Admin API의 service-account, federation-issuer, federation-rule 엔드포인트로, 이들은 org:admin 스코프를 가진 OAuth bearer 토큰만 허용합니다. OAuth bearer 토큰 얻기를 참조하세요.

키를 생성하는 위치는 조직이 사용하는 Claude 제품에 따라 다릅니다.

어떤 키가 필요한가요?

조직키 생성 위치키 접두사생성 가능한 사람사용 가능한 API
Claude Console (Claude Platform, platform.claude.com)Claude Console > Settings > Admin keyssk-ant-admin01-...admin 역할을 가진 조직 구성원Admin API, Usage and Cost API, Rate Limits API, Claude Code Analytics API, 그리고 Compliance API Activity Feed
Claude Enterprise (claude.ai)claude.ai > Organization settings > APIsk-ant-api01-...상위 조직의 primary owner(기본 소유자) (모든 연결된 조직). organization owner(조직 소유자)는 자신의 조직으로 제한되고 Compliance API 스코프만 가진 키를 생성할 수 있습니다선택한 스코프에 따라 사용자 관리(Admin API의 member, invite, group 엔드포인트), Compliance API, Claude Enterprise Analytics API, Spend Limits API

한 조직에서 생성된 키는 다른 조직을 관리하는 데 사용할 수 없습니다. 회사에서 Claude Console과 Claude Enterprise를 모두 사용하는 경우 각각에서 키를 하나씩 생성하세요.

Claude Console 조직용 키 생성

  1. 조직 admin으로 로그인

    admin 역할을 가진 조직 구성원만 Admin API 키를 생성할 수 있습니다. 조직 역할 및 권한을 참조하세요.

  2. Admin keys 설정 열기

    Claude Console > Settings > Admin keys로 이동하세요.

  3. 키 생성

    Create key를 클릭하고, 이름을 지정하고, 키 만료를 선택한 다음 Create를 클릭하세요. Claude Console 키에는 선택 가능한 스코프가 없습니다. 모든 키는 Admin API 키를 허용하는 모든 엔드포인트에 대한 전체 액세스 권한을 가집니다(이 페이지 상단에 언급된 service-account 및 federation 엔드포인트는 Admin API 키를 허용하지 않습니다).

  4. 시크릿 복사 및 저장

    표시된 시크릿(sk-ant-admin01-로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.

Claude Enterprise 조직용 키 생성

  1. primary owner 또는 organization owner로 로그인

    Claude Enterprise 상위 조직의 primary owner는 모든 연결된 조직에 액세스할 수 있는 키 또는 단일 조직으로 제한된 키를 생성할 수 있습니다. organization owner는 자신의 조직으로 제한되고 Compliance API 스코프만 가진 키를 생성할 수 있습니다.

  2. API 설정 열기

    claude.ai > Organization settings > API로 이동하여 Keys 섹션을 찾으세요.

  3. + Create key 클릭

    키 이름을 지정하고 스코프 표에서 필요한 스코프를 선택하세요. primary owner는 서로 다른 API의 스코프(예: read:analytics와 read:spend_limits)를 하나의 키에 결합할 수 있습니다.

  4. 시크릿 복사 및 저장

    표시된 시크릿(sk-ant-api01-로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.

Claude Enterprise 키의 스코프 선택

Claude Enterprise 키를 생성할 때, 호출하려는 API에 필요한 모든 스코프를 선택하세요. 스코프는 생성 시 고정됩니다. 나중에 스코프를 추가하려면 새 키를 생성하세요.

호출 대상선택할 스코프
Admin API 사용자 관리: 구성원 및 초대 목록 조회와 검색, 사용자 지정 역할 및 해당 권한 읽기read:members
Admin API 사용자 관리: 구성원 역할 변경, 구성원 제거, 초대 생성 및 철회write:members
Admin API 사용자 관리: 그룹 및 그룹 구성원 읽기read:rbac_groups
Admin API 사용자 관리: 그룹 생성, 이름 변경, 삭제, 그룹 구성원 추가 및 제거, 초대 생성 시 그룹 할당write:rbac_groups
Spend Limits API: 구성원의 유효 지출 한도 및 증액 요청 읽기read:spend_limits
Spend Limits API: 사용자별 지출 한도 설정 또는 해제, 증액 요청 승인 또는 거부write:spend_limits
Claude Enterprise Analytics API: 참여도, 도입, 비용 및 사용량 보고서read:analytics
Compliance API Activity Feed: 조직 전체 활동 이벤트read:compliance_activities
Compliance API 채팅, 파일, 프로젝트 엔드포인트 및 Compliance API 세션 엔드포인트: 채팅, 파일, 프로젝트, 세션 기록, 조직 사용자 읽기read:compliance_user_data
Compliance API 채팅, 파일, 프로젝트 엔드포인트: 채팅, 파일, 프로젝트 삭제delete:compliance_user_data
Compliance API 조직 엔드포인트: 조직 메타데이터 및 유효 설정 읽기read:compliance_org_data
단일 읽기 전용 스코프로 Admin API 사용자 관리 읽기 엔드포인트 및 모든 Compliance API 읽기 엔드포인트 호출(보안 감사 통합용, Spend Limits 또는 Analytics API는 포함되지 않음)read:org_audit

해당 스코프를 가진 키를 사용하려면 먼저 조직에서 Compliance 및 Analytics API가 활성화되어 있어야 합니다. Compliance API 설정 및 Claude Enterprise Analytics API 액세스 얻기를 참조하세요.

키 사용

모든 요청에서 x-api-key 헤더에 키를 전달하세요. 전체 요청 예시는 각 API의 문서를 참조하세요.

키의 스코프를 초과하는 호출은 403 Forbidden을 반환하며, 키가 가진 스코프와 엔드포인트에 필요한 스코프를 나열하는 메시지가 함께 표시됩니다.

다음 단계

Admin API

조직 구성원, 워크스페이스 및 API 키를 관리합니다.

Spend Limits API

Claude Enterprise 조직의 구성원별 지출 한도를 설정하고 증액 요청을 검토합니다.

Analytics API

Claude Code 생산성 또는 Claude Enterprise 참여도 및 도입에 대해 보고합니다.

Compliance API

조직 전체의 활동을 감사하고 사용자 콘텐츠를 검색하거나 삭제합니다.

Was this page helpful?