claudekit / updates / linked-billing-claude-platform
[ NEW · ]

Claude Platform linked billing — API 키 공유 없이 고객 조직으로 사용량 청구 (베타)

Claude Platform에 linked billing이 베타로 공개됐습니다. 코딩 에이전트, 워크플로 자동화 도구 같은 외부 플랫폼이 고객에게 API 키를 받지 않고도, 고객이 연결한 Claude Platform 조직으로 Claude API 사용량을 직접 청구할 수 있습니다. 고객은 플랫폼마다 월 지출 한도를 정하고 언제든 연결을 해제할 수 있습니다.

공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

핵심 요약

Anthropic이 2026년 11월 17일에 Claude Platform의 linked billing을 베타로 공개했습니다. 코딩 에이전트나 워크플로 자동화 도구 같은 외부 플랫폼이 고객에게 API 키를 받지 않고도 Claude API 사용량을 고객의 Claude Platform 조직으로 직접 청구할 수 있게 하는 기능입니다. 고객은 기존 Anthropic 결제 방식을 그대로 유지하면서 플랫폼마다 지출 한도를 정할 수 있습니다.

주요 기능

  • API 키를 주고받지 않는 청구 연결

    고객이 API 키를 플랫폼에 공유하는 방식이라면, 플랫폼은 그 키를 저장하고 암호화하고 교체(rotation)해야 하고, 고객은 조직 밖으로 키를 내보내야 합니다. linked billing에서는 고객이 Anthropic이 호스팅하는 승인 화면에서 자기 조직을 한 번 연결하면, 사용량이 그 조직으로 바로 청구됩니다. 키는 고객 조직 안에 남아 있습니다. 연결 승인은 Owner, Admin, Billing 역할을 가진 Console 사용자가 합니다.

  • 기존 결제 방식 유지와 플랫폼별 지출 한도

    고객은 기존 Anthropic 약정(commitment)에서 차감하거나 사용한 만큼 결제(pay as you go)할 수 있습니다. 플랫폼마다 월 지출 한도를 정하거나, 모든 플랫폼에 각각 적용되는 기본 한도를 설정할 수 있고, Console에서 플랫폼별 지출을 확인합니다. 연결은 언제든 해제할 수 있습니다.

  • 요청마다 누가 낼지 플랫폼이 선택

    플랫폼은 요청 단위로 비용을 플랫폼이 낼지 고객이 낼지 정합니다. 공식 문서에 따르면 /v1/messages, /v1/chat/completions 요청에 anthropic-user-profile-id 헤더와 billing_policy의 bill_to: "user_profile"을 넣으면 고객에게 청구되고, bill_to: "self"이거나 billing_policy를 생략하면 플랫폼이 냅니다. 이 요청에는 베타 헤더 user-profiles-billing-2026-10-01이 필요합니다.

  • 고객별 사용량 확인

    플랫폼은 연결된 고객별 요청 수, 토큰 사용량, 사용한 모델을 Console이나 Usage and Cost Analytics API(베타)로 확인할 수 있습니다. 승인 화면과 청구는 Anthropic이 호스팅하므로, 플랫폼은 결제 연동을 직접 만들지 않아도 됩니다.

