Pitch: claude-usage-tray: uso do Claude Code direto na bandeja do Windows

Uso Claude Code todo dia. O plano tem uma janela de 5 horas de uso e, cada sessão que eu começava, eu digitava um comando ou abria o plugin claude-hud só pra ver o percentual. Toda vez.

Resolvi tirar isso da frente. Criei o claude-usage-tray: um ícone na bandeja do Windows, do lado do relógio e do volume, que mostra o percentual da janela de 5h e atualiza sozinho a cada 5 segundos.

A cor já entrega a resposta antes de eu ler o número. Verde abaixo de 70%. Laranja entre 70% e 89%. Vermelho a partir de 90%. Passo o mouse por cima e vejo o percentual exato e quando reseta.

Como funciona

O plugin claude-hud já grava um snapshot local do uso em JSON. O tray só lê esse arquivo a cada 5 segundos e redesenha o ícone. Sem chamada de API própria, sem credencial nova, sem nada além de ler um arquivo que já existe na sua máquina.

O script roda em PowerShell puro, usando System.Windows.Forms pro NotifyIcon e System.Drawing pra desenhar o círculo colorido com o número dentro. Um instalador copia o script pra pasta de scripts do Claude Code, liga a opção externalUsageWritePath no config do claude-hud e registra o ícone pra abrir sozinho no login.

Limitação que vale citar

O ícone só aparece no monitor principal. É limitação do próprio Windows: nenhum ícone de bandeja duplica num segundo monitor, nem os nativos do sistema.

Também só atualiza enquanto existe uma sessão do Claude Code rodando, porque essa sessão é a única fonte do dado. Depois de 15 minutos sem sessão ativa, o ícone mostra "-".

Instalação

Repo, script e instruções completas aqui: https://github.com/obrenoalvim/claude-usage-tray

powershell -ExecutionPolicy Bypass -File install.ps1

Se preferir, dá pra apontar qualquer agente de código pro repo e pedir pra ele ler o README e o install.ps1 e replicar a instalação na mão. O script é idempotente e comentado com esse uso em mente.