Open source · MIT · Barra dei menu di macOS

Claude Usage Barometer

Un indicatore compatto, in stile batteria, nella barra dei menu per il tuo utilizzo di Claude. Osserva le finestre da 5 ore e 7 giorni svuotarsi in tempo reale — direttamente dalla barra dei menu di macOS.

Cos'è?

I tuoi limiti di Claude, sempre sott'occhio

Claude Usage Barometer è un plugin gratuito e open source per SwiftBar (o xbar) che vive nella barra dei menu di macOS. Mostra due barre in stile batteria — una per la finestra mobile da 5 ore di Claude e una per quella da 7 giorni — così vedi a colpo d'occhio quanta quota ti resta. È puro Bash senza alcun passaggio di build, legge in locale il tuo token di Claude Code dal Keychain di macOS e non invia mai i tuoi dati da nessuna parte.

Perché è importante

I limiti d'uso sono invisibili finché non li raggiungi

Claude applica finestre d'uso mobili, ma nulla sul tuo desktop ti dice quanto sei vicino — finché il lavoro non si ferma a metà.

Nessun indicatore nativo

Non esiste un indicatore integrato per le finestre da 5 ore e 7 giorni, così un limite può arrivare senza preavviso nel mezzo di una sessione.

Il costo del cambio di contesto

Controllare l'utilizzo significa abbandonare il lavoro e frugare in una dashboard — un attrito che paghi ogni volta che ti chiedi quanto ne resta.

Interruzioni a sorpresa

Raggiungere un limite all'improvviso spezza il flusso e blocca ciò che stavi consegnando. Un indicatore a colpo d'occhio previene la sorpresa.

Come funziona

Una batteria per la tua quota di Claude

Due barre nella barra dei menu, un menu a discesa dettagliato e un colore che racconta tutto senza un solo clic.

Barre in stile batteria

Il segmento pieno mostra ciò che resta, quello vuoto ciò che è stato usato. Ogni barra si svuota man mano che consumi la quota da 5 ore e da 7 giorni.

Codice colore

Verde fino al 69% usato, ambra dal 70%, rosso dal 90% — la barra nella barra dei menu segue la finestra più vincolante.

Menu a discesa dettagliato

Clicca per vedere la percentuale rimasta di ciascuna finestra e il conto alla rovescia esatto fino al reset, oltre all'ora dell'ultimo aggiornamento.

Legge in locale

Legge il token OAuth di Claude Code dal Keychain su questo Mac. Niente account, niente server, nulla lascia la tua macchina.

Funzionalità

Indicatore piccolo, dettagli curati

Tutto ciò che vuoi da uno strumento per la barra dei menu, e nulla di superfluo.

Indicatori da 5 ore e 7 giorni

Entrambe le finestre mobili a colpo d'occhio, con percentuale rimasta e conti alla rovescia fino al reset nel menu a discesa.

Stato con codice colore

Dal verde all'ambra al rosso man mano che ti avvicini al limite, così lo stato è evidente senza aprire nulla.

Rispettoso dei limiti di frequenza

Memorizza nella cache l'ultima lettura valida e distanzia le chiamate API di almeno 3 minuti, superando con eleganza brevi errori 429.

Consapevole degli aggiornamenti

Controlla GitHub una volta al giorno e mostra un link "aggiornamento disponibile" nel menu a discesa quando esce una nuova release.

Aggiornamento regolabile

Scegli un intervallo di aggiornamento di 1, 3 o 5 minuti dal menu a discesa per bilanciare freschezza dei dati e chiamate API.

Zero build, puro Bash

Facile da leggere, verificare e modificare. Privato by design e rilasciato con licenza MIT.

Installazione

Una riga nel Terminale

L'installer aggiunge jq e SwiftBar tramite Homebrew, inserisce il plugin e lo avvia. Al primo avvio, scegli "Consenti sempre" alla richiesta del Keychain.

curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/claude-usage-barometer/main/install.sh | bash

Richiede macOS 12+, Homebrew e Claude Code con accesso effettuato su questo Mac.

FAQ

Domande frequenti

Claude Usage Barometer è gratuito?

Sì. È open source con licenza MIT e gratuito da usare. Gli serve soltanto la sessione di Claude Code che hai già sul tuo Mac.

Cosa mi serve per eseguirlo?

macOS 12 o successivo, SwiftBar (o xbar), jq e curl, e Claude Code con accesso effettuato sullo stesso Mac. L'installer a riga singola configura jq e SwiftBar al posto tuo.

Il mio token Claude è al sicuro?

Sì. Il plugin legge il token OAuth di Claude Code in locale dal Keychain di macOS e lo usa soltanto per recuperare il tuo utilizzo. È puro Bash, non invia nulla a terze parti e non ha telemetria.

Cosa significano i colori?

La barra è verde sotto il 70% usato, ambra dal 70% all'89% e rossa dal 90% al 100%. Il colore nella barra dei menu segue la finestra delle due più vicina al proprio limite.

Supporta xbar oltre a SwiftBar?

Sì. Funziona come plugin per SwiftBar o xbar. SwiftBar è consigliato ed è ciò che configura l'installer a riga singola.

Porta i tuoi limiti di Claude nella barra dei menu

Installa in una riga e non farti più sorprendere da un limite d'uso. Gratuito e open source.