Claude HUD
shouyuandong/claude-hud
Monitor em tempo real de tokens e contexto do Claude Code na sidebar
Ver no GitHubExtensão de VS Code que exibe em tempo real o uso de tokens, janela de contexto, status de agentes e histórico do Claude Code diretamente na sidebar. Fornece visualização completa de métricas sem necessidade de terminal, com gráficos interativos e configuração modular.
Instalação
npx convez-ai shouyuandong/claude-hud1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Monitorar consumo de tokens durante sessões de coding com Claude
- Acompanhar status de agentes multi-tarefa e progresso em tempo real
- Visualizar histórico de uso de tokens em períodos de 24h ou 7 dias
- Otimizar uso da janela de contexto durante desenvolvimento
Veredito

Ferramenta essencial para desenvolvedores usando Claude Code, oferecendo visibilidade clara sobre recursos consumidos sem sair do editor. Implementação limpa em TypeScript com UI responsiva e tema automático.
README
A tradução para o português deste README ainda está na fila.
Claude HUD
English · 中文
A Heads-Up Display for Claude Code in VS Code sidebar.
Real-time visibility into token usage, context window, agent status, and history — all from the Activity Bar, no terminal needed.
![]()
Features
- Token Flow — Matrix rain / candlestick / tracer-ball visualization of real-time token rate
- Context Window — At-a-glance progress bar showing current vs limit
- Token Usage — IN/OUT token breakdown with proportional bar
- Agent Status — Multi-agent tree with tasks, progress, and token counts
- History Chart — Token usage over 24h or 7d
- Plan Mode Badge — Shows when Claude is in Plan Mode
- Drag & Reorder — Move modules to your preferred order
- Auto Theme — Matches VS Code color theme (light / dark)

Requirements
- Claude Code (VS Code extension)
- VS Code 1.90+
Usage
- Click the Claude HUD icon in the Activity Bar (left sidebar)
- The panel shows real-time metrics while Claude Code is active
- Click the eye icon (◈) to toggle module visibility
- Drag module headers to reorder
Configuration
Toggle individual modules via claudeHud.modules in settings.json:
{
"claudeHud.modules": {
"tokenFlow": true,
"contextWindow": true,
"tokenUsage": true,
"agentStatus": true,
"historyChart": true,
"sessionTime": true
}
}
Development
# Install dependencies
npm install
# Compile TypeScript
npx tsc -p ./
# Launch VS Code extension host (F5)
Project Structure
claude-hud/
├── src/
│ ├── extension.ts # Entry point
│ ├── hudPanel.ts # WebviewViewProvider
│ ├── dataProvider.ts # Data source (JSONL parsing)
│ ├── statusBar.ts # Status bar item
│ ├── historyStore.ts # Token history persistence
│ ├── configManager.ts # Module config management
│ ├── types.ts # Shared types
│ └── webview/
│ ├── script.js # Frontend rendering
│ └── styles.css # Styling
├── media/icon.svg # Extension icon
└── package.json
Acknowledgements
This project references and adapts processing logic from jarrodwatts/claude-hud. Thanks to the original author for the inspiration.
License
MIT