Coste de tokens de Claude Code: lo que realmente consume una sesión

Respuesta rápida: espera dólares por sesión, no céntimos.

Claude Code es una herramienta agéntica, no una ventana de chat. Una sola petición tuya puede desencadenar decenas de llamadas al modelo, y cada llamada reenvía toda la conversación, cada vez más grande, como tokens de entrada. Eso convierte al volumen de entrada, no a la salida, en el factor que determina el coste. Los tokens de salida suelen ser un error de redondeo comparados con la entrada. Cifras aproximadas reportadas por la comunidad sitúan una sesión seria de una hora en un repositorio mediano en unos 5 a 20 millones de tokens. A tarifas directas de Anthropic para Sonnet 4.6 ($3 por millón de entrada, $15 por millón de salida), la mayoría de las sesiones quedan entre unos $2 y $40 antes de los descuentos de caché, y los días intensivos con Opus superan eso con creces. La caché de prompts baja las facturas reales por debajo de la aritmética ingenua, pero el patrón se mantiene: las sesiones largas en repositorios grandes cuestan dinero de verdad. Tienes tres palancas. Reduce lo que entra en la ventana de contexto, enruta el trabajo rutinario a modelos más baratos y baja la tarifa por token cambiando dónde se facturan las peticiones. El resto de esta página desarrolla cada una con números concretos.

A dónde van realmente los tokens.

Dos mecánicas suavizan esto. Primero, la caché de prompts de Anthropic: Claude Code marca los prefijos estables como cacheables, las escrituras de caché cuestan una prima y las lecturas de caché se facturan a aproximadamente una décima parte de la tarifa normal de entrada. Segundo, la compactación de contexto: el comando /compact resume el historial y descarta la transcripción en bruto. Ambas ayudan mucho, y ninguna cambia la regla fundamental: todo lo que está en la ventana se paga en cada llamada que lo incluya. Por eso el mismo prompt cuesta cantidades muy distintas en repositorios diferentes. Una pregunta hecha en una sesión nueva con un CLAUDE.md ligero es barata. La misma pregunta hecha 30 turnos dentro de una sesión que ha leído una docena de archivos grandes va montada sobre una ventana de tokens de seis cifras.

• System prompt y definiciones de herramientas: unos 15 a 20K tokens, reenviados en cada llamada al modelo.
• CLAUDE.md, archivos de reglas y esquemas de herramientas MCP: se cargan al inicio de la sesión y se arrastran en cada llamada posterior.
• Lecturas de archivos: un archivo fuente de 500 líneas son unos 5 a 7K tokens, y se queda en la ventana después de leerse una vez.
• Resultados de herramientas: la salida de tests, los resultados de grep y los registros de terminal se añaden a la conversación y se refacturan como entrada en cada turno posterior.
• El propio bucle agéntico: un simple "arregla este test que falla" puede producir entre 10 y 40 llamadas al modelo antes de que Claude Code responda.

Matemáticas realistas del coste de una sesión.

Modélalo turno a turno en lugar de adivinar. Una sesión típica de tamaño medio corre unas 40 llamadas al modelo. Una vez que se han acumulado unos cuantos archivos y algo de salida de tests, la ventana completa promedia unos 90K tokens por llamada. Cuarenta llamadas a 90K son 3.6M de tokens de entrada. La salida se mantiene pequeña: 40 llamadas de unos 1,000 tokens cada una son unos 40K tokens de salida. La tabla de abajo tarifica tres perfiles de sesión a tarifas de lista directas de Anthropic. Trátalas como techos: la caché de prompts descuenta mucho el prefijo repetido, así que las sesiones con caché suelen salir más bajas. El patrón sigue coincidiendo con lo que reportan los desarrolladores. Las tardes ocasionales cuestan unos pocos dólares; usar Opus como opción diaria en la API puede superar varios cientos de dólares al mes.

Plan vs API: ¿por dónde sale más barato Claude Code?

Anthropic vende Claude Code de dos formas: incluido en planes de suscripción de tarifa plana con topes de uso aplicados en ventanas móviles, o medido por token en la API. El precio de la API de Claude Code es simplemente las tarifas de modelo de arriba aplicadas a lo que consuman tus sesiones, sin tope y sin corte. El punto de equilibrio es aritmética pura. Si tu sesión típica cuesta unos $11 en Sonnet a tarifas directas, un plan de $20 se paga solo con aproximadamente dos sesiones al mes, siempre que te mantengas bajo sus topes. La trampa está en los propios topes: el uso agéntico intensivo es exactamente el patrón que dispara los límites móviles, y una tarifa plana deja de ser barata en el momento en que te bloquea a mitad de sesión. La facturación de la API invierte el trato. Nunca te cortan, y pagas exactamente por lo que consumes. Muchos usuarios intensivos terminan en un híbrido: un plan para el trabajo interactivo, una clave de API para trabajos de CI y el excedente.

Cómo recortar el coste de tokens de Claude Code.

Las dos últimas palancas se combinan. Enrutar un modelo barato a través de un endpoint con descuento puede convertir una sesión de $10 en bastante menos de un dólar para el trabajo rutinario. Una opción de pasarela es APIsRouter, una API compatible con OpenAI con facturación de pago por uso y sin suscripción: los modelos globales tienen un precio 20% por debajo de la lista oficial, los modelos chinos quedan por debajo de sus tarifas oficiales, la primera recarga añade +100% de saldo, y el checkout sin registro en /topup cobra primero y envía la clave por correo. El catálogo de abajo muestra cómo es en la práctica una escala de enrutamiento. Kimi K2.6 (kimi-k2.6) también está disponible si lo prefieres como nivel económico.

• Mantén CLAUDE.md ligero. Cada línea es un cargo recurrente en cada llamada al modelo de cada sesión.
• Empieza una sesión nueva por tarea y ejecuta /compact cuando una sesión larga se descontrole. Una ventana de 150K tokens factura 150K en cada llamada.
• Acota las lecturas. Dirige Claude Code a archivos concretos en lugar de dejar que rastree, y excluye la salida de build y los directorios de dependencias empaquetadas.
• Desactiva los servidores MCP que no uses. Sus esquemas de herramientas viajan dentro del system prompt en cada llamada.
• Enruta por modelo. Reserva Opus para la arquitectura y la depuración más complicada, usa Sonnet como opción por defecto, y envía el código repetitivo, el andamiaje de tests y los mensajes de commit a modelos más baratos.
• Baja la propia tarifa por token apuntando la base URL a una pasarela en lugar de facturar a precios de lista directos.

Ejemplo de configuración: reapunta Claude Code y verifica.

Claude Code lee ANTHROPIC_BASE_URL al arrancar, así que cambiar dónde se facturan los tokens es un cambio de configuración, no de flujo de trabajo. Pon el endpoint y la clave en ~/.claude/settings.json y cada sesión los recoge. Los IDs de modelo se mantienen iguales, la ejecución de herramientas sigue local en tu máquina, y revertir es comentar una línea. Para herramientas y scripts compatibles con OpenAI, la base URL termina en /v1 (https://api.apisrouter.com/v1). Verifica la clave con un curl puntual antes de apuntar tu uso diario ahí:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apisrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-APIsRouter-...",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
  }
}

Preguntas frecuentes