Tokenômetro

Saiba antes se o seu limite do Claude Code vai acabar.

O Claude Code mostra quanto do limite você já usou. O Tokenômetro mostra para onde você está indo: mede o seu ritmo de uso e avisa, com dia e hora, se nesse ritmo o limite vai acabar antes de renovar. Assim dá tempo de se programar, em vez de descobrir quando ele já acabou.

Para quem é

Para quem usa o Claude Code no VS Code com um plano de assinatura (Pro, Max ou Team), que tem limite de uso de 5 horas e limite semanal. A extensão do Claude Code é instalada junto, se ainda não estiver. Depois de instalada, a previsão aparece também no Claude Code aberto pelo terminal, na mesma máquina.

O que aparece

No VS Code, uma linha acima do campo de mensagem do Claude Code, depois do nome tokenometro plugin. No terminal, o aviso aparece na faixa logo acima do campo de mensagem, só quando um limite vai acabar antes de renovar; dentro dos limites, o estado fica discreto no fim da linha de dicas, abaixo do campo.

Os nomes dos limites e o formato da data são os mesmos do painel de uso do Claude Code. A hora segue a sua configuração de formato (timeFormat) e de fuso (timeZone) do Claude Code: com 12 horas, por exemplo, aparece 11:40 AM.

Quando a previsão passa a dizer que um limite vai acabar, aparece também um aviso na tela, uma vez só:

Atenção: se continuar nesse ritmo, o limite semanal irá esgotar quinta, 19/11, às 15h00. Ele só renova sexta, 20/11, às 00h00.

Digite /limite no Claude Code para ver o detalhe na conversa: quanto já foi usado, o ritmo por hora de uso, quando renova e até quanto o ritmo pode subir ou precisa cair para chegar à renovação.

Exemplos

Como a previsão é calculada

• Percentual oficial: o quanto você já usou de cada limite vem do próprio Claude Code, que recebe esse número a cada resposta.
• Ritmo por hora de uso: a extensão aprende em que horas você costuma trabalhar. No começo, supõe dias úteis das 8h às 18h. Noites e fins de semana em que você não usa não contam, então o horário previsto cai dentro do seu expediente.
• Limite de 5 horas: vale o ritmo dos últimos 45 minutos, que reage quando você acelera ou para.
• Limite semanal: vale a média das horas de uso desde o começo da semana do limite.
• Hora e fuso: seguem as configurações timeFormat e timeZone do Claude Code, as mesmas do painel de uso dele.

Instalação

1. Instale pelo Visual Studio Marketplace ou, no VS Code, pela aba Extensões, buscando Tokenômetro.
2. Na janela que aparece, clique em Instalar. A extensão instala no Claude Code o plugin que faz o cálculo.
3. Abra uma nova sessão do Claude Code. A previsão aparece depois da primeira resposta.

O que é alterado na sua máquina:

• O plugin é copiado para ~/.claude/tokenometro/plugin.
• Essa pasta é adicionada em CLAUDE_CODE_PLUGIN_DIRS, no ~/.claude/settings.json. Antes, é feita uma cópia de segurança em settings.json.tokenometro.bak.
• A previsão é gravada em ~/.claude/tokenometro/previsao.json, e as opções do Tokenômetro em ~/.claude/tokenometro/config.json.

O comando Tokenômetro: Remover plugin do Claude Code desfaz tudo isso.

Comandos

Pela paleta de comandos (Ctrl+Shift+P):

• Tokenômetro: Instalar plugin no Claude Code
• Tokenômetro: Remover plugin do Claude Code
• Tokenômetro: Mostrar previsão de uso

Configuração

• Tokenômetro: Abrir Painel Ao Iniciar (desligada por padrão): abre o painel do Tokenômetro toda vez que uma sessão começa, no lugar da linha junto ao campo de mensagem. No VS Code e no terminal em tela cheia, ele fica numa coluna ao lado da conversa; no terminal comum, acima do campo de mensagem, com uma linha de altura. A mudança vale a partir da próxima sessão.
• Tokenômetro: Barra De Status (desligada por padrão): mostra a previsão também na barra de status do VS Code.

Limitações

• Prevê os limites de 5 horas e semanal. O limite por modelo (como o do Fable) não chega aos plugins do Claude Code, então ainda não é previsto.
• A previsão só se atualiza com o Claude Code em uso, porque o percentual chega junto com as respostas.
• Uso feito fora do Claude Code, como no claude.ai pelo navegador, consome o mesmo limite mas não entra como hora de uso. Se você usa muito por lá, o ritmo calculado sai um pouco mais alto.
• O plugin usa o recurso de plugins do Claude Code, que está em acesso antecipado e pode mudar em versões futuras. Testado com o Claude Code 2.1.322 no VS Code.
• Considera as configurações do Claude Code na pasta padrão (~/.claude). Quem muda essa pasta com a variável CLAUDE_CONFIG_DIR precisa instalar o plugin à mão.

Privacidade

Nada sai da sua máquina. A extensão não tem servidor e não coleta dados: ela usa apenas o que o Claude Code já recebe.

Desenvolvimento

• Testes do plugin: claude plugin test plugin
• Validação do plugin: claude plugin validate plugin
• Pacote da extensão: npx @vscode/vsce package

Sugestões e problemas

Abra uma issue no GitHub. Para problemas, informe a versão do Claude Code e, se puder, o texto que aparece no /limite.

Licença

MIT

Projeto independente, sem vínculo com a Anthropic. Claude e Claude Code são marcas da Anthropic.