Claude Usage Monitor (Unofficial)

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

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

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/messages API using Claude Haiku with max_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 /usage command
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 com max_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 globalState do 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

Claude Status Bar Monitor

Luan Ortega Dev