본문으로 건너뛰기
PIXEL & CODE

AI 뉴스 ·

클로드 엔터프라이즈 사용자 관리 API, 왜 7월에 나왔을까요

클로드 엔터프라이즈 사용자 관리 API란 무엇인가요

2026년 7월 13일, Anthropic은 Claude Enterprise(claude.ai) 조직의 구성원을 Admin API로 직접 관리할 수 있는 기능을 베타로 공개했습니다. 이메일로 멤버를 조회하고, 역할을 바꾸고, 멤버를 제거하고, 초대를 보내거나 철회하고, 그룹과 그룹 멤버십을 관리하고, 커스텀 역할을 조회하는 작업까지 API 호출 하나로 처리할 수 있게 됐습니다. 지금까지는 이런 작업을 관리자가 웹 admin 콘솔에 매번 로그인해서 클릭하거나, SCIM 2.0 연동이 갖춰진 대규모 조직만 자동화할 수 있었는데, 이제는 API 키만 있으면 중소 규모 조직도 이 작업을 스크립트로 처리할 수 있습니다.

이 소식이 실무자에게 중요한 이유는 단순합니다. AI 도구가 회사 전체로 퍼질수록 “누가 어떤 권한으로 Claude를 쓰고 있는지”를 관리하는 일이 IT 담당자의 새로운 상시 업무가 되기 때문입니다. 직원이 입사하면 계정을 만들어주고, 퇴사하면 즉시 접근을 끊고, 부서 이동이 생기면 역할을 바꿔주는 일을 매번 콘솔에서 손으로 처리하다 보면 누락이 생기기 쉽습니다. 이번 업데이트는 바로 그 반복 작업을 코드로 대체할 수 있게 해주는 변화입니다.

무엇이 바뀌었나요

기존 공개 API(api.anthropic.com/v1)는 추론(모델 호출) 전용이라 멤버 목록 조회, 초대, 역할 변경 같은 사용자 관리 엔드포인트가 없었습니다. 이런 작업은 Claude 웹 admin 콘솔에서 수동으로 하거나, SCIM 2.0을 연동한 Enterprise 조직만 IdP(Okta, Entra ID 등)를 통해 자동화할 수 있었습니다. SCIM 연동은 SSO 설정이 먼저 완료되어 있어야 하고, 설정 난이도도 낮지 않아 중소 규모 조직에서는 접근하기 쉽지 않은 방식이었습니다.

이번 베타는 이 간극을 줄여줍니다. Admin API 키만 있으면 별도의 SSO·SCIM 인프라 구축 없이도 아래와 같은 작업을 스크립트로 처리할 수 있습니다.

  • 조직 멤버 목록 조회 및 이메일로 특정 멤버 찾기
  • 멤버 역할(role) 변경
  • 멤버 제거
  • 초대 발송 및 철회
  • 그룹과 그룹 멤버십 관리, 커스텀 역할 조회

그룹 관리나 커스텀 역할 조회 요청에는 anthropic-beta: ce-user-management-2026-07-13 베타 헤더가 필요하고, 멤버 조회나 초대 관련 요청은 헤더 없이 바로 호출할 수 있습니다. 또한 read:org_audit 스코프를 가진 Admin API 키라면 모든 사용자 관리 GET 엔드포인트를 조회 전용으로 호출할 수 있어, 감사(audit) 목적으로 별도 권한을 분리해 운용하는 것도 가능합니다.

클로드 엔터프라이즈 사용자 관리 API 핵심 정리

실무에서는 어떻게 쓸 수 있나요

픽셀앤코드처럼 인사 시스템에 입퇴사 정보가 이미 있는 중소기업이라면, 이 API를 인사 이벤트에 연동하는 간단한 자동화가 가능합니다. 예를 들어 퇴사자가 발생하면 사내 인사 스프레드시트나 그룹웨어에서 정보를 읽어와 해당 이메일의 Claude 계정을 자동으로 제거하는 스크립트를 만들 수 있습니다.

import requests

ADMIN_KEY = "sk-ant-admin-..."
BASE_URL = "https://api.anthropic.com/v1/organizations"

headers = {
    "anthropic-version": "2023-06-01",
    "x-api-key": ADMIN_KEY,
}

def find_user_by_email(email):
    resp = requests.get(f"{BASE_URL}/users", headers=headers, params={"limit": 100})
    resp.raise_for_status()
    for user in resp.json().get("data", []):
        if user.get("email") == email:
            return user
    return None

def remove_user(user_id):
    resp = requests.delete(f"{BASE_URL}/users/{user_id}", headers=headers)
    resp.raise_for_status()
    return resp.status_code

# 퇴사자 이메일 목록을 인사 시스템에서 받아와 처리하는 예시
retired_emails = ["hong.gildong@company.co.kr"]

for email in retired_emails:
    user = find_user_by_email(email)
    if user:
        remove_user(user["id"])
        print(f"{email} 계정 접근 제거 완료")
    else:
        print(f"{email} 계정을 찾지 못했습니다")

이런 식의 자동화는 파이썬으로 만드는 업무 자동화를 이미 경험해본 실무자라면 어렵지 않게 확장할 수 있는 수준입니다. 또한 API 호출 권한을 누구에게 어떻게 줄지 고민된다면, 클로드 엔터프라이즈 모델 접근 관리 글에서 다룬 역할별 권한 설계 원칙을 함께 참고하면 좋습니다.

다만 이 기능은 아직 베타이고 Claude Enterprise 플랜에 한정됩니다. 지금 이 API가 필요한 조직이라면, 우선 소수 계정으로 조회(GET)와 역할 변경을 테스트해보고, 실제 삭제·초대 철회 같은 되돌리기 어려운 작업은 로그를 남기는 절차를 먼저 만든 뒤 적용하는 순서를 권합니다. 자동화 스크립트를 만든 뒤에는 자동화 로그 작성법처럼 누가 언제 무엇을 바꿨는지 기록을 남겨두면, 나중에 문제가 생겼을 때 원인을 훨씬 빠르게 찾을 수 있습니다.

왜 지금 이런 기능이 나왔을까요

Claude가 챗봇을 넘어 Cowork, Claude Code, 각종 커넥터까지 포함한 업무 플랫폼으로 확장되면서, 조직 안에서 관리해야 할 계정과 권한의 종류도 함께 늘어났습니다. 이번 사용자 관리 API는 앞서 나온 관리자 분석·비용 통제 기능과 같은 흐름 위에 있는 변화로, Anthropic이 Enterprise 고객의 “운영 부담”을 낮추는 방향으로 계속 기능을 채워가고 있다는 신호로 볼 수 있습니다. AI 도입 초기에는 기능 자체에 관심이 쏠리지만, 사용자가 늘어난 다음에는 이런 관리 기능의 성숙도가 실제 운영 난이도를 결정합니다.

아직 Claude를 회사 전체에 배포하지 않았거나 소수 인원만 쓰고 있다면 지금 당장 이 API가 필요하지는 않을 수 있습니다. 하지만 조직 규모가 커지고 입퇴사·부서이동이 잦아지는 시점을 대비해, 관리 기능이 어떤 방향으로 발전하고 있는지 눈여겨봐 둘 필요는 있습니다. 픽셀앤코드는 이런 관리자용 API를 사내 시스템과 연동하는 자동화 작업을 포함해, 중소기업과 관공서가 AI 도구를 실무에 안전하게 붙이는 과정을 함께 설계하는 작업을 지원하고 있습니다.