Claude Code Usage Monitor: O Widget em Rust para Monitorar 7 IAs na Barra do Windows

Veja como monitoro os limites do Claude e do ChatGPT no trabalho e do Google Antigravity em casa direto na barra de tarefas do Windows.

Cassiano Freitas
11 min. leitura
Ilustração conceitual do Claude Code Usage Monitor: utilitário open source em Rust que exibe barras de consumo e tempo de reset de 7 assistentes de IA na barra do Windows.

No computador do trabalho, uso o Claude Code Usage Monitor o dia inteiro na barra de tarefas para acompanhar os limites do Claude e do ChatGPT (via Codex) sem precisar parar o que estou fazendo para checar cota em terminal ou navegador. Em casa, onde rodo meus projetos no Google Antigravity, mantenho o mesmo widget aberto ao lado do relógio do Windows para saber quanto ainda tenho de franquia antes de o limite zerar.

Criado pela empresa australiana CodeZeno (Code Zeno Pty Ltd) e publicado no GitHub sob licença MIT, o utilitário já passa de 710 estrelas, soma 160 forks e está na versão v2.23.6. Além do Claude Code, do Codex e do Google Antigravity, ele acompanha Cursor, GitHub Copilot, Grok Build e OpenCode Go no Windows 10 e Windows 11.

Resposta Rápida (TL;DR)

O Claude Code Usage Monitor é um widget gratuito e de código aberto (licença MIT) para a barra de tarefas do Windows 10 e Windows 11 que mostra ao lado do relógio, em tempo real, o consumo de cota e o tempo exato de reset de 7 assistentes de programação com IA: Claude Code, OpenAI Codex (ChatGPT), Google Antigravity, Cursor, GitHub Copilot, Grok Build e OpenCode Go. Compilado nativamente em Rust (versão v2.23.6) com renderização via Win32, DirectX 11 e GDI, o executável dispensa frameworks pesados como Electron, suporta múltiplas contas simultâneas para Claude Code e Codex e detecta automaticamente sessões locais do Windows e do WSL. O aplicativo lê as credenciais salvas na própria máquina e consulta os endpoints oficiais de cada serviço, sem servidor próprio, sem cadastro extra e sem coletar telemetria.

Como instalar e configurar o Claude Code Usage Monitor no Windows

O instalador oficial está no WinGet, e os binários portáteis ficam no repositório oficial do Claude Code Usage Monitor no GitHub.

1. Instalação via WinGet ou binário portátil

Para instalar pelo PowerShell via WinGet:

winget install CodeZeno.ClaudeCodeUsageMonitor

Quem prefere rodar sem instalador pode baixar o claude-code-usage-monitor.exe em GitHub Releases e abrir pelo terminal:

claude-code-usage-monitor

Se quiser ir direto para a tela de configurações:

claude-code-usage-monitor --dashboard

Com ele rodando na bandeja do sistema, clique com o botão esquerdo no ícone para esconder ou mostrar a barra, e com o direito para abrir o menu rápido.

2. Provedores, direção de uso e Theme Studio

No Dashboard, abra Settings > Providers para deixar ligados só os provedores da sua máquina. É assim que separo o setup do trabalho (Claude Code e Codex) do computador de casa (Google Antigravity). Na aba General, você ajusta o intervalo de atualização em minutos (Update frequency) e tem o botão Refresh now para forçar uma leitura na hora.

Já em Settings > Display, a opção Usage direction alterna a leitura entre Used (sobe de 0%) e Remaining (começa em 100% e vai caindo). Quem usa escala de tela alta no Windows e notar texto cortado pode desativar Use Windows default font em Settings > Appearance, recurso da versão v2.23.0 que troca a renderização para a fonte Segoe UI do sistema.

Para mudar cores, fontes ou camadas, o Theme Studio permite duplicar temas nativos como o Compact Fluent Quad e usar bindings .display, como {claude.session.display:usage_line}. Os temas salvos no Claude Code Usage Monitor ficam em %APPDATA%\ClaudeCodeUsageMonitor\themes, e as preferências gerais em %APPDATA%\ClaudeCodeUsageMonitor\settings.json.

3. Diagnóstico de falhas e segurança local

Se uma sessão expirar, basta passar o mouse sobre o ícone na bandeja para ver o motivo ou rodar o diagnóstico pelo terminal:

claude-code-usage-monitor --diagnose

O log é gravado em %TEMP%\claude-code-usage-monitor.log, arquivo que também registra automaticamente eventuais panics em Rust.

Cuidado ao Compartilhar Logs e Tokens Locais

Antes de anexar %TEMP%\claude-code-usage-monitor.log em uma issue no GitHub, revise o texto e remova identificadores de conta ou dados pessoais. Iniciar uma nova sessão com --diagnose também apaga o log anterior. Se você usa o OpenCode Go via %APPDATA%\opencode-go\config.json, proteja o arquivo como um cookie de sessão, pois o token fica em texto puro.

Como eu uso o Claude Code Usage Monitor no trabalho e em casa

O problema das assinaturas do Claude e do ChatGPT (Codex) é que você não tem uma franquia mensal fixa fácil de prever. A conta mistura uma janela móvel curta de cinco horas com um teto semanal de sete dias, fora eventuais cotas específicas por modelo e uso sob demanda.

