저널 Uncategorized

Claude API 연결 결제(Linked billing) 베타 정리: API 키 없이 외부 앱에 사용료 연결하는 법, 월 한도와 이용 조건

왼쪽 회사 건물 안에 자물쇠 달린 열쇠가 그대로 남아 있고, 빛나는 사슬 고리가 건물과 오른쪽 앱 화면을 잇고 있으며 그 위에 지출 한도를 뜻하는 계기판이 떠 있는 AI 생성 설명용 일러스트
AI로 생성한 설명용 일러스트이며 실제 사건의 사진이 아닙니다.

회사에서 Claude API를 쓰면서 외부 개발 도구나 업무 자동화 서비스에도 Claude를 붙이고 싶을 때가 있습니다. 지금까지는 보통 Claude Console에서 API 키를 만들어 그 서비스 설정 화면에 붙여 넣었습니다. 키가 비밀번호처럼 여러 곳에 흩어지기 때문에 보안 담당자 입장에서는 부담이 큰 방식이었습니다.

Anthropic은 2026년 11월 17일 Claude Platform 릴리스 노트에서 이 문제를 줄이는 연결 결제(Linked billing)를 베타로 공개했습니다. 키를 건네는 대신 내 Claude 조직을 외부 앱에 한 번 연결하면, 그 앱에서 쓴 Claude 사용료가 내 조직으로 바로 청구되는 방식입니다.

이 글은 공식 문서와 발표를 바탕으로, 이 기능을 쓰는 고객과 이 기능을 붙이려는 개발자가 각각 확인할 내용을 나눠 정리했습니다. 편집부가 직접 연결해 본 사용기가 아니며, 2026년 11월 22일에 확인한 내용입니다.

1. 연결 결제란: API 키 대신 조직을 연결하는 방식

Anthropic의 공식 소개 글에 따르면 연결 결제는 코딩 에이전트나 업무 자동화 도구 같은 외부 플랫폼이 고객에게 API 키를 받지 않고도 Claude 사용료를 고객이 내게 하는 기능입니다. 고객은 기존 Anthropic 결제 조건을 그대로 쓰고, 플랫폼별 지출 한도를 직접 정합니다.

  • 고객 쪽: 키를 만들어 넘기지 않으므로, 키를 저장·암호화·교체하는 부담이 플랫폼으로 넘어가지 않습니다.
  • 플랫폼 쪽: 승인 화면과 청구는 Anthropic이 맡으므로, 사용량 측정이나 청구서 발행을 따로 만들지 않아도 된다고 설명합니다.
  • 요청마다 선택: 플랫폼은 요청 하나하나에 대해 고객이 낼지, 플랫폼이 낼지 정할 수 있습니다.

발표 시점에 지원 플랫폼으로 소개된 곳은 Asana, ClickHouse, Factory, Gumloop, Harness, Higgsfield AI, Kilo Code, Linear, Major, Mintlify, Omni, OpenArt, Niteshift, Railway, Ramp, Runlayer, Tessera, Tines, Warp 등입니다. 지원 목록은 바뀔 수 있으니 사용하는 서비스의 결제·연동 설정 화면에서 직접 확인하는 편이 정확합니다.

2. 고객 입장: 연결하는 순서와 월 지출 한도

고객이 하는 일은 외부 앱에 있는 Link your Claude organization 버튼을 누르고 Claude에 로그인해 승인하는 것입니다. 연결 결제 개발 문서는 승인 화면이 다음 순서로 나온다고 설명합니다.

  1. 조직 선택: 내가 속한 조직이 여러 개일 때만 나옵니다.
  2. 결제 방식 안내 화면
  3. 월 지출 한도 설정
  4. 최종 연결 및 승인 버튼

승인하면 브라우저가 바로 원래 앱으로 돌아가며, 별도의 완료 확인 화면은 없습니다. 연결은 승인한 개인이 아니라 조직 전체에 속합니다. 승인한 직원이 퇴사해도 연결은 유지되므로, 담당자가 바뀔 때 연결 목록을 따로 점검해야 합니다.

