Unofficial extension — not affiliated with Anthropic.
Monitor your Claude Code session and weekly usage directly in the VSCode status bar — with color alerts, model display, and renewal countdown.
Features / Funcionalidades
- Status bar display — shows session % and weekly % at a glance
S:27% W:42% | Opus 4.8 (1M) - Color coding — green → yellow → red as usage grows
- Renewal countdown — shows time remaining before limits reset
- Model display — shows the current Claude model
- Notifications — alerts when crossing warning/critical thresholds
- Bilingual — English and Portuguese (pt-BR), auto-detected from VSCode language
- Minimal token usage — each refresh uses ~6 tokens via Claude Haiku (less than one short message per day)
Como usar / How to use
PT-BR
- Instale a extensão
- Abra qualquer projeto no VSCode
- O monitor aparece automaticamente na status bar inferior
- Passe o mouse sobre ele para ver detalhes (sessão, semana, tempo para renovação)
- Clique para atualizar manualmente
EN
- Install the extension
- Open any project in VSCode
- The monitor appears automatically in the bottom status bar
- Hover over it to see details (session, week, renewal time)
- Click to manually refresh
Status bar colors / Cores
| Color | Meaning |
|---|---|
| Normal | Usage below warning threshold (default: 65%) |
| Yellow ⚠ | Usage above warning threshold |
| Red 🔴 | Usage above critical threshold (default: 85%) |
| ⏱ timer | Limit renewing within N minutes (default: 30 min) |
Settings / Configurações
| Setting | Default | Description |
|---|---|---|
claudeUsageMonitor.refreshIntervalMinutes |
5 |
Auto-refresh interval in minutes (min: 3) |
claudeUsageMonitor.showModel |
true |
Show current model in status bar |
claudeUsageMonitor.warningThreshold |
65 |
% that triggers yellow warning |
claudeUsageMonitor.criticalThreshold |
85 |
% that triggers red critical |
claudeUsageMonitor.renewingSoonMinutes |
30 |
Minutes before renewal to highlight |
claudeUsageMonitor.language |
"" |
Override language: "" (auto), "pt", "en" |
claudeUsageMonitor.claudeDir |
"" |
Custom Claude config directory (default: ~/.claude) |
Requirements / Requisitos
- Claude Code installed and logged in
- VSCode 1.85.0 or newer
The extension reads your authentication token from ~/.claude/.credentials.json (created automatically when you log in to Claude Code).
Privacy / Privacidade
EN
- The extension reads your OAuth token from
~/.claude/.credentials.json— the same file Claude Code uses - To fetch usage data, it makes a minimal request to Anthropic's official
/v1/messagesAPI using Claude Haiku withmax_tokens: 1. The session and weekly utilization percentages are read from the response headers (anthropic-ratelimit-unified-5h-utilization/7d-utilization) — the same values shown by the/usagecommand - Each refresh consumes approximately 6 tokens (Claude Haiku). At the default 5-minute interval, this is ~576 tokens per day — less than one short message
- No data is stored remotely; all state is kept locally in VSCode's
globalState - Your token is never sent anywhere other than Anthropic's official API
PT-BR
- A extensão lê seu token OAuth de
~/.claude/.credentials.json— o mesmo arquivo que o Claude Code usa - Para buscar os dados de uso, ela faz uma requisição mínima à API oficial da Anthropic (
/v1/messages) usando o Claude Haiku commax_tokens: 1. Os percentuais de utilização da sessão e semana são lidos dos headers da resposta (anthropic-ratelimit-unified-5h-utilization/7d-utilization) — os mesmos valores exibidos pelo comando/usage - Cada atualização consome aproximadamente 6 tokens (Claude Haiku). No intervalo padrão de 5 minutos, isso representa ~576 tokens por dia — menos do que uma mensagem curta
- Nenhum dado é armazenado remotamente; todo o estado é mantido localmente no
globalStatedo VSCode - O token nunca é enviado para nenhum lugar além da API oficial da Anthropic
Disclaimer
This is an unofficial, community-made extension. It is not affiliated with, endorsed by, or supported by Anthropic. Claude and Claude Code are trademarks of Anthropic.
License
MIT