Claude API o suscripción para uso intensivo de Claude Code

A 10 de octubre de 2026, la respuesta corta es esta: si eres tú quien trabaja cada día con Claude Code en el terminal o el IDE, una suscripción Pro o Max sale casi siempre más barata que pagar lo mismo por tokens en la API de Claude. La API es la opción correcta cuando el consumo lo genera un programa (CI, scripts con claude -p, el Agent SDK, un backend) o cuando usas Claude Code tan poco que no llegas a amortizar los 20 $ de Pro.

Tres datos actuales cambian las cuentas:

• Max incluye crédito de API desde el 7 de octubre de 2026: 100 $ al mes en Max 5x y 200 $ en Max 20x. Sirve para la API, el Agent SDK y claude -p con una API key de la organización vinculada, pero no para Claude Code interactivo.
• Fable va distinto en cada plan: en Max, hasta el 50 % del límite semanal puede ir a Fable 5 y 5.1 sin coste extra; en Pro, Fable se paga con créditos de uso desde la primera petición.
• El exceso sobre el plan se paga a tarifa de API: con créditos de uso, y hay paquetes con descuento (50 $ por 45 $, 250 $ por 200 $ y 1.000 $ por 700 $).

La regla práctica que sale de los precios: Max 5x cuesta 80 $ más que Pro, lo mismo que unos 67 turnos grandes de Opus 5.5 pagados con créditos (200.000 tokens de entrada y 20.000 de salida, sin caché, a 1,20 $ cada uno). Si cada mes pasas de esa cifra, Max 5x sale más barato; si no llegas, te basta Pro con créditos de uso y un límite de gasto. Las cuentas completas, con caché y con el crédito de API de Max, están más abajo.

Límites oficiales a 10 de octubre de 2026: qué cambió desde julio

Pro y Max no tienen un número de mensajes ni de tokens publicado. Anthropic los describe con dos contadores: un límite por sesión que se reinicia a las cinco horas y un límite semanal para todos los modelos, que se reinicia a una hora fija de la semana según tu cuenta. Max 5x multiplica por cinco el uso por sesión de Pro y Max 20x por veinte; para el límite semanal no hay un múltiplo oficial entre los dos Max. El detalle por plan está en Límites de uso de Claude Pro y Max: el 5x y 20x es por sesión.

Ese límite es una bolsa común: claude.ai, Claude Code y Claude Desktop gastan del mismo contador, y el consumo depende de la longitud de la conversación, el modelo, las herramientas y el esfuerzo de razonamiento. En Claude Code, /usage enseña las barras, y los avisos que verás al agotarlas son «You've hit your session limit», «weekly limit» o el límite de una familia de modelos («Opus limit», «Sonnet limit»).

Lo que ha cambiado desde julio y afecta a la decisión:

Lo que no ha cambiado: Pro sigue sin incluir uso de la API a través de Claude Console, y una ANTHROPIC_API_KEY en el entorno de Claude Code sigue pasando el gasto a la API.

Cuatro rutas de coste que no debes mezclar

Gráfico anterior a la actualización del 10 de octubre de 2026: no refleja el crédito mensual de API que Max y Team incluyen desde el 7 de octubre. El texto está al día.

La primera ruta es la suscripción. Pro o Max pagan el uso interactivo de una persona en Claude y en Claude Code dentro de los límites del plan. Su valor no es que sea ilimitada, sino que la factura del mes es fija.

La segunda es la API de Claude, que se gestiona en Claude Console. Funciona con saldo prepagado: compras créditos en Settings > Billing, puedes activar recarga automática y los créditos caducan al año de la compra y no se reembolsan. Las claves empiezan por sk-ant- y solo se muestran una vez al crearlas. Aquí entran las apps, el CI, los agentes programados y cualquier proceso que no sea una persona escribiendo. Si tienes Max, el crédito mensual de API se carga en una organización de Console que vinculas tú y se gasta antes que el saldo que hayas comprado.

