Uso de tokens do Claude Code e do Codex: o que o Token Meter lê

O que o Token Meter mostra

Quando um agente instalado ou uma chave de conta salva dá a ele algo para mostrar, o Token Meter fica no grupo de botões à direita da barra de título e permanece ali enquanto o app estiver aberto, então você não precisa abrir um painel para encontrá-lo.

A barra traz um único valor: a cota mais restrita entre todas, colorida conforme a proximidade do limite. Se nada do que você configurou publica uma cota, o chip mostra o total de tokens de 5 horas do Claude Code, ou do Codex quando o Claude Code não está instalado. Sem nenhum agente instalado e só com saldos de conta, ele mostra o menor saldo em USD.

Clique nele para ver um resumo. Cada provedor configurado ganha um item de duas linhas: na primeira, o nome e o horário do próximo reinício do limite; na segunda, as barras de 5 horas e semanal onde há um limite conhecido, ou o gasto e os tokens de hoje onde não há. O provedor que você fixa em Configurações → Token Meter aparece primeiro (o Claude Code, a menos que você mude, ou nenhum).

Abra uma linha para ver o detalhe completo daquele agente. Ele lista os tokens usados nas últimas 5 horas e nos últimos 7 dias, abreviados com K, M ou B, além de um sparkline das últimas 24 horas com uma barra por hora. Os blocos de custo mostram o custo estimado de hoje e dos últimos 7 dias a preços de API, com a data da última atualização da tabela de preços.

O detalhamento de 7 dias cobre entrada nova, saída, escritas de cache, leituras de cache e o número de turnos. Os números são atualizados em segundo plano cerca de uma vez por minuto.

Um agente só aparece se estiver instalado, ou seja, se a pasta de transcrições dele existir. Sem agente local e sem chave de conta salva, o medidor não aparece, em vez de mostrar um indicador vazio. Um indicador em zero afirma que você não usou nada, o que não é o mesmo que não saber.

Quais agentes o Token Meter lê do disco

Para a contagem de tokens, o Token Meter tem uma única fonte: a transcrição que cada agente guarda no seu disco. O Claude Code, o Codex, o Gemini CLI e o omp registram nela a contagem de tokens de cada turno. O medidor não chama a API de nenhum provedor nem pede que você entre em uma conta. Não há chave de API para colar nem conta para conectar, e, para a contagem de tokens, nada é enviado para lugar nenhum.

A lista tem quatro nomes porque o medidor lê as pastas de transcrições do Claude Code, do Codex, do Gemini CLI e do omp. Ele não lê o OpenCode. Para ele, não mostra nada em vez de chutar um valor.

A 1.0.22 acrescentou uma segunda fonte, separada, que não são transcrições. Cole uma chave de API em Configurações → Token Meter para qualquer um dos seis provedores de conta e cada um ganha uma linha própria, mostrando o que aquele provedor informa pelo próprio endpoint: um saldo, uma cota do plano ou um gasto. É outra medição, com outras ressalvas. Leia a diferença entre uso e saldo antes de tratar esses números como intercambiáveis.

Por que as leituras de cache têm uma linha própria

A maior parte dos tokens de uma sessão longa de agente são leituras de cache: contexto que o agente já enviou, devolvido do cache do provedor a cada novo turno. Somadas a todo o resto, elas fazem a sessão parecer muito maior do que é.

Com uma linha só para elas, as leituras de cache deixam de atrapalhar, e você vê quanto o resto da sessão realmente somou.

O que ele não mostra

Por padrão, o Token Meter mostra consumo: tokens já usados. Ele não prevê quanto você ainda consegue usar. As transcrições do Claude Code não registram em que ponto está uma assinatura, então uma porcentagem do Claude exige outra fonte. Os arquivos de sessão do Codex trazem as leituras de limite de uso dele, mas só tão recentes quanto o seu último turno no Codex. Duas opções que você ativa agora dão um valor ao vivo para cada um.

Para o Claude, a 1.0.21 acrescentou Limites do plano, que funcionam só no macOS. Ative em Configurações → Token Meter. O app passa a ler o login salvo do Claude Code no seu Keychain do macOS pela ferramenta security do sistema, e por isso o macOS não pergunta a cada vez. Ele busca o uso real do seu plano em api.anthropic.com, no máximo uma vez a cada cinco minutos.

Para o Codex, a 1.0.22 acrescentou Limites do Codex em tempo real. Ele lê o login do ChatGPT do Codex em ~/.codex/auth.json e o envia só para chatgpt.com, para buscar as janelas atuais de 5 horas e semanal.

Ele foi projetado para ler somente esse arquivo. Um token expirado não faz nenhuma requisição e pede que você execute codex. Já um login guardado no keychain do sistema não é lido de forma alguma. As duas opções ficam desligadas até você ligá-las.

O Codex é o que tem um número mesmo com essa opção desligada. A própria CLI dele grava as leituras de limite de uso do plano nos arquivos de sessão, então o medidor as lê das mesmas linhas que já varre. Essa leitura é só tão recente quanto o seu último turno no Codex, e é por isso que a opção ao vivo existe.

Os números de 5 horas e 7 dias são janelas que olham para trás a partir do momento atual. "Usado nas últimas 5 horas" é exatamente o que o número significa. Ele não diz nada sobre o que o seu plano permite.

Para quem é

O Token Meter foi feito para quem executa o Claude Code e o Codex lado a lado, em painéis divididos ou juntos em uma Control Room (antes War Room). Ele mostra qual dos dois está consumindo tokens sem você precisar entrar em uma das CLIs para perguntar. Se você usa um único agente de vez em quando, não vai aprender muito com ele. Veja também a página do Token Meter e a documentação do Token Meter.