Precios de Claude Code 2026: suscripción frente a API, tarifas por modelo y cuánto cuesta un mes

Claude Code tiene dos precios completamente distintos, y gran parte de la confusión sobre su coste proviene de mezclarlos. Una suscripción de claude.ai lo incluye en una cuota mensual fija con límites de uso. Una clave de API factura por token sin cuota mensual y sin límites. Esta página contiene las cifras actuales de ambos, los cálculos para decidir cuál quieres y lo que cuesta realmente un mes.

Tarifas verificadas el 10 de octubre de 2026 frente a claude.com/pricing y la documentación de precios de la API de Anthropic. Los precios por token de Kunavo se leen en tiempo real del catálogo de modelos.

TL;DR: cuál es para ti

No se acumulan. Mientras haya definida una variable de credenciales, Claude Code usa la clave y tu suscripción queda en pausa: sus límites dejan de aplicarse y el uso se factura a la clave. Ejecuta /status para ver cuál está activa.

Ruta 1: precios de suscripción

Claude Code requiere una cuenta Pro, Max, Team, Enterprise o Console; la documentación de configuración de Anthropic indica que el plan gratuito de Claude.ai no incluye acceso a Claude Code. Tarifas de los planes publicadas en claude.com/pricing:

Lo importante es el límite, no la tarifa. El uso de un plan se mide contra una ventana móvil de cinco horas y una ventana semanal, ambas compartidas con el chat de Claude; por eso una tarde en la aplicación web consume la misma asignación que tu sesión de programación. Cambiar de modelo con /model no reinicia una ventana, porque las ventanas abarcan todos los modelos.

Ruta 2: precios de API por modelo

Con una clave no hay plan ni ventana: Claude Code se factura como tráfico normal de Claude API. Los archivos y la salida de las herramientas cuentan como tokens de entrada; las ediciones, explicaciones y tokens de razonamiento cuentan como salida. Tarifas por 1M de tokens:

Una nota sobre Claude Sonnet 5: Anthropic convirtió su tarifa de $2,00 / $10,00 en el precio estándar permanente el 31 de agosto de 2026; el aumento a $3 / $15 previsto para el 1 de septiembre se canceló; y Kunavo cobra $1,40 / $7,00, un 30% por debajo. El detalle completo por modelo está en la guía de precios de Claude API.

La caché forma parte del precio

Claude Code vuelve a enviar toda la conversación en cada paso, por lo que la mayor parte de lo que factura es contexto repetido; precisamente para eso sirve la caché de prompts. Los multiplicadores publicados por Anthropic se aplican al tráfico de Claude Code como a cualquier otro:

En una sesión con la caché activa, la mayoría de los tokens de entrada son lecturas de caché a una décima parte de la tarifa, por lo que una estimación ingenua de tokens × precio sobrestima mucho la factura. También explica el peor patrón de costes de Claude Code: volver después de una pausa larga provoca un fallo de caché y reprocesa todo el contexto al precio completo.

Cuánto cuesta realmente un mes

El coste sigue los pasos agénticos, no los días del calendario. Un paso es un viaje de ida y vuelta al modelo dentro de una tarea: aproximadamente 25.000 tokens de entrada y 1.200 de salida una vez contabilizados el prompt del sistema, la conversación y el contexto nuevo de los archivos. Con las tarifas de Kunavo, sin caché:

Veinte días de este tipo con Sonnet 5 cuestan aproximadamente $87, frente a unos $124 al precio de lista de Anthropic para el mismo modelo. Son cifras deliberadamente pesimistas: sin caché y con un solo modelo para todo.

Como comprobación frente a implementaciones reales, la propia documentación de costes de Anthropic informa de una media de unos $13 por desarrollador y día activo y $150–250 por desarrollador al mes en implementaciones empresariales, y de que el 90% de los usuarios se mantiene por debajo de $30 por día activo. Es el precio de lista con una combinación de modelos, y es la cifra con la que conviene planificar el presupuesto de un equipo.

El punto de equilibrio

Pon las dos rutas en el mismo eje. A $0,043 por paso con Sonnet 5:

• $20 (Pro) compra aproximadamente 460 pasos agénticos al mes, es decir, unas 23 tareas de veinte pasos.
• $100 (Max, nivel inicial) compra aproximadamente 2300 pasos, es decir, unas 115 tareas.

