Cómo medir los costes de Claude Code por mensaje (sin herramientas de terceros)

Claude Code es uno de los agentes de programación con IA más potentes que existen hoy. Puede refactorizar bases de código enteras, escribir suites de tests desde cero y depurar problemas complejos que abarcan varios archivos en cuestión de minutos. Pero esa potencia tiene un precio sorprendentemente difícil de controlar. Es habitual que los desarrolladores reporten gastos de 50, 100 o incluso más de 300 dólares al día en Claude Code sin darse cuenta hasta que llega la factura.

El problema de fondo es la visibilidad. Claude Code se ejecuta en tu terminal, procesa miles de tokens por interacción y no te da ningún feedback en tiempo real sobre lo que cuesta cada mensaje. Terminas una sesión de programación, revisas tu panel de Anthropic al día siguiente y descubres que te has fundido todo el presupuesto mensual en una tarde.

Esta guía explica por qué importa medir los costes de Claude Code, qué herramientas existen actualmente y cómo conseguir visibilidad de costes por mensaje en tiempo real con SuperBuilder: una app de escritorio gratuita y de código abierto para agentes de programación con IA.

Por qué los costes de Claude Code se descontrolan

Claude Code no es un simple chatbot. Cuando le pides que "refactorice el módulo de autenticación", lee decenas de archivos, construye un modelo mental de tu base de código, escribe código, ejecuta tests, lee la salida de errores e itera. Un solo prompt puede desencadenar una cadena de llamadas a herramientas que consume decenas de miles de tokens a lo largo de varios turnos.

Esto es lo que hace que los costes sean impredecibles:

Las ventanas de contexto grandes son caras

Claude Code usa Claude 3.5 Sonnet o Claude 3 Opus por debajo. Cada interacción incluye tu system prompt, el historial de la conversación, el contenido de los archivos y los resultados de las herramientas. Un mensaje típico a mitad de sesión puede arrastrar entre 50.000 y 100.000 tokens de entrada antes de que Claude empiece siquiera a generar una respuesta. Con los precios actuales de Anthropic, solo ese contexto cuesta entre 0,15 y 0,30 dólares por mensaje con Sonnet, y bastante más con Opus.

El uso de herramientas multiplica el consumo de tokens

Cuando Claude Code lee un archivo, ese archivo pasa a formar parte del contexto de la conversación. Cuando ejecuta un comando y lee la salida, eso son más tokens. Un solo prompt de "arregla este bug" puede dar lugar a entre 5 y 15 llamadas a herramientas, cada una sumando miles de tokens al contexto acumulado. La conversación crece con cada turno y pagas por el contexto completo en cada mensaje posterior.

Sin feedback de coste integrado

El CLI de Claude Code te muestra la respuesta. No te muestra el número de tokens, ni el coste, ni siquiera un aviso cuando te acercas a un umbral de gasto. Vas a ciegas. Este es el problema fundamental: los desarrolladores no pueden optimizar lo que no pueden ver.

La duración de la sesión agrava el problema

Cuanto más larga sea tu sesión, mayor será la ventana de contexto y más caro será cada mensaje. Una sesión nueva puede costar 0,02 dólares por mensaje. Tras 30 turnos de depuración de ida y vuelta, el mismo tipo de mensaje puede costar 0,50 dólares o más, porque todo el historial de la conversación se incluye en cada solicitud.

Soluciones existentes para medir los costes de Claude Code

Antes de pasar al seguimiento en tiempo real, veamos qué hay disponible hoy y dónde se queda corto cada enfoque.

Panel de Anthropic Console

El Anthropic Console en console.anthropic.com ofrece métricas de uso para tu cuenta de API. Puedes ver el total de tokens consumidos y el gasto total, desglosado por día y por modelo.

Lo que hace bien:

• Fuente de verdad oficial para la facturación
• Muestra agregados diarios y mensuales
• Desglosa el uso por modelo (Sonnet vs. Opus)

Lo que le falta:

• Sin granularidad por mensaje: ves totales diarios, no interacciones individuales
• Sin asociación con proyectos o sesiones de programación concretas
• Los datos llegan con retraso: siempre miras el uso pasado, no el gasto actual
• Sin alertas ni umbrales: descubres los excesos a posteriori

El panel de Anthropic es útil para la contabilidad mensual, pero no te dice nada sobre qué sesión o prompt concreto fue caro. Si ayer gastaste 40 dólares, no tienes forma de saber si fue la refactorización de la autenticación o la generación de la suite de tests lo que se comió tu presupuesto.

