Você lança uma tarefa no Claude Code, pressiona enter, e… espera. O cursor pisca. Algo está acontecendo. Mas o quê, exatamente? Está lendo arquivos? Rodando um agente? Prestes a escrever em disco? Queimando sua context window? Você não faz ideia.
Esse é o problema que Claude HUD resolve.
Um HUD para seu Terminal
Claude HUD é um plugin de Claude Code que adiciona uma barra de status persistente na parte inferior da sua sessão de terminal. Sempre visível. Sempre atualizada. Sem janela separada, sem painel de tmux, sem nenhum dashboard para abrir — vive exatamente onde você já está trabalhando.
O que mostra, em tempo real:
- Uso da context window — uma barra de progresso que indica qual percentual do contexto já foi consumido
- Cota de uso — quanto do seu limite de 5 horas ou semanal você já queimou
- Tools ativos — quais tools Claude está rodando neste momento (Bash, Read, Write, chamadas MCP)
- Agentes em execução — quais subagentes estão ativos na sessão atual
- Progresso de tudo — tarefas que Claude planejou vs. as que já completou
- Custo da sessão — custo real em tokens, tirado diretamente dos dados de custo nativos de Claude Code, com estimativa local como fallback
Usa a API nativa statusLine de Claude Code — o que significa que é uma integração de primeira classe, não um hack. Está construído em TypeScript e o código-fonte é completamente aberto no GitHub.
Por Que Importa Mais do que Parece
A context window é um dos recursos mais importantes de qualquer sessão de Claude Code, e também um dos mais invisíveis. Você pode estar em 80% sem perceber — e esse é o momento em que a qualidade começa a se degradar, os agentes começam a perder contexto, e as tarefas falham de formas sutis.
Com Claude HUD, a barra está sempre lá. Você vê ela enchendo. Você sabe quando rodar /compact antes das coisas ficarem complicadas.
O display de custos é igualmente valioso, embora menos óbvio. Usar Claude Code com Opus em uma sessão longa pode sair caro. Saber seu custo em tempo real muda como você toma decisões: você lança três subagentes em paralelo para isso, ou um passe único e focado é mais inteligente?
Para devs latino-americanos trabalhando com orçamentos de tokens limitados — seja no plano Pro, Max, ou consumo por API — esse número na barra de status é a diferença entre um uso intencional e uma surpresa no final do mês.
Setup em Menos de um Minuto
Claude HUD se instala através do sistema de plugins de Claude Code:
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup
O wizard de setup te guia por três presets (Full, Essential, Minimal), te deixa escolher o idioma dos labels, e te permite afinar cada elemento individualmente. Depois do setup, você reinicia Claude Code e o HUD aparece automaticamente.
A configuração avançada vive em ~/.claude/plugins/claude-hud/config.json — cores, limites, layout, formato de hora, e mais são editáveis diretamente.
Um detalhe que vale a pena saber: no Linux, se /tmp é um filesystem separado (tmpfs), a instalação do plugin pode falhar. A solução é rodar a instalação a partir de uma sessão com TMPDIR apontando para um path persistente. Está documentado no README.
Os Números
- 16.600+ stars no GitHub
- 698 forks
- 326 commits — ativamente mantido
- Listado no registro oficial Composio awesome-claude-plugins
Para um plugin que faz uma única coisa focada — te mostrar o que está acontecendo — esses números de adoção são notáveis. Sugerem que muitos usuários de Claude Code estavam sentindo a mesma dor: trabalhar às cegas, sem saber o que Claude estava fazendo nem quão perto do limite estavam rodando.
Limitações que Vale Conhecer
O display de uso de memória (display.showMemoryUsage) é explicitamente opt-in e reporta RAM do sistema aproximada, não a memória precisa do processo de Claude Code. O README é honesto sobre isso: pode superestimar a pressão porque o cache do SO e os buffers podem ser contados como memória usada.
Além disso, Claude HUD lê a partir do stream stdin de Claude Code e do transcript de sessão. Não tem acesso a informação que Claude Code em si não exponha — então se uma chamada de tool não aparecer no event stream, o HUD também não vai ver.
O Panorama Geral
Claude HUD é parte de uma mudança mais ampla em como devs constroem em torno de Claude Code. A ferramenta em si é poderosa, mas foi projetada para autonomia — roda, age, commita. O ecossistema de plugins está agora preenchendo a camada de observabilidade que sempre faltou: o que está acontecendo, quanto custou, o que mudou.
Se você está usando Claude Code a sério, está voando muito mais rápido do que antes. Claude HUD é o painel de instrumentos.