워크스페이스

워크스페이스는 조직 내에서 API 사용을 구성하는 방법을 제공합니다. 워크스페이스를 사용하여 중앙 집중식 청구 및 관리를 유지하면서 다양한 프로젝트, 환경 또는 팀을 분리할 수 있습니다.

워크스페이스 작동 방식

모든 조직에는 이름을 바꾸거나, 보관하거나, 삭제할 수 없는 기본 워크스페이스가 있습니다. 추가 워크스페이스를 만들 때 각 워크스페이스에 API 키, 멤버 및 리소스 제한을 할당할 수 있습니다.

주요 특징:

• 워크스페이스 식별자는 wrkspc_ 접두사를 사용합니다(예: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ).
• 조직당 최대 100개 워크스페이스(보관된 워크스페이스는 계산되지 않음)
• 기본 워크스페이스는 ID가 없으며 목록 엔드포인트에 나타나지 않습니다.
• API 키는 단일 워크스페이스로 범위가 지정되며 해당 워크스페이스 내의 리소스에만 액세스할 수 있습니다.

워크스페이스 역할 및 권한

멤버는 각 워크스페이스에서 다양한 역할을 가질 수 있으므로 세밀한 액세스 제어가 가능합니다.

역할 상속

• 조직 관리자는 모든 워크스페이스에 대해 자동으로 Workspace Admin 액세스를 받습니다.
• 조직 청구 멤버는 모든 워크스페이스에 대해 자동으로 Workspace Billing 액세스를 받습니다.
• 조직 사용자 및 개발자는 각 워크스페이스에 명시적으로 추가되어야 합니다.

워크스페이스 관리

Claude Console을 통해

Claude Console에서 워크스페이스를 만들고 관리합니다.

워크스페이스 만들기

워크스페이스 세부 정보 편집

워크스페이스의 이름 또는 색상을 수정하려면:

1. 목록에서 워크스페이스를 선택합니다.
2. 줄임표 메뉴(...)를 클릭하고 Edit details를 선택합니다.
3. 이름 또는 색상을 업데이트하고 변경 사항을 저장합니다.

워크스페이스에 멤버 추가

1. 워크스페이스의 Members 탭으로 이동합니다.
2. Add to Workspace를 클릭합니다.
3. 조직 멤버를 선택하고 워크스페이스 역할을 할당합니다.
4. 추가를 확인합니다.

멤버를 제거하려면 해당 이름 옆의 휴지통 아이콘을 클릭합니다.

워크스페이스 제한 설정

Limits 탭에서 다음을 구성할 수 있습니다:

• Rate limits: 분당 요청, 입력 토큰 또는 출력 토큰에 대해 모델 계층별 제한 설정
• Spend notifications: 지출이 특정 임계값에 도달할 때 경고 구성

워크스페이스 보관

워크스페이스를 보관하려면 줄임표 메뉴(...)를 클릭하고 Archive를 선택합니다. 보관하면:

• 보고를 위한 과거 데이터 보존
• 워크스페이스 및 모든 관련 API 키 비활성화
• 실행 취소할 수 없음

Admin API를 통해

Admin API를 사용하여 프로그래밍 방식으로 워크스페이스를 관리합니다.

# 워크스페이스 만들기
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"

완전한 매개변수 세부 정보 및 응답 스키마는 Workspaces API reference를 참조하세요.

워크스페이스 멤버 관리

워크스페이스에서 멤버를 추가, 업데이트 또는 제거합니다:

# 워크스페이스에 멤버 추가
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 --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"

완전한 매개변수 세부 정보는 Workspace Members API reference를 참조하세요.

API 키 및 리소스 범위 지정

API 키는 특정 워크스페이스로 범위가 지정됩니다. 워크스페이스에서 API 키를 만들 때 해당 워크스페이스 내의 리소스에만 액세스할 수 있습니다.

워크스페이스로 범위가 지정된 리소스는 다음을 포함합니다:

• Files Files API를 통해 생성됨
• Message Batches Batch API를 통해 생성됨
• Skills Skills API를 통해 생성됨

워크스페이스 제한

각 워크스페이스에 대해 사용자 정의 지출 및 속도 제한을 설정하여 과도한 사용을 방지하고 공정한 리소스 분배를 보장할 수 있습니다.

워크스페이스 제한 설정

워크스페이스 제한은 조직의 제한보다 낮게 설정할 수 있지만 높게 설정할 수는 없습니다:

• Spend limits: 워크스페이스의 월간 지출 상한선
• Rate limits: 분당 요청, 분당 입력 토큰 또는 분당 출력 토큰 제한

속도 제한 및 작동 방식에 대한 자세한 정보는 Rate limits를 참조하세요.

사용량 및 비용 추적

Usage and Cost API를 사용하여 워크스페이스별 사용량 및 비용을 추적합니다:

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

기본 워크스페이스에 귀속된 사용량 및 비용은 workspace_id에 대해 null 값을 가집니다.

일반적인 사용 사례

환경 분리

개발, 스테이징 및 프로덕션을 위한 별도의 워크스페이스를 만듭니다:

팀 또는 부서 격리

비용 할당 및 액세스 제어를 위해 다양한 팀에 워크스페이스를 할당합니다:

• Engineering team 개발자 액세스 포함
• Data science team 자체 API 키 포함
• Support team 고객 도구에 대한 제한된 액세스 포함

프로젝트 기반 구성

특정 프로젝트 또는 제품에 대한 워크스페이스를 만들어 사용량 및 비용을 별도로 추적합니다.

모범 사례

FAQ

참고 항목

• Admin API overview
• Admin API reference
• Rate limits
• Usage and Cost API