Facturación de automatización de Claude Code: límites de suscripción y créditos API

¿Cómo se factura la automatización de Claude Code frente al uso interactivo?#

El anuncio de mayo proponía pasar Agent SDK y uso programático a una bolsa mensual separada desde el 15 de junio. La propuesta no entró en vigor: la actualización de soporte de Anthropic indica que se pausó.

La distinción práctica es ahora la autenticación. Una ejecución con sesión del plan Claude puede usar sus límites. Una clave API de Claude Console utiliza el saldo API de esa organización. Chat y terminal interactivos siguen usando límites del plan. No clasifiques la factura solo por ejecutarse un proceso sin supervisión.

Consulta la guía de créditos API mensuales para la cuota de octubre y sus requisitos actuales. La cuota abandonada de junio no puede reclamarse.

Una prueba sencilla: ¿qué saldo utiliza tu ejecución?#

Enumera GitHub Actions, scripts programados, aplicaciones Agent SDK y sesiones interactivas. Registra para cada uno autenticación y superficie de inicio. Acceder por suscripción o con clave API son vías de facturación distintas aunque invoquen el mismo modelo.

Usa una tarea pequeña de desarrollo e inspecciona el registro de consumo en la cuenta correspondiente. Ver claude -p no demuestra por sí solo un cargo a créditos API: la guía oficial distingue un proceso propio con clave de los usos de Claude Code iniciados desde GitHub Actions, extensiones IDE o escritorio.

Comprueba casos como revisiones nocturnas de PR, investigación recurrente, wrappers n8n y herramientas de terceros. Haz explícitos credenciales y límites de gasto antes de habilitar trabajo desatendido.

Cuántos créditos recibes y qué incluyen#

La política API de octubre incluye 100 $ mensuales en Max 5x y 200 $ en Max 20x. Team incluye 20 $ por puesto Standard o 100 $ por Premium, agrupados hasta 500 $. Free, Pro y Enterprise no son aptos. Esta es la referencia vigente frente a la propuesta abandonada de junio.

Los créditos se conceden a una organización Console vinculada. Son independientes de los límites Claude y no cubren Claude Code interactivo ni su uso adicional. Comprueba requisitos y superficies de inicio oficiales antes de presupuestar un flujo concreto.

Calcula entrada y salida por separado con tarifas publicadas del modelo. Los ejemplos siguientes usan precios fechados de Opus 4.8 de 5 $ por millón de entrada y 25 $ de salida: son aritmética, no mediciones de tus ejecuciones.

Una ejecución ilustrativa de 30–50K de entrada y 15–20K de salida cuesta aproximadamente 0,50–1 $. En ese rango, 100 $ cubren unas 100–200 ejecuciones y 200 $ unas 200–400. Las largas consumen más y las cortas menos.

Qué ocurre cuando se agotan los créditos#

Los créditos API mensuales caducan en cada ciclo. Si no hay otros créditos disponibles, se detienen las solicitudes API. Los créditos comprados o la recarga automática pueden mantener el uso; las organizaciones con factura siguen su acuerdo. Esto no añade un cargo al propio plan Claude.

Comprueba saldo y recarga de la organización Console antes de trabajar sin supervisión. Una notificación no es un límite estricto. Fija un presupuesto y vigila el consumo real sin suponer que una cuota mensual garantiza disponibilidad.

3 estrategias: qué elegir según tu uso#

Estrategia 1: conservar la vía del plan existente

Si el desarrollo ocasional cabe en tus límites de suscripción, la propuesta de junio pausada no justifica comprar otro plan ni migrar credenciales. Verifica primero el consumo real.

Estrategia 2: usar una cuota API apta con saldo de respaldo acotado

Para trabajo API Max o Team apto, comprueba organización Console vinculada, cuota restante y ajustes opcionales de créditos comprados o recarga. Estima una ejecución representativa y fija presupuesto antes de habilitar gasto adicional.

Estrategia 3: usar un presupuesto API independiente

Para producción o una factura compartida de equipo, compara Console API con la vía del plan existente. Conserva o cancela tu suscripción personal según necesidades interactivas; una clave API tiene presupuesto separado. Prueba en desarrollo antes de cambiar credenciales productivas que funcionan.

No existe un número universal de trabajos a partir del cual migrar sea más barato. Usa costes medidos y tu tasa de finalización.

Calculadora: ¿cuántas ejecuciones caben?#

Esta calculadora es un ejemplo. La columna de 20 $ es un presupuesto hipotético, no un derecho de Pro; Pro no tiene acceso a los créditos API de octubre. Las cifras corresponden a Opus 4.8 (5 $ por millón de tokens de entrada y 25 $ por millón de tokens de salida; precios vigentes en el momento de la publicación. Si lees esto mucho más adelante, consulta la página de precios de Anthropic).

Si usas Sonnet, multiplica las cifras por aproximadamente 1,5: el modelo cuesta entre 1,5 y 2 veces menos. Haiku cuesta entre 5 y 10 veces menos, así que podrás hacer proporcionalmente más ejecuciones.

Estimación sencilla para tu propio proyecto:

1. Consulta la página de seguimiento de costes de Agent SDK para ver cuánto gastas actualmente por semana.
2. Multiplica la cantidad por 4,3 para calcular el gasto mensual.
3. Compara ese gasto con el saldo verificado y los requisitos de la vía de facturación elegida.

Si la cuota no basta, compara un presupuesto acotado de créditos comprados con API independiente. Decide por costes reales, no por una proporción fija.

Qué comprobar ahora#

