Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
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 keys | sk-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 > API | sk-ant-api01-... | 상위 조직의 기본 소유자(모든 연결된 조직). 조직 소유자는 자신의 조직으로 제한된 Compliance API 범위만 포함하는 키를 생성할 수 있습니다 | 선택한 범위에 따라 사용자 관리(Admin API의 member, invite, group 엔드포인트, 베타), Compliance API, Claude Enterprise Analytics API, Spend Limits API |
한 조직에서 생성된 키는 다른 조직을 관리하는 데 사용할 수 없습니다. 회사에서 Claude Console과 Claude Enterprise를 모두 사용하는 경우 각각에 하나씩 키를 생성하세요.
조직 관리자로 로그인
admin 역할을 가진 조직 구성원만 Admin API 키를 생성할 수 있습니다. 조직 역할 및 권한을 참조하세요.
Admin keys 설정 열기
키 생성
Create key를 클릭하고 이름을 지정한 다음 키 만료를 선택하고 Create를 클릭하세요. Claude Console 키에는 선택 가능한 범위가 없습니다. 모든 키는 Admin API 키를 허용하는 모든 엔드포인트에 대한 전체 액세스 권한을 가집니다(이 페이지 상단에 언급된 service-account 및 federation 엔드포인트는 Admin API 키를 허용하지 않습니다).
시크릿 복사 및 저장
표시된 시크릿(sk-ant-admin01-로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.
기본 소유자 또는 조직 소유자로 로그인
Claude Enterprise 상위 조직의 기본 소유자는 모든 연결된 조직에 액세스할 수 있는 키 또는 단일 조직으로 제한된 키를 생성할 수 있습니다. 조직 소유자는 자신의 조직으로 제한된 Compliance API 범위만 포함하는 키를 생성할 수 있습니다.
API 설정 열기
claude.ai > Organization settings > API로 이동하여 Keys 섹션을 찾으세요.
+ Create key 클릭
키 이름을 지정하고 범위 표에서 필요한 범위를 선택하세요. 기본 소유자는 서로 다른 API의 범위(예: read:analytics와 read:spend_limits)를 단일 키에 결합할 수 있습니다.
시크릿 복사 및 저장
표시된 시크릿(sk-ant-api01-로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.
Claude Enterprise 키를 생성할 때 호출하려는 API에 필요한 모든 범위를 선택하세요. 범위는 생성 시 고정됩니다. 나중에 범위를 추가하려면 새 키를 생성하세요.
| 호출하려는 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 콘텐츠 엔드포인트: 채팅, 파일, 프로젝트, Cowork 세션 기록 및 사용자 읽기 | 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을 반환합니다.
조직 구성원, 워크스페이스 및 API 키를 관리합니다.
Claude Enterprise 조직의 구성원별 지출 한도를 설정하고 증액 요청을 검토합니다.
Claude Code 생산성 또는 Claude Enterprise 참여 및 도입에 대해 보고합니다.
조직 전체의 활동을 감사하고 사용자 콘텐츠를 검색하거나 삭제합니다.
Was this page helpful?