Claude Usage

Claude UsageVersão 1.0.0

Seus limites do Claude, sempre à vista

Uma linha de status abaixo do prompt e um widget de vidro no desktop mostram os limites de 5 horas e semanal, quando eles redefinem e quanto cada sessão custou.

Windows 10/11 · macOS 13 ou superior · um zip com os dois instaladores

O widget recolhido: uso de 5 horas em 62% em laranja, com aviso de que vai acabar, e uso semanal em 38% em verde.

Duas formas de ficar de olho

Na linha de status

Abaixo do prompt do Claude Code: quanto do contexto já foi usado, o que a sessão consumiu e custou, e os dois limites com o tempo restante até a redefinição. Funciona em qualquer lugar onde o Claude Code roda.

No seu desktop

Um pequeno cartão flutuante mostra os dois limites em verde, laranja ou vermelho, com uma marca de quanto da janela já passou. Se, nesse ritmo, o limite acabar antes da redefinição, ele avisa quando.

  • Folga de sobra
  • Ficando perto
  • Quase no fim

Pequenos detalhes que fazem diferença

Gastos e modelos

Abra a visão de estatísticas para ver tudo: quanto suas sessões custariam a preços de API por dia, semana e mês e como isso se divide entre os modelos.

DiasAs últimas duas semanas, barra por barra.
A visão de estatísticas na aba Dias: gasto diário das últimas duas semanas em barras, com a divisão por modelo abaixo.
SemanasVeja as semanas pesadas e as tranquilas.
A visão de estatísticas na aba Semanas: gasto semanal em barras.
MesesA visão de longo prazo, mês a mês.
A visão de estatísticas na aba Meses: gasto mensal em barras.

Capturas de tela: o widget do Windows, com dados de demonstração. O widget do macOS tem os mesmos recursos. Ele é compilado no seu Mac durante a instalação, por isso não há capturas dele aqui.

Cada sessão, em detalhe

Cada sessão do Claude Code em sua própria linha: título, projeto, horário, tokens e custo, da mais recente para a mais antiga. As mais caras se destacam num relance.

A visão de estatísticas na aba Sessões: lista das sessões recentes com projeto, horário, tokens e custo.

Instale em um minuto

Um zip traz os dois instaladores. Execute o do seu sistema.

Windows 10 e 11Seu sistema

  1. Baixe o zip, descompacte e abra a pasta claude-usage.
  2. Dê um duplo clique em install.cmd ou execute no PowerShell:
    powershell -ExecutionPolicy Bypass -File install.ps1
  3. Reinicie o Claude Code. A linha de status aparece abaixo do prompt e o widget abre com a sua primeira sessão. Os limites aparecem depois da primeira resposta.

macOS 13 e posterioresSeu sistema

  1. Uma única vez: instale as Xcode Command Line Tools. O widget é compilado no seu Mac durante a instalação.
    xcode-select --install
  2. Descompacte o download e execute no Terminal, a partir da pasta claude-usage:
    bash install.sh
  3. Reinicie o Claude Code. A linha de status aparece abaixo do prompt e o widget abre com a sua primeira sessão. Os limites aparecem depois da primeira resposta.

Só o que você precisa

Quer só a linha de status? Instale-a sem o widget. Já instalou? Desative a linha de status no menu do widget ou impeça o widget de iniciar com o Claude Code: a outra parte continua funcionando.

Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -NoWidget
macOS
bash install.sh --no-widget

Para abrir o widget manualmente, procure Claude Usage no menu Iniciar (Windows) ou em Aplicativos (macOS). Se estiver oculto, clique no ícone dele na bandeja ou na barra de menus.

Atualizar ou desinstalar

Atualizar

Uma vez por dia o widget pergunta a este site se existe uma versão mais nova. Se existir, aparece um ponto no botão de atualizar e o menu oferece a atualização. A solicitação leva só a versão e o sistema, e você pode desativá-la no menu.

  1. Baixe o novo zip nesta página.
  2. Execute o instalador de novo. Seu histórico e suas configurações são mantidos.

Desinstalar

Remove o mod, o widget e seus atalhos.

Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall
macOS
bash install.sh --uninstall

Acrescente -KeepHistory (Windows) ou --keep-history (macOS) para manter seu histórico.

Tudo é local

Os limites vêm de um arquivo que a linha de status grava no seu computador, e o histórico de gastos é lido dos logs de sessão do próprio Claude Code. Nada é enviado, e não há conta nem login. A verificação de atualização é a única coisa que o widget envia.

O que você precisa

  • Windows 10 ou 11, ou macOS 13 ou superior
  • Claude Code com suporte a mods (testado na 2.1.296). A API de mods está em acesso antecipado e pode mudar entre versões.
  • Uma assinatura Pro ou Max: os limites vêm da sua conta.
  • Node.js para o histórico de gastos. Sem ele, os limites continuam aparecendo.
  • No macOS, as Xcode Command Line Tools: o widget é compilado no seu Mac durante a instalação.

Como ler os números

  • Os limites são as porcentagens que o Claude informa a cada resposta, então se atualizam quando você usa o Claude Code, em qualquer sessão.
  • O custo é o que os mesmos tokens custariam a preços de API. Uma assinatura não é cobrada assim: o valor mostra quanto você aproveita dela.
  • O histórico é lido dos logs de sessão locais do Claude Code. O widget mantém um registro próprio desde a primeira execução; períodos anteriores são estimados e desenhados mais claros.

Saiba antes de acabar.

Grátis, de código aberto e discreto: fica num canto até você olhar.

Windows 10/11 · macOS 13 ou superior · um zip com os dois instaladores