ccusage (herramienta CLI de código abierto)

ccusage es una herramienta CLI creada por la comunidad que analiza los archivos de log locales de Claude Code para calcular el uso de tokens y los costes estimados. La ejecutas después de una sesión y produce un desglose de tus interacciones recientes.

Lo que hace bien:

• Gratuita y de código abierto
• Proporciona desgloses de coste por sesión
• Funciona en local sin enviar datos a ningún sitio
• Puede analizar sesiones históricas

Lo que le falta:

• Solo a posteriori: la ejecutas cuando el daño ya está hecho
• Requiere invocación manual: tienes que acordarte de comprobarlo
• Salida solo por CLI: sin panel visual ni gráficos
• Sin feedback en tiempo real durante las sesiones de programación activas
• Las estimaciones pueden desviarse de la facturación real por el caché y las optimizaciones de prompts

ccusage es una herramienta sólida para revisar sesiones pasadas. Pero no resuelve el problema de fondo: necesitas visibilidad de costes mientras programas, no después de haber gastado el dinero.

Conteo manual de tokens

Algunos desarrolladores miden los costes estimando los conteos de tokens a mano. Saben más o menos cómo de grandes son los archivos de su base de código, estiman el tamaño de la ventana de contexto y lo multiplican por los precios publicados por token.

Esto es tedioso, propenso a errores y se desmorona por completo cuando Claude Code encadena varias llamadas a herramientas. Nadie va a parar a mitad de sesión para calcular que el último mensaje incluía 47.000 tokens de entrada procedentes de tres lecturas de archivos y dos salidas de comandos.

Cómo es el seguimiento de costes por mensaje en tiempo real

La pieza que falta es una herramienta que te muestre el coste de cada mensaje a medida que ocurre, no después de la sesión, ni como un agregado diario, sino ahí mismo en la interfaz, junto a cada respuesta.

Esto es lo que ofrece SuperBuilder. SuperBuilder es una app de escritorio gratuita y de código abierto que envuelve Claude Code en una interfaz nativa y añade funciones que faltan en el CLI, incluido el seguimiento de costes por mensaje en tiempo real.

Cómo funciona

SuperBuilder lanza Claude Code como un proceso hijo usando el flag --output-format stream-json. Esto le da a SuperBuilder acceso al flujo estructurado de eventos que emite Claude Code, incluidos los datos de uso de tokens de cada interacción.

Para cada intercambio de mensajes, SuperBuilder extrae:

• Tokens de entrada: el contexto total enviado al modelo (system prompt + historial de la conversación + contenido de los archivos + resultados de las herramientas)
• Tokens de salida: los tokens que Claude generó en su respuesta
• Tokens de lectura de caché: tokens servidos desde el caché de prompts de Anthropic (más baratos que los tokens de entrada nuevos)
• Tokens de escritura de caché: tokens escritos en caché para reutilizarse en el futuro
• Coste total en USD: calculado a partir de los conteos de tokens usando los precios actuales de Anthropic

Estos datos se muestran junto a cada mensaje, se guardan en una base de datos SQLite local y están disponibles en un resumen de coste por sesión.

Lo que ves por mensaje

Cada respuesta de Claude en SuperBuilder muestra una pequeña insignia de coste. Haz clic o pasa el ratón por encima y verás el desglose completo:

Message #12
Input tokens:   72,431
Output tokens:   1,847
Cache read:     58,200
Cache write:    14,231
Cost:           $0.18

Esto te dice al instante que el mensaje n.º 12 fue caro porque la ventana de contexto era grande (72K tokens de entrada), pero el caché ayudó a reducir el coste (58K tokens servidos desde caché a una tarifa más baja).

A lo largo de una sesión, desarrollas intuición sobre qué tipos de prompts son caros y cuáles baratos. Empiezas a notar patrones: "Cada vez que le pido que lea ese archivo de configuración grande, el coste se dispara" o "Los mensajes en modo plan son sistemáticamente más baratos que las ediciones directas".

Resumen de coste por sesión

A nivel de hilo, SuperBuilder hace seguimiento del coste acumulado de toda la sesión. Puedes ver de un vistazo:

• El gasto total de este hilo
• El número de mensajes intercambiados
• El coste medio por mensaje
• El mensaje individual más caro
• Las tendencias de uso de tokens a lo largo de la sesión

Esto te da el bucle de feedback que está completamente ausente en la experiencia estándar del CLI de Claude Code.

Configurar el seguimiento de costes en SuperBuilder

Empezar lleva unos dos minutos.

