Admin API 개요
The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
Admin API를 사용하면 조직 구성원, 워크스페이스, API 키를 포함한 조직의 리소스를 프로그래밍 방식으로 관리할 수 있습니다. 이는 Claude Console에서 수동 구성이 필요한 관리 작업에 대한 프로그래밍 방식의 제어를 제공합니다.
Admin API는 특별한 액세스가 필요합니다
Admin API는 표준 API 키와 다른 특별한 Admin API 키(sk-ant-admin...으로 시작)가 필요합니다. 관리자 역할을 가진 조직 구성원만이 Claude Console을 통해 Admin API 키를 프로비저닝할 수 있습니다.
Admin API 작동 방식
Admin API를 사용할 때:
x-api-key헤더에 Admin API 키를 사용하여 요청을 만듭니다- API를 통해 다음을 관리할 수 있습니다:
- 조직 구성원 및 그들의 역할
- 조직 구성원 초대
- 워크스페이스 및 그들의 구성원
- API 키
이는 다음과 같은 용도로 유용합니다:
- 사용자 온보딩/오프보딩 자동화
- 워크스페이스 액세스 프로그래밍 방식 관리
- API 키 사용량 모니터링 및 관리
조직 역할 및 권한
다섯 가지 조직 수준 역할이 있습니다. 자세한 내용은 여기를 참조하세요.
| 역할 | 권한 |
|---|---|
| user | Workbench 사용 가능 |
| claude_code_user | Workbench 및 Claude Code 사용 가능 |
| developer | Workbench 사용 및 API 키 관리 가능 |
| billing | Workbench 사용 및 청구 세부 정보 관리 가능 |
| admin | 위의 모든 작업 및 사용자 관리 가능 |
주요 개념
조직 구성원
조직 구성원을 나열하고, 구성원 역할을 업데이트하고, 구성원을 제거할 수 있습니다.
# 조직 구성원 나열
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
# 구성원 역할 업데이트
curl "https://api.anthropic.com/v1/organizations/users/{user_id}" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{"role": "developer"}'
# 구성원 제거
curl --request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"조직 초대
사용자를 조직에 초대하고 해당 초대를 관리할 수 있습니다.
# 초대 생성
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{
"email": "[email protected]",
"role": "developer"
}'
# 초대 나열
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
# 초대 삭제
curl --request DELETE "https://api.anthropic.com/v1/organizations/invites/{invite_id}" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"워크스페이스
리소스를 구성하기 위해 워크스페이스 (콘솔)를 생성하고 관리합니다:
# 워크스페이스 생성
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{"name": "Production"}'
# 워크스페이스 나열
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
# 워크스페이스 아카이브
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"워크스페이스 구성원
특정 워크스페이스에 대한 사용자 액세스를 관리합니다:
# 워크스페이스에 구성원 추가
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{
"user_id": "user_xxx",
"workspace_role": "workspace_developer"
}'
# 워크스페이스 구성원 나열
curl "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members?limit=10" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
# 구성원 역할 업데이트
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{
"workspace_role": "workspace_admin"
}'
# 워크스페이스에서 구성원 제거
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"API 키
API 키를 모니터링하고 관리합니다:
# API 키 나열
curl "https://api.anthropic.com/v1/organizations/api_keys?limit=10&status=active&workspace_id=wrkspc_xxx" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"
# API 키 업데이트
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--data '{
"status": "inactive",
"name": "New Key Name"
}'조직 정보 액세스
/v1/organizations/me 엔드포인트를 사용하여 조직에 대한 정보를 프로그래밍 방식으로 가져옵니다.
예를 들어:
curl "https://api.anthropic.com/v1/organizations/me" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"{
"id": "12345678-1234-5678-1234-567812345678",
"type": "organization",
"name": "Organization Name"
}이 엔드포인트는 Admin API 키가 어떤 조직에 속하는지 프로그래밍 방식으로 결정하는 데 유용합니다.
완전한 매개변수 세부 정보 및 응답 스키마는 조직 정보 API 참조를 참조하세요.
사용량 및 비용 보고서 액세스
조직의 사용량 및 비용 보고서에 액세스하려면 사용량 및 비용 API 엔드포인트를 사용하세요:
- 사용량 엔드포인트 (
/v1/organizations/usage_report/messages)는 워크스페이스, 사용자, 모델과 같은 다양한 차원으로 그룹화된 토큰 수 및 요청 메트릭을 포함한 상세한 사용량 데이터를 제공합니다. - 비용 엔드포인트 (
/v1/organizations/cost_report)는 조직의 사용량과 관련된 비용 데이터를 제공하여 비용을 추적하고 워크스페이스 또는 설명별로 비용을 할당할 수 있습니다.
이러한 엔드포인트는 조직의 사용량 및 관련 비용에 대한 상세한 통찰력을 제공합니다.
Claude Code 분석 액세스
Claude Code를 사용하는 조직의 경우, Claude Code Analytics API는 상세한 생산성 메트릭 및 사용량 통찰력을 제공합니다:
- Claude Code Analytics 엔드포인트 (
/v1/organizations/usage_report/claude_code)는 세션, 코드 라인, 커밋, 풀 리퀘스트, 도구 사용량 통계, 사용자 및 모델별로 분류된 비용 데이터를 포함한 Claude Code 사용량에 대한 일일 집계 메트릭을 제공합니다.
이 API를 통해 개발자 생산성을 추적하고, Claude Code 채택을 분석하고, 조직을 위한 사용자 정의 대시보드를 구축할 수 있습니다.
모범 사례
Admin API를 효과적으로 사용하려면:
- 워크스페이스 및 API 키에 의미 있는 이름과 설명 사용
- 실패한 작업에 대한 적절한 오류 처리 구현
- 구성원 역할 및 권한 정기적 감사
- 사용하지 않는 워크스페이스 및 만료된 초대 정리
- API 키 사용량 모니터링 및 키 주기적 교체