claude-quota es un complemento para SwiftBar que muestra en la barra de menús de macOS un medidor por cada cuenta de Claude Code con el consumo de la ventana de cinco horas. La barra se pinta en verde de forma predeterminada y cambia a naranja a partir del 70 % y a rojo desde el 90 %. Cuando se agota la ventana de cinco horas, en lugar del porcentaje aparece una cuenta atrás hasta el siguiente reinicio. Si se alcanza el límite semanal, la barra se vuelve negra y muestra los días que faltan para el reinicio semanal, ya que ese tope es más restrictivo que el de la ventana corta. Al desplegar el menú, el usuario ve el detalle completo por cuenta: ventanas de cinco horas y semanal, ventanas por modelo cuando el plan las reporta, créditos de uso extra y horas exactas de reinicio.
El complemento se actualiza cada cinco minutos siguiendo la convención de SwiftBar, e incluye una opción manual de refresco. La instalación se realiza con un solo comando mediante curl, y la otra alternativa es clonar el repositorio y ejecutar el script install.sh. En ambos casos se instala SwiftBar con Homebrew si aún no está disponible. El token de OAuth de Claude Code se lee del llavero de macOS en modo solo lectura: la herramienta nunca lo modifica ni lo renueva, por lo que no puede cerrar la sesión del usuario. La aplicación consulta el mismo endpoint interno que utiliza la pantalla /usage de Claude Code, por lo que futuros cambios de la herramienta oficial podrían requerir ajustes.
La configuración detecta de forma automática todas las cuentas a partir de los directorios ~/.claude y ~/.claude-* con entrada en el llavero. Para cuentas múltiples se puede fijar el sufijo o renombrar mediante un archivo accounts, y ocultar la barra de una cuenta sin perder su detalle en el menú. La desinstalación se limita a borrar el script de la carpeta de complementos de SwiftBar.