Claude Platform Docs
AdministraciónClaude Platform OAuth

Claude Platform OAuth

Permite que tus clientes paguen el uso de Claude en tu producto desde su propia organización de Claude.

Claude Platform OAuth permite que el uso dentro de tu app se facture a la organización de Claude de tus usuarios.

Qué puedes crear

Permite que los clientes paguen su propio uso de Claude

Cuando tu producto llama a Claude, el uso puede facturarse a la propia organización de Claude de tus clientes. Tus usuarios hacen clic en un botón Link your Claude organization, inician sesión en Claude y aprueban tu app. Para Linked billing, el usuario debe tener el rol Administrador o Facturación en su organización de Claude.

Después de eso:

  • Tú eliges en cada solicitud a la Claude API si paga el cliente o pagas tú.
  • Si una solicitud que marcas para el cliente no se le puede facturar, la Claude API la rechaza en lugar de facturártela a ti.
  • El cliente puede desvincular tu app en cualquier momento.
  • Solo puedes facturar a un cliente por las solicitudes que ese cliente te indique realizar, nunca por tu propio uso.

Tú brindas soporte a tus clientes: Anthropic proporciona la página de aprobación y la página de la Claude Console donde establecen un tope de gasto o desvinculan tu app, y todas las demás preguntas sobre tu app llegan a ti.

Linked billing funciona para clientes cuya organización de Claude le paga directamente a Anthropic por su uso de la API. No funciona para organizaciones que se facturan a través de un marketplace en la nube. Consulta Linked billing.

Cómo funciona

Linked billing sigue un recorrido breve de ida y vuelta. La persona sale de tu producto hacia la página de aprobación de Claude una vez, aprueba tu app allí y regresa:

Navegador
Tu back end
auth.claude.com
Haz clic en “Link your Claude organization”
Envía a la persona a la página de aprobación de Claude
Inicia sesión en Claude y aprueba tu aplicación
Envía a la persona de vuelta a tu producto con un código de un solo uso
Entrega el código
Intercambia el código
Un ID de conexión

La página de aprobación muestra el nombre de tu app y lo que tu app solicita, para que la persona sepa qué está aprobando.

Configuración única de la app de OAuth

Linked billing comienza con estos pasos de configuración única en la Claude Console. La guía Linked billing te acompaña en ellos.

  1. Crea la app. Un miembro de tu organización de Claude con el rol Administrador crea una app de OAuth en la Claude Console y copia su “client ID” (ID de cliente). La app contiene el nombre que las personas ven en la página de aprobación y la dirección de tu producto a la que regresan.
  2. Configura la autenticación del cliente. En lugar de un secreto de cliente, tu back end demuestra que una solicitud proviene de tu app con un token de corta duración de tu propio proveedor de identidad, como AWS, Google Cloud, Microsoft Entra ID o Kubernetes. Seleccionas el proveedor de identidad, y cuáles de sus tokens aceptar, en la pestaña Client authentication de la app.
  3. Configura la identidad de tu back end. Crea una cuenta de servicio y una segunda regla de federación con Workload Identity Federation, y selecciona la cuenta de servicio como la cuenta de servicio operadora de la app.

Próximos pasos

La guía Linked billing te acompaña en la configuración y en tu primer cliente vinculado.

Permite que tus clientes paguen el uso de Claude en tu producto desde su propia organización de Claude

Endpoints, parámetros, respuestas de tokens, tiempos de vida y errores

¿Te resultó útil esta página?