La tercera son los créditos de uso (extra usage): el exceso cuando agotas el límite de Pro o Max. Se activan en Settings > Usage, se cobran a tarifa estándar de API, admiten un límite de gasto mensual y valen para los chats y para Claude Code en el terminal. Un detalle que encarece las sesiones largas: mientras gastas créditos, la caché de prompts dura cinco minutos en lugar de una hora. El coste por turno y cuándo pasarte a Max están en Coste del uso adicional de Claude: créditos, Max y Claude Code.

La cuarta es la credencial que usa Claude Code en ese momento. Con /login de tu plan, gastas suscripción; con una ANTHROPIC_API_KEY aprobada, gastas API. Sin comprobar esto, comparar precios no sirve de nada.

Anclas de precio actuales antes de estimar

Los precios de la API de Claude se miden por millón de tokens de entrada y de salida. A 10 de octubre de 2026, según la página de precios de la API de Claude:

Tres ajustes cambian la factura real:

• Batch cuesta la mitad: Opus 5.5 queda en 2 $/10 $ y Opus 4.x o 5 en 2,50 $/12,50 $. Batch y caché se pueden combinar.
• La lectura de caché cuesta una décima parte de la entrada normal en la mayoría de modelos, pero solo un 5 % en Opus 5.5 y Sonnet 5.5, y un 2,5 % en Fable 5.1. En sesiones largas de Claude Code, que releen el mismo contexto, esto pesa más que el precio de lista.
• El modo rápido de Opus 5.5 cuesta 8 $/40 $, y la inferencia solo en EE. UU. multiplica el precio por 1,1. Desde Claude 4.6 no hay recargo por contexto largo: el millón de tokens entero se cobra a la tarifa normal.

Los modelos antiguos ya no sirven como referencia: Opus 4 se retiró el 15 de junio de 2026 y Opus 4.1 el 5 de agosto; Sonnet 4.5 se retira el 30 de noviembre de 2026. Si buscas el precio de una versión concreta de Opus, lo tienes en Claude Opus 5.5: precio de la API y restablecimiento de límites.

En la suscripción, los precios publicados son Pro a 20 $ al mes o 200 $ al año pagados por adelantado (17 $ al mes), Max 5x a 100 $ y Max 20x a 200 $, ambos solo mensuales. Son precios de la web; en el móvil pueden variar y en algunos países se suman impuestos al pagar. No hay descuentos permanentes y el soporte no emite cupones; las formas legítimas de pagar menos están en Descuento de Claude Code en 2026: cupones, Pro anual y créditos.

Punto de equilibrio de Max: cuántos turnos de Opus 5.5 lo pagan

Para comparar una cuota fija con un precio por token hace falta un tamaño de turno. El ejemplo usa un turno grande de Claude Code: lee 200.000 tokens de contexto y escribe 20.000. Es una suposición; tus turnos pueden ser bastante más pequeños o más grandes, así que vuelve a hacer la cuenta con tus cifras de /usage o de Console.

Coste del turno con los precios de la sección anterior:

• Opus 5.5 sin caché: 200.000 × 4 $ / 1.000.000 + 20.000 × 20 $ / 1.000.000 = 0,80 $ + 0,40 $ = 1,20 $.
• Opus 5.5 con 180.000 tokens leídos de caché: 180.000 × 0,20 $ + 20.000 × 4 $ + 20.000 × 20 $, todo por millón = 0,036 $ + 0,08 $ + 0,40 $ = 0,516 $.
• Sonnet 5.5 sin caché: 0,40 $ + 0,20 $ = 0,60 $.
• Fable 5.1 sin caché: 2,00 $ + 1,00 $ = 3,00 $.

El caso con caché supone que el contexto ya está guardado; la primera escritura de esos 180.000 tokens cuesta 0,90 $ más en Opus 5.5 (180.000 × 5 $ por millón). Con créditos de uso la caché caduca a los cinco minutos, así que en la práctica quedarás entre las dos cifras.

Dividiendo la diferencia de precio entre el coste del turno:

Cómo se lee: si en un mes normal gastarías en créditos más de lo que indica la fila, el plan superior sale más barato. Con Sonnet 5.5 hacen falta el doble de turnos para llegar al mismo importe; con Fable 5.1 en Pro, 80 $ son solo unos 27 turnos, y en Max esos turnos entran en el plan hasta la mitad del límite semanal. Si trabajas a menudo con Fable, Max suele ganar aunque el resto de tu uso cupiera en Pro.

