Créditos de API de Claude Max y Team: cómo reclamarlos y usarlos

Desde el 7 de octubre de 2026, los planes Claude Max y Team incluyen cada mes un saldo para la API de Claude: 100 $ en Max 5x, 200 $ en Max 20x y hasta 500 $ en Team, repartidos en Team como 20 $ por plaza Standard y 100 $ por plaza Premium dentro de una bolsa común. El saldo no aparece solo en tu cuenta de desarrollador: tienes que vincular una organización de Claude Console desde la facturación de claude.ai, y a partir de ese momento se deposita en esa organización en cada ciclo de facturación (documentación de Anthropic, artículo de ayuda).

Lo esencial, a 9 de octubre de 2026:

• Cómo se reclaman: en claude.ai, Settings > Billing (Max) u Organization settings > Billing (Team), sección API credits, botón Link organization. No necesitas tarjeta en Console. Solo puedes vincular una organización y no puedes cambiarla por tu cuenta.
• En qué se gastan: Messages API, Message Batches API, el Playground de Console, Managed Agents y el Agent SDK, incluido claude -p cuando lo ejecutas con una clave de API de la organización vinculada. Claude Code interactivo, el uso adicional de las apps de Claude y Claude en Bedrock, Vertex AI o Foundry quedan fuera.
• Dónde ver el saldo: en Console, Settings > Billing, apartado Promotional credits, con importe y fecha de caducidad.
• Cuándo caducan y qué pasa al agotarlos: lo que no gastes caduca al final del ciclo, sin acumularse. Si se acaban y no tienes saldo comprado ni recarga automática, la API deja de responder hasta la siguiente entrega; nada se carga a tu suscripción.

Los botones y apartados aparecen aquí con su nombre en inglés, tal como figuran en la documentación de Anthropic; la interfaz en español puede rotularlos de otra forma.

Cuánto recibes: 100 $ en Max 5x, 200 $ en Max 20x y hasta 500 $ en Team

En Team, el crédito de todas las plazas se suma en un único saldo mensual con un tope de 500 $, y cada entrega, incluida la primera, se calcula con las plazas que tiene el plan al empezar ese mes de facturación. El ejemplo de la propia documentación: tres plazas Standard y dos Premium reciben 260 $ al mes (3 × 20 $ + 2 × 100 $); si añades otra Premium, la entrega del mes siguiente sube a 360 $. Un equipo con cinco Premium ya llega al tope.

Para situar las cifras: Max 5x cuesta 100 $ al mes y Max 20x 200 $ en suscripción web, y una plaza Team cuesta 20 $ (Standard) o 100 $ (Premium) al mes con pago anual, según la página de precios de Claude. El crédito de Max coincide con el precio web del plan y el de Team con el precio anual de cada plaza. Esa coincidencia es una cuenta, no una promesa de Anthropic: el plan no sale gratis y el crédito solo vale para la API, con la caducidad que verás más abajo.

¿Por qué no te aparece la sección API credits?

Si al abrir la facturación de claude.ai no ves el apartado API credits, repasa estas condiciones en orden:

1. El plan. Solo Max 5x, Max 20x y Team (también Team con descuento). Free, Pro y Enterprise no tienen estos créditos, y quien no es elegible no ve la sección.
2. Los 7 días. Si te acabas de suscribir, puedes reclamar cuando lleves 7 días en un plan elegible.
3. El estado del plan. Tiene que estar activo y al corriente de pago.
4. Tu rol. En Max, la persona suscrita. En Team, el Primary Owner o un Owner; un miembro normal no verá la opción.
5. El despliegue. Anthropic activa la oferta a lo largo de varios días desde el lanzamiento, así que puede que aún no te haya llegado. Si pasados los 7 días sigues sin verla y cumples plan y rol, la vía es el soporte de Anthropic.

Si pagas la suscripción desde la app de iOS o Android, también tienes derecho a los créditos, pero el vínculo se hace en claude.ai desde un navegador, no desde la app.

Un caso que la documentación no resuelve: el año gratis de Claude Team que da el programa para fundadores. Como planes con descuento elegibles solo se citan los de organizaciones sin ánimo de lucro y científicos. Qué hacer en ese caso y cuánto saldo serían está en Claude para startups: requisitos y qué rinden 1.000 $ en créditos.

