Moniteur en temps réel de l'utilisation des tokens pour Claude AI

Optimisez votre utilisation de Claude AI grâce à un suivi en temps réel

Pour les développeurs et les utilisateurs intensifs de Claude AI, la gestion de la consommation de jetons peut représenter un défi majeur. Atteindre inopinément les limites de débit peut perturber les flux de travail et impacter la productivité. Nous vous présentons le Claude-Code-Usage-Monitor, un projet Python robuste et open source conçu pour vous offrir un contrôle et une visibilité inégalés sur votre consommation de jetons Claude AI.

Qu'est-ce que Claude-Code-Usage-Monitor ?

Développé par Maciek-roboblog, cet outil intuitif basé sur le terminal affiche en temps réel votre consommation de jetons Claude AI. Plus qu'un simple compteur, il offre des analyses prédictives, des barres de progression visuelles et des systèmes d'avertissement intelligents pour vous alerter avant que vous ne manquiez de jetons. Que vous soyez sur un plan Pro, Max5, Max20, ou que vous ayez des limites personnalisées variables, ce moniteur s'adapte à vos besoins.

Fonctionnalités clés qui optimisent votre flux de travail :

• Suivi en temps réel : Mises à jour toutes les 3 secondes avec un rafraîchissement fluide et sans scintillement, affichant la consommation de jetons en direct sur plusieurs sessions.
• Barres de progression visuelles : Les barres de progression de jetons et de temps, codées par couleur, offrent une compréhension immédiate et d'un seul coup d'œil de votre utilisation et du temps de session restant.
• Prédictions intelligentes : Basé sur votre taux de consommation actuel, le moniteur prédit avec précision quand vos jetons seront épuisés, vous aidant ainsi à planifier à l'avance.
• Système de détection automatique : Passe intelligemment en mode custom_max si votre utilisation dépasse les limites des plans standard, analysant les sessions précédentes pour découvrir vos limites réelles de jetons.
• Prise en charge de plusieurs plans : Fonctionne parfaitement avec Claude Pro, Max5, Max20, et détecte automatiquement les limites personnalisées en fonction de votre utilisation passée.
• Système d'avertissement avancé : Recevez des alertes lorsque vos jetons sont proches de l'épuisement ou s'ils sont susceptibles de s'épuiser avant la réinitialisation de votre session.
• Interface utilisateur professionnelle : Profitez d'une interface de terminal claire, colorée et très lisible, conçue pour l'efficacité.
• Planification personnalisable : Définissez vos propres heures de réinitialisation de session et fuseaux horaires pour les aligner sur votre flux de travail personnel ou d'équipe.

Comment ça marche : Comprendre les sessions Claude

Claude AI fonctionne sur une fenêtre de session glissante de 5 heures. Cela signifie que chaque interaction démarre un nouveau compte à rebours de 5 heures pour la consommation de jetons. Vous pouvez avoir plusieurs sessions qui se chevauchent, et votre réinitialisation de jetons se produit exactement 5 heures après votre premier message dans chaque session. Le Claude-Code-Usage-Monitor suit cette dynamique complexe, calculant votre « taux de consommation » en analysant l'utilisation des jetons de toutes les sessions actives au cours de la dernière heure pour fournir des prédictions précises.

Installation et démarrage :

La configuration du Claude-Code-Usage-Monitor est simple. Le projet met l'accent sur l'utilisation d'un environnement virtuel pour l'isolation et la portabilité, évitant les conflits de dépendances avec l'installation Python de votre système.

Prérequis : * Python 3.6+ * Node.js (pour l'outil CLI ccusage)

Configuration rapide pour la production (recommandé) :

1. Installez ccusage globalement :

   npm install -g ccusage
   

2. Clonez le dépôt :

   git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
   cd Claude-Code-Usage-Monitor
   

3. Créez et activez un environnement virtuel :

   python3 -m venv venv
   # Sur Linux/Mac :
   source venv/bin/activate
   # Sur Windows :
   # venv\Scripts\activate
   

4. Installez les dépendances Python :

   pip install pytz
   

5. Exécutez le moniteur :

   python ccusage_monitor.py
   

Pour une utilisation quotidienne, activez simplement votre environnement virtuel et exécutez le script principal. Vous pouvez même créer un alias de shell pour un accès rapide.

Configuration et utilisation :

Le moniteur offre diverses options de configuration via des arguments de ligne de commande :

• Spécifiez votre plan : Utilisez --plan pro, --plan max5, --plan max20, ou --plan custom_max pour correspondre à votre abonnement Claude.
• Heures de réinitialisation personnalisées : Ajustez les heures de réinitialisation de session avec --reset-hour <heure> (par exemple, --reset-hour 9 pour 9h du matin).
• Configuration du fuseau horaire : Assurez des prédictions précises en définissant votre fuseau horaire, par exemple, --timezone US/Eastern ou --timezone Asia/Tokyo.

Ce niveau de personnalisation rend le Claude-Code-Usage-Monitor incroyablement flexible, s'adaptant à différents horaires de travail, équipes internationales et modèles d'utilisation d'IA variables.

Pourquoi avez-vous besoin de cet outil :

Pour quiconque cherche à optimiser son interaction avec Claude AI, à éviter les interruptions de service inattendues et à mieux comprendre ses dépenses de jetons, le Claude-Code-Usage-Monitor est un atout inestimable. Ses prédictions intelligentes et son interface professionnelle transforment la gestion complexe des jetons en un processus simple, visuel et très efficace. Ce projet open source vous permet d'être plus productif et rentable dans vos tâches pilotées par l'IA.

Plongez dans le projet, contribuez et prenez le contrôle total de votre utilisation de Claude AI dès aujourd'hui !