Uso, limite do plano e saldo: três números que todo mundo confunde
Comparar o limite de uso do Claude Code com o uso de tokens e o saldo da conta é comparar três respostas para "quanto eu já usei?", vindas de três lugares sem relação. Os tokens gastos vêm dos transcripts no seu disco. A porcentagem do plano vem do provedor, pela rede, e só se você pedir. O saldo pré-pago vem de uma API da conta e não tem relação com nenhum dos dois. Eles discordam o tempo todo. Cada divergência é informação, não um bug.
Número um: tokens gastos, direto do seu disco
O primeiro número são os tokens gastos. O Claude Code e o Codex gravam um transcript de cada sessão, e os dois registram nele a contagem de tokens de cada turno. Some tudo em uma janela e você sabe o que um agente consumiu nas últimas 5 horas ou nos últimos 7 dias. Sem chave de API, sem conta, sem rede. A contagem de tokens é lida localmente e não é enviada para lugar nenhum.
Esse número diz se o Claude Code ou o Codex é o mais caro quando você roda os dois lado a lado, algo que nenhuma outra medida responde enquanto os dois estão no meio de uma tarefa. É também o único dos três separado por ferramenta de agente, e não somado por conta, embora não por painel: dois painéis do Claude Code compartilham um único total.
Leia com cuidado, porque a maior parte dos tokens de uma sessão longa de agente são leituras de cache: contexto que o agente já enviou e que o cache do provedor devolve a cada turno. Como um total único, isso parece catastrófico.
Separadas as leituras de cache, a entrada nova, a saída e as gravações de cache somadas são uma fatia pequena. Uma ferramenta que mostra um total grande sem separar as leituras de cache mostra um número que vai te assustar à toa.
A versão em dinheiro do número um e por que ela vem com ressalvas
O Token Meter do MXterm Pro calcula o preço de cada modelo a partir de uma tabela e mostra a data em que esses preços foram conferidos pela última vez. Uma tabela de preços sem data vira ficção sem ninguém perceber.
Um modelo sem preço publicado fica sem preço em vez de aparecer como US$ 0,00, porque "US$ 0,00" parece grátis e a verdade é "não sabemos". O total passa a ser rotulado como piso, e não como total, e lista os modelos que ficaram sem preço.
A ressalva maior é o que o valor significa. Em uma assinatura Max ou Pro, o valor em dólar é o que esses tokens teriam custado em tarifas de pagamento por uso. Não é a sua fatura. Nada em um transcript diz qual plano pagou um turno, então uma ferramenta que lê só transcripts não tem como saber o que você realmente pagou.
Número dois: porcentagem do seu plano
Seu disco não responde "quanto ainda tenho?", e essa é a pergunta que todo mundo faz. Nada em um transcript do Claude Code registra em que ponto está a sua assinatura: quando o desenvolvedor do MXterm Pro procurou campos de limite de uso e de cota nos transcripts dele, toda ocorrência era texto dentro de uma mensagem, nunca um campo de dados. A porcentagem do plano precisa vir do provedor.
No macOS, o MXterm Pro busca a porcentagem do Claude no endpoint de uso da própria Anthropic, com o login salvo do Claude Code. Isso significa ler a credencial de outro aplicativo. O MXterm Pro faz isso pela ferramenta security do sistema, então o macOS não pergunta a cada vez. Não está disponível no Windows.
A opção fica desligada até você ativá-la, e ela diz exatamente o que vai fazer antes de você ligar. Se você negar o acesso, o app para de perguntar, em vez de abrir uma janela a cada atualização.
O Codex é a exceção. A CLI dele grava os cabeçalhos de limite de uso do próprio plano nos arquivos de sessão, então essas porcentagens já estão no seu disco e não exigem credencial. O problema é o quão recente é o dado: uma leitura gravada no seu último turno do Codex tem exatamente a idade desse turno.
Uma opção adicionada na 1.0.22 lê o arquivo de login do próprio Codex e pergunta direto à OpenAI as janelas atuais de 5 horas e semanal. Use a porcentagem do plano como o número que orienta a decisão antes de começar algo longo.
Guia relacionadoUso de tokens do Claude Code e do Codex: o que o Token Meter lêNúmero três: o que sobra na conta
O terceiro número pertence a quem você realmente paga, e o formato depende do provedor. Um provedor pré-pago como DeepSeek ou Moonshot dá um saldo pré-pago: dinheiro que só diminui até você recarregar. Um plano de programação como o da Kimi, da MiniMax ou da Z.ai dá a capacidade restante em uma janela que se renova.
Uma chave do OpenRouter mostra a parcela já usada do limite de gasto, se a chave tem limite, e só o que a chave gastou, se não tem. O MXterm Pro não lê o saldo de uma conta do OpenRouter. Cada leitura vem do endpoint de conta do próprio provedor, usando uma chave de API que você cola. Essa fonte é diferente das outras duas, e só ela sabe do dinheiro que você já pagou.
Antes de configurar qualquer uma, leia por completo o que cada provedor expõe e onde ficam essas chaves. Os leitores de conta seguem o formato de resposta publicado por cada fornecedor; nem todos foram conferidos ainda com uma conta real.
Um saldo também resiste a virar medidor, porque não tem denominador. US$ 37,40 de crédito da DeepSeek não são a porcentagem de nada, a menos que você invente o que significa "cheio". O MXterm Pro mostra o saldo como dinheiro e nunca o transforma em porcentagem. Um saldo nunca entra no ranking contra as janelas de cota no chip da barra de título, e o chip mostra o menor saldo em USD só quando não há cota nem uso do Claude Code ou do Codex para mostrar.
Quando cada um realmente importa
Antes de uma execução longa, olhe a porcentagem do plano. Os tokens gastos não dizem se você vai bater na parede em vinte minutos, e um saldo pré-pago saudável não ajuda se o limite é uma janela de assinatura de 5 horas.
Enquanto você roda o Claude Code e o Codex lado a lado, acompanhe os tokens gastos.
Quando algo para de funcionar, a divergência entre os três já é o diagnóstico. Um plano em 100% com saldo de sobra significa que você bateu no limite de uso, não que o dinheiro acabou. Uma porcentagem de plano saudável com o saldo pré-pago zerado significa o oposto. Se os tokens gastos parecem normais e os outros dois também, o problema não é cota.
No fim do mês, nenhum dos três é a sua fatura. O custo derivado do transcript está em tarifas de API, porcentagens de plano não são dinheiro e um saldo é uma foto do momento. A página de cobrança do fornecedor é a autoridade, e a única coisa que deve encerrar uma discussão sobre o que você pagou.
Como ler os três juntos sem se enganar
Ler o limite de uso do Claude Code junto com os tokens gastos pede três regras, e elas valem em qualquer ferramenta em que você leia os números.
Primeiro, confira a idade de tudo que não é calculado ao vivo. Uma leitura de provedor que falhou continua mostrando o último valor bom. Esse é o comportamento certo, mas só se a tela avisar.
Segundo, nunca converta um em outro. Tokens gastos não viram porcentagem de um plano, porque você não sabe o denominador. Uma porcentagem não vira dinheiro. Um saldo não vira turnos restantes. Cada conversão exige um número que ninguém publicou.
Terceiro, trate uma porcentagem como pertencente a uma janela específica, com horário de reinício. "90% usado" não significa nada até você saber se é uma janela de 5 horas que reinicia em vinte minutos ou uma semanal que reinicia no domingo.
No MXterm Pro, cada linha nomeia a janela a que sua barra pertence e quando ela reinicia. Uma janela que já reiniciou mostra um traço, porque um valor desatualizado passaria pelo atual. Veja também a página do Token Meter e a documentação do Token Meter.
SSH com vários painéis, Command Recipes (Cmd+J) e uma Control Room (antes War Room) multiagente: comece grátis.
Já tem o MXterm Pro? Leia o guia de configuração →
Novo no MXterm Pro? Veja os preços →
Perguntas frequentes
Porque medem coisas diferentes. A contagem de tokens dos transcripts locais é o que o agente desta máquina consumiu. O painel do provedor mostra o valor cobrado na sua conta ou quanto de uma janela do plano você usou, em todas as máquinas e ferramentas ligadas àquela conta. Raramente vão coincidir, e nenhum dos dois está errado.
Não. Nada nos transcripts de sessão do Claude Code registra em que ponto está a sua assinatura, então a porcentagem precisa vir do provedor. Uma ferramenta que mostra uma sem chamada de rede e sem credencial está te dando uma estimativa. O Codex é a exceção: a CLI dele grava os cabeçalhos de limite de uso do plano nos arquivos de sessão, mas uma leitura ali é tão recente quanto o seu último turno do Codex.
Não, e ele avisa: "Em tarifas de API, não o que uma assinatura cobrou". Os transcripts não registram qual plano pagou um turno, então o valor é o que esses tokens custariam nas tarifas de API publicadas de cada modelo, com a data em que essas tarifas foram conferidas ao lado. Um modelo sem preço publicado não é contado como US$ 0, e o total é marcado como piso.
Quase certamente por leituras de cache. Em uma sessão longa, o agente reenvia contexto que já enviou, devolvido pelo cache do provedor a cada turno, e isso supera todo o resto. Por isso o detalhamento lista as leituras de cache separadas da entrada nova, da saída e das gravações de cache.
A porcentagem do plano do agente com o qual você vai executar algo longo, porque é nela que você esbarra no limite de verdade. Os tokens gastos servem para comparar o Claude Code com o Codex. Um saldo pré-pago serve para provedores que você paga por requisição, não por mês.
Não para a contagem de tokens: ela vem de transcripts que já estão na sua máquina, sem chave e sem conta. Só é preciso uma chave para os saldos de conta dos provedores, e cada uma é usada apenas contra o próprio provedor. As opções de porcentagem do plano não usam chaves de API. Elas reaproveitam o login que a CLI do agente já tem, e ficam desligadas até você ativá-las.