관리 및 모니터링

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...으로 시작)가 필요합니다. 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	위의 모든 작업 수행 가능, 추가로 사용자 관리 가능

주요 개념

조직 멤버

조직 멤버를 목록 조회하고, 멤버 역할을 업데이트하고, 멤버를 제거할 수 있습니다.

Shell

# List organization members
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Update member role
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"}'

# Remove member
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"

조직 초대

사용자를 조직에 초대하고 해당 초대를 관리할 수 있습니다.

Shell

# Create invite
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"
  }'

# List invites
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Delete invite
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"

워크스페이스

워크스페이스에 대한 종합 가이드는 워크스페이스를 참조하세요.

리소스를 구성하기 위해 워크스페이스(콘솔)를 생성하고 관리하세요:

Shell

# Create workspace
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"}'

# List workspaces
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"

# Archive workspace
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"

워크스페이스 멤버

특정 워크스페이스에 대한 사용자 접근을 관리하세요:

Shell

# Add member to workspace
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"
  }'

# List workspace members
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"

# Update member role
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"
  }'

# Remove member from workspace
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 키를 모니터링하고 관리하세요:

Shell

# List API keys
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"

# Update API key
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 레퍼런스를 참조하세요.

사용량 및 비용 보고서 접근

조직의 사용량 및 비용 보고서에 접근하려면 Usage 및 Cost API 엔드포인트를 사용하세요:

Usage 엔드포인트 (/v1/organizations/usage_report/messages)는 워크스페이스, 사용자, 모델 등 다양한 차원별로 그룹화된 토큰 수 및 요청 메트릭을 포함한 상세 사용량 데이터를 제공합니다.
Cost 엔드포인트 (/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 키 사용량을 모니터링하고 주기적으로 키를 교체하세요

FAQ

Was this page helpful?

관리 및 모니터링

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는 특별한 접근 권한이 필요합니다

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	위의 모든 작업 수행 가능, 추가로 사용자 관리 가능

주요 개념

조직 멤버

조직 멤버를 목록 조회하고, 멤버 역할을 업데이트하고, 멤버를 제거할 수 있습니다.

Shell

# List organization members
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Update member role
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"}'

# Remove member
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"

조직 초대

사용자를 조직에 초대하고 해당 초대를 관리할 수 있습니다.

Shell

# Create invite
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"
  }'

# List invites
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Delete invite
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"

워크스페이스

워크스페이스에 대한 종합 가이드는 워크스페이스를 참조하세요.

리소스를 구성하기 위해 워크스페이스(콘솔)를 생성하고 관리하세요:

Shell

# Create workspace
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"}'

# List workspaces
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"

# Archive workspace
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"

워크스페이스 멤버

특정 워크스페이스에 대한 사용자 접근을 관리하세요:

Shell

# Add member to workspace
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"
  }'

# List workspace members
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"

# Update member role
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"
  }'

# Remove member from workspace
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 키를 모니터링하고 관리하세요:

Shell

# List API keys
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"

# Update API key
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 레퍼런스를 참조하세요.

사용량 및 비용 보고서 접근

조직의 사용량 및 비용 보고서에 접근하려면 Usage 및 Cost API 엔드포인트를 사용하세요:

Usage 엔드포인트 (/v1/organizations/usage_report/messages)는 워크스페이스, 사용자, 모델 등 다양한 차원별로 그룹화된 토큰 수 및 요청 메트릭을 포함한 상세 사용량 데이터를 제공합니다.
Cost 엔드포인트 (/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 키 사용량을 모니터링하고 주기적으로 키를 교체하세요

FAQ

Was this page helpful?

Admin API 작동 방식

조직 역할 및 권한

주요 개념

조직 멤버

조직 초대

워크스페이스

워크스페이스 멤버

API 키

조직 정보 접근

사용량 및 비용 보고서 접근

Claude Code 분석 접근

모범 사례

FAQ

Admin API를 사용하려면 어떤 권한이 필요한가요?

Admin API를 통해 새 API 키를 생성할 수 있나요?

사용자를 제거하면 API 키는 어떻게 되나요?

API를 통해 조직 관리자를 제거할 수 있나요?

조직 초대는 얼마나 오래 유효한가요?

워크스페이스에 제한이 있나요?

기본 워크스페이스란 무엇인가요?

조직 역할은 워크스페이스 접근에 어떤 영향을 미치나요?

워크스페이스에서 어떤 역할을 할당할 수 있나요?

조직 admin 또는 billing 멤버의 워크스페이스 역할을 변경할 수 있나요?

조직 역할이 변경되면 워크스페이스 접근은 어떻게 되나요?

Admin API 작동 방식

조직 역할 및 권한

주요 개념

조직 멤버

조직 초대

워크스페이스

워크스페이스 멤버

API 키

조직 정보 접근

사용량 및 비용 보고서 접근

Claude Code 분석 접근

모범 사례

FAQ

Admin API를 사용하려면 어떤 권한이 필요한가요?

Admin API를 통해 새 API 키를 생성할 수 있나요?

사용자를 제거하면 API 키는 어떻게 되나요?

API를 통해 조직 관리자를 제거할 수 있나요?

조직 초대는 얼마나 오래 유효한가요?

워크스페이스에 제한이 있나요?

기본 워크스페이스란 무엇인가요?

조직 역할은 워크스페이스 접근에 어떤 영향을 미치나요?

워크스페이스에서 어떤 역할을 할당할 수 있나요?

조직 admin 또는 billing 멤버의 워크스페이스 역할을 변경할 수 있나요?

조직 역할이 변경되면 워크스페이스 접근은 어떻게 되나요?