HeadRoom Code v1.0.1
Barra de menús macOS para monitorizar Claude Code
QUE HACE
——–
HeadRoom Code vive en tu barra de menús y te muestra en tiempo
real el estado de tu suscripción de Claude Code:
– Modelo activo (Sonnet, Opus, Haiku…)
– Ventana de contexto: tokens usados y porcentaje
– Límite de 5 horas: uso y hora de reinicio
– Límite de 7 días: uso y hora de reinicio
– Nivel de effort de la sesión (low / medium / high)
– Antigüedad del dato (hace cuánto se actualizó)
También incluye un panel flotante con gráfico histórico
de uso de los dos límites de rate.
REQUISITOS
———-
– macOS 15.6 (Sequoia) o posterior
– Claude Code instalado (debe existir la carpeta ~/.claude)
– Suscripción activa a Claude con rate limits (Max, Pro o Team)
– Python 3 (viene preinstalado en macOS, sin extras)
COMO FUNCIONA
————-
Claude Code tiene un hook llamado «statusLine»: un comando
de shell que ejecuta cada vez que actualiza su barra de estado.
HeadRoom Code registra un pequeño shim como ese comando.
El shim guarda el JSON de Claude Code en un fichero local.
La app vigila ese fichero y se actualiza al instante.
PRIVACIDAD Y DATOS
——————
La app se conecta a un servidor privado únicamente para:
– Contar instalaciones (identificador anónimo por dispositivo)
– Enviar logs técnicos de errores internos de la propia app
No se comparte ningún dato personal, ningún código tuyo,
ni ningún contenido de tus conversaciones con Claude.
La app no lee ni transmite nada de tus proyectos.
PREGUNTAS FRECUENTES
——————–
¿Funciona con varias sesiones de Claude Code abiertas?
El shim captura la sesión más reciente. Si tienes varias
ventanas abiertas a la vez, gana la última que se actualice.
¿Qué pasa si settings.json ya tiene un «statusLine»?
El Setup lo detecta y no sobreescribe nada, mostrando un
aviso en pantalla. Tendrás que editar manualmente ese valor
para apuntar al shim de HeadRoom Code.
¿Necesita arrancar al iniciar sesión?
Puedes añadirla en:
Ajustes del Sistema > General > Ítems de inicio
¿Cómo desinstalo?
1. Elimina HeadRoomCode.app de Aplicaciones
2. Borra ~/.claude/headroom-shim.sh
3. Edita ~/.claude/settings.json y elimina la clave «statusLine»
Descargate la app aqui 👇