Claude API vs suscripción: ¿cuál es más barata?

¿Es la API de Claude más barata que una suscripción?

La API de Claude es más barata que una suscripción por debajo de cierto volumen de uso, y más cara por encima de este. Para un desarrollador que programa interactivamente todo el día, el plan fijo suele ser mejor. Para un programa que realiza sus propias llamadas, la API es la única opción, por lo que el coste no es el factor decisivo. El resto es aritmética que puedes realizar en diez minutos.

No existe un número oficial de punto de equilibrio para consultar. El modelo de suscripción se vende mediante ventanas de uso en lugar de asignaciones de tokens, por lo que ninguna cifra publicada puede indicar dónde se cruzan ambas líneas. Lo que sigue es la fórmula, calculada con las tarifas actuales por token, más los factores de tu propio comportamiento que desplazan el resultado mucho más que la cuota del plan. Cada cifra de punto de equilibrio a continuación es mi propia aritmética basada en tarifas publicadas y supuestos declarados, no un número documentado.

Si aún estás decidiendo qué plan comprar, qué plan de Claude se adapta a tu forma de trabajar responde a eso. Este post asume que ya sabes qué plan comprarías y quieres saber si te conviene comprarlo.

Dos modelos de facturación que no tienen la misma forma

Una suscripción es capacidad que podrías no usar. Pagas una cuota fija y obtienes una asignación que se reinicia según un calendario. La documentación de Claude Code de Anthropic establece la estructura para los asientos de Team y Enterprise: el uso "se extrae de una asignación por asiento que se reinicia en una ventana rotativa de cinco horas y una ventana semanal", compartida con Claude chat y Cowork. Un suscriptor experimenta la misma estructura mediante los mensajes que alcanza, que muestran "You've hit your session limit" y "You've hit your weekly limit". La capacidad que no utilizas es dinero gastado de todos modos. La capacidad que excedes detiene tu trabajo hasta que la ventana se reinicie, y cambiar de modelo con /model no restaura el acceso, porque las ventanas se comparten entre modelos.

La API es un medidor que nunca se detiene. No hay ventanas ni límites. Cada solicitud tiene un precio por token, y algunas cosas tienen un precio fuera de los tokens: la búsqueda web "está disponible en la Claude API por $10 por cada 1,000 búsquedas". Nada se detiene ante un límite. La factura simplemente crece.

Cuotas de los planes al 23 de julio de 2026, según la página de precios de Claude: Pro es "$17 al mes con descuento por suscripción anual ($200 facturados por adelantado). $20 si se factura mensualmente", e incluye Claude Code. Max se lista como "Desde $100 al mes". Los asientos de Team comienzan en "$20 por asiento / mes si se factura anualmente". Enterprise es el caso interesante, porque ejecuta ambos modelos a la vez: "Precio por asiento + uso a tarifas de API $20/asiento". Las tarifas cambian con frecuencia y la asignación detrás de cada una nunca se publica en tokens, así que consulta la página de precios el día que decidas.

Lo que no puedes obtener de la API

Una asignación de plan y la interfaz construida en torno a ella. El comando /usage-credits de Claude Code gestiona los créditos de uso de la suscripción, y se ejecuta "después de iniciar sesión con tu suscripción de claude.ai a través de /login; el comando no está disponible con autenticación por clave API". La pantalla /usage también difiere según el modo de facturación: su bloque de Session "muestra el uso de tokens de la API y está destinado a usuarios de la API", mientras que los suscriptores ven barras de uso del plan y un desglose de uso en su lugar.

Un caché de prompt más largo en Claude Code. Esto cuesta dinero real y es fácil pasarlo por alto. La documentación dice: "La duración es de una hora en una suscripción y baja a cinco minutos una vez que utilizas créditos de uso; en una clave API o proveedor de la nube, es de cinco minutos por defecto". Tu primer mensaje después de un descanso más largo que la duración del caché no utiliza el caché, por lo que todo tu contexto se vuelve a procesar y se factura a precios de escritura. Con una suscripción puedes tener una reunión de cincuenta minutos y volver con el contexto listo. Con una clave API, el mismo descanso cuesta un re-escritura completo del prefijo de la sesión.

