Anthropic lanzó el 17 de noviembre de 2026, en beta, Linked billing en Claude Platform: una forma de que los clientes de tu app paguen con su propia cuenta de Claude las llamadas a la API que hace tu producto. El cliente vincula su organización una vez y, a partir de ahí, en cada request tú decides quién paga: él o tú. Para cualquiera que venda un SaaS, un bot o una herramienta interna montada sobre Claude, esto toca el problema más incómodo del negocio: comerte el costo de los tokens de otros y luego intentar cobrárselo con márgenes y planes de precios.
Qué anunció Anthropic
Según las notas de versión de Claude Platform, la función se activa con el encabezado beta user-profiles-billing-2026-10-01. Una vez que un cliente vincula su organización, la app agrega un campo billing_policy en cada llamada a /v1/messages o /v1/chat/completions para indicar quién paga. Desde la Claude Console, el cliente puede ponerle un tope de gasto a tu app o desvincularla cuando quiera.
La documentación de Linked billing explica el resto. Tu app pone un botón de "Link your Claude organization"; el cliente entra a Claude, elige su organización y aprueba. La API llama a ese vínculo una connection. Hay una garantía que vale la pena subrayar: si una llamada marcada para el cliente no se le puede cobrar, la API la rechaza en lugar de cobrártela a ti en silencio.
Cómo funciona por dentro
El montaje tiene dos partes. La primera se hace una vez y requiere el rol de Admin en tu organización:
- Crear una OAuth app en la Console con el permiso "Bill and link to organizations" y una URI de redirección. Anthropic no emite client secrets: tu back end se autentica con tokens de tu propio proveedor de identidad.
- Crear una cuenta de servicio con Workload Identity Federation y asignarla como "operator service account" de la app. Solo esa cuenta puede mandar llamadas que se cobren a clientes vinculados, y cada cuenta de servicio opera una sola app.
La segunda se repite por cliente: creas un user profile en tu organización que lo represente, mandas un pushed authorization request con PKCE a auth.claude.com, rediriges al cliente a la página de aprobación y, cuando vuelve con el código, lo canjeas por un connection_id que guardas en su registro. La relación es uno a uno: una organización de Claude solo se puede vincular a uno de tus perfiles, y un perfil a una sola organización.

En cada llamada mandas el encabezado anthropic-user-profile-id con el perfil del cliente. Si quieres que pague él, agregas "billing_policy": {"type": "billing_policy", "bill_to": "user_profile"} y el encabezado beta. Si pagas tú, omites billing_policy o usas bill_to: "self".
La documentación también describe una variante más estricta: tokens OAuth por conexión, que solo pueden cobrarle a ese cliente y caducan en una hora como máximo (con refresh tokens de hasta un año si pides offline_access). Es la opción para despliegues de un solo cliente o sandboxes que controla el propio cliente.
Quién puede pagar así (y quién no)
Aquí está la letra chica. Según la documentación:
- Solo aplica a organizaciones de Claude Platform que le pagan directo a Anthropic, con créditos prepagados o con factura mensual (invoiced billing). Las que pagan por AWS, Google Cloud o Azure Marketplace, o que solo tienen una suscripción de Claude, quedan fuera: sus llamadas regresan
403 user_profile_not_billable. - No todo el crédito sirve. Los créditos mensuales de API que vienen con los planes Max, Ultra y Team, y los de programas de socios, VC y startups, no pueden pagar estas llamadas.
- Las llamadas corren en tu organización: aplican tus límites, tu acceso a modelos, tu retención de datos y tus llaves de cifrado. Los acuerdos del cliente, como cero retención de datos, BAA o llaves propias (CMEK), no cuentan. Anthropic pide expresamente no vincular a clientes que necesiten cobertura HIPAA, FERPA o CMEK para ese uso.
- Las funciones de ejecución de código con costo regresan un 400 si intentas cobrárselas al cliente, y Message Batches todavía no admite este tipo de cobro.
Topes de gasto y errores que hay que manejar
Al vincularse, el cliente puede fijar un tope mensual en dólares para tu app, aparte del límite mensual de toda su organización. Tú no puedes leer ese tope ni cuánto lleva gastado. Mientras tu app está en pruebas o en revisión, el tope es obligatorio y no puede pasar de 50 dólares. Para publicarla tienes que comprobar el dominio con un registro TXT y pasar una revisión de Anthropic, salvo que tu organización tenga invoiced billing (te facturan a crédito): en ese caso sale en cuanto confirmas.
Los errores que tu código tiene que esperar:
| Código | Qué significa | ¿Se reintenta? |
|---|---|---|
403 user_profile_not_billable |
No se le puede cobrar a ese cliente; la API no dice por qué | Solo en los primeros 10 segundos tras vincular |
402 linked_organization_spend_limit_reached |
El cliente llegó a su tope o no tiene crédito válido | No |
402 linked_organization_billing_unavailable |
La organización del cliente no se puede cobrar (por ejemplo, está suspendida) | No |
503 overloaded_error |
No se pudo confirmar el cobro en ese momento | Sí, con backoff |
En todos los casos de rechazo, la documentación sugiere el mismo plan B: reenviar con bill_to: "self" y absorber tú el costo. Otro detalle operativo: si el cliente desvincula tu app, Anthropic no te avisa con webhook ni correo. Te enteras porque empiezan los 403, o consultando el estado del perfil con el encabezado beta user-profiles-search-2026-08-30.
Mi lectura
Lo que esto significa, en la práctica, es que el modelo "trae tu propia llave" deja de ser un hack. Hoy muchas apps le piden al cliente que pegue su API key en un formulario, lo que es incómodo y riesgoso para los dos lados. Linked billing reemplaza eso con un OAuth formal, topes de gasto controlados por el cliente y un botón para cortar el acceso. Para un desarrollador que vende bots, agentes o automatizaciones con Claude, abre la puerta a cobrar solo por su software y dejar que el consumo de IA lo pague quien lo genera.
Pero la letra chica pesa. El cliente tiene que ser, a su vez, cliente directo de Claude Platform con crédito pagado, lo que deja fuera a la mayoría de las pymes que solo usan Claude por suscripción o por un marketplace de nube. Además, la responsabilidad no se mueve: la documentación dice que tú das el soporte, que la API no puede comprobar si una llamada de verdad la pidió el cliente, y que los datos viajan bajo tus condiciones, no las suyas. El montaje (Workload Identity Federation, PAR, PKCE, revisión de la app) tampoco es de una tarde.
No lo probé; todo esto sale de la documentación oficial de Claude Platform. Si construyes sobre Claude para clientes corporativos que ya tienen cuenta con Anthropic, vale la pena montarlo en pruebas ahora, con el tope de 50 dólares, y diseñar desde el principio el respaldo a bill_to: "self" para cuando el cobro al cliente falle.