No expediente, olho rápido para a barra do Claude Code Usage Monitor antes de disparar uma refatoração grande no Claude Code ou no Codex. Se a janela de cinco horas já passou de 85%, deixo a tarefa maior para depois do reset ou alterno de perfil, porque o widget suporta múltiplas contas simultâneas para esses dois provedores.

Em casa a rotina muda. Como concentro meus projetos pessoais no Google Antigravity, ativo só ele na aba de provedores e acompanho a contagem regressiva direto na mesma barra. O utilitário também reconhece sessões do Claude Code autenticadas dentro do WSL sem exigir configuração extra no Windows. Quando alguma cota aperta no fim do dia, jogo tarefas mais simples para um setup de OpenClaw grátis com Ollama rodando local e enxugo o tamanho dos prompts com Markdown para IA.

Os 7 provedores compatíveis e como o widget lê cada sessão

Você não precisa gerar chaves novas nem criar conta em nenhum painel de terceiros. O Claude Code Usage Monitor aproveita as sessões já autenticadas no seu Windows e consulta direto os endpoints de uso dos próprios editores.

ProvedorOrigem da Credencial LocalMétricas ExibidasMúltiplas Contas
Claude CodeClaude Code CLI, app desktop ou WSLJanela de 5h, 7 dias, cotas extras e sob demandaSim
Codex (OpenAI / ChatGPT)Sessão autenticada no Codex CLIJanela de 5h, janela semanal e sob demandaSim
Google AntigravitySessão ativa do aplicativo AntigravityConsumo da cota ativa e contagem de resetNão
CursorSessão local ou CURSOR_SESSION_TOKENConsumo da sessão ativa do planoNão
GitHub CopilotCOPILOT_GITHUB_TOKEN, GH_TOKEN, Copilot CLI ou GitHub CLIPool mensal premium (copilot_internal/user), chat e completionsNão
Grok Build (xAI)%USERPROFILE%\.grok\auth.json (grok login)Pool semanal na linha longa e uso sob demandaNão
OpenCode GoOPENCODE_GO_WORKSPACE_ID e OPENCODE_GO_AUTH_COOKIE ou config.jsonLimites via API JSON do console OpenCodeNão

No GitHub Copilot e no Grok Build, os limites são mensais ou semanais, sem janela de cinco horas, então a linha de janela curta fica vazia. No Grok Build, uma chave isolada XAI_API_KEY não lê a franquia semanal compartilhada; é preciso entrar antes com grok login. Se você usa o Google Antigravity em máquinas Linux fora de casa ou em outro ambiente, veja também como instalar o Google Antigravity IDE no Linux.

Engenharia em Rust: zero Electron e renderização via DirectX 11

O Claude Code Usage Monitor é compilado direto em Rust 1.95, sem Electron nem navegador Chromium embutido. O Cargo.toml usa flags de tamanho mínimo (opt-level = "z", lto = true, strip = true e codegen-units = 1), e o .cargo/config.toml ativa +crt-static para embutir o C Runtime da Microsoft no próprio claude-code-usage-monitor.exe.

Você baixa um único executável portátil que roda no Windows 10 e Windows 11 sem instalar pacote Visual C++ Redistributable. É o mesmo caminho técnico de binários nativos leves que vimos no ArtCraft open source.

Por dentro, a barra conversa com as APIs do sistema via crate windows (0.62), usando Direct3D 11, DirectComposition, DXGI e HiDPI. O painel de configurações roda em eframe e egui 0.37 com backend egui-directx11 (com fallback para OpenGL e WARP). A partir das versões v2.22.8 e v2.23.6, cliques, rolagem e tooltips passaram a ser tratados no controlador do próprio app para nunca travar o explorer.exe, enquanto as chamadas HTTPS usam ureq 3.5 com os certificados do Windows.

Perguntas frequentes sobre o Claude Code Usage Monitor

O Claude Code Usage Monitor envia minhas chaves de API ou tokens para servidores externos?

Não. O widget não tem servidor próprio, não coleta telemetria e lê credenciais locais sem alterar os arquivos dos provedores. As requisições vão direto do Windows para os endpoints oficiais de cada serviço.

O widget funciona com o Claude Code instalado dentro do WSL no Windows?

Sim. Ele detecta automaticamente credenciais do Claude Code tanto do app desktop e CLI no Windows quanto de sessões autenticadas no ambiente WSL.

Qual a diferença entre os modos Used e Remaining nas configurações?

No modo Used (padrão), a barra parte de 0% e sobe conforme a cota é gasta. No modo Remaining, uma cota nova aparece em 100% e diminui até zero conforme o uso avança.

Como monitorar o GitHub Copilot e o Google Antigravity juntos?

Faça login no aplicativo Google Antigravity e autentique o Copilot via Copilot CLI (/login) ou GitHub CLI (gh auth login). Depois, rode claude-code-usage-monitor --dashboard e ative ambos em Settings > Providers.

Por que a janela curta fica vazia no GitHub Copilot e no Grok Build?

O Copilot usa um pool mensal de requisições premium e o Grok Build tem um pool semanal único, sem janela de 5 horas como Claude Code e Codex. Por isso, ambos ocupam apenas a linha longa.

Compartilhe este artigo
Coordenador de Marketing Digital, pós-graduado em Comunicação Digital e especialista em dados, automação e inteligência artificial. Criador de conteúdo técnico focado em IA local, engenharia de software, marketing de dados e tecnologia aplicada.
Nenhum comentário

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *