Precio de Claude Code en 2026: suscripción o API, cuánto cuesta un mes y cuál compensa

Claude Code es gratis de instalar, pero no de usar, y su precio depende de cómo lo pagues. Con una suscripción de claude.ai va incluido en la cuota: Claude Pro cuesta $20 al mes ($17 al mes con pago anual) y Claude Max, desde $100 al mes, a septiembre de 2026; el plan gratuito (Free) no incluye Claude Code. Con una clave de API no hay cuota y se paga por tokens: en Kunavo, Claude Sonnet 5 cuesta $2,00 por millón de tokens de entrada y $10,00 por millón de salida, así que una interacción típica del agente (unos 25.000 tokens de entrada y 1.200 de salida) sale por unos $0,062. Según la propia documentación de Anthropic, el gasto real ronda los $13 por desarrollador y día de uso. Todas las cifras están en dólares estadounidenses (USD).

Casi toda la confusión sobre cuánto cuesta Claude Code viene de mezclar esas dos vías. Esta página da las cifras actuales de ambas, la cuenta para elegir entre ellas, lo que cuesta un mes real y cómo apuntar Claude Code a una API más barata sin reinstalar nada.

Tarifas verificadas el 11 de septiembre de 2026 con claude.com/pricing (planes, a septiembre de 2026) y la documentación de precios de la API de Anthropic. Las tarifas de Kunavo se leen del catálogo de modelos del sitio.

¿Cuánto cuesta Claude Code? Las dos formas de pagarlo

Las dos vías no se suman. Mientras haya una variable de credencial definida, Claude Code usa la clave y deja aparcada la suscripción: los límites del plan dejan de aplicarse y el consumo se cobra a la clave. El comando /status muestra cuál está activa.

Precio de Claude Code con suscripción

Claude Code requiere una cuenta Pro, Max, Team, Enterprise o de consola (API); según la documentación de instalación de Anthropic, el plan Free de Claude.ai no incluye Claude Code. Precios publicados en claude.com/pricing, a septiembre de 2026:

Lo que más pesa no es la cuota sino el límite. El uso de un plan se mide en una ventana móvil de cinco horas y en otra semanal, ambas compartidas con el chat de Claude: una tarde de conversación en la web consume la misma asignación que tu sesión de programación. Cambiar de modelo con /model no reinicia la ventana, porque las ventanas abarcan todos los modelos. Qué incluye cada plan fuera de la programación, y cuándo compensa la API para chatear, está en los precios de Claude.

¿Claude Code es gratis?

La herramienta sí; el uso, no. La CLI, las extensiones para VS Code y JetBrains y toda la configuración son gratuitas: lo que se paga son las llamadas al modelo. No existe un nivel gratuito que permita a Claude Code usar un modelo sin pagar: el plan Free de Claude.ai no lo incluye y la API se cobra por token desde la primera llamada.

La vía con menos compromiso es una clave de pago por uso: sin cuota mensual, con una recarga mínima de $10 y un saldo que no caduca, así que un mes sin programar cuesta $0. Con esos $10 y Sonnet 5 hay para unos 160 pasos agénticos, unas 8 tareas de 20 pasos. La versión larga, en inglés: is Claude Code free.

Precio de Claude Code con API, por modelo

Con una clave no hay plan ni ventanas: Claude Code se cobra como tráfico normal de la API de Claude. Los archivos y la salida de las herramientas cuentan como tokens de entrada; las ediciones, las explicaciones y el razonamiento, como tokens de salida. Tarifas por millón de tokens (entrada / salida):

Una advertencia, dicha claramente: Claude Sonnet 5 es el único modelo de esta tabla que Kunavo no vende por debajo de Anthropic. Anthropic convirtió su tarifa de $2,00 / $10,00 en precio estándar permanente el 31 de agosto de 2026 —la subida a $3 / $15 prevista para el 1 de septiembre se canceló— y Kunavo la iguala.

Si en una sesión lo que decide es el precio por token, claude-opus-5 cuesta en Kunavo exactamente lo mismo que Sonnet 5 ($2,00 / $10,00), con el razonamiento de la gama Opus y un 60 % por debajo de su propia tarifa oficial ($5,00 / $25,00). Si lo que manda es el presupuesto, Sonnet 4.6 hace el mismo paso por $0,0372.

La caché también forma parte del precio

Claude Code reenvía la conversación entera en cada paso, así que la mayor parte de lo que factura es contexto repetido: justo lo que abarata la caché de prompts. Multiplicadores sobre la tarifa de entrada:

En una sesión con la caché caliente, la mayoría de los tokens de entrada son lecturas a una décima parte de la tarifa; por eso multiplicar tokens por precio sobrestima mucho la factura. También explica el peor patrón de gasto en Claude Code: volver tras una pausa larga, cuando la caché ya ha expirado, obliga a procesar todo el contexto de nuevo a precio completo.

Cuánto cuesta un mes de Claude Code

El gasto sigue a los pasos agénticos, no a los días. Un paso es una ida y vuelta al modelo dentro de una tarea: unos 25.000 tokens de entrada (prompt de sistema, conversación y archivos) y 1.200 de salida. Con tarifas de Kunavo y sin caché:

Veinte días así con Sonnet 5 suman unos $124, lo mismo que en la API directa de Anthropic, porque Sonnet 5 se vende a precio oficial. Con Opus 5 a la tarifa oficial de Anthropic serían unos $310; en Kunavo, $124. Son cifras pesimistas a propósito: sin caché y con un solo modelo para todo.

Para contrastarlas con despliegues reales, la documentación de Anthropic sobre el gasto de Claude Code habla de unos $13 por desarrollador y día de uso y de $150 a $250 por desarrollador al mes en despliegues de empresa, con el 90 % de los usuarios por debajo de $30 al día. Son cifras a tarifa oficial con una mezcla de modelos, y son la referencia para presupuestar un equipo.

El punto de equilibrio

Con las dos vías en el mismo eje, a $0,062 por paso con Sonnet 5:

• $20 (Pro) equivalen a unos 320 pasos agénticos al mes, unas 16 tareas de 20 pasos.
• $100 (Max, nivel de entrada) equivalen a unos 1.600 pasos, unas 80 tareas.

La regla que sale de ahí: si programas con Claude Code casi todos los días, la suscripción suele salir más barata. Al ritmo medio que mide Anthropic, un mes de trabajo supera con holgura los $100 de Max, y el plan lo cubre mientras no topes con sus límites. Si tu uso es irregular —semanas intensas y semanas sin tocarlo—, gana el pago por uso, porque las semanas tranquilas no cuestan nada. Los equipos suelen preferir claves de todos modos: reparten el gasto por persona y admiten un tope mensual por clave. Para hacer tu propia cuenta, usa la calculadora de precios por token (en inglés).

Calcula una sesión con sus propios números

El comando /usage de Claude Code muestra los cuatro recuentos de tokens de la sesión. Es el dato fiable para estimar el gasto, porque separa las lecturas de caché de la entrada nueva:

# Cuánto costó una sesión de Claude Code, a partir de sus propios tokens.
# Ejecuta /usage dentro de Claude Code para obtener los cuatro números.
TARIFAS = {  # USD por millón de tokens en Kunavo: (entrada, salida)
    "claude-haiku-4-5":  (0.40, 2.00),
    "claude-sonnet-4-6": (1.20, 6.00),
    "claude-sonnet-5":   (2.00, 10.00),
    "claude-opus-5":     (2.00, 10.00),
}

def gasto_sesion(modelo, entrada, salida, lectura_cache=0, escritura_cache=0):
    e, s = TARIFAS[modelo]
    return (
        entrada / 1e6 * e                   # entrada nueva
        + salida / 1e6 * s                  # salida, razonamiento incluido
        + lectura_cache / 1e6 * e * 0.10    # lectura de caché: 10 % de la entrada
        + escritura_cache / 1e6 * e * 1.25  # escritura en caché: 125 %
    )

