Anthropic이 Claude API에 Linked billing 베타를 도입해 앱 사용자가 자기 Claude 조직으로 요금을 내게 할 수 있습니다 | DAKER 커뮤니티

Anthropic이 11월 17일 Claude Platform에 Linked billing 베타를 내놓았습니다. 내 앱의 사용자가 자기 Claude 조직을 앱에 한 번 연결해 두면, 그 사용자가 시킨 Claude 호출의 요금을 개발자가 아니라 사용자의 조직에 청구할 수 있다는 기능입니다. 요청마다 billing_policy 필드로 누가 낼지 고르며, 사용자가 연결을 끊으면 더는 청구되지 않습니다.

신문 조각을 오려 붙인 배경 위에서 영수증이 앱 모양 종이에서 고객 조직 모양 종이로 넘어가는 장면과 「클로드 사용료는 고객 조직이 냅니다」 문구 모션 미리보기
설명을 돕기 위해 만든 생성 이미지입니다.
신문 조각을 오려 붙인 배경 위에서 영수증이 앱 모양 종이에서 고객 조직 모양 종이로 넘어가는 장면과 「클로드 사용료는 고객 조직이 냅니다」 문구
설명을 돕기 위해 만든 생성 이미지입니다.

무엇이 새로 생겼나

지금까지 Claude API를 붙인 서비스는 호출 요금을 서비스 운영자가 먼저 부담하고, 그 비용을 구독료나 크레딧으로 사용자에게 다시 받아야 했습니다. Linked billing은 이 구조를 바꿉니다. 사용자가 앱 화면의 Link your Claude organization 버튼으로 자기 Claude 조직을 승인하면 둘 사이에 연결(connection)이 생기고, 이후 개발자는 요청마다 사용자가 낼지 자신이 낼지를 정합니다. Anthropic 문서는 사용자 몫으로 표시한 요청이 그 사용자에게 청구될 수 없으면 개발자에게 대신 청구하지 않고 요청을 거절한다고 설명합니다.

사용자 몫으로 표시한 요청은 사용자에게 청구할 수 없으면 개발자에게 넘어가지 않고 거절됩니다

어떤 사용자와 엔드포인트가 해당하나

모든 사용자가 대상은 아닙니다. Claude Platform 조직이 Anthropic에 API 사용료를 직접 내는 경우만 해당하고, 선불 크레딧과 청구서 결제는 모두 인정됩니다. AWS·Google Cloud·Azure 마켓플레이스로 결제하는 조직이나 Claude 구독 요금제만 있는 조직은 대상이 아니며, 이런 요청은 403 user_profile_not_billable 오류로 거절됩니다.

billing_policy는 현재 /v1/messages와 /v1/chat/completions에서 지원됩니다. 토큰 수 계산용 /v1/messages/count_tokens는 이 필드를 받아서 무시하므로 실제로 보낼 본문 그대로 토큰 수를 셀 수 있습니다. Message Batches는 아직 사용자 청구를 지원하지 않습니다. 배치 안에서 사용자 몫으로 표시한 요청은 오류로 처리되고 누구에게도 청구되지 않으며, 같은 배치의 다른 요청은 그대로 실행됩니다. 사용자 몫 요청에서는 요금이 붙는 코드 실행 기능도 쓸 수 없고 400 오류가 납니다.

결제에 쓸 수 있는 크레딧과 없는 크레딧

Claude Console에서 해당 조직이 직접 산 크레딧으로는 결제됩니다. 청구서 결제 조직이라면 이 요청분이 청구서에 포함됩니다. 반대로 Claude Max·Ultra·Team 요금제에 딸린 월간 API 크레딧 같은 일부 프로모션 크레딧과 파트너·VC·스타트업 프로그램 크레딧은 이 요청의 결제에 쓸 수 없다고 문서에 적혀 있습니다. 쓸 수 있는 크레딧이 없으면 402로 거절될 수 있는데, 응답만 봐서는 크레딧 부족인지 지출 한도 때문인지 알 수 없습니다. 앱에서 이 두 경우를 구분해 안내하려면 사용자에게 지출 한도와 잔액을 함께 확인하도록 알려야 합니다.

