¿Cuánto cuesta Claude Code?
Cuánto cuesta una sesión de Claude Code con clave de API, por qué un agente de código gasta tantos tokens y seis formas de bajar la factura mensual.
Claude Code puede funcionar con una suscripción a Claude o con una clave de API, y cada una factura distinto. Con clave de API pagas por token sin tope, y por eso la gente se sorprende con la factura tras una semana intensa: un agente de código no envía un prompt, envía toda la conversación y los archivos que ha leído, otra vez, en cada paso. Esta página explica qué consume realmente una sesión, cómo ver lo que gastaste y qué cambiar cuando es demasiado.
Qué gasta una sesión de Claude Code
Un agente trabaja en bucles: lee un archivo, ejecuta un comando, edita, corre las pruebas, vuelve a pensar. Cada bucle es una petición a la API, y cada petición contiene todo lo anterior: el prompt de sistema, las definiciones de herramientas, los mensajes previos y los resultados de las herramientas. Tres consecuencias:
Una sesión larga envía cientos de miles de tokens de entrada por cada pocos miles que escribe.
Claude Code se apoya en la caché de prompts, así que casi toda esa entrada repetida se factura al precio de lectura de caché, una pequeña fracción del normal. Una sesión cuya caché sigue funcionando cuesta una fracción de otra cuya caché falla una y otra vez.
La misma sesión en un modelo más grande cuesta un múltiplo de lo que costaría en uno más pequeño.
En Half Off Dev, todos esos precios son la mitad del precio de lista de Anthropic, y la pasarela mantiene cada sesión en el canal que guarda su caché, de modo que la caché sigue caliente durante toda la sesión.
Un turno realista, con precios
Un paso a mitad de sesión en claude-sonnet-5.5: 3,000 tokens de entrada nuevos, 50,000 leídos de la caché, 1,500 escritos en la caché y 1,200 tokens de salida.
| Tipo de token | Tokens | Pagas por 1 M | Costo |
|---|---|---|---|
| Entrada sin caché | 3,000 | $1.00 | $0.003000 |
| Lectura de caché | 50,000 | $0.05 | $0.002500 |
| Escritura de caché | 1,500 | $1.25 | $0.001875 |
| Salida | 1,200 | $5.00 | $0.006000 |
| Total | $0.013375 |
Una tarea de cincuenta pasos así cuesta unas cincuenta veces eso. La cifra de tu proyecto depende del modelo, del tamaño del repositorio que lee el agente y de cuántas veces repite el bucle, así que mide una tarea real en vez de fiarte de un promedio.
Mira lo que gastas
Abre Registros en el panel: cada petición aparece con su modelo, sus tokens de entrada, de caché y de salida, y su costo. Ejecuta una tarea, ordena por costo y fíjate en dos cosas: cuántos pasos dio y qué parte de la entrada vino de la caché. Pon un límite de gasto a la clave (Claves de API) para que un agente que se quede corriendo toda la noche no se descontrole.
Seis formas de gastar menos
- Ajusta el modelo al paso. Usa un modelo mediano para las ediciones de todos los días y deja el más grande para planificar o depurar casos difíciles. Claude Code toma un modelo principal y un modelo pequeño de segundo plano, que se configuran con
ANTHROPIC_MODELyANTHROPIC_DEFAULT_HAIKU_MODEL. - Mantén las sesiones enfocadas. Una sesión nueva para una tarea nueva empieza con un historial pequeño. Una sola sesión arrastrada por cinco tareas sin relación mete todo ese historial en cada petición.
- No rompas la caché. Cambiar el prompt de sistema o la lista de herramientas a mitad de sesión, y las pausas más largas que la vida de la caché, obligan a reescribirla. Trabaja en ráfagas.
- Señala los archivos que importan. Decirle al agente qué directorio y qué archivos son relevantes es mejor que dejar que lea medio repositorio para averiguarlo.
- Limpia o compacta el historial largo cuando cambies de tema.
- Paga la mitad por token. La configuración son dos variables de entorno:
export ANTHROPIC_BASE_URL=https://halfoff.dev
export ANTHROPIC_AUTH_TOKEN=$HALFOFF_API_KEY
claudeLos detalles completos, con settings.json y soluciones a errores, están en Claude Code.
Preguntas frecuentes
¿Cuánto cuesta Claude Code al mes?+
Con clave de API depende por completo del uso: unas pocas tareas enfocadas por semana cuestan muy poco; una jornada completa de programación cuesta bastante más. Mide una tarea en Registros, multiplica por cuántas haces y revisa el resultado en la calculadora de costo de Claude Code.
¿Claude Code es gratis?+
La herramienta es gratuita de instalar. Pagas el modelo, ya sea con un plan de Claude o por token con una clave de API.
¿Puedo usar Claude Code con una clave de API en lugar de una suscripción?+
Sí. Define ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN como se muestra arriba y Claude Code hablará con la API con cargo a tu saldo prepago. Claude Pro frente a la API compara ambas opciones.
¿Por qué Claude Code usa tantos tokens?+
Porque cada paso reenvía la conversación y los resultados de las herramientas. La caché convierte la mayor parte en lecturas baratas, y por eso mantener las sesiones enfocadas y sin interrupciones ahorra más que acortar los prompts.
¿Qué modelo es mejor para Claude Code?+
El modelo mediano es un buen punto de partida para el trabajo diario; usa el más grande cuando una tarea siga fallando con el más pequeño. Opus, Sonnet y Haiku da los detalles.
Para las palancas de más bajo nivel, mira la forma más barata de usar la API de Claude. ¿Eres nuevo? Crea una cuenta y genera una clave.
Una clave prepago para modelos, datos y agentes
Sin suscripción. Recarga, usa lo que necesites y ve cada cargo en tus registros.