Claude Usage Barometer
Un indicador compacto y con estilo de batería en la barra de menús para tu uso de Claude. Observa cómo se vacían tus ventanas de 5-hour y 7-day en tiempo real, directamente desde la barra de menús de macOS.
Tus límites de Claude, siempre a la vista
Claude Usage Barometer es un plugin gratuito y de código abierto para SwiftBar (o xbar) que vive en la barra de menús de macOS. Muestra dos barras con estilo de batería — una para la ventana móvil de 5-hour de Claude y otra para la de 7-day — para que veas de un vistazo exactamente cuánta cuota te queda. Es Bash puro sin paso de compilación, lee tu token de Claude Code de forma local desde el Keychain de macOS y nunca envía tus datos a ningún sitio.
Los límites de uso son invisibles hasta que los alcanzas
Claude aplica ventanas de uso móviles, pero nada en tu escritorio te indica lo cerca que estás, hasta que el trabajo se detiene a mitad de una tarea.
Sin indicador nativo
No existe un medidor integrado para las ventanas de 5-hour y 7-day, así que un límite puede llegar sin aviso en medio de una sesión.
El coste de cambiar de contexto
Consultar el uso significa dejar tu trabajo y rebuscar en un panel de control, una fricción que pagas cada vez que te preguntas cuánto queda.
Interrupciones por sorpresa
Alcanzar un límite de forma inesperada rompe el flujo y detiene lo que estuvieras a punto de entregar. Un indicador visible de un vistazo evita la sorpresa.
Una batería para tu cuota de Claude
Dos barras en la barra de menús, un desplegable detallado y un color que cuenta la historia sin un solo clic.
Un segmento lleno muestra lo que queda y uno vacío lo que se ha usado. Cada barra se vacía a medida que consumes la cuota de 5-hour y 7-day.
Verde hasta el 69% usado, ámbar a partir del 70%, rojo a partir del 90%; la barra de la barra de menús sigue la ventana más restringida.
Haz clic para ver el porcentaje restante de cada ventana y la cuenta atrás exacta hasta el reinicio, además de la hora de la última actualización.
Lee el token OAuth de Claude Code desde tu Keychain en este Mac. Sin cuentas, sin servidores, nada sale de tu máquina.
Indicador pequeño, detalles bien pensados
Todo lo que quieres de una herramienta de barra de menús, y nada de lo que no.
Indicadores de 5-hour y 7-day
Ambas ventanas móviles de un vistazo, con el porcentaje restante y las cuentas atrás hasta el reinicio en el desplegable.
Estado con código de colores
De verde a ámbar y a rojo a medida que te acercas al límite, para que el estado sea evidente sin abrir nada.
Respetuoso con los límites de tasa
Almacena en caché la última lectura válida y limita las llamadas a la API a un intervalo de al menos 3 minutes, superando con elegancia los 429 puntuales.
Consciente de las actualizaciones
Comprueba GitHub una vez al día y muestra un enlace de "actualización disponible" en el desplegable cuando se publica una versión más reciente.
Frecuencia de actualización ajustable
Elige un intervalo de actualización de 1, 3 o 5 minutos desde el desplegable para equilibrar la frescura frente a las llamadas a la API.
Sin compilación, Bash puro
Fácil de leer, auditar y ajustar. Privado por diseño y publicado bajo la licencia MIT.
Una línea en Terminal
El instalador añade jq y SwiftBar a través de Homebrew, coloca el plugin y lo inicia. En la primera ejecución, elige "Permitir siempre" en la solicitud del Keychain.
curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/claude-usage-barometer/main/install.sh | bashRequiere macOS 12+, Homebrew y Claude Code con la sesión iniciada en este Mac.
Preguntas frecuentes
¿Claude Usage Barometer es gratuito?
Sí. Es de código abierto bajo la licencia MIT y de uso gratuito. Solo necesita la sesión de Claude Code que ya tienes en tu Mac.
¿Qué necesito para ejecutarlo?
macOS 12 o posterior, SwiftBar (o xbar), jq y curl, y Claude Code con la sesión iniciada en el mismo Mac. El instalador de una línea configura jq y SwiftBar por ti.
¿Mi token de Claude está seguro?
Sí. El plugin lee el token OAuth de Claude Code de forma local desde tu Keychain de macOS y lo usa únicamente para obtener tu propio uso. Es Bash puro, no envía nada a terceros y no tiene telemetría.
¿Qué significan los colores?
La barra es verde mientras se usa menos del 70%, ámbar del 70% al 89% y rojo del 90% al 100%. El color de la barra de menús sigue a la de las dos ventanas que esté más cerca de su límite.
¿Es compatible con xbar además de con SwiftBar?
Sí. Funciona como plugin de SwiftBar o de xbar. Se recomienda SwiftBar, que es lo que configura el instalador de una línea.
Lleva tus límites de Claude a la barra de menús
Instálalo en una línea y nunca más te sorprenda un límite de uso. Gratuito y de código abierto.