Os logs de tokens do Claude Code superestimam o uso em 2,5x. Veja como contar corretamente

Atualizado November 3, 2026 · publicado originalmente November 3, 2026

O Claude Code grava a mesma mensagem do assistente no log várias vezes enquanto a resposta é transmitida. Somar todas as linhas de uso em outubro nos deu 21,3 bilhões de tokens e $12.438 em valor a preço de lista. Contando cada mensagem uma única vez, deu 8,4 bilhões de tokens e $4.323. A soma bruta superestima em cerca de 2,5x em tokens e 2,9x em dólares.

2,5x

de superestimativa de tokens se você somar todas as linhas

175.884

linhas de uso para 70.592 mensagens únicas

60%

das linhas eram repetições de uma mensagem anterior

14%

dos tokens de saída perdidos ao manter só a primeira linha

Publicado em 3 de novembro de 2026 · Transcrições do Claude Code, de 1º de outubro a 3 de novembro de 2026 (UTC; 1º a 3 de novembro parcial)

Por que uma mensagem aparece várias vezes?

Cada entrada do assistente em uma transcrição do Claude Code (~/.claude/projects/.../*.jsonl) traz um objeto usage com as contagens de tokens de entrada, saída, escrita em cache e leitura de cache. Em nossos logs, o mesmo par de message.id e requestId aparece em várias linhas, e as linhas posteriores trazem contagens de saída maiores que as anteriores. Não rastreamos todas as causas; o padrão é consistente com uma resposta sendo gravada enquanto é transmitida. Seja qual for a causa, somar todas as linhas conta a mesma requisição mais de uma vez. Das 175.884 linhas de uso na janela, apenas 70.592 eram mensagens distintas.

Quão errada é a soma bruta?

As mesmas transcrições de outubro contadas de três formas. Os valores são preços de lista da API conforme a página de preços da Anthropic, com as escritas em cache precificadas pela divisão registrada entre 5 minutos e 1 hora. Isto é valor a preços de lista, não uma fatura.

A soma bruta está 2,5x acima em tokens e 2,9x acima em dólares. Os dólares inflam mais que os tokens, o que significa que as linhas repetidas pesavam mais nos tipos de token mais caros; não detalhamos isso mais a fundo.

Por que manter a primeira linha também está errado

A correção óbvia é manter a primeira linha de cada mensagem. Isso subconta a saída, porque a primeira linha é um retrato parcial. Nós mantemos o maior valor de cada campo entre todas as linhas que compartilham o mesmo id de mensagem e o mesmo id de requisição.

Tokens de saída perdidos ao manter apenas a primeira linha de cada mensagem, por modelo (modelos com mais de 100 mensagens). No total, o método da primeira linha perdeu 14% dos tokens de saída (33,1 milhões contra 38,5 milhões).

A diferença varia por modelo: o Claude Haiku 4.5 perdeu 100% dos seus tokens de saída, enquanto o Claude Fable 5.1 perdeu 0,0%. Em dólares o efeito foi pequeno aqui ($4.297 contra $4.323, cerca de 0,6%) porque a saída foi uma fração pequena do nosso volume de tokens. Uma carga que escreve mais e lê menos sentiria mais.

Mais três formas de os logs de agentes enganarem

Uma coluna de custo zerada. O OpenCode registrou 4.938 mensagens do assistente no mesmo período, 82,4 milhões de tokens de entrada e 279,7 milhões de tokens de leitura de cache, e todas as mensagens mostram custo 0 porque rodaram em rotas de modelos gratuitas. Custo registrado zero não significa uso zero: os tokens e a cota gratuita por trás deles continuam reais.
Contagens que não são da sua janela. Os arquivos de conversa do Antigravity guardam contagens de chamadas ao modelo de toda a vida de cada conversa, não só de outubro. Uma conversa que você tocou em 30 de outubro contribui com o histórico dela de setembro também.
Logs que não param de se mover. Nossa própria sessão estava gravando nos logs enquanto medíamos. Duas execuções com minutos de diferença divergiram em cerca de 0,1% nas contagens de mensagens. Fixe a janela e diga quando você tirou o instantâneo.

Como contamos

Leia as entradas do assistente que têm um objeto usage, entre 1º de outubro e 3 de novembro de 2026 (UTC). Ignore mensagens sintéticas de preenchimento.
Use como chave de cada entrada message.id mais requestId. Se nenhum dos dois existir, use o arquivo e o id da entrada.
Para cada chave, mantenha o máximo de cada campo de uso entre as suas linhas. Inclua as mensagens de subagentes (sidechain), que são registradas nos mesmos arquivos.
Precifique os tokens pelos preços de lista da Anthropic (conferidos em 3 de novembro de 2026): por exemplo, o Opus 5.5 a $4 de entrada, $0,20 de leitura de cache e $20 de saída por milhão de tokens, e o Sonnet 5.5 a $2, $0,10 e $10. As escritas em cache usam a divisão registrada entre 5 minutos e 1 hora. O Haiku 5.5 usa a tarifa mais alta para prompts acima de 100.000 tokens, que estimamos por mensagem a partir dos tokens do lado da entrada.

O que isto não diz

Não é a sua fatura. Em uma assinatura fixa, o valor é um equivalente em API, e os logs não contêm valores em dólares.
Não comparamos com a cobrança do provedor. Faça isso antes de confiar em qualquer total derivado de logs.
O mecanismo por trás das repetições é a nossa leitura do padrão, não uma declaração da Anthropic.

O que fazer com isto

Deduplique antes de somar. Qualquer painel que soma linhas de log provavelmente está superestimando. Pergunte qual é a chave dele.
Use o máximo, não a primeira linha, por mensagem.
Concilie com uma fatura do provedor ou do gateway uma vez por mês. Veja o rastreamento de tokens de LLM e a observabilidade de IA para saber o que um registro precisa ter.
Não confie em um zero. Rastreie os tokens mesmo onde o preço é gratuito.

Para a visão de uso que isto alimenta, veja Claude Code em outubro: tokens, cache e valor a preço de lista e como verificar e reduzir o uso de tokens do Claude Code.

Perguntas frequentes

Como contar corretamente os tokens do Claude Code?

Leia as entradas do assistente nos arquivos de transcrição, use como chave o id da mensagem mais o id da requisição e mantenha o máximo de cada campo de uso entre as linhas que compartilham a chave. Somar todas as linhas contou o nosso uso de outubro 2,5 vezes acima do real.

Por que os logs do Claude Code mostram a mesma mensagem mais de uma vez?

Em nossas transcrições, o mesmo id de mensagem e id de requisição apareceu em várias linhas (175.884 linhas para 70.592 mensagens únicas), com as linhas posteriores trazendo contagens de saída maiores. Esse padrão é consistente com uma resposta sendo registrada enquanto é transmitida; não confirmamos a causa com a Anthropic.

Manter a primeira linha por mensagem é suficiente?

Ela subconta os tokens de saída, porque a primeira linha é um retrato parcial. Perdemos 14% dos tokens de saída no total, e até 100% em um modelo, embora o efeito em dólares tenha sido de apenas cerca de 0,6% na nossa combinação.

O valor a preço de lista é igual ao que paguei?

Não. É o custo dos mesmos tokens pelos preços de API publicados pela Anthropic. Uma assinatura ou um desconto de gateway muda o que você realmente paga, e os logs não contêm valores em dólares.