# La sesión de ejemplo que muestra la documentación de Anthropic para /usage:
print(gasto_sesion("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))  # ≈ 0.37

En esa sesión de ejemplo hay 940.000 tokens leídos de caché frente a 1.200 de entrada nueva. A tarifa completa, esos 940.000 tokens costarían $1,88; como lecturas de caché cuestan $0,188. Por eso la caché, más que la elección de modelo, es la mayor palanca de gasto en Claude Code.

Las cuatro palancas que bajan la factura

1. Deja trabajar a la caché. La entrada leída de caché cuesta el 10 % de la tarifa y Claude Code relee la conversación en cada paso: es el mayor efecto disponible (cómo funciona).
2. Limpia entre tareas sin relación. El contexto se reenvía en cada paso, así que una sesión de todo el día se encarece con cada mensaje; con /clear y una tarea nueva, el contexto vuelve a ser pequeño.
3. Elige el modelo por tarea. Dejar el modelo más grande por defecto es la causa más habitual de una factura inesperada: un paso con Fable 5 cuesta 3,5 veces lo que uno con Sonnet 5. Sonnet resuelve la mayor parte de la programación; reserva Opus y Fable para la arquitectura y el razonamiento difícil.
4. Manda las llamadas de fondo a Haiku. Claude Code hace sus propias llamadas para resúmenes y títulos; ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 es una línea y es ahorro puro.

Usar Claude Code con Kunavo

Claude Code lee ANTHROPIC_BASE_URL de forma nativa, así que funciona contra cualquier endpoint que sirva la API Messages de Anthropic: sin plugin, sin proxy y sin tocar la instalación. Para una sesión de terminal:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # el origen, sin /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

ANTHROPIC_BASE_URL es solo el origen: Claude Code añade /v1/messages por su cuenta, y un valor que ya termina en /v1 acaba en un 404. Usa ANTHROPIC_AUTH_TOKEN y no ANTHROPIC_API_KEY: las dos variables envían la clave en cabeceras distintas, y Kunavo autentica con Authorization: Bearer, que es la que envía ANTHROPIC_AUTH_TOKEN. Para dejarlo fijo, pon las variables en el bloque env de tu configuración de usuario:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Nunca en el .claude/settings.json del proyecto, que acaba en el repositorio. En la extensión de VS Code, las variables van en claudeCode.environmentVariables, dentro de la configuración de usuario de VS Code. Para comprobarlo, abre la pestaña de estado con /status: una línea «Auth token» confirma que la credencial está activa; si aparece «Login method» con una cuenta de claude.ai, la variable no se ha cargado. La guía completa está en Claude Code con Kunavo (en inglés).

La clave sk-kn- se crea en el panel de claves después de registrarte y recargar $10. El saldo se recarga con Stripe —tarjetas (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Link y Klarna, entre otros métodos según tu país; no se ofrece la domiciliación SEPA—, no caduca y las peticiones fallidas no se cobran. Cada clave admite un tope de gasto mensual (al alcanzarlo, la API responde con un 402) y una lista de IP permitidas: útil para dar una clave a cada desarrollador o a la CI sin sustos a fin de mes.

Lo que cambia, y lo que no, al usar Claude Code con una API

El núcleo de Claude Code —el agente, las herramientas, los subagentes, los servidores MCP— funciona sobre la API Messages y no cambia. Lo que sí cambia: con una credencial de pasarela activa, Remote Control y el dictado por voz dejan de estar disponibles, porque necesitan una identidad de claude.ai.

Y lo que Kunavo no sustituye: sirve Claude sobre capacidad compartida, sin cuota dedicada ni SLA contractual. Si tu equipo necesita una cuota garantizada o un acuerdo de nivel de servicio, contrata directamente con Anthropic. Y si programas con Claude Code a diario y cabes en los límites del plan, la suscripción probablemente te salga más barata; la API compensa con uso irregular, en equipos que quieren repartir y limitar el gasto, y en automatización.

Preguntas frecuentes