메인 콘텐츠로 건너뛰기

플랫폼에서 연결된 결제 제공

이 문서에서는 고객이 자신의 Claude Console 조직을 앱에 연결할 수 있는 연결된 결제를 제공하는 방법을 설명합니다. 당사가 고객에게 직접 청구하며, 귀사는 API 키를 보관하지 않습니다.

연결된 결제는 베타 버전입니다.

연결된 결제 작동 방식

고객이 API 키를 붙여넣는 대신 OAuth를 사용하여 Claude Console 조직을 플랫폼에 연결합니다. 플랫폼은 키가 아닌 연결 ID를 보관합니다. 귀사가 고객을 위해 Claude를 실행하고, 당사가 고객에게 직접 청구합니다.

연결된 결제 범위

연결된 결제는 /v1/messages 및 /v1/chat/completions 엔드포인트를 포함합니다. 각 요청에 대해 고객 또는 귀사 중 누가 비용을 지불할지 선택합니다.

Message Batches API 및 Claude Managed Agents는 아직 지원되지 않습니다.

고객 결제 요청은 청구 가능한 코드 실행을 사용할 수 없습니다. API가 400 오류를 반환하므로 해당 요청을 플랫폼 결제로 전송하세요.

일부 기능만 고객에게 청구하는 경우 고객에게 어떤 기능인지 알려주세요. 모든 Claude 사용이 조직에 청구된다고 말하지 마세요.

연결된 결제는 Claude Console 조직이 Anthropic에서 직접 청구되는 고객에게만 작동합니다.

다음은 연결할 수 없습니다:

  • Bedrock, Vertex AI 또는 Foundry와 같은 클라우드 제공자를 통해 Claude를 사용하는 고객은 연결할 수 없습니다

  • Claude 구독 요금제(Pro, Max, Ultra, Team 및 Enterprise)는 연결할 수 없습니다

  • AWS, Google Cloud 또는 Azure 마켓플레이스를 통해 결제하는 Claude Console 조직은 연결된 결제를 사용할 수 없습니다

요청은 고객의 조직이 아닌 플랫폼 조직에서 실행됩니다. 청구만 고객에게 청구됩니다. IP 허용 목록, 암호화 키 및 데이터 보존과 같은 고객 조직의 설정은 적용되지 않으며, 콘텐츠는 귀사 조직과 Anthropic 간의 계약에 따라 처리됩니다.

모든 연결된 고객은 조직의 속도 제한, 모델 액세스 및 서비스 계층을 공유합니다.

API 키에서 고객 이동

고객 API 키를 연결된 결제와 함께 계속 제공하고 자신의 속도에 맞춰 고객을 이동할 수 있습니다.

고객을 이동하려면:

  1. 연결 ID를 저장할 때까지 고객의 API 키를 계속 사용하세요.

  2. 고객의 요청을 고객 결제로 표시하세요.

  3. 저장된 API 키를 삭제하고 고객에게 알리세요.

연결된 결제 설정

연결된 결제를 설정하려면:

  1. Claude Console에서 OAuth 앱을 만드세요.

  2. 앱이 할 수 있는 작업에서 “조직에 청구 및 연결”을 선택하세요.

  3. 메시지가 표시되면 연결된 결제 약관에 동의하세요.

  4. 앱의 클라이언트 인증 탭에서 클라이언트 인증, 운영자 서비스 계정 및 기본 작업 공간을 설정하세요.

  5. 앱에 “Claude 조직 연결”과 같은 연결을 시작하는 버튼을 추가하세요. 당사의 브랜딩 샘플을 사용하세요.

  6. 비용을 지불할 각 고객 조직에 대해 하나의 사용자 프로필을 만드세요. 각 앱은 고객 조직당 하나의 프로필을 허용하며, 프로필당 하나의 고객 조직을 허용합니다.

  7. 고객이 비용을 지불해야 하는 각 요청에서 고객의 프로필 ID, 결제 베타 헤더 및 bill_to이 user_profile로 설정된 billing_policy를 전송하세요.

  8. 준비가 되면 앱을 게시하세요.