1. Comprueba plan, autenticación, superficie de inicio y uso restante en la cuenta correspondiente.
2. Si tienes acceso a créditos API, sigue las instrucciones actuales de vinculación y comprueba qué organización los recibe. No esperes un correo de junio ni supongas que puedas reclamar la cuota abandonada.
3. Estima uso mensual con ejecuciones medidas, incluidos intentos fallidos y relecturas.
4. Decide si se debe detener al agotar el saldo o añadir un respaldo de pago acotado. Verifica el resultado en desarrollo.
5. En un equipo, pregunta al administrador quién controla claves y gasto. No supongas que la cuota de un puesto es privada o transferible.

Los plazos del 14/15 de junio son históricos, no pasos de configuración actuales.

Alternativas si los créditos no son suficientes#

Si tienes mucha automatización, puede que valga la pena considerar alternativas.

OpenAI Codex CLI: incluido con una suscripción ChatGPT Plus por 20 $ al mes. No tiene una bolsa de créditos separada ni una fecha de transición. Admite /hooks, /goal y perfiles de permisos. Para tareas habituales (revisión de código, refactorización basada en un ejemplo, pruebas), ofrece una calidad comparable.

Cursor Ultra: por 200 $ al mes ofrece una «bolsa programática» de 400 $ a precios de la API. La cuota anunciada no demuestra por sí sola una oferta mejor: compara usos admitidos, precios de modelos, tareas completadas y condiciones vigentes. Créditos API y límites de suscripción de Anthropic son independientes.

Cursor Composer 2.5: un modelo económico basado en Kimi K2.5, a 0,50 $ por millón de tokens de entrada y 2,50 $ por millón de tokens de salida. Es adecuado como «modelo de trabajo económico» para tareas largas y de gran volumen que no requieren inteligencia de primer nivel.

He analizado las alternativas en detalle:

• Comparación entre Codex y Claude Code
• Cursor frente a Claude Code
• Cómo ejecutar ambos durante la noche con /goal

Método de pago para los créditos de uso#

Revisa la facturación Console antes de comprar créditos API adicionales. Reclamar la cuota incluida no exige por sí solo añadir un método de pago; el uso de pago adicional tiene sus propios requisitos.

Uso interactivo y automatización: distingue las vías#

Chat, Claude Code interactivo y Cowork usan límites del plan. Agent SDK o claude -p también pueden usar suscripción con sesión del plan. El trabajo con clave API usa facturación Console, sujeto a los requisitos de la cuota.

Skills, subagentes, MCP, plugins y hooks no crean por sí mismos otra factura. Registra cómo se autentica e inicia el proceso que los contiene. Conserva una configuración funcional hasta demostrar en una tarea pequeña de desarrollo el consumo y facturación previstos.

Un aviso histórico separado: retiradas de modelos de junio#

Es un aviso histórico de migración separado, no prueba de que entrara en vigor la propuesta de facturación pausada. Verifica por separado disponibilidad de modelos y migración de paquetes antes de editar una aplicación funcional.

Qué se retirará de la API:

• claude-sonnet-4-20250514
• claude-opus-4-20250514

Los identificadores y sustitutos sugeridos pertenecían al aviso original. No copies una sustitución histórica como recomendación actual: elige un modelo disponible en la documentación actual y pruébalo en desarrollo.

Qué cambió de nombre:

• TypeScript: @anthropic-ai/claude-code → @anthropic-ai/claude-agent-sdk
• Python: claude-code-sdk → claude-agent-sdk

El aviso original indicaba que los paquetes antiguos redirigían a los renombrados. Consulta la guía de migración vigente antes de depender de ese comportamiento histórico.

Qué hacer ahora:

1. Busca en tus scripts

   grep -r 'claude-sonnet-4-20250514\|claude-opus-4-20250514\|claude-code-sdk\|@anthropic-ai/claude-code' .: si aparece algo, actualízalo.

2. Actualiza package.json o requirements.txt

   Compara paquete instalado e identificadores fijos con la documentación actual de migración y disponibilidad; cambia solo lo que exija esa comparación.

3. Ejecuta tus pruebas

   Ejecuta las pruebas Agent SDK con cualquier nombre cambiado antes de aplicarlo en producción. El antiguo plazo de junio no es un paso actual.

Cinco preguntas frecuentes#

¿La cuota de junio era otro pago mensual obligatorio?

No. Se anunció como crédito incluido y el cambio propuesto se pausó. No sumes esos importes a la suscripción.

¿Un usuario Pro puede reclamar los créditos API de octubre?

No. La guía actual incluye Max y Team aptos. Pro y Enterprise no lo son.

¿Los créditos se transfieren al ciclo siguiente?

No. Comprueba su caducidad en Console y presupuesta dentro del ciclo.

¿Debo esperar el antiguo correo de junio?

No. Usa la página actual de facturación e instrucciones oficiales; el crédito Agent SDK abandonado no está disponible.

¿Debe cambiar una integración existente con clave API?

El anuncio por sí solo no exige otra clave. Comprueba saldo de organización y vía de facturación, conserva credenciales funcionales y prueba cualquier cambio justificado en desarrollo.

Qué debes recordar#

Comprueba tres cosas separadas: límites de suscripción, cuota API incluida para planes aptos y uso API de pago opcional. El cambio de junio se pausó y no es una segunda factura obligatoria.

Registra autenticación y superficie de inicio, mide una ejecución representativa y compara coste con saldo verificado. Un contexto limpio e instrucciones organizadas pueden reducir relecturas, pero mide ese ahorro en lugar de prometer una reducción fija.