Largás una tarea en Claude Code, presionás enter, y… esperás. El cursor parpadea. Algo está pasando. Pero ¿qué, exactamente? ¿Está leyendo archivos? ¿Corriendo un agente? ¿A punto de escribir en disco? ¿Quemando tu context window? No tenés ni idea.
Ese es el problema que Claude HUD resuelve.
Un HUD para tu Terminal
Claude HUD es un plugin de Claude Code que agrega una barra de estado persistente en la parte inferior de tu sesión de terminal. Siempre visible. Siempre actualizada. Sin ventana separada, sin panel de tmux, sin ningún dashboard que abrir — vive exactamente donde ya estás trabajando.
Lo que muestra, en tiempo real:
- Uso del context window — una barra de progreso que indica qué porcentaje del contexto ya está consumido
- Cuota de uso — cuánto de tu límite de 5 horas o semanal ya quemaste
- Tools activos — qué tools está corriendo Claude en este momento (Bash, Read, Write, llamadas MCP)
- Agentes en ejecución — qué subagentes están activos en la sesión actual
- Progreso de todos — tareas que Claude planificó vs. las que ya completó
- Costo de sesión — costo real en tokens, tomado directamente de los datos de costo nativos de Claude Code, con estimación local como fallback
Usa la API nativa statusLine de Claude Code — lo que significa que es una integración de primera clase, no un hack. Está construido en TypeScript y el código fuente es completamente abierto en GitHub.
Por Qué Importa Más de lo que Parece
El context window es uno de los recursos más importantes de cualquier sesión de Claude Code, y también uno de los más invisibles. Podés estar al 80% sin darte cuenta — y ese es el momento en que la calidad empieza a degradarse, los agentes empiezan a perder contexto, y las tareas fallan de formas sutiles.
Con Claude HUD, la barra siempre está ahí. La ves llenarse. Sabés cuándo ejecutar /compact antes de que las cosas se compliquen.
El display de costos es igual de valioso, aunque menos obvio. Usar Claude Code con Opus en una sesión larga puede salir caro. Saber tu costo en tiempo real cambia cómo tomás decisiones: ¿lanzás tres subagentes en paralelo para esto, o un pase único y enfocado es más inteligente?
Para devs latinoamericanos trabajando con presupuestos de tokens acotados — ya sea en plan Pro, Max, o consumo por API — ese número en la barra de estado es la diferencia entre un uso intencional y una sorpresa a fin de mes.
Setup en Menos de un Minuto
Claude HUD se instala a través del sistema de plugins de Claude Code:
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup
El wizard de setup te guía por tres presets (Full, Essential, Minimal), te deja elegir el idioma de los labels, y te permite afinar cada elemento individualmente. Después del setup, reiniciás Claude Code y el HUD aparece automáticamente.
La configuración avanzada vive en ~/.claude/plugins/claude-hud/config.json — colores, umbrales, layout, formato de hora, y más son editables directamente.
Un gotcha que vale la pena saber: en Linux, si /tmp es un filesystem separado (tmpfs), la instalación del plugin puede fallar. La solución es correr la instalación desde una sesión con TMPDIR apuntando a un path persistente. Está documentado en el README.
Los Números
- 16.600+ stars en GitHub
- 698 forks
- 326 commits — activamente mantenido
- Listado en el registro oficial Composio awesome-claude-plugins
Para un plugin que hace una sola cosa enfocada — mostrarte qué está pasando — esos números de adopción son notables. Sugieren que muchos usuarios de Claude Code estaban sintiendo el mismo dolor: trabajar a ciegas, sin saber qué estaba haciendo Claude ni qué tan cerca del límite estaban corriendo.
Limitaciones que Vale Conocer
El display de uso de memoria (display.showMemoryUsage) es explícitamente opt-in y reporta RAM del sistema aproximada, no la memoria precisa del proceso de Claude Code. El README es honesto al respecto: puede sobreestimar la presión porque el cache del OS y los buffers pueden contarse como memoria usada.
Además, Claude HUD lee desde el stream stdin de Claude Code y el transcript de sesión. No tiene acceso a información que Claude Code mismo no exponga — así que si una llamada a tool no aparece en el event stream, el HUD tampoco la va a ver.
El Panorama General
Claude HUD es parte de un cambio más amplio en cómo los devs construyen alrededor de Claude Code. La herramienta en sí es poderosa, pero fue diseñada para la autonomía — corre, actúa, commitea. El ecosistema de plugins está llenando ahora la capa de observabilidad que siempre faltó: qué está pasando, qué costó, qué cambió.
Si estás usando Claude Code en serio, estás volando mucho más rápido que antes. Claude HUD es el panel de instrumentos.