Lo que no puedes obtener de una suscripción

Acceso programático. Un cron job o un manejador de webhooks que llame a Claude necesita una clave API, por lo que si ese es tu flujo de trabajo, la comparación ha terminado. Construir tu primera app de Claude API en un VPS cubre el manejo de claves y el primer script funcional.

El descuento de la Batch API. La página de precios lo indica claramente: "La Batch API permite el procesamiento asíncrono de grandes volúmenes de solicitudes con un 50% de descuento tanto en tokens de entrada como de salida". Eso reduce a la mitad el medidor para cualquier trabajo para el cual un humano no esté esperando. Las tarifas de Batch por millón de tokens son $2.50 de entrada y $12.50 de salida en Opus 4.8, $1 y $5 en Sonnet 5 con precio de lanzamiento, y $0.50 y $2.50 en Haiku 4.5. El intercambio es la latencia: la mayoría de los batches terminan en menos de una hora, un batch que no se haya completado en 24 horas expira, y el streaming no puede procesarse por batches. El batch y el prompt caching se pueden combinar, y como un batch puede durar más de cinco minutos, utiliza el caché de 1 hora dentro de uno.

Atribución de costes por proyecto. Cada respuesta de la API devuelve un bloque usage, por lo que puedes registrar el coste de una sola solicitud y atribuirlo a un proyecto o cliente. Una suscripción reporta un único conjunto de barras para la persona que posee el asiento.

Una aclaración importante, porque es fácil asumir lo contrario en ambos casos: estas son superficies de facturación separadas. La documentación de Anthropic dirige la facturación de suscripciones al soporte de claude.ai y la facturación de Console a la plataforma API, y /usage-credits no funciona bajo una clave API. Nada de lo que he revisado indica que una suscripción incluya crédito de API, así que planifica dos cuentas y dos facturas.

La fórmula del punto de equilibrio

Calcula el precio de un turno y luego escálalo.

turn cost = uncached_input_tokens x base_input_price
          + cache_write_tokens    x 1.25 x base_input_price
          + cache_read_tokens     x 0.10 x base_input_price
          + output_tokens         x output_price

monthly API cost = turn cost x turns_per_active_day x active_days_per_month

break even when: monthly API cost = flat plan fee

Los multiplicadores están publicados, no son estimaciones. Una escritura de caché de 5 minutos cuesta "1.25x el precio base de entrada", una escritura de 1 hora cuesta "2x el precio base de entrada", y una lectura de caché cuesta "0.1x el precio base de entrada". Los tokens de pensamiento se facturan como tokens de salida, por lo que pertenecen a output_tokens incluso en modelos que no muestran un resumen de razonamiento.

Tarifas base por millón de tokens (MTok), actuales al 23 de julio de 2026:

• claude-fable-5: $10 entrada, $50 salida. Lectura de caché $1. Escritura de caché de 5 min $12.50. 1M contexto.
• claude-opus-4-8 y claude-opus-4-7: $5 entrada, $25 salida. Lectura de caché $0.50. Escritura de caché de 5 min $6.25. 1M contexto.
• claude-sonnet-5: $2 entrada, $10 salida con precio de lanzamiento hasta el 31 de agosto de 2026, luego $3 y $15. Con tarifas de lanzamiento, lectura de caché $0.20 y escritura de caché de 5 min $2.50. 1M contexto.
• claude-haiku-4-5: $1 entrada, $5 salida. Lectura de caché $0.10. Escritura de caché de 5 min $1.25. 200K contexto.

No hay recargo por un contexto largo: "Una solicitud de 900k tokens se factura a la misma tarifa por token que una solicitud de 9k tokens".

Un ejemplo práctico, con los supuestos detallados

Toma un turno medio de Claude Code en Sonnet 5 con 60,000 tokens de contexto: 55,000 servidos desde el caché, 3,000 recién escritos en el caché, 2,000 tokens de entrada nueva sin caché, y 1,200 tokens de salida incluyendo pensamiento.

• Lecturas de caché: 55,000 x $0.20/MTok = $0.0110
• Escrituras de caché: 3,000 x $2.50/MTok = $0.0075
• Entrada sin caché: 2,000 x $2.00/MTok = $0.0040
• Salida: 1,200 x $10.00/MTok = $0.0120

