Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
이 가이드의 Admin 섹션에 있는 모든 API(Admin API, Analytics API, Compliance API, Spend Limits API, Usage and Cost API, Rate Limits API)는 Admin API 키로 인증됩니다. 각 API마다 별도의 키가 필요하지 않습니다.
키를 생성하는 위치는 조직에서 사용하는 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(기본 소유자) | 선택한 스코프에 따라 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 접근 권한을 가집니다.
시크릿 복사 및 저장
표시된 시크릿(sk-ant-admin01-로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.
기본 소유자로 로그인
Claude Enterprise 상위 조직의 primary owner(기본 소유자)만 이러한 키를 생성할 수 있습니다.
API 설정 열기
claude.ai > Organization settings > API로 이동하여 Keys 섹션을 찾으세요.
+ Create key 클릭
키 이름을 지정하고 스코프 표에서 필요한 스코프를 선택하세요. 서로 다른 API의 스코프(예: read:analytics와 read:spend_limits)를 하나의 키에 결합할 수 있습니다.
시크릿 복사 및 저장
표시된 시크릿(sk-ant-api01-로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.
Claude Enterprise 키를 생성할 때, 호출하려는 API에 필요한 모든 스코프를 선택하세요. 스코프는 생성 시 고정되며, 나중에 스코프를 추가하려면 새 키를 생성해야 합니다.
| 호출하려는 API | 선택할 스코프 |
|---|---|
| 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 콘텐츠 엔드포인트: 채팅, 파일, 프로젝트 및 사용자 조회 | read:compliance_user_data |
| Compliance API 콘텐츠 엔드포인트: 채팅, 파일 및 프로젝트 삭제 | delete:compliance_user_data |
| Compliance API 조직 엔드포인트: 조직 메타데이터 및 설정 조회 | read:compliance_org_data, read:compliance_org_settings |
해당 스코프를 가진 키를 사용하려면 먼저 조직에서 Compliance 및 Analytics API가 활성화되어 있어야 합니다. Compliance API 접근 권한 얻기 및 Analytics API를 참조하세요.
모든 요청의 x-api-key 헤더에 키를 전달하세요. 전체 요청 예시는 각 API의 문서를 참조하세요.
키의 스코프를 초과하는 호출은 해당 키가 가진 스코프와 엔드포인트에 필요한 스코프를 나열하는 메시지와 함께 403 Forbidden을 반환합니다.
조직 구성원, 워크스페이스 및 API 키를 관리합니다.
Claude Enterprise 조직의 구성원별 지출 한도를 설정하고 증액 요청을 검토합니다.
Claude Code 생산성 또는 Claude Enterprise 참여도 및 도입률에 대한 보고서를 생성합니다.
조직 전체의 활동을 감사하고 사용자 콘텐츠를 조회하거나 삭제합니다.
Was this page helpful?