새 앱은 테스트에서 시작됩니다. 나열한 테스트 사용자(최대 10명)만 연결할 수 있으며, 각각 월 $50 이하의 한도가 있습니다. 조직에 청구 인보이스가 없으면 앱의 도메인을 확인하고 Anthropic이 앱을 검토한 후 라이브됩니다.

연결 규칙

  • 고객의 조직이 이미 다른 프로필을 통해 앱에 연결되어 있으면 연결이 거부됩니다.

  • 이미 앱에 연결된 프로필은 두 번째 조직에 연결할 수 없습니다.

  • 연결을 이동하려면 먼저 연결을 해제한 후 다시 연결하세요.

  • 앱을 소유한 Claude Console 조직에 앱을 연결할 수 없습니다. 고객이 하는 것처럼 연결된 결제를 테스트하려면 연결할 수 있는 두 번째 Claude Console 조직을 사용하세요.

  • 연결을 시작하고 해당 고객의 요청을 만드는 데 동일한 사용자 프로필 ID를 사용하세요.

  • 연결이 없는 프로필을 지정하는 고객 결제 요청은 고객의 Console에 플랫폼이 연결됨으로 표시되더라도 403 오류로 거부됩니다.

  • 다른 고객의 프로필을 지정하는 고객 결제 요청은 해당 고객에게 청구됩니다.

자신의 사용에 대해 비용을 지불하려면 billing_policy 없이 요청을 전송하세요.

전체 단계 및 헤더 값은 Claude Platform 문서를 참조하세요.

고객이 연결할 때 보는 내용

고객이 조직을 연결할 때:

  1. 앱에 추가한 “Claude 조직 연결”과 같은 버튼을 클릭합니다.

  2. Claude에 로그인합니다. 이메일이 둘 이상의 조직에 속하면 하나를 선택합니다. Claude 계정이나 Claude Console 조직이 아직 없으면 여기서 만들고, 크레딧을 추가한 후 연결을 완료하기 위해 돌아올 수 있습니다.

  3. 청구 작동 방식을 읽은 후 앱에 대한 월간 지출 한도를 설정하거나 한도 없이 계속합니다. 앱이 아직 테스트 중이면 $50 이하의 한도를 설정해야 합니다.

  4. 앱의 이름과 요청하는 내용이 포함된 승인 페이지가 표시됩니다. 사용량이 조직의 기존 청구 약관에 따라 청구된다고 표시됩니다.

  5. 승인하고 앱으로 돌아갑니다.

관리자 또는 청구 역할이 있는 사용자만 승인할 수 있습니다. Claude Console 역할 및 권한에 대해 자세히 알아보세요. 다른 사람이 승인을 시도하면 액세스 거부 오류와 함께 앱으로 돌아갑니다. 관리자에게 요청을 전달하는 방법과 같은 인수를 계획하세요.

한 번의 승인으로 전체 조직을 포함합니다. 연결은 조직에 속하므로 승인자가 떠나도 활성 상태로 유지됩니다. 각 조직은 앱당 하나의 연결을 가질 수 있습니다.

승인 후 고객의 관리자 및 청구 구성원은 일반적으로 연결을 확인하는 이메일과 연결을 해제할 때 다른 이메일을 받습니다.

고객이 연결을 관리하는 방법

고객은 Claude Console의 연결된 플랫폼 페이지에서 모든 연결을 관리합니다. 플랫폼에 대한 월간 지출 한도를 설정하고 언제든지 연결을 해제할 수 있습니다. 앱에서 이 페이지로 연결하세요.

고객의 연결을 해제할 수도 있습니다. 조직의 관리자가 사용자 프로필 페이지에서 이를 수행합니다. Console에서 고객의 연결을 해제할 때 고객은 이메일을 받지 않으므로 직접 알려주세요. 백엔드에서 고객의 연결을 해제할 수도 있으며, Anthropic은 일반적으로 이를 수행할 때 이메일을 보냅니다.

또한 사용자 프로필 API를 사용하여 고객의 프로필을 만들고, 나열하고, 업데이트할 수 있습니다.

연결되지 않은 고객 관리

고객이 연결을 해제할 때 Anthropic은 앱에 알림을 보내지 않습니다. 해당 고객에 대한 고객 결제 요청이 403 오류로 거부되거나 Console의 사용자 프로필 페이지에서 연결 상태에서 알게 됩니다. 403은 고객이 다른 이유로 청구될 수 없음을 의미할 수도 있습니다.