승인할 수 있는 권한은 문서마다 표현이 조금 다릅니다. 개발 문서는 고객 조직에서 Admin 또는 Billing 역할이 필요하다고 적었고, 공식 소개 글은 Owner, Admin, Billing 역할의 Console 사용자가 승인한다고 적었습니다. 실제 승인 전에는 내 계정 역할을 Console에서 확인하는 것이 좋습니다.

  • 플랫폼마다 월 지출 한도를 따로 정하거나, 모든 플랫폼에 적용할 기본 한도를 둘 수 있습니다.
  • Console에서 연결된 플랫폼별 지출을 볼 수 있습니다.
  • 고객 조직 관리자나 플랫폼 쪽 관리자는 언제든 연결을 끊을 수 있습니다.
노트북을 든 사람이 조직 건물, 안내 카드, 지출 한도 계기판, 승인 체크 표시가 놓인 네 개의 발판을 차례로 오르고, 마지막 체크 표시에서 화살표가 앱 화면으로 돌아가는 승인 흐름 일러스트
AI로 생성한 설명용 일러스트

3. 누가 쓸 수 있나: 조직 결제 방식과 크레딧 조건

가장 먼저 확인할 조건은 결제 경로입니다. 연결 결제는 Anthropic에 API 사용료를 직접 내는 조직만 쓸 수 있습니다. 선불 크레딧과 청구서(인보이스) 결제는 모두 해당합니다.

  • AWS, Google Cloud, Azure 같은 클라우드 마켓플레이스를 통해 결제하는 조직은 쓸 수 없습니다.
  • Claude 구독 요금제만 있고 API 결제가 없는 조직도 쓸 수 없습니다. 이 경우 요청은 403 오류로 거절됩니다.
  • Console에서 그 조직이 직접 산 크레딧은 결제에 쓸 수 있습니다.
  • Claude Max, Ultra, Team 요금제에 딸린 월간 API 크레딧, 파트너·VC·스타트업 프로그램 크레딧은 이 요청에 쓸 수 없습니다.

쓸 수 있는 잔액이 없거나 한도에 걸리면 API가 402 오류로 요청을 거절할 수 있습니다. 문서는 이 응답만으로는 크레딧 부족인지 지출 한도 때문인지 구분되지 않는다고 밝힙니다. 고객 몫으로 표시한 요청을 고객에게 청구할 수 없으면 플랫폼에 대신 청구하지 않고 거절한다는 점도 함께 기억해 둘 만합니다.

기술 매체 The Next Web도 클라우드 마켓플레이스 결제 조직과 구독만 있는 조직이 제외되고, 요금제·스타트업 프로그램 크레딧을 쓸 수 없다는 점을 이 기능의 주요 제약으로 짚었습니다.

4. 개발자 입장: 요청마다 누가 낼지 정하는 방법

개발자는 고객별로 Claude 조직에 사용자 프로필(user profile)을 하나씩 만들고, 고객이 연결을 마치면 그 프로필로 요청을 보냅니다. 요청에는 사용자 프로필 ID 헤더를 붙이고, 고객에게 청구할 요청이면 본문에 billing_policy를 넣어 청구 대상을 정합니다.

  • 고객이 낼 때: bill_to 값을 user_profile로 지정하고, 베타 헤더 user-profiles-billing-2026-10-01을 함께 보냅니다.
  • 플랫폼이 낼 때: billing_policy를 빼거나 bill_to 값을 self로 지정합니다.
  • 지원 범위: /v1/messages와 /v1/chat/completions에서 쓸 수 있고, 토큰 수 계산 엔드포인트는 이 필드를 받아도 무시합니다.

제약도 있습니다. 메시지 배치(Message Batches)는 아직 고객 청구를 지원하지 않아, 배치 안에서 고객 청구를 지정한 요청은 오류로 처리되고 누구에게도 청구되지 않습니다. 고객에게 청구하는 Messages 요청에서는 과금되는 코드 실행 기능을 쓸 수 없어 400 오류가 납니다.

문서는 고객이 직접 지시한 요청에만 고객에게 청구할 수 있고, 플랫폼 자체 용도의 사용량은 고객에게 넘길 수 없다고 명시합니다. 또 한 앱 안에서 고객 조직과 사용자 프로필은 1대1로만 연결되므로, 한 고객사의 여러 팀이 같은 조직을 쓰면 프로필도 하나로 묶어야 합니다.

