Como verificar o uso de tokens do Claude Code: 4 maneiras de ver quanto seus agentes gastam

Se você executa o Claude Code por mais de alguns minutos por dia, os tokens são sua verdadeira moeda. Eles decidem quando você atinge um limite de taxa, quão rápido você consome uma assinatura e se uma execução longa do agente valeu a pena. O problema é que o Claude Code não grita o número para você. Você precisa ir e olhar.

Aqui estão quatro maneiras de verificar o uso de tokens do Claude Code, desde o comando embutido mais rápido até um medidor ao vivo que mostra cada agente em tempo real. Escolha a que se encaixa na profundidade que você precisa.

1. A maneira mais rápida: o comando /cost

Dentro de qualquer sessão do Claude Code, digite:

/cost

O Claude Code imprime o custo total e a contagem de tokens para a sessão atual, além de quanto tempo ela está em execução. É a resposta mais rápida para "quanto esta sessão gastou até agora", e não precisa de nada instalado.

O detalhe: /cost é restrito à sessão em que você está. Ele não informa o que você gastou ontem, quanto custou um projeto diferente ou como um agente específico se compara a outro. Para uma verificação rápida única, é perfeito. Para qualquer coisa histórica, continue lendo.

2. Leia a fonte: as transcrições da sessão

O Claude Code grava cada sessão no disco como uma transcrição JSONL. No macOS e Linux, você as encontrará aqui:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

Cada linha é uma mensagem, e as mensagens do assistente carregam um objeto usage com as contagens exatas: input_tokens, output_tokens e os campos de cache (cache_creation_input_tokens, cache_read_input_tokens). As leituras de cache são a parte interessante: elas são muito mais baratas do que a entrada fresca, então uma sessão com uma alta taxa de acerto de cache custa muito menos do que a contagem bruta de tokens sugere.

Esta é a verdade fundamental. Todas as outras ferramentas, incluindo as duas abaixo, leem esses mesmos arquivos. Se você quiser criar seu próprio relatório, jq sobre o JSONL vai te levar lá.

3. Um CLI dedicado: ccusage

Se você preferir não escrever seu próprio analisador, a ferramenta comunitária ccusage lê essas transcrições e as resume em totais diários, mensais e por sessão:

npx ccusage@latest

É um bom meio-termo: mais histórico do que /cost, menos trabalho do que fazer jq manualmente. No entanto, ele permanece no terminal, então responde "o que eu gastei" mas não "qual agente, agora, está gastando".

4. Um medidor ao vivo: uso por sessão no AgentsRoom

Os três métodos acima compartilham um ponto cego: eles são posteriores aos fatos e de fluxo único. No momento em que você executa vários agentes em paralelo, você quer ver o uso por agente, ao vivo, sem digitar um comando em cada terminal.

É isso que o medidor de uso de tokens do Claude Code no AgentsRoom faz. Ele lê as mesmas transcrições JSONL, por sessão, e exibe:

• tokens de entrada, saída e cache por agente, atualizando conforme a sessão avança
• a taxa de acerto de cache, para que você possa ver quando o contexto está sendo reutilizado em vez de reenviado
• um aviso antes que uma sessão se aproxime de um limite de taxa

Como atribui o uso por sessão, ele permanece correto mesmo quando você executa várias contas do Claude Code lado a lado: cada conta mantém seus próprios totais, o que torna a re-faturação por cliente direta.

Qual deles você deve usar

• Precisa apenas do número desta sessão? /cost.
• Quer criar um relatório personalizado? Leia as transcrições JSONL diretamente.
• Quer totais diários e mensais no terminal? ccusage.
• Executando vários agentes e quer assistir ao uso ao vivo, por agente e por conta? Use o medidor no AgentsRoom.

Verificar o uso é o primeiro passo. Se os números te fazem sentir desconfortável, o próximo movimento é reduzi-los: veja como reduzir os custos de tokens do Claude Code para as alavancas que realmente importam, começando pela reutilização de cache.