---
title: Claude Platform OAuth
url: https://platform.claude.com/docs/ko/manage-claude/oauth-apps/overview
description: 고객이 귀사 제품의 Claude 사용량을 자신의 Claude 조직에서 결제하도록 할 수 있습니다.
---

<Warning>
  Claude Platform OAuth는 Beta Service로, [상업 서비스 약관](https://www.anthropic.com/legal/commercial-terms) 및 [서비스별 약관](https://www.anthropic.com/legal/service-specific-terms) 등 Anthropic과 체결한 계약에 따라 제공되는 출시 전 소프트웨어입니다. 베타 기간 동안 엔드포인트, 매개변수 및 동작이 변경될 수 있습니다. 프로덕션 환경에서 사용하기에 적합하지 않을 수 있습니다.
</Warning>

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](https://platform.claude.com/docs/ko/manage-claude/oauth-apps/organization-billing-connections)을 참조하세요.

## 작동 방식

Linked billing은 짧은 왕복 과정을 따릅니다. 사용자는 귀사 제품을 한 번 떠나 Claude의 승인 페이지로 이동하고, 그곳에서 귀사 앱을 승인한 다음 돌아옵니다:

<Frame>
  ![Sequence diagram(시퀀스 다이어그램): 사용자가 auth.claude.com에서 귀사 앱을 승인한 다음, 귀사 백엔드가 일회용 코드를 교환합니다](https://platform.claude.com/docs/ko/images/oauth-apps-billing-round-trip.svg)
</Frame>

승인 페이지에는 귀사 앱의 이름과 앱이 요청하는 내용이 표시되므로, 사용자는 무엇을 승인하는지 알 수 있습니다.

<Note>
  OAuth를 사용해 본 적이 있다면: Claude Platform OAuth는 PKCE를 사용하는 OAuth 2.0 “authorization code flow”(인가 코드 흐름)를 사용하며, Anthropic이 “authorization server”(인가 서버) 역할을 합니다.
</Note>

## 일회성 OAuth 앱 설정

Linked billing은 Claude Console에서 다음과 같은 일회성 설정 단계로 시작합니다. [Linked billing](https://platform.claude.com/docs/ko/manage-claude/oauth-apps/organization-billing-connections#setup-process) 가이드에서 이 과정을 안내합니다.

1. **앱을 생성합니다.** Admin 역할을 가진 귀사 Claude 조직의 구성원이 Claude Console에서 OAuth 앱을 생성하고 해당 “client ID”(클라이언트 ID)를 복사합니다. 앱에는 사용자가 승인 페이지에서 보게 되는 이름과, 사용자가 돌아올 귀사 제품 내 주소가 저장됩니다.
2. **클라이언트 인증을 설정합니다.** 귀사 백엔드는 “client secret”(클라이언트 시크릿) 대신 AWS, Google Cloud, Microsoft Entra ID 또는 Kubernetes와 같은 자체 “identity provider”(ID 공급자)에서 발급한 수명이 짧은 토큰으로 요청이 귀사 앱에서 온 것임을 증명합니다. 앱의 **Client authentication** 탭에서 ID 공급자와 허용할 토큰을 선택합니다.
3. **백엔드의 ID를 설정합니다.** [Workload Identity Federation](https://platform.claude.com/docs/ko/manage-claude/workload-identity-federation)을 사용하여 서비스 계정과 두 번째 페더레이션 규칙을 생성하고, 해당 서비스 계정을 앱의 운영자 서비스 계정으로 선택합니다.

## 다음 단계

Linked billing 가이드는 설정 과정과 첫 번째 연결된 고객까지 안내합니다.

<CardGroup cols={3}>
  <Card title="Linked billing" icon="coins" href="https://platform.claude.com/docs/ko/manage-claude/oauth-apps/organization-billing-connections">
    고객이 귀사 제품의 Claude 사용량을 자신의 Claude 조직에서 결제하도록 할 수 있습니다
  </Card>

  <Card title="OAuth 레퍼런스" icon="book" href="https://platform.claude.com/docs/ko/manage-claude/oauth-apps/oauth-reference">
    엔드포인트, 매개변수, 토큰 응답, 수명 및 오류
  </Card>
</CardGroup>
