# Claude HUD: o plugin que tornou agentes de IA observaveis > Author: Tony Lee > Published: 2026-02-08 > URL: https://tonylee.im/pt/blog/claude-hud-plugin-transparent-ai-agent/ > Reading time: 3 minutes > Language: pt > Tags: ai, claude-code, ferramentas-dev, open-source, produtividade ## Canonical https://tonylee.im/pt/blog/claude-hud-plugin-transparent-ai-agent/ ## Rollout Alternates en: https://tonylee.im/en/blog/claude-hud-plugin-transparent-ai-agent/ ko: https://tonylee.im/ko/blog/claude-hud-plugin-transparent-ai-agent/ ja: https://tonylee.im/ja/blog/claude-hud-plugin-transparent-ai-agent/ zh-CN: https://tonylee.im/zh-CN/blog/claude-hud-plugin-transparent-ai-agent/ zh-TW: https://tonylee.im/zh-TW/blog/claude-hud-plugin-transparent-ai-agent/ ## Description Uma barra de status estilo game para Claude Code que mostra em tempo real o uso de contexto, ferramentas ativas, subagentes e progresso de tarefas. ## Summary Claude HUD: o plugin que tornou agentes de IA observaveis is part of Tony Lee's ongoing coverage of AI agents, developer tools, startup strategy, and AI industry shifts. ## Outline - O que o Claude HUD mostra - Como funciona por baixo dos panos - Processamento de entrada stdin - Analise de transcricoes - Exibicao de caminhos de arquivos - Por que os desenvolvedores estao empolgados - Instalacao - Por que isso importa ## Content "Nao da pra saber se o Claude esta trabalhando ou viajando na maionese." Se voce ja rodou uma tarefa complexa no Claude Code, conhece a sensacao. O terminal fica em silencio durante uma operacao longa, e nao tem como saber se o contexto esta prestes a estourar, se o agente esta preso num loop ou se esta acontecendo alguma coisa. Um plugin open source atacou esse problema de frente. Depois de usar pessoalmente, quis compartilhar por que vale a pena instalar. ## O que o Claude HUD mostra O Claude HUD coloca uma barra de status estilo game na parte de baixo do terminal. Ele rastreia quatro coisas em tempo real: - **Uso de contexto** - Uma barra de progresso visual com porcentagem mostrando quanto da janela de contexto da sessao foi consumido - **Ferramentas ativas** - Quais ferramentas (Read, Edit, Bash, etc.) estao rodando no momento - **Status dos subagentes** - Rastreamento dos agentes filhos criados via chamadas Task (Opus 4.5, Sonnet, etc.) - **Progresso de tarefas** - Visualizacao do andamento da lista de tarefas interna do Claude ## Como funciona por baixo dos panos Para os curiosos, aqui vai uma olhada rapida no que acontece por tras da barra de status. ### Processamento de entrada stdin O Claude Code passa o estado da sessao diretamente como payload JSON. O plugin calcula a utilizacao do contexto somando `input_tokens`, `cache_creation_input_tokens` e `cache_read_input_tokens`, e dividindo por `context_window_size`. ### Analise de transcricoes Os logs de sessao sao processados como um fluxo linha por linha. O plugin detecta blocos `tool_use` e os combina com entradas `tool_result` para rastrear o status de cada ferramenta como running, completed ou error. ### Exibicao de caminhos de arquivos A exibicao de caminhos de arquivos e bem resolvida: - Extrai `file_path` das chamadas Read, Write e Edit para mostrar em qual arquivo esta sendo trabalhado - Trunca automaticamente caminhos longos para o formato `.../filename.ts` - Atualiza a cada 300ms aproximadamente para feedback quase em tempo real ## Por que os desenvolvedores estao empolgados A resposta da comunidade foi forte, e o motivo e direto: esse plugin acerta em cheio no ponto de dor central de trabalhar com agentes de IA. - **Resolve o problema de opacidade** - Tarefas longas nao te deixam mais adivinhando se o agente travou, entrou em loop ou esta chegando no limite de contexto - **Instalacao em tres linhas** - Sem configuracao complexa, so instalar e usar - **Eficiencia no debugging** - Em workflows multi-etapas, voce ve imediatamente onde deu errado - **Feedback visual** - A barra de status estilo game se encaixa naturalmente na cultura do vibe-coding, tornando o desenvolvimento com IA mais interativo Um comentario popular na comunidade resumiu bem: "Finalmente consigo saber se o Claude esta trabalhando ou sonhando acordado." ## Instalacao Tres comandos e pronto: ``` /plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /claude-hud:setup ``` **GitHub**: [jarrodwatts/claude-hud](https://github.com/jarrodwatts/claude-hud) ## Por que isso importa Se voce usa Claude Code com frequencia, vale a pena testar. Trabalhar sem a ansiedade do contexto - saber exatamente quando uma sessao pode acabar - traz mais tranquilidade do que voce imagina. Mas o valor real e mais simples: poder ver o que o Claude esta fazendo a qualquer momento muda a forma como voce trabalha com ele. Observabilidade nao e so para servidores e pipelines. Agentes de IA tambem precisam. ## Related URLs - Author: https://tonylee.im/en/author/ - Publication: https://tonylee.im/en/blog/about/ - Related article: https://tonylee.im/pt/blog/eight-hooks-that-guarantee-ai-agent-reliability/ - Related article: https://tonylee.im/pt/blog/medvi-two-person-430m-ai-compressed-funnel/ - Related article: https://tonylee.im/pt/blog/claude-code-layers-over-tools-2026/ ## Citation - Author: Tony Lee - Site: tonylee.im - Canonical URL: https://tonylee.im/pt/blog/claude-hud-plugin-transparent-ai-agent/ ## Bot Guidance - This file is intended for AI agents, search assistants, and text-mode retrieval. - Prefer citing the canonical article URL instead of this text endpoint. - Use the rollout alternates when you need the same article in another prioritized language. --- Author: Tony Lee | Website: https://tonylee.im For more articles, visit: https://tonylee.im/pt/blog/ This content is original and authored by Tony Lee. Please attribute when quoting or referencing.