Claude Platform OAuth
고객이 귀사 제품의 Claude 사용량을 자신의 Claude 조직에서 결제하도록 할 수 있습니다.
Claude Platform OAuth를 사용하면 사용자가 앱 내 사용량을 자신의 Claude 조직에 청구할 수 있습니다.
구축할 수 있는 것
고객이 자신의 Claude 사용량을 직접 결제하도록 하기
귀사 제품이 Claude를 호출할 때, 해당 사용량을 고객 자신의 Claude 조직에 청구할 수 있습니다. 사용자는 Link your Claude organization 버튼을 클릭하고, Claude에 로그인한 다음, 귀사 앱을 승인합니다. Linked billing의 경우 사용자는 자신의 Claude 조직에서 Admin 또는 Billing 역할을 가지고 있어야 합니다.
그 이후에는 다음과 같습니다.
- 각 Claude API 요청마다 고객이 비용을 지불할지, 아니면 귀사가 지불할지를 선택합니다.
- 고객에게 청구하도록 표시한 요청을 고객에게 청구할 수 없는 경우, Claude API는 귀사에 청구하는 대신 해당 요청을 거부합니다.
- 고객은 언제든지 귀사 앱의 연결을 해제할 수 있습니다.
- 귀사는 고객의 지시에 따라 보내는 요청에 대해서만 고객에게 청구할 수 있으며, 귀사 자신의 사용량은 절대 고객에게 청구해서는 안 됩니다.
고객 지원은 귀사가 담당합니다. Anthropic은 승인 페이지와 고객이 지출 한도를 설정하거나 귀사 앱의 연결을 해제하는 Claude Console 페이지를 제공하며, 귀사 앱에 관한 그 밖의 모든 문의는 귀사로 오게 됩니다.
Linked billing은 API 사용량에 대해 Claude 조직이 Anthropic에 직접 비용을 지불하는 고객에게 적용됩니다. 클라우드 마켓플레이스를 통해 청구되는 조직에는 적용되지 않습니다. Linked billing을 참조하세요.
작동 방식
Linked billing은 짧은 왕복 과정을 따릅니다. 사용자는 귀사 제품을 한 번 떠나 Claude의 승인 페이지로 이동하고, 그곳에서 귀사 앱을 승인한 다음 돌아옵니다:
승인 페이지에는 귀사 앱의 이름과 앱이 요청하는 내용이 표시되므로, 사용자는 무엇을 승인하는지 알 수 있습니다.
일회성 OAuth 앱 설정
Linked billing은 Claude Console에서 다음과 같은 일회성 설정 단계로 시작합니다. Linked billing 가이드에서 이 과정을 안내합니다.
- 앱을 생성합니다. Admin 역할을 가진 귀사 Claude 조직의 구성원이 Claude Console에서 OAuth 앱을 생성하고 해당 “client ID”(클라이언트 ID)를 복사합니다. 앱에는 사용자가 승인 페이지에서 보게 되는 이름과, 사용자가 돌아올 귀사 제품 내 주소가 저장됩니다.
- 클라이언트 인증을 설정합니다. 귀사 백엔드는 “client secret”(클라이언트 시크릿) 대신 AWS, Google Cloud, Microsoft Entra ID 또는 Kubernetes와 같은 자체 “identity provider”(ID 공급자)에서 발급한 수명이 짧은 토큰으로 요청이 귀사 앱에서 온 것임을 증명합니다. 앱의 Client authentication 탭에서 ID 공급자와 허용할 토큰을 선택합니다.
- 백엔드의 ID를 설정합니다. Workload Identity Federation을 사용하여 서비스 계정과 두 번째 페더레이션 규칙을 생성하고, 해당 서비스 계정을 앱의 운영자 서비스 계정으로 선택합니다.
다음 단계
Linked billing 가이드는 설정 과정과 첫 번째 연결된 고객까지 안내합니다.
고객이 귀사 제품의 Claude 사용량을 자신의 Claude 조직에서 결제하도록 할 수 있습니다
엔드포인트, 매개변수, 토큰 응답, 수명 및 오류
이 페이지가 도움이 되었나요?