Open Source · MIT · macOS-Menüleiste

Claude Usage Barometer

Eine kompakte Menüleisten-Anzeige im Batterie-Stil für Ihre Claude-Nutzung. Beobachten Sie, wie sich Ihr 5-Stunden- und 7-Tage-Fenster in Echtzeit leert — direkt aus der macOS-Menüleiste.

Was ist das?

Ihre Claude-Limits, immer im Blick

Claude Usage Barometer ist ein kostenloses, quelloffenes Plugin für SwiftBar (oder xbar), das in Ihrer macOS-Menüleiste lebt. Es zeigt zwei Balken im Batterie-Stil — einen für Claudes rollierendes 5-Stunden-Fenster und einen für das 7-Tage-Fenster — sodass Sie auf einen Blick genau sehen, wie viel Kontingent noch übrig ist. Es ist reines Bash ohne Build-Schritt, liest Ihr Claude Code-Token lokal aus der macOS-Keychain und sendet Ihre Daten niemals irgendwohin.

Warum es zählt

Nutzungslimits sind unsichtbar, bis Sie an sie stoßen

Claude erzwingt rollierende Nutzungsfenster, doch nichts auf Ihrem Desktop verrät Ihnen, wie nahe Sie der Grenze sind — bis die Arbeit mitten in einer Aufgabe stoppt.

Keine native Anzeige

Es gibt keine eingebaute Anzeige für das 5-Stunden- und das 7-Tage-Fenster, sodass ein Limit mitten in einer Session ohne Vorwarnung eintreten kann.

Kosten des Kontextwechsels

Die Nutzung zu prüfen bedeutet, Ihre Arbeit zu verlassen und sich durch ein Dashboard zu graben — Reibung, die Sie jedes Mal bezahlen, wenn Sie sich fragen, wie viel noch übrig ist.

Überraschende Unterbrechungen

Unerwartet an ein Limit zu stoßen, durchbricht den Arbeitsfluss und legt lahm, woran Sie gerade gearbeitet haben. Eine auf einen Blick erfassbare Anzeige verhindert die Überraschung.

So funktioniert es

Eine Batterie für Ihr Claude-Kontingent

Zwei Balken in der Menüleiste, ein detailliertes Dropdown und eine Farbe, die ohne einen einzigen Klick die ganze Geschichte erzählt.

Balken im Batterie-Stil

Ein gefülltes Segment zeigt, was übrig ist, ein leeres Segment, was verbraucht wurde. Jeder Balken leert sich, während Sie Ihr 5-Stunden- und 7-Tage-Kontingent verbrauchen.

Farbcodiert

Grün bis 69 % Verbrauch, Bernstein ab 70 %, Rot ab 90 % — der Balken in der Menüleiste folgt dem stärker eingeschränkten Fenster.

Detailliertes Dropdown

Klicken Sie, um für jedes Fenster den verbleibenden Prozentsatz, den genauen Countdown bis zum Zurücksetzen und den Zeitpunkt der letzten Aktualisierung zu sehen.

Liest lokal

Es liest das Claude Code-OAuth-Token aus Ihrer Keychain auf diesem Mac. Keine Konten, keine Server, nichts verlässt Ihren Rechner.

Funktionen

Kleine Anzeige, durchdachte Details

Alles, was Sie von einem Menüleisten-Tool erwarten, und nichts, was Sie nicht brauchen.

5-Stunden- & 7-Tage-Anzeigen

Beide rollierenden Fenster auf einen Blick, mit verbleibendem Prozentsatz und Countdowns bis zum Zurücksetzen im Dropdown.

Farbcodierter Status

Von Grün über Bernstein zu Rot, je näher Sie dem Limit kommen — so ist der Status offensichtlich, ohne etwas zu öffnen.

Schonend für Rate-Limits

Speichert die letzte gültige Messung im Cache und drosselt API-Aufrufe auf mindestens 3 Minuten Abstand, sodass kurze 429-Fehler problemlos überstanden werden.

Update-bewusst

Prüft GitHub einmal täglich und zeigt im Dropdown einen Link "Update verfügbar" an, sobald eine neuere Version erscheint.

Anpassbare Aktualisierung

Wählen Sie im Dropdown ein Aktualisierungsintervall von 1, 3 oder 5 Minuten, um Aktualität und API-Aufrufe auszubalancieren.

Kein Build, reines Bash

Leicht zu lesen, zu prüfen und anzupassen. Privat von Grund auf und unter der MIT-Lizenz veröffentlicht.

Installation

Eine Zeile im Terminal

Der Installer fügt jq und SwiftBar über Homebrew hinzu, spielt das Plugin ein und startet es. Wählen Sie beim ersten Start beim Keychain-Dialog "Immer erlauben".

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

Erfordert macOS 12+, Homebrew und ein auf diesem Mac angemeldetes Claude Code.

FAQ

Häufig gestellte Fragen

Ist Claude Usage Barometer kostenlos?

Ja. Es ist Open Source unter der MIT-Lizenz und kostenlos nutzbar. Es benötigt lediglich die Claude Code-Session, die Sie bereits auf Ihrem Mac haben.

Was brauche ich, um es auszuführen?

macOS 12 oder neuer, SwiftBar (oder xbar), jq und curl sowie ein auf demselben Mac angemeldetes Claude Code. Der Ein-Zeilen-Installer richtet jq und SwiftBar für Sie ein.

Ist mein Claude-Token sicher?

Ja. Das Plugin liest das Claude Code-OAuth-Token lokal aus Ihrer macOS-Keychain und verwendet es ausschließlich, um Ihre eigene Nutzung abzurufen. Es ist reines Bash, sendet nichts an Dritte und hat keine Telemetrie.

Was bedeuten die Farben?

Der Balken ist grün, solange weniger als 70 % verbraucht sind, bernsteinfarben von 70 % bis 89 % und rot von 90 % bis 100 %. Die Farbe in der Menüleiste richtet sich danach, welches der beiden Fenster näher an seinem Limit ist.

Unterstützt es xbar ebenso wie SwiftBar?

Ja. Es läuft als SwiftBar- oder xbar-Plugin. SwiftBar wird empfohlen und ist das, was der Ein-Zeilen-Installer einrichtet.

Bringen Sie Ihre Claude-Limits in die Menüleiste

In einer Zeile installieren und nie wieder von einem Nutzungslimit überrascht werden. Kostenlos und Open Source.