Intermédiaire·2 min·10 juin 2026

Surveille ton quota Claude Code dans la barre macOS

🎧 Résumé audio0:00 / 0:00

Un widget macOS qui affiche en temps réel ton utilisation Claude Code avec un système d'alerte coloré.

Pourquoi ça compte pour toi

Si tu utilises Claude Code régulièrement, tu sais que les limites horaires et hebdomadaires surprennent vite. Ce widget te montre exactement où tu en es sans ouvrir Claude à chaque fois — et te prévient avant de te bloquer. C'est particulièrement utile si tu gères plusieurs comptes.

Ce qu'il faut retenir

1.Barre colorée dans le menu macOS : vert jusqu'à 70%, orange jusqu'à 90%, rouge au-delà
2.Affiche les deux limites : fenêtre 5h ET plafond hebdomadaire (le vrai mur)
3.Actualisation automatique toutes les 5 min, lecture sécurisée du Keychain (jamais de réécriture du token)
4.Gestion multi-comptes avec étiquettes personnalisées, masquable si besoin

Tu galères avec le jargon ?

Lis la version réécrite en mode débutant — toutes les idées, sans le jargon.

Comment ça marche

C'est un plugin SwiftBar (l'outil macOS pour ajouter des éléments dans la barre de menu). L'installation est ultra simple :

curl -fsSL https://raw.githubusercontent.com/grzegorz-raczek-unit8/claude-quota/main/install.sh | bash

Il te demande une permission Keychain une seule fois (« Always Allow »), puis c'est transparent.

Ce que tu vois

La barre affiche ton utilisation 5h en pourcentage :

▸Vert = cool, tu es en dessous de 70%
▸Orange = approche la limite, ≥70%
▸Rouge = vraiment serré, ≥90%
▸Noir avec compte à rebours = plafond hebdomadaire atteint (2D, 3H, etc.)

Quand la fenêtre 5h est saturée, au lieu du pourcentage elle affiche un compte à rebours jusqu'à la remise à zéro.

Le menu déroulant (clique sur la barre) liste tous tes comptes avec les détails complets :

▸Utilisation 5h et hebdomadaire
▸Fenêtres par modèle (si ton plan les rapporte)
▸Crédits de dépassement
▸Heures exactes de remise à zéro

Multi-comptes

Par défaut, le widget détecte automatiquement tous tes répertoires ~/.claude* qui ont un token. Chacun obtient sa barre avec une lettre (W pour work, P pour priv, etc.).

Si tu veux renommer ou réordonner, crée ~/.config/claude-quota/accounts :

~/.claude-work Work
~/.claude-priv Priv

Tu peux aussi masquer une barre du menu tout en gardant ses infos dans le menu déroulant.

Sécurité

Zéro données envoyées ailleurs. Le script lit juste ton token OAuth du Keychain (lecture seule — il ne peut pas le modifier, donc aucun risque de déconnexion) et appelle le même endpoint que Claude Code utilise pour son écran /usage. Pas de scraping, pas de services tiers, pas de mot de passe stocké.

À noter : cet endpoint est interne à Claude Code et non documenté. Anthropic peut le modifier un jour, ce qui demandera un petit correctif au plugin. Ça arrive.

Désinstallation

Supprimer claude-quota.5m.py du dossier ~/.swiftbar. C'est tout.

Et concrètement pour toi ?

Choisis ton profil — la lecture de l'article change selon qui tu es.

🔭 Curieux

Pour toi, ce widget montre concrètement que Claude n'est pas un « service illimité » — il y a des seuils, des coûts, de la gestion. C'est une bonne porte d'entrée pour comprendre pourquoi les entreprises ne remplacent pas tout par de l'IA demain matin.

Essayer maintenant

Installer le widget Claude quota →

Source