---
title: Claude Platform OAuth
url: https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/overview
description: Permita que seus clientes paguem pelo uso do Claude no seu produto a partir da própria organização Claude.
---

<Warning>
  Claude Platform OAuth é um Beta Service: software de pré-lançamento fornecido nos termos do seu contrato com a Anthropic, como os [Termos de Serviço Comerciais](https://www.anthropic.com/legal/commercial-terms), e os [Termos Específicos de Serviço](https://www.anthropic.com/legal/service-specific-terms). Endpoints, parâmetros e comportamento podem mudar durante o beta. Pode não ser adequado para uso em produção.
</Warning>

Claude Platform OAuth permite que seus usuários cobrem da organização Claude deles o uso dentro do seu aplicativo.

## O que você pode construir

### Permita que os clientes paguem pelo próprio uso do Claude

Quando seu produto chama o Claude, o uso pode ser cobrado da organização Claude dos seus próprios clientes. Seus usuários clicam em um botão **Link your Claude organization**, entram no Claude e aprovam seu aplicativo. Para o Linked billing, o usuário deve ter a função Admin ou Faturamento na organização Claude dele.

Depois disso:

* Você escolhe, em cada solicitação à Claude API, se quem paga é o cliente ou você.
* Se uma solicitação que você marcar para o cliente não puder ser cobrada dele, a Claude API a rejeita em vez de cobrar você.
* O cliente pode desvincular seu aplicativo a qualquer momento.
* Você pode cobrar de um cliente apenas as solicitações que ele orientar você a fazer, nunca o seu próprio uso.

Você dá suporte aos seus clientes: a Anthropic fornece a página de aprovação e a página do Claude Console onde eles definem um teto de gastos ou desvinculam seu aplicativo, e todas as outras perguntas sobre seu aplicativo chegam até você.

O Linked billing funciona para clientes cuja organização Claude paga à Anthropic diretamente pelo uso da API. Ele não funciona para organizações faturadas por meio de um marketplace de nuvem. Consulte [Linked billing](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections).

## Como funciona

O Linked billing segue uma ida e volta curta. A pessoa sai do seu produto para a página de aprovação do Claude uma vez, aprova seu aplicativo lá e volta:

<Frame>
  ![Diagrama de sequência: a pessoa aprova seu aplicativo em auth.claude.com e, em seguida, seu back end troca o "one-time code" (código de uso único)](https://platform.claude.com/docs/pt-BR/images/oauth-apps-billing-round-trip.svg)
</Frame>

A página de aprovação mostra o nome do seu aplicativo e o que ele está solicitando, para que a pessoa saiba o que está aprovando.

<Note>
  Se você já trabalhou com OAuth antes: Claude Platform OAuth usa o “authorization code flow” (fluxo de código de autorização) do OAuth 2.0 com PKCE, com a Anthropic como servidor de autorização.
</Note>

## Configuração única do aplicativo OAuth

O Linked billing começa com estas etapas de configuração única no Claude Console. O guia [Linked billing](https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections#setup-process) orienta você nelas.

1. **Crie o aplicativo.** Um membro da sua organização Claude com a função Admin cria um aplicativo OAuth no Claude Console e copia o “client ID” (ID do cliente) dele. O aplicativo contém o nome que as pessoas veem na página de aprovação e o endereço no seu produto para o qual elas retornam.
2. **Configure a autenticação do cliente.** Em vez de um “client secret” (segredo do cliente), seu back end comprova que uma solicitação vem do seu aplicativo com um token de curta duração do seu próprio “identity provider” (provedor de identidade), como AWS, Google Cloud, Microsoft Entra ID ou Kubernetes. Você seleciona o provedor de identidade, e quais dos tokens dele aceitar, na aba **Client authentication** do aplicativo.
3. **Configure a identidade do seu back end.** Crie uma conta de serviço e uma segunda regra de federação com [Workload Identity Federation](https://platform.claude.com/docs/pt-BR/manage-claude/workload-identity-federation) e selecione a conta de serviço como a conta de serviço operadora do aplicativo.

## Próximos passos

O guia Linked billing orienta você na configuração e no seu primeiro cliente vinculado.

<CardGroup cols={3}>
  <Card title="Linked billing" icon="coins" href="https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/organization-billing-connections">
    Permita que seus clientes paguem pelo uso do Claude no seu produto a partir da própria organização Claude
  </Card>

  <Card title="Referência de OAuth" icon="book" href="https://platform.claude.com/docs/pt-BR/manage-claude/oauth-apps/oauth-reference">
    Endpoints, parâmetros, respostas de token, tempos de vida e erros
  </Card>
</CardGroup>
