Anthropic, Rate Limits API 도입: 관리자가 조직 및 워크스페이스의 속도 제한 설정을 프로그래밍 방식으로 조회 가능

Anthropic은 2026년 4월 24일 릴리스 노트에서 새로운 Rate Limits API를 발표했습니다. 이는 더 광범위한 Admin API의 일부로, 관리자가 조직 및 개별 워크스페이스에 설정된 속도 제한 구성을 프로그래밍 방식으로 조회할 수 있게 합니다. 지금까지 Claude Console 그래픽 인터페이스에서만 확인할 수 있었던 기능의 자연스러운 확장입니다.

새 API가 노출하는 엔드포인트와 반환 내용

API는 https://api.anthropic.com을 통해 접근할 수 있는 두 개의 주요 엔드포인트를 노출합니다. **GET /v1/organizations/rate_limits**는 Messages API 및 관련 리소스(Claude Managed Agents 제한은 미포함)에 대해 조직 수준에서 적용된 모든 속도 제한을 반환합니다. **GET /v1/organizations/workspaces/{workspace_id}/rate_limits**는 특정 워크스페이스에 설정된 재정의 값만 반환합니다. 응답에 존재하지 않는 항목은 워크스페이스가 조직 값을 상속함을 의미합니다.

두 엔드포인트는 카테고리별 필터링을 위한 선택적 group_type 쿼리 파라미터를 지원합니다. 유효한 값은 model_group, batch, token_count, files, skills, web_search입니다. 조직 엔드포인트는 추가로 model 파라미터를 받아 지정한 모델이 속한 그룹을 반환합니다.

각 레코드는 하나의 속도 제한 그룹을 나타냅니다. model_group 유형 그룹의 경우 models 필드에 동일한 할당량을 공유하는 모든 모델 ID와 별칭이 나열됩니다(예: Opus 4.5, 4.6, 4.7은 동일한 RPM 할당량 공유). limits 필드에는 {type, value} 쌍이 포함되며, type은 requests_per_minute, input_tokens_per_minute, output_tokens_per_minute 중 하나입니다. 워크스페이스 엔드포인트는 각 제한에 org_limit 필드를 추가로 제공하여 재정의 값의 비교와 감사를 용이하게 합니다.

세 가지 실제 활용 시나리오

엔드포인트에는 sk-ant-admin 접두사의 전용 Admin API 키가 필요하며, 표준 API 키와 구별됩니다. 관리자 역할을 가진 조직 구성원만 Claude Console에서 생성할 수 있으므로, 제한 정보 접근을 런타임에 내장할 필요 없이 CI/CD 또는 모니터링 프로세스에 분리하여 보관할 수 있습니다.

Anthropic은 문서에서 세 가지 시나리오를 명시적으로 제시합니다. 첫 번째는 게이트웨이 및 프록시 동기화——자체 API 게이트웨이가 시작 시 및 스케줄에 따라 현재 제한을 읽어, Anthropic이 변경 시 「드리프트」되는 하드코딩된 값을 피할 수 있습니다. 두 번째는 내부 경보——Usage and Cost API 데이터와 설정된 제한을 비교하여 429 오류가 반환되기 전에 조기 경고를 발생시킵니다. 세 번째는 구성 감사——워크스페이스 재정의 값이 프로비저닝 자동화 도구의 예상과 일치하는지 확인합니다.

동일한 워크스페이스를 통해 여러 클라이언트를 위한 Claude 통합을 구축하는 팀에게 세 번째는 특히 실용적입니다——Terraform 또는 Ansible 작업으로 합의된 구성 외부에서 누군가 제한을 수동으로 변경했는지 주기적으로 확인할 수 있습니다. API는 쓰기 작업을 지원하지 않습니다. 워크스페이스 제한은 Console을 통해 변경해야 합니다.