Claude Code Usage Monitor: seus limites de uso na barra de tarefas

Quem usa o Claude Code no dia a dia já conhece a cena: você está no meio de uma tarefa, o raciocínio fluindo, e do nada aparece o aviso de limite de uso. O Claude trabalha com duas janelas de consumo, uma de 5 horas e outra de 7 dias, e é fácil perder a noção do que sobra em cada uma. A interrupção costuma chegar bem na hora errada, justo quando você estava resolvendo alguma coisa complicada.

Esses dias esbarrei num projetinho que resolve exatamente isso: o Claude Code Usage Monitor, do CodeZeno. É um widget pequeno que fica na barra de tarefas do Windows e mostra o consumo das duas janelas em tempo real, sem abrir o terminal ou o site da Anthropic.

O que o Claude Code Usage Monitor acompanha

A ideia é direta: você vê o status das duas janelas de uma olhada só, sem precisar ir a lugar nenhum checar.

• As duas janelas ao mesmo tempo, a de 5 horas e a de 7 dias, com contagem regressiva atualizada.
• Ícone na bandeja do sistema com a porcentagem de uso, então basta bater o olho pra saber como está.
• Widget que mora na barra de tarefas e pode ser arrastado pra qualquer lugar.
• Menu de botão direito pra ajustar a frequência de atualização, trocar o idioma, configurar inicialização com o Windows e checar atualizações.
• Opção de acompanhar o Codex também, se você usa os dois (o Codex tem página própria de analytics, mas o widget consolida tudo num lugar só).

Quando a leitura principal não está disponível, ele usa os cabeçalhos de limite que chegam da API de mensagens do Claude como fallback. Na prática, você raramente fica sem informação.

Por que os limites do Claude Code pegam de surpresa

O Claude Pro e o Max têm janelas de uso rolantes, não um contador simples que zera à meia-noite. A janela de 5 horas conta a partir da primeira mensagem que você manda num período, e a de 7 dias faz o mesmo. O problema é que a única forma oficial de checar é abrir a página de uso da Anthropic, o que significa sair do fluxo de trabalho toda vez. Sem isso, você precisa tentar lembrar quando começou, ou descobrir na marra quando o aviso aparece.

Pra quem usa o Claude Code pra tarefas longas de programação, é especialmente chato. Você começa um refactor grande, ou pede pro Claude analisar um codebase inteiro, e quando falta pouco pro trabalho terminar, tchau. Saber o que sobra antes de começar muda bastante a forma de planejar.

Como instalar o Claude Code Usage Monitor no Windows

1. Abra o terminal (PowerShell ou Prompt de Comando).
2. Execute o comando abaixo:

winget install CodeZeno.ClaudeCodeUsageMonitor

3. Aguarde a instalação terminar e rode o programa.
4. Um ícone vai aparecer na bandeja do sistema, perto do relógio.
5. Clique com o botão esquerdo no ícone pra mostrar ou esconder o widget.
6. Clique com o botão direito pra abrir as configurações.

Se preferir não usar o WinGet, dá pra baixar o executável direto na página de releases do projeto. É só baixar, rodar e pronto.

O único requisito é ter o Claude Code já instalado e autenticado na máquina, seja a versão CLI ou o app de desktop. Se quiser acompanhar o Codex também, precisa do CLI do Codex instalado.

Por que rodar 100% local importa

Duas coisas me convenceram. A primeira é privacidade: ele roda completamente local, sem backend, sem telemetria, nada sai do computador. Lê as credenciais dos CLIs que você já tem instalados, inclusive via WSL, e só isso. Não tem conta pra criar, nada pra configurar em servidor nenhum.

A segunda é que o código é aberto, em Rust, sob licença MIT. Dá pra ler o que está rolando por baixo se você quiser. Pra uma ferramenta que lê credenciais da sua máquina, isso faz diferença.

Vale mencionar: por enquanto é Windows 10 e 11 apenas. Quem está no Mac ou Linux ainda vai ter que esperar ou buscar outra solução.

Vale instalar?

Se você passa o dia trabalhando com o Claude Code, vale. É leve, não atrapalha e tira aquela ansiedade de não saber quanto ainda dá pra usar antes do reset. Pra mim já faz parte do setup, e planejar as tarefas mais pesadas olhando o ponteiro da janela de 5 horas é bem melhor do que descobrir o limite no susto no meio de algo importante.

Link do projeto: CodeZeno/Claude-Code-Usage-Monitor.

Perguntas frequentes

O Claude Code tem limite de uso? Sim. O Claude Pro e o Max têm duas janelas de consumo rolantes: uma de 5 horas e outra de 7 dias. Quando você atinge o limite de qualquer uma delas, precisa esperar a janela resetar antes de continuar. O limite exato depende do plano.

Como ver quanto resta do meu limite no Claude Code? Existe uma página oficial de uso no site da Anthropic, mas você precisa abrir o navegador pra checar. O Claude Code Usage Monitor mostra a mesma informação direto na barra de tarefas, sem sair do que você está fazendo.

O Claude Code avisa quando vai acabar o limite? Só quando já acabou ou está muito perto do fim. Não tem aviso antecipado nativo. É exatamente pra isso que o Usage Monitor é útil.

O Claude Code Usage Monitor é gratuito? Sim, é open source sob licença MIT. Código disponível no GitHub, sem custo nenhum.