Plugin de linha de status para o Claude Code que mostra, abaixo do campo de entrada, o uso do contexto, os limites de cinco horas e sete dias, as ferramentas ativas e o progresso das tarefas.
O Claude HUD é um plugin para o Claude Code que desenha uma linha de status abaixo do campo de entrada: uso do contexto, limites de taxa, ferramentas ativas, agentes em execução e progresso das tarefas. O uso aparece sempre que o Claude Code envia os limites de assinante, por isso fica oculto em sessões com chave de API, Bedrock e Vertex. A janela de sete dias aparece quando passa de um limite configurável (80% por padrão).
O que ela faz
Onde Claude HUD roda e o que acrescenta, segundo a documentação
Uso da janela de contexto a cada turno
Janela de cinco horas e, acima de display.sevenDayThreshold, a de sete dias
Janelas semanais por modelo, cores conforme o ritmo, contagem regressiva até a redefinição ou hora do relógio
Ferramentas ativas, agentes em execução e progresso das tarefas
Pode ler ou gravar instantâneos de uso em um arquivo JSON local
Quando usar
Boa adequação
Você usa o Claude Code com um plano Pro, Max ou Team e quer ver os limites sem sair do terminal
Não indicado para
Sessões com chave de API, Bedrock ou Vertex, que não enviam limites de assinante
Como instalar o Claude HUD
Você precisa de: Claude Code v2.1.260 ou posterior; Node.js 18+ ou Bun (macOS, Linux); Node.js 18+ no Windows
Instalar com um clique/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
Cole o comando copiado no terminal do Claude Code e confirme a solicitação.
No Claude Code: /plugin marketplace add jarrodwatts/claude-hud
Lê os limites de taxa que o Claude Code repassa aos plugins de linha de status
Revise a fonte antes de conceder ao agente acesso a credenciais ou sistemas de produção. Documentamos o que os mantenedores informam; não auditamos o código.
Limitações
A exibição do uso exige uma sessão de assinatura; nada é mostrado com chaves de API
Ferramenta de programação agêntica da Anthropic que lê sua base de código, edita arquivos e executa comandos pelo terminal, por IDEs, pelo app desktop ou pelo navegador.
Atenção: Não está incluído no plano Claude Free, e o uso nas assinaturas é limitado pelos limites de cada plano.
O uso só aparece quando o Claude Code envia os limites de assinante. Sessões com chave de API, Bedrock e Vertex não os enviam, então a linha de uso fica oculta.
Como instalo o Claude HUD pelo terminal?
claude plugin marketplace add jarrodwatts/claude-hud, depois claude plugin install claude-hud@claude-hud e, dentro de uma sessão, /reload-plugins e /claude-hud:setup.
Quando a janela de sete dias aparece?
Quando o uso passa de display.sevenDayThreshold, 80 por cento por padrão; defina display.showUsage como false para ocultar o uso por completo.