La regla es sencilla: si completas cómodamente un par de docenas de tareas reales al mes, todos los meses, la cuota fija ofrece una buena relación calidad-precio. Si tu uso es irregular, con algunas semanas intensas y otras sin actividad, el pago por token gana, porque las semanas tranquilas son gratis. Los equipos casi siempre prefieren claves de todos modos, para la atribución por puesto y los límites estrictos de gasto. Haz tus propios cálculos en la calculadora de costes.

Calcular el coste de una sesión a partir de sus propios datos

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

# What one Claude Code session costs, from its own token counts.
# Run /usage in Claude Code to get the four numbers for a real session.
RATES = {  # USD per 1M tokens on Kunavo: (input, output)
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-4-6": (2.10, 10.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
    "claude-opus-5-5":   (2.80, 14.00),
}

def session_cost(model, inp, out, cache_read=0, cache_write=0):
    i, o = RATES[model]
    return (
        inp / 1e6 * i            # fresh input
        + out / 1e6 * o          # output, incl. thinking tokens
        + cache_read / 1e6 * i * 0.10   # cache reads bill at 10% of input
        + cache_write / 1e6 * i * 1.25  # 5-minute cache writes at 125%
    )

# The example session Anthropic's docs print for /usage:
print(session_cost("claude-sonnet-5", 1_200, 5_300, 940_000, 50_000))

Observa cómo afecta la división al total: en ese ejemplo, la sesión contiene 940.000 tokens leídos de la caché frente a 1.200 tokens de entrada nueva, y las lecturas de caché se facturan a una décima parte de la tarifa de entrada.

Las cuatro palancas que cambian la cifra

1. Deja que funcione la caché de prompts. La entrada almacenada en caché se factura al 10% de la tarifa de entrada, y Claude Code vuelve a leer la conversación en cada paso, por lo que este es el mayor efecto individual disponible (cómo funciona).
2. Limpia entre tareas no relacionadas. El contexto se vuelve a enviar en cada paso, por lo que una sola sesión de todo el día resulta cuadráticamente cara. Una tarea nueva vuelve a tener un contexto pequeño.
3. Adapta el modelo al trabajo. Dejar el modelo más grande como predeterminado es la causa más habitual de una factura inesperada. Sonnet gestiona la mayor parte del trabajo de programación; reserva Opus para la arquitectura y el razonamiento difícil de varios pasos.
4. Conserva la línea de Haiku. Sin ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5, el alias haiku de Claude Code solicita un ID de modelo que Kunavo no ofrece (Haiku 5.5 desde la v2.1.293), por lo que /model haiku y los subagentes configurados con haiku devuelven 404. La misma línea traslada fuera del modelo principal las llamadas que Claude Code realiza por su cuenta para generar resúmenes y títulos.

Ejecutar Claude Code en Kunavo

Claude Code lee ANTHROPIC_BASE_URL de forma nativa, por lo que funciona con cualquier endpoint que sirva la API de mensajes de Anthropic: sin plugin, sin proxy y sin binario modificado. Esa es la forma compatible de conservar la misma CLI y los mismos modelos con una tarifa por token más baja:

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

ANTHROPIC_BASE_URL solo es el origen; Claude Code añade /v1/messages por sí mismo. Conserva las líneas de modelos: el valor predeterminado integrado de Claude Code y su alias opus resuelven ambos al Opus más reciente y, si Kunavo aún no ofrece ese modelo, la primera solicitud devuelve 404. El alias sonnet ya solicita Sonnet 5.5, que Kunavo no ofrece; sin ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, la fase de ejecución de opusplan y cualquier subagente configurado en model: sonnet devuelven 404. El ajuste opus es Opus 5.5 (claude-opus-5-5, $2,80 / $14,00 por millón aquí), que requiere Claude Code v2.1.280 o posterior; ejecuta claude update en una instalación antigua. Usa ANTHROPIC_AUTH_TOKEN en lugar de ANTHROPIC_API_KEY: van en encabezados distintos y el segundo requiere una aprobación interactiva única que no vuelve a solicitarse si se rechaza. Crea la clave sk-kn- en el panel después de registrarte y recargar $10: no hay cuota mensual y el saldo no caduca, por lo que un mes sin actividad realmente no cuesta nada. La configuración completa, incluido lo que deja de funcionar detrás de una pasarela, está en la guía del enrutador de Claude Code; los detalles de las credenciales están en la guía de la clave de API de Claude Code.

Preguntas frecuentes