Open source · MIT · Barre de menus macOS

Claude Usage Barometer

Une jauge compacte façon batterie, dans la barre de menus, pour votre usage de Claude. Regardez vos fenêtres de 5-hour et 7-day se vider en temps réel — directement depuis la barre de menus macOS.

De quoi s'agit-il ?

Vos limites Claude, toujours sous les yeux

Claude Usage Barometer est un plugin gratuit et open source pour SwiftBar (ou xbar) qui s'installe dans votre barre de menus macOS. Il affiche deux barres façon batterie — une pour la fenêtre glissante de 5-hour de Claude et une pour la fenêtre de 7-day — afin que vous voyiez d'un coup d'œil exactement le quota restant. C'est du Bash pur, sans étape de build ; il lit votre token Claude Code en local depuis le Keychain de macOS et n'envoie jamais vos données où que ce soit.

Pourquoi c'est important

Les limites d'usage sont invisibles jusqu'à ce que vous les atteigniez

Claude applique des fenêtres d'usage glissantes, mais rien sur votre bureau ne vous indique à quel point vous en êtes proche — jusqu'à ce que le travail s'arrête en pleine tâche.

Aucun indicateur natif

Il n'existe aucune jauge intégrée pour les fenêtres de 5-hour et 7-day : une limite peut donc surgir sans prévenir en pleine session.

Le coût du changement de contexte

Vérifier son usage suppose de quitter son travail et de fouiller dans un tableau de bord — une friction que vous payez chaque fois que vous vous demandez ce qu'il vous reste.

Des interruptions inattendues

Atteindre une limite à l'improviste brise votre élan et fige ce que vous étiez en train de livrer. Une jauge lisible d'un coup d'œil évite la mauvaise surprise.

Comment ça marche

Une batterie pour votre quota Claude

Deux barres dans la barre de menus, un menu déroulant détaillé et une couleur qui raconte tout sans le moindre clic.

Barres façon batterie

Un segment plein indique ce qu'il reste et un segment vide ce qui est consommé. Chaque barre se vide à mesure que vous épuisez le quota de 5-hour et de 7-day.

Code couleur

Vert jusqu'à 69 % d'usage, ambre à partir de 70 %, rouge à partir de 90 % — la barre de menus suit la fenêtre la plus contrainte.

Menu déroulant détaillé

Cliquez pour voir le pourcentage restant de chaque fenêtre et le décompte exact avant réinitialisation, ainsi que l'heure de la dernière mise à jour.

Lecture en local

Il lit le token OAuth de Claude Code depuis votre Keychain, sur ce Mac. Aucun compte, aucun serveur, rien ne quitte votre machine.

Fonctionnalités

Petite jauge, attention aux détails

Tout ce que vous attendez d'un outil de barre de menus, et rien de superflu.

Jauges de 5-hour et 7-day

Les deux fenêtres glissantes d'un coup d'œil, avec le pourcentage restant et les décomptes de réinitialisation dans le menu déroulant.

Statut à code couleur

Du vert à l'ambre puis au rouge à l'approche de la limite, pour que le statut soit évident sans rien ouvrir.

Respectueux des limites de débit

Met en cache la dernière lecture valide et espace les appels API d'au moins 3 minutes, en absorbant sans heurt les brèves 429.

Conscient des mises à jour

Interroge GitHub une fois par jour et fait apparaître un lien « mise à jour disponible » dans le menu déroulant dès qu'une nouvelle version sort.

Rafraîchissement ajustable

Choisissez un intervalle de rafraîchissement de 1, 3 ou 5 minutes dans le menu déroulant pour équilibrer fraîcheur des données et appels API.

Sans build, du Bash pur

Facile à lire, à auditer et à ajuster. Privé par conception et publié sous licence MIT.

Installation

Une seule ligne dans le Terminal

L'installateur ajoute jq et SwiftBar via Homebrew, dépose le plugin et le lance. Au premier lancement, choisissez « Toujours autoriser » à l'invite du Keychain.

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

Nécessite macOS 12+, Homebrew et Claude Code connecté sur ce Mac.

FAQ

Questions fréquentes

Claude Usage Barometer est-il gratuit ?

Oui. Il est open source sous licence MIT et gratuit à l'usage. Il n'a besoin que de la session Claude Code dont vous disposez déjà sur votre Mac.

De quoi ai-je besoin pour l'exécuter ?

macOS 12 ou version ultérieure, SwiftBar (ou xbar), jq et curl, ainsi que Claude Code connecté sur le même Mac. L'installateur en une ligne met en place jq et SwiftBar pour vous.

Mon token Claude est-il en sécurité ?

Oui. Le plugin lit le token OAuth de Claude Code en local depuis votre Keychain macOS et l'utilise uniquement pour récupérer votre propre usage. C'est du Bash pur, qui n'envoie rien à des tiers et ne comporte aucune télémétrie.

Que signifient les couleurs ?

La barre est verte tant que l'usage reste sous 70 %, ambre de 70 % à 89 %, et rouge de 90 % à 100 %. La couleur dans la barre de menus suit celle des deux fenêtres la plus proche de sa limite.

Prend-il en charge xbar aussi bien que SwiftBar ?

Oui. Il fonctionne comme plugin SwiftBar ou xbar. SwiftBar est recommandé et c'est ce que met en place l'installateur en une ligne.

Placez vos limites Claude dans la barre de menus

Installez en une ligne, puis ne soyez plus jamais surpris par une limite d'usage. Gratuit et open source.