Claude Code Usage Monitor : suivre sa consommation de tokens en temps reel
https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor
📌 Claude Code Usage Monitor est un outil de monitoring en terminal qui affiche ta consommation de tokens Claude Code en direct, calcule la vitesse de depense, et estime quand tu risques d’atteindre la limite avant le prochain reset.
Quand tu bosses en continu avec Claude Code, le probleme n’est pas juste « combien j’ai consomme » mais « est-ce que je vais tomber a zero au milieu d’une session ». Ce moniteur essaye de repondre a cette question: il met a jour l’affichage toutes les quelques secondes, trace une progression, et declenche des avertissements quand la trajectoire devient dangereuse.
Points cles
- 📊 Suivi en temps reel: consommation, progression, barres visuelles
- 🔥 Burn rate: vitesse de depense sur la session
- ⏳ Prediction: estimation du moment ou tu atteindras la limite
- ⚠️ Alertes: avertissements si la limite sera atteinte avant le reset
- 🧭 Plans: prise en charge de plusieurs plafonds (pro, max5, max20) et auto-detection
- 🕰️ Reset/Timezone: horaires de reset et fuseaux configurables
Installation et demarrage rapide
Le projet propose plusieurs voies, avec une recommandation claire: uv. L’idee est d’eviter les soucis de Python systeme (environnements « externally managed ») et de garder une install isolee.
Avec uv (recommande)
1. Installer l’outil
- uv tool install claude-monitor
2. Lancer
- claude-monitor
Avec pip
1. pip install claude-monitor
2. Si la commande n’est pas trouvee, ajouter ~/.local/bin au PATH
3. Lancer claude-monitor
Avec pipx
1. pipx install claude-monitor
2. claude-monitor
Comment ca marche (et ce que ca implique pour la confidentialite)
Le moniteur s’appuie sur les donnees de configuration et de sessions de Claude Code. En cas d’erreur du type « No active session found », la doc indique que Claude Code utilise par defaut ~/.config/claude et qu’on peut surcharger le chemin avec la variable d’environnement CLAUDE_CONFIG_DIR.
Concretement, ca veut dire que l’outil est pense pour lire des artefacts locaux de session et en deduire l’etat courant. Pour la confidentialite, le point important est: tu n’as pas besoin de « pousser » tes prompts dans un service tiers pour obtenir un dashboard, tu observes ce qui se passe deja sur ta machine.
A retenir
Claude Code Usage Monitor se comporte comme un « compteur de budget »: il rend visible la trajectoire, pas seulement le total. Si tu utilises Claude Code de facon intensive, la prediction et les alertes valent souvent plus que le chiffre brut.