Cómo cambia la cuenta el crédito de API de Max

El crédito mensual de Max no paga Claude Code interactivo, pero sí la API. Si ya gastas dinero en la API por otro lado (un agente con el Agent SDK, scripts con claude -p y una API key, pruebas en el Playground de Console), ese gasto pasa a cubrirlo Max. La cuenta queda así:

Coste real de Max 5x sobre Pro = 80 $ − el gasto de API que harías igualmente (hasta 100 $).

Ejemplo: si pagas 60 $ al mes de API para un agente de CI, Max 5x te cuesta en la práctica 20 $ más que Pro más esa API, es decir, unos 17 turnos grandes de Opus 5.5. Si tu gasto de API llega a 80 $, Max 5x no te cuesta nada más que Pro. Con Max 20x la fórmula es 180 $ menos tu gasto de API, hasta 200 $.

Condiciones que pone el centro de ayuda de Claude sobre los créditos de API de Max y Team:

• Lo reclamas en claude.ai, en Settings > Billing, con «Link organization»; los nuevos suscriptores pueden hacerlo tras siete días en un plan elegible. Solo puedes vincular una organización de Console y para cambiarla hay que escribir a soporte.
• El crédito no se acumula: lo que no gastes caduca al final de cada ciclo de facturación.
• claude -p solo lo gasta si lo lanzas con una API key de la organización vinculada; si estás conectado con tu plan, consume los límites del plan. Las ejecuciones de la GitHub Action de Claude Code, de la extensión del IDE o de la app de escritorio cuentan como Claude Code y no lo usan.
• Tampoco cubre los créditos de uso ni Claude en Amazon Bedrock, Google Cloud Vertex AI o Microsoft Foundry.
• Pro, Free y Enterprise no lo tienen.

Escenarios: cuándo gana suscripción o API

Gráfico anterior a la actualización del 10 de octubre de 2026: el uso extra no se activa solo, hay que activarlo en Settings > Usage, y Max incluye ahora crédito de API. El texto está al día.

Con los precios y el punto de equilibrio, la decisión depende de quién genera el consumo y de cuánto se pasa del plan:

Bajar de plan tiene un coste escondido desde el 7 de octubre: si pasas de Max a Pro pierdes también el crédito de API. Antes de bajar, mira en Console cuánto de ese crédito gastaste el último ciclo y réstalo del ahorro. Para comparar Pro y Max con más detalle (límites, Fable, invitaciones y reinicios), tienes Claude Pro vs Max: precios, límites de uso y cuándo compensa Max.

Claude Code: comprueba la ruta activa antes de subir de plan

Antes de subir o bajar de plan, confirma qué paga tu Claude Code. Según la documentación de autenticación de Claude Code, si tienes suscripción y además una ANTHROPIC_API_KEY en el entorno, Claude Code te pregunta una vez en modo interactivo si quieres usar la clave y recuerda la respuesta; en modo no interactivo (claude -p) la usa siempre que exista. /status marca la credencial que no se está usando, y unset ANTHROPIC_API_KEY te devuelve a la suscripción. La elección se cambia luego en /config, con la opción «Use custom API key». El orden completo de credenciales está en Claude Code: API key o suscripción, cuál manda en la facturación.

Si /status muestra tu plan y no hay clave, la decisión pasa a los límites, los créditos de uso o Max. Si hay una clave aprobada, lo primero es arreglar el entorno: puede que estés pagando la API sin saberlo mientras tu plan apenas se usa.

Para scripts y automatizaciones con tu suscripción, claude setup-token genera un token de un año para CLAUDE_CODE_OAUTH_TOKEN, ligado a tu plan Pro, Max, Team o Enterprise, sin crear ninguna API key. Las sesiones de Claude Code en la nube usan siempre las credenciales de la suscripción.