Eso es aproximadamente $0.035 por turno. Con 120 turnos en un día activo, unos $4.14 al día. Con 20 días activos al mes, aproximadamente $83 al mes.

Compara eso con las cuotas fijas anteriores y obtienes dos conclusiones a la vez. Es aproximadamente cuatro veces la cuota de Pro, por lo que Pro es más barato sobre el papel, siempre que su asignación cubra 120 turnos de Sonnet al día. Ese matiz es lo que ningún número publicado puede resolver por ti. Los mismos $83 están por debajo de la cuota inicial de Max, por lo que aquí el medidor vence a Max.

Ahora cambia un supuesto a la vez y observa cómo la cuota del plan deja de ser el número decisivo.

Tres factores que mueven el punto de equilibrio más que el precio del plan

Prompt caching. Ejecuta el mismo turno de 60,000 tokens sin caché y todo el prompt se factura como entrada nueva: 60,000 x $2.00/MTok = $0.12, más $0.012 de salida, total $0.132 por turno. Eso es casi cuatro veces el turno con caché, y convierte el mes de $83 en unos $317. Este es el único punto de equilibrio que Anthropic publica, porque no depende de tu carga de trabajo: "Un acierto de caché cuesta el 10% del precio estándar de entrada, lo que significa que el caché compensa tras solo una lectura de caché para la duración de 5 minutos (1.25x escritura), o tras dos lecturas de caché para la duración de 1 hora (2x escritura)".

Dos modos de fallo desactivan el caché sin avisar. El primero es un prefijo más corto que la longitud mínima cacheable del modelo: 512 tokens en Fable 5, 1,024 en Opus 4.8 y Sonnet 5, 2,048 en Opus 4.7, y 4,096 en Haiku 4.5. Un prefijo más corto no se cachea y no se genera error. El segundo es el envío de solicitudes paralelas, porque "una entrada de caché solo está disponible después de que comienza la primera respuesta". Diez solicitudes idénticas enviadas a la vez pagan el precio completo de entrada. La señal de ambos es que cache_read_input_tokens se mantiene en cero.

Elección del modelo. Calcula el mismo turno en Opus 4.8, a $5 de entrada y $25 de salida, con lecturas de caché a $0.50 y escrituras de 5 min a $6.25 por MTok: lecturas $0.0275, escrituras $0.0188, entrada sin caché $0.0100, salida $0.0300. Eso es aproximadamente $0.086 por turno, 2.5 veces el turno de Sonnet, y unos $207 al mes con el mismo volumen. Una elección de modelo movió el mismo trabajo de estar por debajo de la cuota inicial de Max a más del doble de la misma. Haiku 4.5 a $1 y $5 lo mueve en la dirección opuesta para tareas mecánicas como el triaje de logs.

El nivel de esfuerzo depende de la elección del modelo, porque los tokens de pensamiento se facturan a tarifas de salida. En Opus 4.8 el valor por defecto de la API es high, y el punto de partida documentado para tareas de programación y agentes es el más costoso xhigh. Redúcelo con /effort en Claude Code o con output_config.effort en la API. Una cosa más altera las estimaciones antiguas: los modelos más nuevos usan un tokenizador más nuevo que "produce aproximadamente un 30% más de tokens para el mismo texto", por lo que un recuento medido en un modelo antiguo subestima el mismo texto hoy.

Higiene de la sesión. La API no tiene estado (stateless), por lo que cada turno reenvía toda la conversación como entrada facturable. Una sesión larga, por tanto, cuesta más por mensaje que una nueva, que es el mecanismo detrás de la mayoría de las facturas sorpresa y se detalla en qué consume realmente tokens en una sesión de Claude Code. Ejecuta /clear entre tareas no relacionadas, porque el contexto obsoleto se reenvía y se vuelve a facturar en cada mensaje posterior. Ejecuta /compact dentro de una tarea larga, para que el historial se resuma en lugar de transportarse completo. Trabaja en periodos continuos, porque el caché por defecto "tiene una duración de 5 minutos" y "se actualiza sin coste adicional cada vez que se utiliza el contenido cacheado". Una sesión que tocas una vez cada diez minutos paga una re-escritura cada vez. Una sesión de Claude Code ejecutándose en tmux en un VPS aislada no gasta casi nada mientras está inactiva, pero si la inactividad supera la duración del caché, se pierde el prefijo listo.

