Claude Usage Barometer
Um indicador compacto, ao estilo de bateria, para a sua utilização do Claude, na barra de menus. Veja as suas janelas de 5-hour e 7-day a esgotarem em tempo real — diretamente a partir da barra de menus do macOS.
Os seus limites do Claude, sempre à vista
O Claude Usage Barometer é um plugin gratuito e de código aberto para o SwiftBar (ou xbar) que vive na barra de menus do seu macOS. Mostra duas barras ao estilo de bateria — uma para a janela contínua de 5-hour do Claude e outra para a janela de 7-day — para que veja exatamente quanta quota resta num relance. É Bash puro, sem qualquer passo de compilação, lê o seu token do Claude Code localmente a partir do Keychain do macOS e nunca envia os seus dados para lado nenhum.
Os limites de utilização são invisíveis até os atingir
O Claude impõe janelas de utilização contínuas, mas nada no seu ambiente de trabalho lhe diz o quão próximo está — até que o trabalho pare a meio de uma tarefa.
Sem indicador nativo
Não existe um medidor integrado para as janelas de 5-hour e 7-day, pelo que um limite pode surgir sem aviso a meio de uma sessão.
Custo da mudança de contexto
Verificar a utilização significa sair do seu trabalho e procurar num painel — um atrito que paga sempre que se questiona sobre quanto resta.
Interrupções inesperadas
Atingir um limite inesperadamente quebra o fluxo e trava aquilo que estava a concluir. Um medidor visível num relance evita a surpresa.
Uma bateria para a sua quota do Claude
Duas barras na barra de menus, um menu detalhado e uma cor que conta a história sem um único clique.
Um segmento preenchido mostra o que resta e um segmento vazio o que já foi usado. Cada barra esvazia à medida que consome a quota de 5-hour e de 7-day.
Verde até 69% utilizado, âmbar a partir de 70%, vermelho a partir de 90% — a barra de menus segue a janela mais restrita.
Clique para ver a percentagem restante de cada janela e a contagem decrescente exata até à reposição, além da hora da última atualização.
Lê o token OAuth do Claude Code a partir do seu Keychain neste Mac. Sem contas, sem servidores, nada sai da sua máquina.
Medidor pequeno, detalhes pensados ao pormenor
Tudo o que quer de uma ferramenta de barra de menus, e nada do que não quer.
Medidores de 5-hour e 7-day
Ambas as janelas contínuas num relance, com a percentagem restante e as contagens decrescentes até à reposição no menu.
Estado com código de cores
De verde a âmbar a vermelho à medida que se aproxima do limite, para que o estado seja óbvio sem abrir nada.
Compatível com limites de pedidos
Guarda em cache a última leitura válida e limita as chamadas à API com pelo menos 3 minutes de intervalo, lidando com 429 breves de forma elegante.
Atento a atualizações
Verifica o GitHub uma vez por dia e apresenta uma ligação de "atualização disponível" no menu sempre que sai uma versão mais recente.
Atualização ajustável
Escolha um intervalo de atualização de 1, 3 ou 5 minutos no menu para equilibrar a atualidade com as chamadas à API.
Sem compilação, Bash puro
Fácil de ler, auditar e ajustar. Privado por conceção e disponibilizado sob a licença MIT.
Uma linha no Terminal
O instalador adiciona o jq e o SwiftBar através do Homebrew, coloca o plugin no lugar e inicia-o. No primeiro arranque, escolha "Permitir Sempre" no pedido do Keychain.
curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/claude-usage-barometer/main/install.sh | bashRequer macOS 12+, Homebrew e o Claude Code com sessão iniciada neste Mac.
Perguntas frequentes
O Claude Usage Barometer é gratuito?
Sim. É de código aberto, sob a licença MIT, e de utilização gratuita. Apenas precisa da sessão do Claude Code que já tem no seu Mac.
O que é necessário para o executar?
macOS 12 ou posterior, o SwiftBar (ou xbar), o jq e o curl, e o Claude Code com sessão iniciada no mesmo Mac. O instalador de uma linha configura o jq e o SwiftBar por si.
O meu token do Claude está seguro?
Sim. O plugin lê o token OAuth do Claude Code localmente a partir do Keychain do seu macOS e utiliza-o apenas para obter a sua própria utilização. É Bash puro, não envia nada a terceiros e não tem telemetria.
O que significam as cores?
A barra está verde enquanto a utilização for inferior a 70%, âmbar dos 70% aos 89% e vermelha dos 90% aos 100%. A cor na barra de menus segue a janela que estiver mais próxima do seu limite, das duas.
Suporta o xbar, além do SwiftBar?
Sim. Funciona como plugin do SwiftBar ou do xbar. O SwiftBar é recomendado e é o que o instalador de uma linha configura.
Coloque os seus limites do Claude na barra de menus
Instale numa só linha e nunca mais seja apanhado de surpresa por um limite de utilização. Gratuito e de código aberto.