Claude Platform Docs
AdministraçãoClaude Platform OAuth

Claude Platform OAuth

Permita que seus clientes paguem pelo uso do Claude no seu produto a partir da própria organização Claude.

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.

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:

Navegador
Seu back-end
auth.claude.com
Clique em “Link your Claude organization”
Envie a pessoa para a página de aprovação do Claude
Entre no Claude e aprove seu aplicativo
Envie a pessoa de volta ao seu produto com um código de uso único
Entregue o código
Troque o código
Um ID de conexão

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.

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 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 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.

Permita que seus clientes paguem pelo uso do Claude no seu produto a partir da própria organização Claude

Endpoints, parâmetros, respostas de token, tempos de vida e erros

Esta página foi útil?