Claude Platform Docs
관리인증

Admin API 키 생성

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

Admin API 키는 이 가이드의 Admin 섹션에 있는 모든 API를 인증합니다: Admin API, Analytics API, Compliance API, Plugins API, Claude Tag API, Spend Limits API, Usage and Cost Analytics API, Usage and Cost API, Rate Limits API. API마다 별도의 키가 필요하지 않습니다. 유일한 예외는 Admin API의 서비스 계정, 페더레이션 발급자, 페더레이션 규칙 엔드포인트로, 이 엔드포인트는 org:admin 스코프를 가진 OAuth bearer 토큰만 허용합니다. OAuth bearer 토큰 얻기를 참조하세요.

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

어떤 키가 필요한가요?

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

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

Claude Console 조직용 키 생성

  1. 조직 admin으로 로그인

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

  2. 관리자 키 설정 열기

    Claude Console에서 관리자 키 페이지(platform.claude.com/settings/admin-keys)로 이동하세요.

  3. 키 생성

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

  4. 시크릿 복사 및 저장

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

Claude Enterprise 조직용 키 생성

  1. 기본 소유자 또는 조직 소유자로 로그인

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

  2. API 설정 열기

    claude.ai > 조직 설정 > API로 이동하여 키 섹션을 찾으세요.

  3. + 키 생성 클릭

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

  4. 시크릿 복사 및 저장

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

Claude Enterprise 키의 스코프 선택

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

호출 대상선택할 스코프
Admin API 사용자 관리: 구성원 및 초대 목록 조회와 검색, 사용자 지정 역할 및 해당 권한 읽기read:members
Admin API 사용자 관리: 구성원 역할 변경, 구성원 제거, 구성원을 모든 곳에서 로그아웃 (베타), 초대 생성 및 철회(역할 변경 또는 초대 시 managed 역할을 할당하려면 write:rbac_groups도 선택)write:members
Admin API 사용자 관리: 그룹 및 그룹 구성원 읽기read:rbac_groups
Admin API 사용자 관리: 그룹 생성, 이름 변경 및 삭제, 그룹 구성원 추가 및 제거, write:members와 함께 사용 시 (초대 또는 역할 변경 시) managed 역할 할당 또는 초대 시 그룹 할당write:rbac_groups
Plugins API: 플러그인, 버전, 설치 설정, 공유 및 마켓플레이스 읽기, 구성원의 개인 플러그인 파일을 포함한 플러그인 파일 다운로드, 연결 전 마켓플레이스 검증read:plugins
Plugins API: 플러그인 및 버전 업로드, 구성원에게 제공할 버전 선택, 구성원의 개인 플러그인을 포함한 플러그인 삭제, 설치 설정 지정 및 제거, 마켓플레이스의 기본 설치 설정 지정, 연결 전 마켓플레이스 검증(플러그인을 읽으려면 read:plugins도 선택)write:plugins
Claude Tag API: Slack 채널 및 Slack 워크스페이스의 Claude Tag 설정 읽기; 액세스 번들 목록 및 연결 위치 조회(다른 스코프로는 Claude Tag API에 액세스할 수 없습니다)read:claude_tag
Claude Tag API: 채널 설정 및 제거, 설정 변경, 액세스 번들 연결 및 분리(읽기도 하려면 read:claude_tag도 선택)write:claude_tag
Spend Limits API: 구성원의 유효 지출 한도 및 증액 요청 읽기read:spend_limits
Spend Limits API: 사용자별 지출 한도 설정 또는 해제, 증액 요청 승인 또는 거부write:spend_limits
Claude Enterprise Analytics API: 참여도, 도입, 비용 및 사용량 보고서; Usage and Cost 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 조직 엔드포인트: 조직 메타데이터 및 유효 설정 읽기; Plugins API: 파일 다운로드를 포함한 모든 GET 엔드포인트read:compliance_org_data
단일 읽기 전용 스코프로 Admin API 사용자 관리 읽기 엔드포인트, 모든 Compliance API 읽기 엔드포인트, 그리고 파일 다운로드를 포함한 모든 Plugins API GET 엔드포인트 호출(보안 감사 통합용; Spend Limits API 또는 Analytics API는 포함되지 않음)read:org_audit

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

read:plugins 또는 write:plugins 스코프를 가진 키는 조직에서 Plugins API를 사용할 수 있는 경우에만 생성하고 사용할 수 있습니다. 어떤 조직이 이를 사용할 수 있는지는 Plugins API 가이드에 나와 있습니다. 해당 조직에서는 read:org_audit 또는 read:compliance_org_data 스코프를 가진 키도 파일 다운로드를 포함한 Plugins API의 읽기 엔드포인트를 호출할 수 있지만, 마켓플레이스 검증은 호출할 수 없습니다. read:plugins 및 write:plugins 스코프는 키가 생성된 조직에서만 작동합니다. Plugins API 스코프 및 같은 상위 조직 아래의 다른 조직 읽기를 참조하세요.

키 사용

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

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

다음 단계

Admin API

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

Spend Limits API

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

Analytics API

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

Compliance API

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

이 페이지가 도움이 되었나요?