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의 서비스 계정, 페더레이션 발급자, 페더레이션 규칙 엔드포인트로, 이들은 org:admin 스코프를 가진 OAuth 베어러 토큰만 허용합니다. OAuth 베어러 토큰 획득을 참조하세요.
키를 생성하는 위치는 조직에서 사용하는 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-... | 상위 조직의 primary owner(모든 연결된 조직). organization owner는 Compliance API 스코프만 포함하고 자신의 조직으로 제한된 키를 생성할 수 있습니다 | 선택한 스코프에 따라 사용자 관리(Admin API의 구성원, 초대, 그룹 엔드포인트, 베타), 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 키를 허용하는 모든 엔드포인트에 대한 전체 액세스 권한을 가집니다(이 페이지 상단에 언급된 서비스 계정 및 페더레이션 엔드포인트는 Admin API 키를 허용하지 않습니다).
시크릿 복사 및 저장
표시된 시크릿(sk-ant-admin01-로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.
primary owner 또는 organization owner로 로그인
Claude Enterprise 상위 조직의 primary owner는 모든 연결된 조직에 액세스할 수 있는 키 또는 단일 조직으로 제한된 키를 생성할 수 있습니다. organization owner는 Compliance API 스코프만 포함하고 자신의 조직으로 제한된 키를 생성할 수 있습니다.
API 설정 열기
claude.ai > Organization settings > API로 이동하여 Keys 섹션을 찾으세요.
+ Create key 클릭
키 이름을 지정하고 스코프 표에서 필요한 스코프를 선택하세요. primary owner는 서로 다른 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 및 Claude Code 세션 기록, 사용자 읽기 | 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?