Plugin de línea de estado para Claude Code que muestra el uso del contexto, los límites de cinco horas y siete días, las herramientas activas y el progreso de las tareas bajo el campo de entrada.
Claude HUD es un plugin para Claude Code que dibuja una línea de estado bajo el campo de entrada: uso del contexto, límites de uso, herramientas activas, agentes en ejecución y progreso de las tareas. El uso aparece cuando Claude Code envía los límites de suscriptor, por lo que permanece oculto en sesiones con clave de API, Bedrock y Vertex. La ventana de siete días aparece cuando supera un umbral configurable (80 % por defecto).
Qué hace
Dónde se ejecuta Claude HUD y qué añade, según su documentación
Uso de la ventana de contexto en cada turno
Ventana de cinco horas y, por encima de display.sevenDayThreshold, la de siete días
Ventanas semanales por modelo, colores según el ritmo, cuenta atrás hasta el reinicio u hora del reloj
Herramientas activas, agentes en ejecución y progreso de las tareas
Puede leer o escribir instantáneas de uso en un archivo JSON local
Cuándo usarla
Buen encaje
Usa Claude Code con un plan Pro, Max o Team y quiere ver los límites sin salir de la terminal
No apto para
Sesiones con clave de API, Bedrock o Vertex, que no envían límites de suscriptor
Cómo instalar Claude HUD
Necesitas: Claude Code v2.1.260 o posterior; Node.js 18+ o Bun (macOS, Linux); Node.js 18+ en Windows
Instalar en un clic/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
Pega el comando copiado en la terminal de Claude Code y confirma la solicitud.
En Claude Code: /plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins
/claude-hud:setup
Ejemplo de configuración (de la documentación oficial)
Lee los límites de uso que Claude Code pasa a los plugins de línea de estado
Revisa el código fuente antes de dar a un agente acceso a credenciales o sistemas de producción. Documentamos lo que declaran los responsables; no auditamos el código.
Limitaciones
La visualización del uso requiere una sesión de suscripción; no se muestra nada con claves de API
El uso aparece solo cuando Claude Code envía los límites de suscriptor. Las sesiones con clave de API, Bedrock y Vertex no los envían, así que la línea de uso permanece oculta.
¿Cómo instalo Claude HUD desde la terminal?
claude plugin marketplace add jarrodwatts/claude-hud, luego claude plugin install claude-hud@claude-hud y, dentro de una sesión, /reload-plugins y /claude-hud:setup.
¿Cuándo aparece la ventana de siete días?
Cuando el uso supera display.sevenDayThreshold, 80 por ciento por defecto; configure display.showUsage como false para ocultar el uso por completo.