요청을 뜻하는 봉투가 철로 분기기를 지나 집 옆 동전 병(플랫폼)과 사무실 건물 옆 동전 병(고객 조직) 중 한쪽으로 가고, 세 번째 갈림길은 차단기로 막혀 있으며 플랫폼 쪽 위에 자물쇠 방패가 떠 있는 일러스트
AI로 생성한 설명용 일러스트

5. 개발자 준비 절차와 공개 심사

처음 한 번 하는 설정은 Claude Console에서 Admin 역할이 있는 사람이 진행합니다. Claude Platform OAuth 개요 문서가 정리한 순서는 다음과 같습니다.

  1. OAuth 앱 만들기: 앱 이름과 리디렉션 주소를 넣고, 조직 연결·청구 권한을 선택한 뒤 클라이언트 ID를 복사합니다.
  2. 클라이언트 인증 설정: Anthropic은 클라이언트 시크릿을 발급하지 않습니다. 대신 AWS, Google Cloud, Kubernetes 같은 자체 ID 공급자가 발급한 짧은 수명의 토큰으로 앱을 증명합니다.
  3. 백엔드 신원 설정: 서비스 계정과 워크로드 ID 페더레이션 규칙을 만들고, 이 서비스 계정을 앱의 운영 계정으로 지정합니다.

새 앱은 테스트 상태로 시작해 테스트 사용자 목록에 있는 사람만 연결할 수 있습니다. 실제 고객이 연결하려면 앱을 공개해야 합니다. 청구서 결제 조직은 확인 즉시 공개되지만, 그 외에는 앱 홈페이지 도메인을 DNS TXT 레코드로 증명한 뒤 Anthropic의 심사를 거칩니다. 문서는 DNS 반영에 최대 48시간이 걸릴 수 있으니 미리 시작하라고 권합니다.

심사에서 승인되지 않으면 스스로 다시 공개 신청을 할 수 없고 지원팀에 문의해야 합니다. 공개된 앱의 이름, 로고, 홈페이지, 리디렉션 주소를 바꾸면 다시 심사를 받으며, 이미 연결된 고객은 그대로 유지됩니다.

6. 도입 전 꼭 확인할 주의점

연결 결제 요청은 고객 조직이 아니라 플랫폼 조직 안에서 실행됩니다. 그래서 사용량 한도, 모델 접근 권한, 데이터 보관 기간, 암호화 키는 모두 플랫폼 쪽 설정을 따릅니다.

  • 고객 조직의 무보관(ZDR) 계약, 업무협약(BAA), 고객 관리 암호화 키(CMEK)는 이 요청에 적용되지 않습니다. 문서는 HIPAA, FERPA, CMEK 적용이 필요한 고객은 연결하지 말라고 안내합니다.
  • 공식 소개 글은 고객 조직의 IP 허용 목록도 이 요청에는 적용되지 않는다고 밝혔습니다.
  • Claude Platform OAuth는 베타 서비스로, 엔드포인트와 동작이 바뀔 수 있고 운영 환경에 맞지 않을 수 있다고 문서에 적혀 있습니다.
  • 개발자는 승인 후 받은 일회용 코드를 5분 안에 교환해야 하며, 연결 ID와 토큰은 교환 시 한 번만 내려오므로 바로 안전하게 저장해야 합니다.

요약하면, 고객은 키를 넘기지 않고 플랫폼별 한도를 직접 쥘 수 있지만 내 조직의 보안·데이터 설정이 그대로 따라가지는 않습니다. 민감한 데이터를 다루는 팀이라면 연결 전에 플랫폼의 데이터 처리 조건을 따로 확인하는 것이 안전합니다.

정리하면 연결 결제는 외부 앱에 API 키를 붙여 넣던 방식을 조직 연결과 월 한도로 바꾸는 기능입니다. 고객이라면 내 조직이 Anthropic에 직접 결제하는지, 내 역할로 승인할 수 있는지, 플랫폼별 한도를 얼마로 둘지부터 확인하면 됩니다. 개발자라면 배치·코드 실행 제약과 공개 심사 일정, 데이터 보호 조건이 고객에게 넘어가지 않는다는 점을 먼저 따져 보는 것이 좋습니다. 베타 기간에는 조건이 바뀔 수 있으니 실제 도입 직전에 공식 문서를 다시 확인하시기 바랍니다.

출처 (2026년 11월 22일 확인)

AI로 생성한 설명용 일러스트이며 실제 사건의 사진이 아닙니다.