Los registros de tokens de Claude Code cuentan 2,5x de más. Así se cuentan bien

Actualizado November 3, 2026 · publicado originalmente November 3, 2026

Claude Code escribe el mismo mensaje del asistente en su registro varias veces mientras la respuesta se transmite en streaming. Sumar todas las líneas de uso de octubre nos dio 21.300 millones de tokens y $12.438 de valor a precio de lista. Contar cada mensaje una sola vez dio 8.400 millones de tokens y $4.323. La suma en bruto cuenta de más: unas 2,5 veces en tokens y 2,9 veces en dólares.

2,5x

de exceso de tokens si sumas todas las líneas

175.884

líneas de uso para 70.592 mensajes únicos

60%

de las líneas eran repeticiones de un mensaje anterior

14%

de los tokens de salida se pierden si solo conservas la primera línea

Publicado el 3 de noviembre de 2026 · transcripciones de Claude Code, del 1 de octubre al 3 de noviembre de 2026 (UTC; del 1 al 3 de noviembre, parcial)

¿Por qué un mensaje aparece varias veces?

Cada entrada del asistente en una transcripción de Claude Code (~/.claude/projects/.../*.jsonl) lleva un objeto usage con los recuentos de tokens de entrada, salida, escritura en caché y lectura de caché. En nuestros registros, el mismo par de message.id y requestId aparece en varias líneas, y las líneas posteriores llevan recuentos de salida mayores que las anteriores. No rastreamos todas las causas; el patrón es coherente con una respuesta que se va escribiendo mientras se transmite. Sea cual sea la causa, sumar todas las líneas cuenta la misma petición más de una vez. De las 175.884 líneas de uso de la ventana, solo 70.592 eran mensajes distintos.

¿Cuánto se equivoca la suma en bruto?

Las mismas transcripciones de octubre contadas de tres maneras. Los valores son precios de lista de la API de la página de precios de Anthropic, con las escrituras en caché valoradas según el desglose registrado de 5 minutos y 1 hora. Es valor a precios de lista, no una factura.

La suma en bruto es 2,5 veces demasiado alta en tokens y 2,9 veces en dólares. Los dólares se inflan más que los tokens, lo que significa que las líneas repetidas pesaban más hacia los tipos de token más caros; no lo desglosamos más.

Por qué conservar la primera línea tampoco es correcto

La solución obvia es conservar la primera línea de cada mensaje. Eso subestima la salida, porque la primera línea es una instantánea parcial. Nosotros conservamos el mayor valor de cada campo entre todas las líneas que comparten el mismo id de mensaje y el mismo id de petición.

Tokens de salida que se pierden al conservar solo la primera línea de cada mensaje, por modelo (modelos con más de 100 mensajes). En total, el método de la primera línea perdió el 14% de los tokens de salida (33,1 millones frente a 38,5 millones).

La brecha varía según el modelo: Claude Haiku 4.5 perdió el 100% de sus tokens de salida, mientras que Claude Fable 5.1 perdió el 0,0%. En dólares el efecto fue pequeño aquí ($4.297 frente a $4.323, un 0,6% aproximadamente) porque la salida fue una parte pequeña de nuestro volumen de tokens. Una carga de trabajo que escriba más y lea menos lo notaría más.

Otras tres formas en que los registros de agentes engañan

Una columna de coste en cero. OpenCode registró 4.938 mensajes del asistente en el mismo periodo, 82,4 millones de tokens de entrada y 279,7 millones de tokens de lectura de caché, y todos los mensajes muestran coste 0 porque se ejecutaron en rutas de modelos gratuitas. Un coste registrado de cero no significa uso cero: los tokens y la cuota gratuita que los respalda siguen siendo reales.
Recuentos que no corresponden a tu ventana. Los archivos de conversación de Antigravity contienen recuentos de llamadas al modelo de toda la vida de cada conversación, no solo de octubre. Una conversación que tocaste el 30 de octubre aporta también su historial de septiembre.
Registros que siguen moviéndose. Nuestra propia sesión estaba escribiendo en los registros mientras medíamos. Dos ejecuciones con minutos de diferencia difirieron en un 0,1% aproximadamente en el número de mensajes. Fija la ventana e indica cuándo tomaste la instantánea.

Cómo contamos

Lee las entradas del asistente que tengan un objeto usage, entre el 1 de octubre y el 3 de noviembre de 2026 (UTC). Omite los mensajes sintéticos de relleno.
Identifica cada entrada por message.id más requestId. Si no existe ninguno, usa el archivo y el id de la entrada.
Para cada clave conserva el máximo de cada campo de uso entre sus líneas. Incluye los mensajes de subagentes (sidechain), que se registran en los mismos archivos.
Valora los tokens con los precios de lista de Anthropic (comprobados el 3 de noviembre de 2026): por ejemplo Opus 5.5 a $4 de entrada, $0,20 de lectura de caché y $20 de salida por millón de tokens, y Sonnet 5.5 a $2, $0,10 y $10. Las escrituras en caché usan el desglose registrado de 5 minutos y 1 hora. Haiku 5.5 usa su tarifa más alta para prompts de más de 100.000 tokens, que estimamos por mensaje a partir de sus tokens del lado de entrada.

Lo que esto no te dice

No es tu factura. En una suscripción de tarifa fija la cifra es un valor equivalente en API, y los registros no contienen importes en dólares.
No lo comparamos con la facturación del proveedor. Hazlo antes de fiarte de cualquier total derivado de registros.
El mecanismo detrás de las repeticiones es nuestra lectura del patrón, no una declaración de Anthropic.

Qué hacer con esto

Deduplica antes de sumar. Cualquier panel que sume líneas de registro probablemente cuenta de más. Pregunta cuál es su clave.
Usa el máximo, no la primera línea, por mensaje.
Concilia con una factura del proveedor o del gateway una vez al mes. Consulta el seguimiento de tokens de LLM y la observabilidad de IA para ver qué necesita un libro de registro.
No te fíes de un cero. Registra los tokens incluso donde el precio sea gratuito.

Para la vista de uso que esto alimenta, consulta Claude Code en octubre: tokens, caché y valor a precio de lista y cómo comprobar y reducir el uso de tokens de Claude Code.

Preguntas frecuentes

¿Cómo cuento correctamente los tokens de Claude Code?

Lee las entradas del asistente en los archivos de transcripción, identifica cada una por id de mensaje más id de petición y conserva el máximo de cada campo de uso entre las líneas que comparten la clave. Sumar todas las líneas contó nuestro uso de octubre 2,5 veces demasiado alto.

¿Por qué los registros de Claude Code muestran el mismo mensaje más de una vez?

En nuestras transcripciones el mismo id de mensaje y id de petición aparecieron en varias líneas (175.884 líneas para 70.592 mensajes únicos), con líneas posteriores que llevaban recuentos de salida mayores. Ese patrón es coherente con una respuesta que se registra mientras se transmite; no confirmamos la causa con Anthropic.

¿Basta con conservar la primera línea por mensaje?

Subestima los tokens de salida, porque la primera línea es una instantánea parcial. Perdimos el 14% de los tokens de salida en total, y hasta el 100% en un modelo, aunque el efecto en dólares fue de solo un 0,6% aproximadamente con nuestra mezcla.

¿El valor a precio de lista equivale a lo que pagué?

No. Es el coste de los mismos tokens a los precios de API publicados por Anthropic. Una suscripción o un descuento de gateway cambian lo que realmente pagas, y los registros no contienen importes en dólares.

Relacionado

¿Quieres aplicar esto a tu plataforma? Comparte las facturas, los registros de la pasarela y los flujos principales; identificaremos los costes y las oportunidades de ahorro. Solicitar auditoría gratuita →

Volver a finopsllm.com