Anthropic Admin API의 조직 관리 메서드, 베타에서 정식 버전(GA)으로 전환

Anthropic의 Admin API 중 조직 관리에 관한 메서드 그룹이 베타를 종료하고 **정식 버전(GA)**이 되었습니다. 이 내용은 2026년 9월 30일자 리포트 노트에 추가되었습니다.

각 공식 SDK 및 ant CLI에서는 새로운 네임스페이스인 client.organization / ant organization에서 호출할 수 있습니다.

📌 영향을 받는 사람

• Claude의 조직 관리(멤버, 워크스페이스, API 키 등)를 스크립트나 사내 툴로 자동화하는 관리자 및 플랫폼 엔지니어
• Python / TypeScript / C# / Go / Java / PHP / Ruby 공식 SDK 또는 ant CLI를 사용하는 사람
• 감사/규정 준수 대응을 위해 조직 설정을 IaC(Infrastructure as Code)나 정기 작업으로 관리하는 사람

결론적으로, 기존 코드는 작동하지 않습니다. 구 베타 네임스페이스도 남아있기 때문입니다. 하지만 신규 코드에서는 GA 쪽의 네임스페이스를 사용하는 것이 권장되며, 단계적인 마이그레이션을 고려할 가치가 있습니다.

GA 네임스페이스를 사용하려면 다음 버전 이상이 필요합니다.

⚠️ 주의: 베타 네임스페이스 종료 시기는 미기재
이번 변경 사항에는 베타 네임스페이스를 언제까지 남겨둘지에 대한 언급이 없습니다. '언젠가 사라질' 가능성을 전제로 계획적으로 마이그레이션하는 것이 안전합니다.

action_required는 false입니다. SDK를 업데이트해도 기존의 client.beta.organization / ant beta:organization 호출은 당장 작동하지 않습니다. - 다만, 구 네임스페이스 폐지 시기가 제시되지 않았으므로 방치하는 것은 권장하지 않습니다.

SDK / CLI 버전 확인: 위 표의 최소 버전 이상으로 업데이트할 것

• 신규 코드는 GA 네임스페이스로 작성: client.organization / ant organization
• 기존 코드 정리: beta.organization / beta:organization을 검색하여 사용 위치를 파악할 것
• 단계적으로 대체: 테스트 환경에서 작동 확인 후 본거지에 반영할 것
• 사내 가이드 업데이트: CLAUDE.md 등에 방침을 추가할 것

💡 팁
사용 위치 파악은 다음과 같은 명령어로 일괄 검색할 수 있습니다. grep -rnE "beta\.organization|beta:organization" .

Claude Code 등을 사용해 이 리포지토리를 개발하는 경우, 다음과 같은 방침을 작성해 두면 AI가 오래된 방식을 생성하는 것을 막을 수 있습니다.

## Claude API / SDK 이용 가이드 (Admin API)
- Admin API의 조직 관리 메서드는 GA 완료. 신규 코드에서는 `client.organization` / `ant organization` 사용
...

아래는 네임스페이스 변경 사항을 보여주기 위한 예시입니다. 구체적인 메서드 이름이나 인수는 사용하는 SDK의 레퍼런스로 확인해 주십시오.

# 이전: 베타 네임스페이스
client.beta.organization # ...각 메서드를 호출
# 이후: GA 네임스페이스 (Python SDK 1.10.0 이상)
...

// 이전: 베타 네임스페이스
client.beta.organization; // ...각 메서드 호출
// 이후: GA 네임스페이스 (TypeScript SDK 0.130.0 이상)
...

# 이전
ant beta:organization ...
# 이후 (ant CLI 1.37.0 이상)
...

이전 버전에서 이후 버전으로의 전환은 기본적으로 beta를 제거하는 것만으로 충분합니다. 호출 앞에 붙는 네임스페이스 부분만 교체하고, 그 뒤에 오는 메서드 호출은 기존 것을 그대로 사용하시면 됩니다.

• Admin API의 조직 관리 메서드(조직 정보, 멤버, 초대, 워크스페이스, API 키, 레이트 제한, 서비스 계정, 워크로드 아이덴티티 연합(federation), CMEK, 컴플라이언스 설정)가 GA로 전환되었습니다. - 새로운 호출 경로는 SDK의 경우 client.organization,
  CLI의 경우 ant organization입니다.
• 필요한 버전은 Python 1.10.0, TypeScript 0.130.0, C# 12.52.0, Go 1.77.0, Java 2.67.0, PHP 0.53.0, Ruby 1.75.0, ant CLI 1.37.0 이상입니다.
• 이전 버전의 client.beta.organization / ant beta:organization도 남아있으므로, 기존 코드는 그대로 작동합니다. - 베타 네임스페이스 폐지 시기가 명시되어 있지 않으므로, 신규 코드는 GA 쪽으로 작성하고 기존 코드는 단계적으로 마이그레이션하는 것이 안전합니다.

조직 관리를 자동화하고 계신 분들은 먼저 grep을 사용하여 이전 네임스페이스 사용 부분을 확인하는 것부터 시작해 보시는 것을 추천드립니다.