Paso 1: Descarga SuperBuilder

SuperBuilder está disponible para macOS (Apple Silicon e Intel). Descárgalo desde superbuilder.sh/download.

Paso 2: Conecta tu clave de API de Anthropic

En el primer arranque, SuperBuilder te pide tu clave de API de Anthropic. Es la misma clave que usas con Claude Code en el terminal. SuperBuilder no almacena tu clave en ningún servidor: se queda en tu máquina y se pasa directamente al proceso de Claude Code.

Paso 3: Inicia un hilo

Crea un nuevo hilo, selecciona el directorio de tu proyecto y empieza a programar. El seguimiento de costes es automático: no hay nada que configurar. Cada mensaje mostrará su coste en cuanto Claude responda.

Paso 4: Revisa tu gasto

En cualquier momento puedes revisar el desglose de costes de tu sesión actual. La insignia de coste de cada mensaje te da visibilidad instantánea por interacción, y el resumen del hilo muestra el gasto acumulado.

Consejos prácticos para reducir los costes de Claude Code

Ahora que puedes ver lo que cuesta cada mensaje, aquí tienes estrategias concretas para mantener tu gasto a raya.

1. Mantén las ventanas de contexto pequeñas

El mayor factor de coste, con diferencia, es el número de tokens de entrada. Cada archivo que Claude ha leído, cada salida de comando, cada mensaje anterior: todo se acumula en la ventana de contexto y lo pagas en cada turno.

Qué hacer:

• Inicia sesiones nuevas con frecuencia en lugar de mantener conversaciones de 50 turnos
• Sé específico sobre qué archivos mirar ("lee src/auth/login.ts" en lugar de "echa un vistazo al módulo de auth")
• Evita pedirle a Claude que lea archivos grandes que no son relevantes para la tarea actual

2. Usa el modo plan para tareas complejas

SuperBuilder admite modos de ejecución, entre ellos el modo plan, que indica a Claude que esboce su enfoque antes de escribir código. Esto es más barato porque:

• La respuesta de planificación es mayoritariamente texto (pocos tokens de salida en comparación con la generación de código)
• Puedes corregir el rumbo antes de que Claude gaste tokens en el enfoque equivocado
• Evita ciclos caros de "deshacer y rehacer"

Un mensaje de plan suele costar entre un 30 % y un 50 % menos que un mensaje de generación directa de código, y reduce las probabilidades de mensajes de seguimiento desperdiciados.

3. Agrupa cambios relacionados

En lugar de enviar cinco prompts por separado ("añade manejo de errores a la función A", "añade manejo de errores a la función B", etc.), agrúpalos en un único prompt: "Añade manejo de errores a las funciones A, B, C, D y E en src/api/handlers.ts."

Un único prompt bien estructurado con una respuesta detallada es casi siempre más barato que cinco idas y vueltas, porque cada ida y vuelta incluye el contexto completo de la conversación.

4. Usa el modelo adecuado para cada tarea

No toda tarea necesita el modelo más potente. El formateo simple de código, añadir comentarios o escribir boilerplate los puede gestionar Sonnet a una fracción del coste de Opus. Reserva Opus para decisiones arquitectónicas complejas, depuración delicada y tareas que requieran razonamiento profundo.

5. Monitoriza la tasa de aciertos de caché

SuperBuilder te muestra los tokens de lectura de caché por separado. Una proporción alta de lecturas de caché significa que estás obteniendo buen valor: los tokens en caché cuestan bastante menos que los tokens de entrada nuevos. Para maximizar los aciertos de caché:

• Mantén tus sesiones centradas en un conjunto consistente de archivos
• Evita cambiar bruscamente entre partes no relacionadas de la base de código en la misma sesión
• Reutiliza sesiones cuando sigas trabajando en la misma funcionalidad

6. Fíjate un presupuesto mental por sesión

Con el seguimiento de costes por mensaje, puedes establecer un umbral personal. Por ejemplo: "Iniciaré una sesión nueva si esta supera los 2 dólares". Esta sencilla regla evita sesiones desbocadas en las que la ventana de contexto se hincha y cada mensaje se vuelve desproporcionadamente caro.

7. Vigila los bucles caros de llamadas a herramientas

A veces Claude se queda atascado en un bucle: ejecuta un comando, lee el error, prueba un arreglo, vuelve a ejecutar el comando. Cada iteración suma al contexto y cuesta dinero. Si ves que el coste por mensaje sube de forma pronunciada, interrumpe la sesión y da indicaciones más claras o empieza de cero.