Cómo reclamar los créditos: vincula una organización de Claude Console

Antes de empezar necesitas dos roles a la vez: el del plan (persona suscrita en Max; Primary Owner u Owner en Team) y Owner, Admin o Billing en la organización de Console que va a recibir el saldo. Si todavía no tienes organización en Console, puedes crearla en platform.claude.com o durante el propio proceso.

1. Entra en claude.ai desde el navegador con la cuenta del plan.
2. Abre Settings > Billing si tienes Max, u Organization settings > Billing si administras un Team.
3. En el apartado API credits, pulsa Link organization.
4. Elige la organización de Console que recibirá los créditos o crea una nueva.
5. Revisa los términos complementarios de crédito (Supplemental Credit Terms) y confirma con Link organization.
6. Comprueba en Console, en Settings > Billing, que el saldo aparece en Promotional credits. Después crea una clave de API en esa organización y haz tu primera petición.

Dos detalles evitan la mayoría de los atascos: inicia sesión en Console con el mismo correo que usas en claude.ai, y si el vínculo da error, vuelve a intentarlo pasadas unas horas, que es lo que recomienda la ayuda de Anthropic.

Qué organización elegir: el vínculo no se cambia por tu cuenta

Cada plan se vincula a una sola organización de Console, y cada organización recibe créditos de un solo plan. No puedes repartir el saldo entre varias ni cambiar el vínculo tú mismo: para eso hay que pasar por soporte. Por eso conviene decidir antes de pulsar:

• Si ya tienes una organización con las claves de tus proyectos, vincular esa es lo más directo: tus aplicaciones empiezan a gastar el crédito sin cambiar nada.
• Si esa organización la comparten otras personas o tiene saldo comprado que usa tu equipo, ten en cuenta que todas sus claves y espacios de trabajo (workspaces) tirarán del mismo saldo. Más abajo verás cómo acotarlo.
• Si prefieres aislar el crédito, crea una organización nueva durante el proceso. Las organizaciones nuevas pueden empezar en un nivel de evaluación con límites más bajos, pero una organización vinculada sube como mínimo al nivel Start.
• Evita vincular una organización de pruebas que vayas a abandonar. Deshacer el vínculo depende de soporte.

¿En qué puedes gastar los créditos? Regla para cada cosa que ejecutas

La regla general: los créditos pagan lo que construyes sobre la Claude Platform con una clave de la organización vinculada, con cualquier modelo de Claude disponible allí. No pagan Claude Code como herramienta interactiva ni amplían los límites de tu plan en Claude, Claude Code o Cowork. La tabla baja esa regla a cada caso; la columna de credencial es la que decide.

El matiz de claude -p y del Agent SDK sale de la pregunta frecuente de la ayuda: ese uso se factura como uso del Agent SDK cuando lo ejecutas tú con una clave de la organización vinculada. La tabla resumida de la documentación solo dice «Claude Code: No», que es correcto para el uso interactivo, pero no recoge esta excepción.

Claude Code y claude -p: pasa la clave solo al comando headless

Claude Code elige credencial por orden de prioridad, según su documentación de autenticación: la variable ANTHROPIC_API_KEY va por delante de la sesión que abriste con /login. Lo que hace con ella depende del modo:

• En modo interactivo, te pregunta una vez si quieres usar la clave y recuerda la respuesta. Se puede cambiar después con la opción Use custom API key de /config, que solo aparece mientras la variable está definida.
• Con -p, usa siempre la clave si existe.

De ahí sale el riesgo práctico, que es una deducción a partir de esas reglas: si exportas la clave de la organización vinculada en ~/.zshrc o ~/.bashrc y un día aceptas usarla en una sesión interactiva, esa sesión pasa a facturarse a la organización. Los créditos mensuales no la cubren. Si la organización solo tiene esos créditos, Claude Code mostrará Credit balance too low · Add funds: https://platform.claude.com/settings/billing; si además tiene saldo comprado, lo razonable es esperar que la sesión lo gaste.

La forma segura es dar la clave únicamente al proceso que debe usarla:

# La clave vive en un archivo con permisos restringidos, no en el perfil de la shell
ANTHROPIC_API_KEY="$(cat ~/.secrets/claude-org-vinculada.key)" \
  claude -p "Resume en cinco puntos los cambios del último commit"