알아두면 좋은 점

  • 베타 기능입니다 — 공식 문서는 베타 기간 동안 엔드포인트, 파라미터, 동작이 바뀔 수 있고 프로덕션에 적합하지 않을 수 있다고 안내합니다. 별도 가격 정보는 발표문에 없습니다.
  • 지원 플랫폼 — 발표 시점에 Asana, ClickHouse, Factory, Gumloop, Harness, Higgsfield AI, Kilo Code, Linear, Major, Mintlify, Omni, OpenArt, Niteshift, Railway, Ramp, Runlayer, Tessera, Tines, Warp가 지원합니다. linked billing을 제공하는 플랫폼은 Claude Marketplace에서 찾을 수 있습니다.
  • 고객 조직의 설정은 적용되지 않습니다 — 요청은 플랫폼의 조직에서 실행되므로 고객 조직의 IP 허용 목록, 암호화 키, 데이터 보존 설정이 적용되지 않습니다. 공식 문서는 제로 데이터 보존(ZDR), BAA(business associate agreement), 고객 관리 암호화 키(CMEK)도 적용되지 않으며, HIPAA, FERPA, CMEK 보호가 필요한 고객은 연결하지 말라고 안내합니다.
  • 결제 가능한 조직이 정해져 있습니다 — API 사용료를 Anthropic에 직접 결제하는 조직(선불 크레딧, 청구서 결제)만 대상입니다. AWS, Google Cloud, Azure 마켓플레이스로 결제하는 조직과 Claude 구독 플랜만 있는 조직은 청구할 수 없습니다. Claude Max, Ultra, Team 플랜에 포함된 월 API 크레딧이나 파트너, VC, 스타트업 프로그램 크레딧 같은 일부 프로모션 크레딧으로는 결제되지 않습니다.
  • 일부 API 기능은 고객 청구를 지원하지 않습니다 — 고객에게 청구하는 요청에서는 과금되는 code execution 기능을 쓸 수 없고(400 반환), Message Batches도 현재 고객 청구를 지원하지 않습니다.
  • 지출 한도 동작 — 한도에 도달하면 다음 달 1일 00:00 UTC까지 또는 고객이 한도를 올리거나 없앨 때까지 해당 플랫폼으로 청구되는 요청이 402로 거부됩니다. 한도는 정가 기준 토큰 비용과 웹 검색 요금으로 계산되므로 실제 청구액과 다를 수 있습니다. 앱이 테스트 단계일 때는 한도가 $50 이하로 제한됩니다.
  • 플랫폼 개발자 — Console에서 앱을 만들고 linked billing 문서의 절차를 따릅니다.
§ 4

자주 묻는 질문

자주 묻는 질문
§ 4.1
Claude Platform linked billing은 무엇인가요?
외부 플랫폼이 고객의 Claude API 사용량을 고객 자신의 Claude Platform 조직으로 청구하는 기능입니다. 고객은 Anthropic이 제공하는 승인 화면에서 조직을 한 번 연결하면 되고, API 키를 플랫폼에 넘기지 않습니다.
§ 4.2
지금 바로 사용할 수 있나요?
2026년 11월 17일에 Claude Platform에서 베타로 공개됐습니다. 발표 시점에 Asana, Linear, Ramp, Railway, Warp 등 19개 플랫폼이 지원하며, 지원 플랫폼은 Claude Marketplace에서 찾을 수 있습니다.
§ 4.3
어떤 조직이 linked billing으로 결제할 수 있나요?
API 사용료를 Anthropic에 직접 결제하는 Claude Platform 조직만 가능하며, 선불 크레딧과 청구서 결제 모두 해당합니다. AWS, Google Cloud, Azure 마켓플레이스로 결제하는 조직과 Claude 구독 플랜만 있는 조직은 이 방식으로 청구할 수 없습니다.
§ 4.4
플랫폼이 쓰는 금액을 어떻게 제한하나요?
연결할 때나 연결 후 Console의 Linked platforms 페이지에서 플랫폼별 월 지출 한도를 정할 수 있고, 모든 플랫폼에 적용되는 기본 한도도 설정할 수 있습니다. 한도에 도달하면 다음 달 1일 00:00 UTC까지 또는 한도를 올리거나 없앨 때까지 해당 플랫폼의 요청이 거부되며, 연결은 언제든 해제할 수 있습니다.
§ 4.5
우리 조직의 데이터 보존이나 ZDR 설정이 적용되나요?
적용되지 않습니다. 요청은 플랫폼의 조직에서 실행되므로 고객 조직의 IP 허용 목록, 암호화 키, 데이터 보존 설정, 그리고 제로 데이터 보존(ZDR), BAA, CMEK 같은 데이터 계약도 적용되지 않습니다. 공식 문서는 HIPAA, FERPA, CMEK 보호가 필요한 고객은 연결하지 말라고 안내합니다.
§ 4.6
공식 발표 자료는 어디서 볼 수 있나요?
Claude 블로그 발표문(claude.com/resources/articles/linked-billing-on-claude-platform)과 Claude Platform 문서의 Linked billing 페이지(platform.claude.com/docs/en/manage-claude/oauth-apps/organization-billing-connections)에서 확인할 수 있습니다.