Open source · MIT · Pasek menu macOS

Claude Usage Barometer

Kompaktowy wskaźnik w stylu baterii w pasku menu, pokazujący Twoje zużycie Claude. Obserwuj, jak okna 5-godzinne i 7-dniowe wyczerpują się w czasie rzeczywistym — prosto z paska menu macOS.

Czym to jest?

Twoje limity Claude zawsze na widoku

Claude Usage Barometer to bezpłatna, otwartoźródłowa wtyczka do SwiftBar (lub xbar), która działa w pasku menu macOS. Pokazuje dwa paski w stylu baterii — jeden dla przesuwnego okna 5-godzinnego Claude i jeden dla okna 7-dniowego — dzięki czemu jednym spojrzeniem widzisz dokładnie, ile limitu pozostało. To czysty Bash bez kroku budowania, który lokalnie odczytuje Twój token Claude Code z Keychain macOS i nigdy nie wysyła Twoich danych dokądkolwiek.

Dlaczego to ma znaczenie

Limity zużycia są niewidoczne, dopóki ich nie osiągniesz

Claude egzekwuje przesuwne okna zużycia, ale nic na pulpicie nie podpowiada, jak blisko limitu jesteś — aż praca zatrzymuje się w połowie zadania.

Brak natywnego wskaźnika

Nie ma wbudowanego wskaźnika dla okien 5-godzinnego i 7-dniowego, więc limit może nadejść bez ostrzeżenia w środku sesji.

Koszt przełączania kontekstu

Sprawdzenie zużycia oznacza oderwanie się od pracy i przeszukiwanie panelu — tarcie, które płacisz za każdym razem, gdy zastanawiasz się, ile zostało.

Niespodziewane przerwy

Nieoczekiwane osiągnięcie limitu przerywa pracę i wstrzymuje to, co właśnie wdrażasz. Wskaźnik na pierwszy rzut oka eliminuje zaskoczenie.

Jak to działa

Bateria dla Twojego limitu Claude

Dwa paski w pasku menu, szczegółowe rozwijane menu i kolor, który opowiada historię bez jednego kliknięcia.

Paski w stylu baterii

Wypełniony segment pokazuje, ile zostało, a pusty — ile zużyto. Każdy pasek wyczerpuje się w miarę zużywania limitu 5-godzinnego i 7-dniowego.

Oznaczone kolorami

Zielony do 69% zużycia, bursztynowy od 70%, czerwony od 90% — pasek w pasku menu podąża za bardziej ograniczonym oknem.

Szczegółowe rozwijane menu

Kliknij, aby zobaczyć pozostały procent dla każdego okna i dokładny czas do resetu, a także moment ostatniej aktualizacji.

Odczyt lokalny

Odczytuje token OAuth Claude Code z Keychain na tym Macu. Bez kont, bez serwerów, nic nie opuszcza Twojej maszyny.

Funkcje

Mały wskaźnik, przemyślane detale

Wszystko, czego oczekujesz od narzędzia w pasku menu, i nic, czego nie chcesz.

Wskaźniki 5-godzinny i 7-dniowy

Oba przesuwne okna na pierwszy rzut oka, z pozostałym procentem i czasem do resetu w rozwijanym menu.

Status oznaczony kolorami

Od zielonego przez bursztynowy po czerwony w miarę zbliżania się do limitu, dzięki czemu status jest oczywisty bez otwierania czegokolwiek.

Przyjazny limitom zapytań

Buforuje ostatni poprawny odczyt i ogranicza wywołania API do odstępu co najmniej 3 minut, z gracją przetrwając krótkie błędy 429.

Świadomy aktualizacji

Sprawdza GitHub raz dziennie i wyświetla w rozwijanym menu link „dostępna aktualizacja”, gdy pojawi się nowsze wydanie.

Regulowane odświeżanie

Wybierz w rozwijanym menu interwał odświeżania 1, 3 lub 5 minut, aby zrównoważyć aktualność danych z liczbą wywołań API.

Bez budowania, czysty Bash

Łatwy do odczytania, audytu i modyfikacji. Prywatny z założenia i wydany na licencji MIT.

Instalacja

Jedna linia w terminalu

Instalator dodaje jq i SwiftBar przez Homebrew, wgrywa wtyczkę i uruchamia ją. Przy pierwszym uruchomieniu wybierz „Always Allow” dla monitu Keychain.

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

Wymaga macOS 12+, Homebrew oraz zalogowanego Claude Code na tym Macu.

FAQ

Najczęściej zadawane pytania

Czy Claude Usage Barometer jest bezpłatny?

Tak. To oprogramowanie open source na licencji MIT i jest bezpłatne w użyciu. Potrzebuje jedynie sesji Claude Code, którą już masz na swoim Macu.

Czego potrzebuję, aby go uruchomić?

macOS 12 lub nowszego, SwiftBar (lub xbar), jq i curl oraz zalogowanego Claude Code na tym samym Macu. Jednoliniowy instalator skonfiguruje za Ciebie jq i SwiftBar.

Czy mój token Claude jest bezpieczny?

Tak. Wtyczka odczytuje token OAuth Claude Code lokalnie z Keychain macOS i używa go wyłącznie do pobrania Twojego własnego zużycia. To czysty Bash, nie wysyła niczego do stron trzecich i nie ma telemetrii.

Co oznaczają kolory?

Pasek jest zielony przy zużyciu poniżej 70%, bursztynowy od 70% do 89% i czerwony od 90% do 100%. Kolor w pasku menu podąża za tym z dwóch okien, które jest bliżej swojego limitu.

Czy obsługuje xbar oprócz SwiftBar?

Tak. Działa jako wtyczka SwiftBar lub xbar. SwiftBar jest zalecany i to jego konfiguruje jednoliniowy instalator.

Umieść swoje limity Claude w pasku menu

Zainstaluj w jednej linii i nigdy więcej nie daj się zaskoczyć limitowi zużycia. Bezpłatne i otwartoźródłowe.