---
title: Admin API 키 생성
url: https://platform.claude.com/docs/ko/manage-claude/admin-api-keys
description: Claude Console 또는 Claude Enterprise 조직을 위한 Admin API 키를 생성합니다.
---
Admin API 키는 이 가이드의 **Admin** 섹션에 있는 모든 API를 인증합니다: [Admin API](https://platform.claude.com/docs/ko/manage-claude/admin-api), [Analytics API](https://platform.claude.com/docs/ko/manage-claude/analytics-api), [Compliance API](https://platform.claude.com/docs/ko/manage-claude/compliance-api), [Spend Limits API](https://platform.claude.com/docs/ko/manage-claude/spend-limits-api), [Usage and Cost API](https://platform.claude.com/docs/ko/manage-claude/usage-cost-api), [Rate Limits API](https://platform.claude.com/docs/ko/manage-claude/rate-limits-api). API마다 별도의 키가 필요하지 않습니다. 유일한 예외는 Admin API의 service-account, federation-issuer, federation-rule 엔드포인트로, 이 엔드포인트는 `org:admin` 스코프를 가진 OAuth bearer 토큰만 허용합니다. [OAuth bearer 토큰 얻기](https://platform.claude.com/docs/ko/manage-claude/admin-api#oauth-bearer-token)를 참조하세요.
키를 생성하는 위치는 조직이 사용하는 Claude 제품에 따라 다릅니다.
## 어떤 키가 필요한가요?
| 조직 | 키 생성 위치 | 키 접두사 | 생성 가능한 사람 | 사용 가능한 API |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Claude Console** (Claude Platform, `platform.claude.com`) | Claude Console의 [Admin keys](https://platform.claude.com/settings/admin-keys) 페이지 (`platform.claude.com/settings/admin-keys`) | `sk-ant-admin01-...` | **admin** 역할을 가진 조직 구성원 | [Admin API](https://platform.claude.com/docs/ko/manage-claude/admin-api), [Usage and Cost API](https://platform.claude.com/docs/ko/manage-claude/usage-cost-api), [Rate Limits API](https://platform.claude.com/docs/ko/manage-claude/rate-limits-api), [Claude Code Analytics API](https://platform.claude.com/docs/ko/manage-claude/claude-code-analytics-api) 및 Compliance API [Activity Feed](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed) |
| **Claude Enterprise** (`claude.ai`) | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | `sk-ant-api01-...` | 상위 조직의 **primary owner**(기본 소유자) (모든 연결된 조직). **organization owner**(조직 소유자)는 자신의 조직으로 제한되고 Compliance API 스코프만 가진 키를 생성할 수 있습니다 | 선택한 [스코프](https://platform.claude.com/docs/ko/manage-claude/admin-api-keys#choose-scopes-for-a-claude-enterprise-key)에 따라 [사용자 관리](https://platform.claude.com/docs/ko/manage-claude/user-management)(Admin API의 member, invite, group 엔드포인트), [Compliance API](https://platform.claude.com/docs/ko/manage-claude/compliance-api), [Claude Enterprise Analytics API](https://platform.claude.com/docs/ko/manage-claude/analytics-api), [Spend Limits API](https://platform.claude.com/docs/ko/manage-claude/spend-limits-api) |
한 조직에서 생성된 키는 다른 조직을 관리하는 데 사용할 수 없습니다. 회사에서 Claude Console과 Claude Enterprise를 모두 사용하는 경우 각각에서 키를 하나씩 생성하세요.
## Claude Console 조직용 키 생성
**admin** 역할을 가진 조직 구성원만 Admin API 키를 생성할 수 있습니다. [조직 역할 및 권한](https://platform.claude.com/docs/ko/manage-claude/admin-api#organization-roles-and-permissions)을 참조하세요.
Claude Console에서 [Admin keys](https://platform.claude.com/settings/admin-keys) 페이지(`platform.claude.com/settings/admin-keys`)로 이동하세요.
**Create admin key**를 클릭하고, 이름을 지정하고, [키 만료](https://platform.claude.com/docs/ko/manage-claude/authentication#key-expiration)를 선택한 다음 **Add**를 클릭하세요. Claude Console 키에는 선택 가능한 스코프가 없습니다. 모든 키는 Admin API 키를 허용하는 모든 엔드포인트에 대한 전체 액세스 권한을 가집니다(이 페이지 상단에 언급된 service-account 및 federation 엔드포인트는 Admin API 키를 허용하지 않습니다).
표시된 시크릿(`sk-ant-admin01-`로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.
## Claude Enterprise 조직용 키 생성
Claude Enterprise 상위 조직의 **primary owner**는 모든 연결된 조직에 액세스할 수 있는 키 또는 단일 조직으로 제한된 키를 생성할 수 있습니다. **organization owner**는 자신의 조직으로 제한되고 Compliance API 스코프만 가진 키를 생성할 수 있습니다.
[claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access)로 이동하여 **Keys** 섹션을 찾으세요.
키 이름을 지정하고 [스코프 표](https://platform.claude.com/docs/ko/manage-claude/admin-api-keys#choose-scopes-for-a-claude-enterprise-key)에서 필요한 스코프를 선택하세요. primary owner는 서로 다른 API의 스코프(예: `read:analytics`와 `read:spend_limits`)를 하나의 키에 결합할 수 있습니다.
표시된 시크릿(`sk-ant-api01-`로 시작)을 복사하여 시크릿 관리자에 저장하세요. 전체 시크릿은 한 번만 표시됩니다.
## Claude Enterprise 키의 스코프 선택
Claude Enterprise 키를 생성할 때, 호출하려는 API에 필요한 모든 스코프를 선택하세요. 스코프는 생성 시 고정됩니다. 나중에 스코프를 추가하려면 새 키를 생성하세요.
| 호출 대상 | 선택할 스코프 |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| Admin API [사용자 관리](https://platform.claude.com/docs/ko/manage-claude/user-management): 구성원 및 초대 목록 조회와 검색, 사용자 지정 역할 및 해당 권한 읽기 | `read:members` |
| Admin API [사용자 관리](https://platform.claude.com/docs/ko/manage-claude/user-management): 구성원 역할 변경, 구성원 제거, 초대 생성 및 철회(역할 변경 또는 초대 시 `managed` 역할을 할당하려면 `write:rbac_groups`도 선택) | `write:members` |
| Admin API [사용자 관리](https://platform.claude.com/docs/ko/manage-claude/user-management): 그룹 및 그룹 구성원 읽기 | `read:rbac_groups` |
| Admin API [사용자 관리](https://platform.claude.com/docs/ko/manage-claude/user-management): 그룹 생성, 이름 변경 및 삭제, 그룹 구성원 추가 및 제거, `write:members`와 함께 사용 시 (초대 또는 역할 변경 시) `managed` 역할 할당 또는 초대 시 그룹 할당 | `write:rbac_groups` |
| [Spend Limits API](https://platform.claude.com/docs/ko/manage-claude/spend-limits-api): 구성원의 유효 지출 한도 및 증액 요청 읽기 | `read:spend_limits` |
| [Spend Limits API](https://platform.claude.com/docs/ko/manage-claude/spend-limits-api): 사용자별 지출 한도 설정 또는 해제, 증액 요청 승인 또는 거부 | `write:spend_limits` |
| [Claude Enterprise Analytics API](https://platform.claude.com/docs/ko/manage-claude/analytics-api): 참여도, 도입, 비용 및 사용량 보고서 | `read:analytics` |
| [Compliance API Activity Feed](https://platform.claude.com/docs/ko/manage-claude/compliance-activity-feed): 조직 전체 활동 이벤트 | `read:compliance_activities` |
| [Compliance API 채팅, 파일, 프로젝트 엔드포인트](https://platform.claude.com/docs/ko/manage-claude/compliance-content-data) 및 [Compliance API 세션 엔드포인트](https://platform.claude.com/docs/ko/manage-claude/compliance-sessions): 채팅, 파일, 프로젝트, 세션 기록, [조직 사용자](https://platform.claude.com/docs/ko/manage-claude/compliance-org-data#list-organization-users) 읽기 | `read:compliance_user_data` |
| [Compliance API 채팅, 파일, 프로젝트 엔드포인트](https://platform.claude.com/docs/ko/manage-claude/compliance-content-data): 채팅, 파일, 프로젝트 삭제 | `delete:compliance_user_data` |
| [Compliance API 조직 엔드포인트](https://platform.claude.com/docs/ko/manage-claude/compliance-org-data): 조직 메타데이터 및 유효 설정 읽기 | `read:compliance_org_data` |
| 단일 읽기 전용 스코프로 Admin API [사용자 관리](https://platform.claude.com/docs/ko/manage-claude/user-management) 읽기 엔드포인트 및 모든 Compliance API 읽기 엔드포인트 호출(보안 감사 통합용, Spend Limits 또는 Analytics API는 포함되지 않음) | `read:org_audit` |
해당 스코프를 가진 키를 사용하려면 먼저 조직에서 Compliance 및 Analytics API가 활성화되어 있어야 합니다. [Compliance API 설정](https://platform.claude.com/docs/ko/manage-claude/compliance-api-access#set-up-the-compliance-api) 및 [Claude Enterprise Analytics API 액세스 얻기](https://platform.claude.com/docs/ko/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api)를 참조하세요.
## 키 사용
모든 요청에서 `x-api-key` 헤더에 키를 전달하세요. 전체 요청 예시는 각 API의 문서를 참조하세요.
키의 스코프를 초과하는 호출은 `403 Forbidden`을 반환하며, 키가 가진 스코프와 엔드포인트에 필요한 스코프를 나열하는 메시지가 함께 표시됩니다.
## 다음 단계
조직 구성원, 워크스페이스 및 API 키를 관리합니다.
Claude Enterprise 조직의 구성원별 지출 한도를 설정하고 증액 요청을 검토합니다.
Claude Code 생산성 또는 Claude Enterprise 참여도 및 도입에 대해 보고합니다.
조직 전체의 활동을 감사하고 사용자 콘텐츠를 검색하거나 삭제합니다.