CLAUDE MARGE : vos limites Claude, en un coup de souris

⏱️ Temps de lecture estimé : 3 minutes

https://github.com/Ulrichfr/Claude-Marge-Widget

📌 CLAUDE MARGE est un petit widget Electron, pour macOS et Linux, qui affiche vos limites d’usage Claude, comptes Pro et Max, au bord de l’écran. On pose la souris sur le bord droit, il glisse. On s’écarte, il disparaît.

Un abonnement Claude ne tient pas dans un seul compteur. Il y a une fenêtre de session glissante de cinq heures, un budget hebdomadaire tous modèles confondus et un budget hebdomadaire distinct pour chaque modèle lourd. La limite qui coupe en pleine rédaction est rarement celle qu’on surveille. Le widget lit les vrais chiffres depuis le point d’entrée que Claude Code appelle lui-même, api.anthropic.com/api/oauth/usage : pas d’estimation reconstruite à partir du comptage de jetons.

La liste est construite à partir de ce que votre compte expose réellement : deux anneaux sur un plan léger, cinq sur un plan à plus de quotas. Un anneau par quota, et les couleurs suivent la marge restante plutôt que le modèle — vert sous 35 %, jaune jusqu’à 69 %, orange à 89 %, rouge au-delà. Une limite que l’API ne renvoie pas est laissée vide, jamais dessinée en zéro trompeur.

• 🖱️ Un anneau par quota avec badge « limite active » : celle qui vous arrêtera en premier
• 🔎 Une fenêtre « click-through » : elle ne prend jamais le focus et n’avale aucun clic
• 🎨 Quatorze thèmes, dont Liquid Glass, Windows 95 et Mac OS X Aqua aux rayures d’époque
• 🌍 Sept langues choisies selon la langue système, sans rien régler
• 🔔 Alertes à 80 % et 95 % par défaut, réarmées une fois par fenêtre de remise à zéro
• 🖥️ Suit la souris entre les écrans, jamais déclenchée sur la couture de deux moniteurs

La confidentialité est ici un fait vérifiable : une seule requête réseau, vers api.anthropic.com, avec votre propre jeton, lu là où Claude Code le garde (Keychain sur macOS, ~/.claude/.credentials.json ailleurs). Il n’est jamais copié ni mis en cache. Aucune télémétrie.

Je trouve l’approche rassurante. Le widget se met à jour tout seul, mais il refuse d’installer un nouvel état qui casserait sa propre suite de tests : 75 tests tournent avant le redémarrage, et un échec fait revenir à la révision précédente. Un niveau de prudence peu courant pour un utilitaire de cette taille. J’apprécie aussi le cadencement : les requêtes s’espacent quand la machine dort, se font quatre fois moins souvent après cinq minutes d’inactivité et respectent le Retry-After quand l’API refuse. Le chiffre affiché reste en écran, marqué comme périmé, en cas d’échec.

Il reste des limites. Windows n’est pas supporté, Wayland seulement en mode partiel (Electron force X11), et chaque machine signée sur le même compte dispose de son propre budget de communication — deux ordinateurs à deux minutes d’intervalle, c’est déjà 1440 appels par jour. L’installation tient en une commande, la désinstallation aussi, et celle-ci ne touche jamais aux identifiants Claude. Par défaut, Cmd/Ctrl+Shift+M épingle le widget pour le garder visible sans survoler.

CLAUDE MARGE ne gère pas vos budgets, il vous montre celui qui va vous couper. C’est exactement l’outil qui manquait entre Claude Code et l’interface web.