Claude API ‘링크드 빌링’ 베타: 고객 API 키 없이 고객 조직에 사용료 청구하기
11월 17일부터 Claude API를 쓰는 서비스는 고객의 API 키를 받지 않고도 고객 조직의 Claude 계정으로 사용료를 청구할 수 있어요. ‘링크드 빌링(Linked billing)’이라는 베타 기능이고, 요청마다 billing_policy 필드로 누가 낼지 정하는 방식이에요.
어떤 문제를 푸는 기능인가요
지금까지 코딩 에이전트나 자동화 도구가 “고객 돈으로” Claude를 쓰려면 보통 고객에게 API 키를 받아 보관했어요. 앤트로픽 공지는 이것을 비밀번호를 나눠 갖는 것과 같다고 설명해요. 서비스는 고객 키를 암호화하고 교체하는 부담을 지고, 고객은 키가 밖으로 나가는 위험을 지게 되죠.
링크드 빌링에서는 키가 오가지 않아요. 고객 조직의 관리자(Admin 또는 Billing 역할)가 OAuth 화면에서 한 번 승인하면, 서비스 쪽 조직과 고객 조직 사이에 ‘연결(connection)’이 생겨요. 고객은 승인할 때 월 지출 한도를 정하고, 나중에 Console에서 언제든 연결을 끊을 수 있어요. 공지에는 Asana, Linear, Warp, Railway 등 19개 플랫폼이 이미 지원한다고 적혀 있어요.
개발자가 해야 하는 일
문서 기준으로 순서를 줄이면 이래요.
- Console의 OAuth 앱 화면에서 앱을 만들고 “Bill and link to organizations”를 고릅니다. 클라이언트 시크릿은 발급되지 않고, 백엔드는 RFC 7523 방식의 클라이언트 어설션(JWT)으로 인증해요.
- 내 조직에 서비스 계정을 만들고 이 앱의 운영 계정으로 지정한 뒤, 연결 토큰용 기본 워크스페이스를 정합니다.
- 고객마다 사용자 프로필(
uprof_…)을 만들어 저장합니다. 같은 참조 ID로 다시 만들어도 새 프로필이 생기니 재사용해야 해요. - PAR(pushed authorization request)를 보내고 고객을 승인 화면으로 보낸 뒤, 콜백에서 코드를 교환해
connection_id를 받습니다.
그다음 고객이 내야 하는 요청에는 프로필 헤더와 베타 헤더를 붙이고 bill_to를 user_profile로 지정해요. 아래는 문서 예제를 그대로 옮긴 것이고, 직접 실행해 보지는 않았어요.
curl https://api.anthropic.com/v1/messages \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "anthropic-version: 2026-10-21" \
-H "anthropic-beta: user-profiles-billing-2026-10-01" \
-H "anthropic-user-profile-id: uprof_01HV9Z" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}],
"billing_policy": {"type": "billing_policy", "bill_to": "user_profile"}
}'
bill_to를 self로 하거나 billing_policy를 아예 빼면 서비스 쪽이 내요.
쓰기 전에 알아 둘 점
- 대상 고객이 제한돼요. 앤트로픽에 API 요금을 직접 내는 조직만 연결할 수 있어요. AWS·Google Cloud·Azure 마켓플레이스로 결제하는 조직이나 Claude 구독 플랜만 있는 조직은
403 user_profile_not_billable로 거절돼요. - 데이터 조건은 서비스 쪽을 따라요. 요청은 서비스 조직 안에서 실행되므로 고객의 ZDR, BAA, CMEK 같은 설정은 적용되지 않아요. 문서는 HIPAA나 CMEK가 필요한 고객은 연결하지 말라고 해요.
- 헤더 실수는 오류 없이 청구돼요. 운영 계정 자격 증명은 연결된 모든 고객에게 청구할 수 있어서, 프로필 헤더를 잘못 넣으면 다른 고객에게 요금이 붙어도 에러가 나지 않는다고 문서가 경고해요. 연결마다 전용 토큰을 쓰는 옵션이 있으니 이쪽을 검토할 만해요.
- 일부 엔드포인트는 안 돼요. 배치 API는 고객 청구를 지원하지 않고, 과금되는 코드 실행 기능을 쓴 요청에
user_profile을 지정하면 400이 나요. 토큰 계산 엔드포인트는 이 필드를 받아들이고 무시해요. - 잔액이나 한도가 모자라면
402가 오는데, 원인이 무엇인지는 알려 주지 않아요. 베타라서 필드와 동작이 바뀔 수 있어요.
누구에게 쓸모 있나요
여러 회사 고객에게 Claude 기반 기능을 파는 SaaS나 개발 도구라면, 사용량만큼 요금을 다시 계산해 청구하던 일을 앤트로픽 결제로 넘길 수 있어요. 반대로 기업 고객의 보안 조건(데이터 보존, 암호화 키)을 그대로 지켜야 하는 서비스라면 이 기능만으로는 맞지 않아요.
출처: Claude Platform 릴리스 노트, Linked billing 문서, Claude 블로그: Linked billing on the Claude Platform