Um ponteiro verde, amarelo ou vermelho, os projetos que mais gastam e os robôs que repetem o mesmo trabalho.

O medidor-de-limite é um programa pequeno que lê os registros que o Claude Code e o Codex já gravam no seu computador e mostra para onde foi o limite da sua assinatura. Serve para quem usa muito esses assistentes, principalmente com robôs e tarefas agendadas, e bate o limite da semana sem saber quem gastou. Ele aponta os projetos que mais gastam e as tarefas repetidas que dava para juntar. Precisa só de Python 3: não usa internet nem chave, e não apaga nem pausa nada.
O plano diz que você tem um limite por semana, mas não diz quanto é em tokens nem quem está gastando. O medidor tira isso dos seus próprios registros.
Verde abaixo de 70% do teto, amarelo até 90%, vermelho acima. Sempre com o rótulo escrito, não só a cor.
Top 10 por pasta de projeto, por sessão e por rotina (as tarefas de robô agrupadas pelo primeiro pedido).
Robôs com o mesmo pedido rodando no mesmo dia, a menos de 1 hora um do outro: candidatos a virar uma execução só.
Tudo acontece no seu computador. O conteúdo das conversas nunca aparece: só números e o começo do pedido, com até 80 caracteres e sem e-mail, link ou caminho de pasta.
Quase tudo o que passa pelo modelo é cache lido, que custa pouco. Por isso o ponteiro usa o peso: cada tipo de token conta na proporção do preço público (Claude: novo 1, cache escrito 1,25, cache lido 0,1, saída 5). O relatório mostra os dois números.
O plano não publica o limite em tokens. Quando o limite corta, o Claude Code grava "You've hit your weekly limit" no registro. O comando calibrar acha essa mensagem e soma o que você gastou naquela semana: esse é o seu teto. Uso no site, no app ou em outra máquina não está aqui.
Funciona onde o Claude Code ou o Codex já rodam e gravam os registros (~/.claude/projects e ~/.codex/sessions). Escolha o seu sistema e cole os comandos, um de cada vez.
O Python 3 já vem instalado. Se faltar o git:
sudo apt install -y git python3 python3 --version
O primeiro comando instala as ferramentas da Apple, que trazem git e Python 3.
xcode-select --install python3 --version
No PowerShell como administrador, instale o Ubuntu e reinicie. Depois, no Ubuntu:
wsl --install sudo apt install -y git python3
Se o Claude Code roda no Windows (fora do WSL), aponte para a pasta dele no passo 2 com --claude-dir /mnt/c/Users/SEU_USUARIO/.claude/projects; o Codex do Windows entra com --codex-home /mnt/c/Users/SEU_USUARIO/.codex. O que roda do lado Windows e você não apontar fica fora da conta.
Os comandos são os mesmos no Linux, no Mac e no Ubuntu do WSL.
É uma pasta com um arquivo Python e a página do ponteiro. Não instala nada no sistema.
git clone https://github.com/inematds/medidor-de-limite.git cd medidor-de-limite
Mostra os totais do Claude Code e do Codex, o top 10 de projetos, o top 10 de rotinas e os repetidos. Histórico de 8 GB leva menos de meio minuto, porque ele lê linha a linha e pula o que não é contagem.
python3 medir.py relatorio
Para outra janela, use --dias 14. Se você tem duas contas do Codex, cada uma em uma pasta, ele acha ~/.codex, ~/.codex-2 e a $CODEX_HOME; outra pasta entra com --codex-home.
Procura nos últimos 35 dias a mensagem de limite semanal e soma o que foi gasto naquela semana. Confira o número e grave.
python3 medir.py calibrar python3 medir.py calibrar --salvar
Não achou nenhum corte? Diga quando foi, ou ponha um número à mão. O número é na unidade peso, a mesma que o relatorio mostra por ferramenta: parta do peso de uma semana em que você chegou perto do limite.
python3 medir.py calibrar --estourou-em "2026-10-26 18:00" --salvar python3 medir.py calibrar --ferramenta codex --teto 60000000 --salvar
Gera uma página com o ponteiro animado, as barras por projeto e por rotina, o gráfico dia a dia e a tabela de repetidos. Funciona no celular.
python3 medir.py html --saida medidor.html xdg-open medidor.html
No Mac, troque xdg-open por open. No WSL, use explorer.exe medidor.html.
O medidor só sugere. Ache o timer ou a tarefa agendada que dispara a rotina repetida e decida se junta numa execução só.
systemctl --user list-timers crontab -l
Com --anonimo, as pastas que não estão numa lista de nomes públicos viram privado-1, privado-2… e os pedidos delas somem. A lista é um arquivo de texto com um nome por linha.
python3 medir.py html --anonimo --publicos publicos.txt --saida medidor.html
Medido em 08/11/2026, com --anonimo. Os arquivos completos estão na pasta exemplos/ do repositório; a página está ao vivo aqui.
tokens processados no Claude Code em 7 dias, 96% deles cache lido
do teto semanal usado desde segunda 21h: ponteiro amarelo
do peso dos 7 dias saiu de uma única pasta de projeto
execuções de robô repetidas no mesmo horário, em 91 grupos


Melhor saber antes de confiar no ponteiro.
--teto).