연결을 만드는 순서

설정은 두 단계로 나뉩니다. 먼저 개발자 조직의 관리자(Admin) 권한으로 세 가지를 한 번만 준비합니다. Console에서 OAuth 앱을 만들고 Bill and link to organizations 권한을 고르는 것, 클라이언트 비밀값 대신 Workload Identity Federation 기반의 인증을 설정하는 것, 그리고 백엔드가 Claude API를 부를 서비스 계정과 기본 워크스페이스를 지정하는 것입니다. Anthropic은 OAuth 앱에 클라이언트 시크릿을 발급하지 않습니다. 새 앱은 테스트 사용자만 연결할 수 있는 상태로 시작하고, 게시하면 모든 Claude 사용자가 연결할 수 있게 바뀝니다.

그다음 고객마다 사용자 프로필을 만들고, 푸시 방식 인가 요청으로 승인 화면 주소를 받아 사용자를 보낸 뒤, 돌아온 일회용 코드를 토큰으로 바꿔 connection_id를 고객 정보에 저장합니다. 연결하려는 고객은 자기 Claude 조직의 Admin 또는 Billing 역할이 있어야 합니다. 고객 한 곳의 Claude 조직은 한 앱 안에서 사용자 프로필 하나에만 연결할 수 있고, 한 프로필도 Claude 조직 하나에만 연결됩니다. 같은 회사의 여러 팀이 한 조직을 쓰면 프로필 하나를 같이 쓰고, 팀마다 조직이 따로 있으면 프로필도 따로 만듭니다.

개발자가 먼저 따져 볼 점

사용자 몫 요청도 실행은 개발자 조직에서 이루어집니다. 그래서 속도 제한, 모델 접근 권한, 서비스 티어, 데이터 보관 설정, 암호화 키는 개발자 조직의 것이 적용되고, 고객이 따로 맺은 제로 데이터 보관(ZDR), BAA, 고객 관리형 암호화 키(CMEK)는 이 요청에 적용되지 않습니다. 문서는 HIPAA, FERPA, CMEK 적용이 필요한 고객은 연결하지 말라고 안내합니다. 또 이 서비스는 베타라서 엔드포인트와 동작이 바뀔 수 있고 프로덕션에 맞지 않을 수 있다고 밝혔습니다.

한국 참가자와 실무자에게 주는 의미

해커톤이나 공모전 출품작을 서비스로 이어 가려는 팀에게 가장 현실적인 부담은 사용자가 늘수록 커지는 모델 호출 비용입니다. Linked billing은 Claude 조직을 이미 가진 개발자·기업 고객을 상대로 하는 도구, 예를 들어 사내 분석 도구나 개발자용 서비스처럼 사용자가 자기 API 계약을 가져올 만한 서비스에서 비용 구조를 단순하게 만들 수 있습니다. 반대로 일반 소비자를 상대로 하는 앱은 사용자 대부분이 Claude Platform 조직을 갖고 있지 않으므로 이 방식만으로는 요금을 해결할 수 없습니다.

다음 대회나 프로토타입 기획서에 Claude 호출 비용 계획이 들어간다면, 우리 사용자가 Anthropic과 직접 결제하는 조직인지부터 확인해 보시기 바랍니다. 그리고 기능이 베타이므로 심사나 시연에서 핵심 흐름으로 삼기보다 선택 가능한 결제 경로로 두는 편이 안전합니다. 정확한 필드 이름과 오류 코드는 아래 공식 문서에서 확인하실 수 있습니다.

공식 출처: Claude Platform 릴리스 노트(2026년 11월 17일 항목), Linked billing 가이드

내 서비스의 호출 비용을 사용자가 직접 부담하게 한다면, 어떤 사용자부터 연결을 요청하시겠습니까?