Las herramientas de terceros merecen una comprobación aparte. Las condiciones legales de Claude Code dicen que el acceso con tu cuenta de Claude es para el uso normal de Claude Code y de las apps de Anthropic, que quien construye productos o servicios, también con el Agent SDK, debe usar una API key, y que no se permite canalizar peticiones de otros usuarios a través de credenciales de Free, Pro o Max. Por su parte, la actualización del 7 de octubre de 2026 del centro de ayuda indica que puedes seguir usando el Agent SDK, claude -p y apps de terceros con los límites de tu suscripción. En abril de 2026 la prensa informó de que herramientas del tipo OpenClaw dejaban de entrar en los límites de la suscripción y pasaban a cobrarse aparte. Con una herramienta concreta, mira su propia documentación antes de contar con tu plan.

Compra de equipo y control de gasto

En un equipo, la respuesta casi nunca es una sola: asientos para las personas, la API para los programas y créditos de uso con tope para los picos.

Team cuesta 20 $ por asiento Standard con pago anual (25 $ mensual) y 100 $ por asiento Premium (125 $ mensual). Desde el 7 de octubre de 2026 también incluye crédito de API: 20 $ por asiento Standard y 100 $ por Premium, en una bolsa común con un máximo de 500 $ al mes. Lo vincula el propietario de la organización en Organization settings > Billing. En los asientos Premium, Fable entra en el límite semanal igual que en Max; en los Standard, se paga con créditos.

Para la parte de API, Console ya trae topes. Las organizaciones se asignan a un nivel (Start, Build, Scale o Custom) según su historial, con un límite de gasto mensual de 500 $, 1.000 $ y 200.000 $ en los tres primeros. Al llegar al tope, las peticiones fallan con un error 429 enforced_spend_limit_reached hasta el día 1 a las 00:00 UTC. Puedes fijar tu propio límite de gasto por debajo del tope; al alcanzarlo, las peticiones devuelven un error 400.

Los créditos de uso necesitan una política escrita: quién puede activarlos, con qué límite mensual y a partir de cuántos meses seguidos de exceso se pasa a un asiento superior o se lleva la carga a la API. Si alguien compra paquetes de créditos todos los meses, es señal de que necesita otro tipo de asiento.

Lista de decisión

1. Nombra quién genera el consumo: tú en el terminal, un compañero, una app, el CI o un proceso batch. Las personas van a la suscripción; los programas, a la API.
2. Comprueba la credencial: /status y si existe ANTHROPIC_API_KEY en el shell. Si Claude Code está cobrando por API sin querer, arregla eso antes de tocar el plan.
3. Mide un mes normal: en Settings > Usage, cuántas veces agotas la sesión o la semana; en la factura, cuánto pagaste en créditos de uso.
4. Aplica el umbral: más de 80 $ de créditos al mes sobre Pro, Max 5x; más de 100 $ sobre Max 5x, Max 20x. Si usas Fable a menudo, Max aunque no llegues.
5. Suma el crédito de API de Max: si ya pagas API por otro lado, réstalo del coste de Max antes de decidir, y no bajes de plan sin contarlo.
6. Pon topes: límite de gasto en los créditos de uso y en Console, y alertas en ambos.

Fuentes y ruta de verificación

Precios y condiciones a 10 de octubre de 2026, de las páginas oficiales de Anthropic:

• Planes y precios de Claude: Pro, Max, Team y tabla de modelos antiguos.
• Precios de la API de Claude: tarifas por modelo, caché, Batch y modo rápido.
• Créditos de API mensuales de Max y Team en el centro de ayuda de Claude: importes, cómo se vinculan y qué no cubren.
• Créditos de uso de Pro y Max en el centro de ayuda de Claude: activación, límite de gasto y paquetes.
• Autenticación de Claude Code: orden de credenciales, /status y setup-token.
• Límites de gasto y de peticiones de la API de Claude: niveles Start, Build, Scale y Custom.

Las cifras por turno y los umbrales son cálculos a partir de esas tarifas con un turno de tamaño supuesto; los precios cambian sin aviso largo, así que vuelve a mirar las páginas antes de pagar un plan anual o un paquete de créditos.

Verificación en la cuenta: llevar la comparación a la factura real

La comparación se cierra con tres pantallas de tu propia cuenta, cada una para una pregunta distinta.

En claude.ai, Settings > Usage, ves tu plan, cuánto llevas de la sesión y de la semana, cuándo se reinicia cada límite y si tienes créditos de uso activados, con su límite de gasto. En Settings > Billing, el apartado de créditos de API dice si ya vinculaste una organización de Console (solo en Max).