En un script del Agent SDK o en tu propio servidor de CI, el equivalente es inyectar la clave como secreto del entorno de esa tarea. Para comprobar qué estás usando:

• Abre Claude Code y ejecuta /status: muestra la credencial activa y marca la que no se usa.
• Si ves que una sesión interactiva tira de la clave, ejecuta unset ANTHROPIC_API_KEY en esa terminal para volver a la suscripción.
• Las sesiones de Claude Code en la nube usan siempre la suscripción, aunque definas la variable en ese entorno.

¿Cómo ver los créditos en Claude? Saldo y fecha de caducidad en Console

El saldo no se ve en claude.ai, sino en la organización vinculada: Console → Settings > Billing → apartado Promotional credits. Ahí aparecen el importe y la fecha en que caduca. El gasto se sigue en la página Cost.

Cómo se renueva:

• Entrega: llega en cada ciclo de facturación, poco después de que se procese el cobro de tu plan. No va por mes natural: si tu plan se renueva el día 15, los créditos llegan hacia el 15.
• Plan anual: recibes el crédito una vez al mes, no 12 meses de golpe.
• Caducidad: lo que no gastes caduca al final del ciclo (o del mes, en plan anual) y no pasa al siguiente. Si un mes solo usas 30 $ de 100 $, los 70 $ restantes se pierden.

Si buscas el saldo de los créditos de uso que activaste en claude.ai para seguir trabajando al llegar al límite del plan, ese está en otro sitio: claude.ai, Settings > Usage.

Qué pasa cuando el saldo llega a cero: créditos comprados y recarga automática

El orden de gasto es fijo: primero los créditos incluidos en el plan, después los que hayas comprado. A partir de ahí hay tres situaciones:

• La organización tiene saldo comprado o recarga automática: las peticiones siguen funcionando y tiran de ese saldo.
• No tiene ningún otro saldo: las peticiones a la API se detienen hasta la siguiente entrega mensual y devuelven Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits. El uso nunca se carga a tu plan de Claude. Para seguir, compra créditos o activa la recarga automática en Console.
• La organización factura con el equipo comercial de Anthropic: lo que pase de los créditos se factura como siempre.

Un detalle de la recarga automática (auto-reload) que pilla por sorpresa: solo mira el saldo comprado. Si la activas cuando ese saldo ya está en el umbral o por debajo, por ejemplo a cero, se recarga y te cobra aunque todavía te queden créditos incluidos sin gastar. Si quieres agotar primero el crédito del plan sin cargos en la tarjeta, deja la recarga desactivada hasta que lo necesites. Cómo se compran créditos y cómo aparece el IVA en la factura lo tienes en Créditos de Claude API: cómo comprarlos, cuánto cuestan y el IVA.

Compartir el saldo con un equipo: un espacio de trabajo con límite por proyecto

Todas las claves de API y todos los espacios de trabajo de la organización vinculada tiran del mismo saldo. En Team, cualquiera con una clave en esa organización puede gastar la bolsa común; en Max, lo mismo vale para cada proyecto tuyo que use una clave de esa organización.

Para que un proyecto no se coma el crédito de los demás, dale su propio espacio de trabajo en Console y fija para él un límite de gasto del espacio de trabajo. Al alcanzarlo, las peticiones de ese espacio devuelven un error HTTP 400 que empieza por You have reached your specified workspace API usage limits, y el resto de proyectos sigue funcionando.

Límites de gasto y nivel: el mes natural no coincide con tu ciclo

Los créditos no cambian cómo funcionan los límites de gasto y de uso de la API, y hay dos relojes distintos:

• Los créditos se entregan y caducan por ciclo de facturación de tu plan.
• El tope mensual de gasto de la organización se reinicia el día 1 de cada mes natural a las 00:00 UTC. Lo que pagas con créditos cuenta para ese tope.

Los topes por nivel son 500 $ al mes en Start, 1.000 $ en Build y 200.000 $ en Scale. Al vincular la organización, sube como mínimo a Start; si sus créditos mensuales superan los 200 $, como mínimo a Build. Reclamar no cambia el nivel de ninguna otra forma, y los créditos no cuentan para subir de nivel. Leído al pie de la letra, los 200 $ de Max 20x no «superan» 200 $, así que el mínimo garantizado sería Start; una bolsa de Team de más de 200 $ sí llega a Build. Tu nivel real está en la página Rate limits de Console.