Comparación: herramientas para medir los costes de Claude Code

Aquí tienes una comparación directa de los tres enfoques principales para medir los costes de Claude Code.

El diferenciador clave es el momento. El Anthropic Console y ccusage te dicen lo que gastaste. SuperBuilder te dice lo que estás gastando ahora mismo, mensaje a mensaje, para que puedas ajustar tu comportamiento en tiempo real.

Alertas de llamadas grandes

SuperBuilder incluye una alerta configurable para los mensajes caros. Por defecto, cualquier mensaje individual que cueste más de 0,10 USD activa una tarjeta de aviso en el chat. Esto es útil para detectar interacciones inesperadamente caras antes de que se conviertan en una sesión costosa.

Puedes ajustar el umbral en Ajustes según tu presupuesto y tus patrones de uso.

Patrones de coste en el mundo real

Tras hacer seguimiento de costes en miles de interacciones con Claude Code, estos son algunos patrones que emergen:

Costes típicos por mensaje (Claude 3.5 Sonnet)

• Pregunta simple sobre código: 0,01-0,03 dólares
• Leer un archivo y explicarlo: 0,03-0,08 dólares
• Escribir una función nueva: 0,05-0,15 dólares
• Refactorizar un archivo existente: 0,08-0,25 dólares
• Depurar con varias llamadas a herramientas: 0,10-0,50 dólares
• Cambios grandes en varios archivos: más de 0,20-1,00 dólares

Rangos de coste por sesión

• Arreglo rápido de 5 mensajes: 0,10-0,50 dólares
• Funcionalidad moderada de 20 mensajes: 1,00-5,00 dólares
• Sesión extensa de más de 50 mensajes: más de 5,00-25,00 dólares

Estos rangos varían mucho según el tamaño de la base de código, la longitud de los archivos y cuántas llamadas a herramientas haga Claude. Lo importante no son las cifras exactas, sino que, sin seguimiento por mensaje, no tienes ni idea de en qué punto de estos rangos te encuentras hasta que la sesión termina.

Preguntas frecuentes

¿SuperBuilder añade algún coste por encima de Claude Code?

No. SuperBuilder es gratuito y de código abierto. Solo pagas por los tokens de la API de Anthropic que consume Claude Code, exactamente igual que si usaras el CLI directamente. SuperBuilder no añade tokens, no hace de proxy de tus solicitudes ni cobra ninguna tarifa.

¿Cómo de preciso es el seguimiento de costes?

SuperBuilder lee los conteos de tokens directamente del flujo de salida JSON estructurado de Claude Code. Los conteos de tokens son exactos. El coste en USD se calcula usando los precios publicados por Anthropic, que pueden cambiar con el tiempo. SuperBuilder actualiza los precios a medida que Anthropic publica cambios.

¿Puedo exportar mis datos de coste?

Todos los datos de coste se almacenan en una base de datos SQLite local en tu máquina. Puedes consultarla directamente o usar la interfaz de SuperBuilder para revisar los costes por hilo y por mensaje. La funcionalidad de exportación a CSV y JSON está en la hoja de ruta.

¿Esto funciona con las suscripciones Claude Max o Claude Pro?

El seguimiento de costes de Claude Code en SuperBuilder se aplica al uso de la API. Si usas Claude Code a través de una suscripción Max o Pro en lugar de facturación por API, los conteos de tokens por mensaje se siguen registrando y mostrando, aunque el cálculo del coste en USD puede diferir del precio de tu suscripción.

¿Se envían mis datos a algún sitio?

No. SuperBuilder se ejecuta enteramente en tu máquina. Tu clave de API, los datos de las conversaciones y las métricas de coste nunca salen de tu ordenador. No hay telemetría, ni analítica, ni sincronización en la nube.

Primeros pasos

Si usas Claude Code y quieres visibilidad sobre lo que cuesta cada mensaje, SuperBuilder te lo ofrece en una app de escritorio gratuita y de código abierto.

1. Descarga SuperBuilder en superbuilder.sh/download
2. Añade tu clave de API de Anthropic
3. Empieza a programar: el seguimiento de costes es automático

Cada mensaje mostrará su uso de tokens y su coste en USD. Inmediatamente empezarás a tomar decisiones más inteligentes sobre cómo estructuras los prompts, cuándo iniciar sesiones nuevas y qué tareas justifican el gasto.

Deja de adivinar lo que cuesta Claude Code. Empieza a medirlo por mensaje, en tiempo real.

Descarga SuperBuilder gratis