En Claude Console, Usage y Billing, ves el gasto de API, el saldo comprado y, si lo vinculaste, el crédito mensual de Max. Si aparecen cargos de Opus en días en los que solo trabajaste en el terminal, casi seguro hay una API key en tu entorno.

En Claude Code, /status dice qué credencial está activa y /usage enseña las barras de la sesión y de la semana.

Con un mes de datos de esas pantallas, aplica la fórmula del punto de equilibrio con tus importes reales en lugar del turno de ejemplo.

Preguntas frecuentes

¿Una suscripción de Claude incluye llamadas API?

Pro no: la suscripción y la API de Claude se facturan por separado. Max y Team sí incluyen, desde el 7 de octubre de 2026, un crédito mensual de API (100 $ en Max 5x, 200 $ en Max 20x, 20 $ o 100 $ por asiento de Team con un máximo de 500 $) que se gasta en una organización de Console vinculada. Ese crédito no paga Claude Code interactivo ni los créditos de uso.

¿Claude API es más caro que Pro o Max?

Depende de cuánto uses. Con los precios de octubre de 2026, un turno grande de Claude Code en Opus 5.5 (200.000 tokens de entrada y 20.000 de salida) cuesta 1,20 $ por API, así que con unos 17 turnos al mes ya pagas lo que vale Pro. Para quien programa a diario, la suscripción suele salir mucho más barata; para un uso esporádico o un programa que llama a Claude, la API es la opción lógica.

¿Cuándo compensa pagar uso extra con créditos?

Cuando un plan te alcanza casi siempre y solo te pasas algunas semanas. Ponle un límite de gasto mensual. Si el exceso supera 80 $ al mes sobre Pro, o 100 $ sobre Max 5x, el plan superior ya es más barato; los paquetes de 250 $ por 200 $ o 1.000 $ por 700 $ solo compensan si sabes que vas a gastarlos.

¿Por qué Claude Code genera gasto API si ya pago suscripción?

Casi siempre porque hay una ANTHROPIC_API_KEY en el entorno que aprobaste en el aviso, o porque ejecutas claude -p en un shell donde existe. Ejecuta /status, quita la variable con unset ANTHROPIC_API_KEY o cambia la opción «Use custom API key» en /config.

¿Hay una API key de Claude gratis?

Anthropic da a las cuentas nuevas de Console una pequeña cantidad de crédito para probar la API, sin importe publicado; guías de terceros hablan de unos 5 $. Max incluye crédito mensual de API, y hay programas de crédito para investigadores; el de startups está en pausa desde el 9 de octubre de 2026. El detalle está en Claude API key gratis: crédito de prueba, Max y cómo comprar.

¿Cómo compro una API key de Claude?

La clave se crea en Claude Console, en Settings > API keys > Create key, y empieza por sk-ant-. Lo que pagas es el uso, con créditos prepagados en Settings > Billing, que caducan al año y no se reembolsan. Si tienes Max, vincula primero tu organización para gastar antes el crédito mensual.

¿Puedo usar mi suscripción de Claude en herramientas de terceros?

El centro de ayuda dice, en su actualización del 7 de octubre de 2026, que el Agent SDK, claude -p y apps de terceros pueden usar los límites de tu suscripción. Las condiciones de uso prohíben, en cambio, que un producto canalice peticiones de otros usuarios a través de tu Pro o Max, y desde abril de 2026 la prensa informó de que herramientas del tipo OpenClaw se cobran aparte. Mira lo que dice la documentación de cada herramienta.

¿Un equipo debe comprar suscripciones o usar API?

Normalmente ambas cosas: asientos de Team para quienes trabajan de forma interactiva y la API para apps, CI y agentes. El crédito de API de Team (hasta 500 $ al mes en total) cubre la primera parte de ese gasto.

¿Qué hago si no estoy seguro?

No subas ni bajes de plan todavía. Durante un mes mira /status, Settings > Usage y Console, anota cuánto pagas en créditos de uso y en API, y aplica los umbrales de 80 $ y 100 $ con tus cifras.