En la práctica: si tu ciclo empieza a mitad de mes, en un mismo mes natural se juntan el final de una entrega y el principio de la siguiente, y todo cuenta para el mismo tope. Con Start y créditos de Max 20x, eso deja menos margen del que parece para saldo comprado ese mes. Al llegar al tope del nivel, la API responde HTTP 429 hasta el día 1 siguiente; si el tope lo fijaste tú por debajo, el error es HTTP 400 con You have reached your specified API usage limits.

Cuánto dan 100 $ o 200 $ según el modelo: ejemplo de cálculo

Lo que rinde el crédito depende sobre todo del modelo y del tamaño de cada petición. Como ejemplo, una petición con 3.000 tokens de entrada y 500 de salida, sin caché y con la API estándar, usando los precios de la API de Claude por millón de tokens:

Coste por petición = (3.000 × precio de entrada + 500 × precio de salida) / 1.000.000

Con una bolsa de Team de 500 $, la misma petición con Sonnet 5.5 daría para unas 45.450. Son cifras de un caso concreto, no una cuota: respuestas más largas, herramientas, contexto acumulado o prompts de Haiku por encima de 100K tokens (que pasan a 0,50 $ / 2,50 $) cambian el resultado.

Tres palancas para estirarlo:

• Message Batches API para lo que no necesita respuesta inmediata: cuesta la mitad, así que aproximadamente duplica las cifras de la tabla.
• Caché de prompts si repites el mismo contexto: en Opus 5.5 y Sonnet 5.5, la lectura de caché cuesta el 5 % del precio de entrada.
• El modelo justo para cada tarea. Si dudas entre modelos económicos, la comparación de precios está en Claude Haiku 5.5 vs GPT-6 Luna: precio API igual hasta 100K tokens; para el modelo grande, en Claude Opus 5.5: precio, disponibilidad y qué falla al migrar.

Si cambias de plan: subir a Max 20x, pasar a Team o cancelar

Preguntas frecuentes sobre los créditos de API de Max y Team

¿Puedo usar los créditos de uso (usage credits) de Claude para la API?

No. Los créditos de uso son un saldo aparte que activas en claude.ai (Settings > Usage) para seguir usando Claude, Claude Code o Cowork cuando agotas los límites del plan, y se cobran por separado a tarifa de API. Según la ayuda sobre créditos de uso, los créditos mensuales de API no se aplican a ese saldo: son dos bolsas separadas que no se mezclan.

¿Los créditos de API de Max sirven para Claude Code?

No para Claude Code interactivo en terminal, IDE, escritorio o web, ni para la GitHub Action. Sí cubren claude -p y el Agent SDK cuando los ejecutas tú con una clave de API de la organización vinculada. Tampoco amplían tus límites de Claude Code; para entender esos límites, mira Claude Pro y Max: qué límites cambian y por qué puedes agotar la cuota semanal.

¿Los créditos mensuales de API son el crédito del Agent SDK anunciado en junio?

No. Aquel crédito no llegó a lanzarse: los cambios previstos para el 15 de junio de 2026 se pausaron, y la actualización del 7 de octubre de 2026 remite a estos créditos mensuales de API, que cubren el Agent SDK, claude -p, la API de Claude y Managed Agents. Con la sesión de tu plan puedes seguir usando el Agent SDK y claude -p dentro de los límites de la suscripción. Si encuentras cifras de junio presentadas como vigentes, no corresponden a ningún programa activo.

¿Puedo repartir los créditos entre varias organizaciones de Console?

No. Van a una sola organización. Para separar proyectos dentro de ella, usa espacios de trabajo con su propio límite de gasto.

¿Valen en Amazon Bedrock, Vertex AI o Microsoft Foundry?

No. Solo se aplican a la API de Claude en Claude Console; Bedrock, Google Cloud Vertex AI, Microsoft Foundry y Claude Platform on AWS quedan fuera.

¿Tengo estos créditos con Claude Pro?

No. Solo Max 5x, Max 20x y Team, incluidos los Team con descuento. Pro, Free y Enterprise no los incluyen.