Mide tu propio uso antes de decidir

No decidas basándote en mi ejemplo. Decide basándote en una semana tuya.

En Claude Code, ejecuta /usage al final de cada sesión durante una semana (/cost es un alias para la misma pantalla). Informa de los recuentos de tokens de la sesión y una estimación de coste, con una advertencia de la documentación: "La cifra en dólares es una estimación calculada localmente a partir de los recuentos de tokens y puede diferir de tu factura real". Los totales se reinician cuando ejecutas /clear, así que lee la pantalla primero. En una suscripción, esa cifra en dólares no es tu factura, pero los recuentos de tokens que la sustentan son lo que esta fórmula necesita. /context muestra qué está llenando la ventana.

En una cuenta de API, la página de uso en la Claude Console es el registro oficial. Para calcular el precio de un prompt antes de enviarlo, client.messages.count_tokens() es "gratuito pero sujeto a límites de tasa de solicitudes por minuto basados en tu nivel de uso", y es el único recuento que utiliza el tokenizador por el que realmente se te facturará.

Después de una llamada, lee el bloque de uso y léelo correctamente:

u = response.usage
total_input = u.input_tokens + u.cache_creation_input_tokens + u.cache_read_input_tokens

input_tokens solo cuenta el remanente sin caché, documentado como "los tokens después del último punto de interrupción de caché". Un turno que informa de input_tokens: 4000 no es un turno de 4,000 tokens, y la suma de los tres campos es el tamaño del prompt que esta fórmula requiere.

Luego compara. Si tu mes medido queda claramente por debajo de la cuota del plan, elige la API. Si queda claramente por encima, elige el plan, siempre que su asignación cubra una jornada laboral normal para ti. Si queda cerca de la línea, elige el plan, porque un plan no puede sorprenderte y un medidor sí puede.

FAQ

¿Es la API de Claude más barata que Claude Pro o Max?

Depende del volumen, y no hay un punto de equilibrio publicado para consultar, porque las suscripciones se venden como ventanas de uso en lugar de asignaciones de tokens. Calcula el precio de un turno típico con las tarifas por token publicadas, multiplícalo por tus turnos por día activo y días activos por mes, y luego compara esa cifra con la cuota del plan. En un ejemplo práctico, un turno de Sonnet 5 de 60,000 tokens costó unos $0.035, o aproximadamente $83 al mes con 120 turnos al día durante 20 días: por encima de la cuota de Pro, por debajo de la cuota inicial de Max.

¿Cómo calculo mi coste mensual de la API de Claude?

Ejecuta /usage en Claude Code durante una semana para recopilar recuentos reales de tokens, o lee la página de uso en la Claude Console si ya tienes una cuenta de API. Luego calcula el precio de un turno: entrada sin caché al precio base, escrituras de caché a 1.25 veces la entrada base, lecturas de caché a 0.1 veces la entrada base, y salida a la tarifa de salida, contando los tokens de pensamiento como salida. Multiplica por turnos por día activo y días activos por mes.

¿Qué es lo que más cambia una factura de la API de Claude?

El prompt caching, más que cualquier otra cosa. Un turno de 60,000 tokens en Sonnet 5 cuesta unos $0.035 cuando el prefijo se sirve desde el caché y unos $0.132 cuando no es así. La elección del modelo es lo siguiente: el mismo turno en Opus 4.8 cuesta unos $0.086. La duración de la sesión es lo tercero, porque la API no tiene estado y cada turno reenvía toda la conversación como entrada facturable.

¿Incluye una suscripción de Claude el acceso a la API?

Trátalos como dos cuentas con dos facturas. Las llamadas de la API se facturan por token contra una cuenta que creas en la Console, y nada en la documentación que he revisado indica que una suscripción otorgue crédito de API. La señal más clara de que son superficies separadas es el comando /usage-credits de Claude Code, que "no está disponible con autenticación por clave API". Muchos desarrolladores tienen ambos: un plan para programación interactiva y una clave para las cosas que construyen.