연결됨 상태는 연결이 존재한다는 것만 나타냅니다. 예를 들어 고객이 크레딧이 부족하거나 지출 한도에 도달한 경우 요청이 거부될 수 있습니다.

연결 해제는 일반적으로 약 10초 내에 새 호출을 중지합니다. 이미 실행 중인 호출은 완료되고 고객에게 청구됩니다. 고객에게 명확한 메시지와 다시 연결할 수 있는 방법을 표시하세요.

청구 오류 관리

고객에게 청구할 수 없으면 요청을 거부합니다. 해당 요청에 대해 귀사에 청구하지 않습니다.

  • 고객이 지출 한도에 도달했거나 Anthropic이 현재 청구할 수 없으면(예: 크레딧이 부족하거나 일시 중단됨) 402 오류가 발생합니다.

  • Anthropic이 다른 이유로 고객에게 청구할 수 없으면 403 오류가 발생합니다.

  • Anthropic이 현재 고객에게 청구할 수 있는지 확인할 수 없으면 503 오류가 발생할 수 있습니다. 백오프로 다시 시도하고 고객에게 오류를 표시하지 마세요.

402는 고객이 조치를 취해야 함을 의미합니다. Claude Console에서 한도 및 청구를 확인하도록 요청하세요.

다음에 어떤 일이 발생할지는 귀사가 결정합니다. 고객이 조치를 취할 때까지 기능을 일시 중지하거나 요청을 플랫폼 결제로 다시 전송하여 사용량을 직접 처리할 수 있습니다. 처리하는 경우 고객에게 기간을 알려주세요.

사용량 및 지출 모니터링

각 고객의 사용량과 비용을 확인할 수 있습니다. 고객이 실제로 지불하는 금액은 절대 볼 수 없습니다.

각 고객의 사용량을 두 가지 방법으로 모니터링할 수 있습니다:

  • Claude Console에서: 사용자 프로필 페이지에서 고객을 선택하여 사용량을 확인하세요. 귀사의 지출은 고객을 대신하여 지불한 금액만입니다.

  • API 사용: 사용량 및 비용 분석 API에서 user_profile_id로 결과를 그룹화하세요(베타 버전). 사용량 엔드포인트는 토큰을 반환합니다. 비용 엔드포인트에서 amount는 크레딧 전 비용이며, 고객이 지불하는 요청의 경우 0입니다. list_amount는 누가 지불하든 정가 기준 비용입니다.

두 보기 모두 누가 지불했든 고객에 대한 모든 요청을 포함합니다. 어떤 요청이 고객 결제였는지 자신의 기록을 유지하세요. API 데이터는 일반적으로 4시간 내에 새로 고쳐지며 최대 24시간이 걸릴 수 있습니다.

자주 묻는 질문

HIPAA, FERPA 또는 CMEK 요구 사항이 있는 고객이 연결할 수 있습니까?

베타 기간에는 불가능합니다. 연결된 요청은 조직에서 실행되므로 고객의 비즈니스 제휴 계약(BAA), 암호화 키 및 보존 설정(영 데이터 보존 포함)이 적용되지 않습니다. HIPAA, FERPA 또는 CMEK 보장이 필요한 고객을 연결하지 마세요.

연결된 사용에 어떤 크레딧을 사용할 수 있습니까?

연결된 사용은 고객의 선불 잔액 또는 인보이스로 청구됩니다. 일부 프로모션 크레딧은 사용할 수 없습니다.

지불할 수 있는 것

  • 고객이 구매한 크레딧(선불 잔액)

  • 월간 청구인 경우 고객의 인보이스

  • Anthropic의 청구 수정

  • 고객의 계약에 작성된 크레딧

지불할 수 없는 것

고객 계정에서 지불할 수 있는 것이 없으면 요청이 거부될 수 있습니다. 고객이 자금을 추가한 후 구매가 적용되는 데 시간이 걸릴 수 있습니다. 크레딧 프로그램이 변경되면 이 목록을 업데이트할 수 있습니다.

답변이 도움되었나요?