Ccusage

ccusage  est un puissant outil en ligne de commande (CLI) conçu pour apporter une transparence indispensable à votre consommation de tokens Claude Code. En analysant les fichiers d'utilisation locaux JSONL générés par Claude Code, ccusage résout un problème courant pour les utilisateurs des forfaits illimités : quantifier leur consommation réelle, identifier les principaux facteurs de coût et évaluer la véritable valeur tirée de leur abonnement. Il fournit des rapports détaillés et exploitables pour gérer et optimiser vos interactions avec l'IA.

Fonctionnalités Clés

Nous nous engageons à fournir des détails granulaires et des informations pratiques, vous assurant une visibilité complète sur votre consommation de tokens et vos dépenses.

📊 Suite de Rapports Complète

Accédez à des données d'utilisation agrégées selon plusieurs dimensions, dépassant les simples totaux quotidiens. Les rapports quotidiens, hebdomadaires, mensuels et par session (Daily, Weekly, Monthly, and Session Reports) vous permettent de suivre les tendances à long terme et d'identifier instantanément quelles conversations ou périodes ont généré la plus forte consommation. Cette vue granulaire est essentielle pour une analyse rétrospective de l'utilisation.

⏰ Blocs de 5 Heures et Surveillance en Temps Réel

Suivez la consommation au sein des fenêtres de facturation spécifiques de 5 heures utilisées par les systèmes backend de Claude. Ce Blocks Report unique offre une surveillance active, des projections de coûts et des calculs de taux de consommation en temps réel, vous fournissant des alertes précoces et vous aidant à gérer l'utilisation en accord avec la mécanique sous-jacente de la plateforme.

💰 Suivi Détaillé des Coûts et des Modèles

ccusage fournit des coûts estimés en USD basés sur la consommation actuelle de tokens et la tarification spécifique à chaque modèle. Il assure automatiquement le suivi de l'utilisation des différents modèles Claude (Opus, Sonnet, etc.) et offre une vue détaillée par modèle (Model Breakdown). De plus, il distingue avec précision entre les tokens standards et les Cache Read/Creation Tokens, offrant une image plus fidèle de vos coûts opérationnels nets.

🔒 Analyse 100% Locale et Privée

Votre confidentialité est primordiale. ccusage fonctionne entièrement en Mode Hors Ligne (Offline Mode) et effectue toutes les analyses localement sur votre machine en lisant les fichiers JSONL de Claude Code. Aucune donnée n'est jamais transmise ni ne quitte votre ordinateur, garantissant une sécurité totale et une souveraineté des données sur vos habitudes d'utilisation.

🚀 Encombrement Ultra-Réduit et Accès Instantané

Contrairement à de nombreux outils CLI complexes, ccusage est conçu avec une taille de paquet incroyablement petite. Cet accent mis sur l'efficacité signifie que vous pouvez souvent exécuter l'outil directement sans installation complète (par exemple, en utilisant bunx ccusage), permettant un accès instantané aux données d'utilisation critiques avec un minimum de configuration.

Cas d'Utilisation

ccusage transforme les données d'utilisation brutes en informations stratégiques, permettant aux utilisateurs de prendre des décisions éclairées concernant leur flux de travail d'IA.

1. Évaluer le Retour sur Investissement (ROI) des Forfaits Illimités

Si vous êtes sur l'offre Max, utilisez les Monthly et Session Reports pour calculer ce que votre utilisation coûterait avec un plan de paiement à l'usage. Cette comparaison fournit une métrique concrète et quantifiable pour juger si votre modèle d'abonnement actuel offre une valeur suffisante, vous aidant à justifier ou ajuster votre offre.

2. Identifier les Flux de Travail Coûteux

Utilisez les Session Reports pour identifier les projets spécifiques ou les fils de conversation qui consomment le plus de tokens. En combinant cela avec les fonctionnalités de Model Tracking et de Breakdown, vous pouvez déterminer si les sessions coûteuses se sont appuyées de manière disproportionnée sur des modèles premium (comme Opus) et évaluer si un modèle moins coûteux pourrait obtenir des résultats similaires pour certaines tâches.

3. Intégrer les Données d'Utilisation dans des Tableaux de Bord Personnalisés

La fonctionnalité JSON Output vous permet d'exporter toutes les analyses agrégées dans un format structuré et programmable. Les développeurs et les utilisateurs avancés peuvent acheminer ces données directement vers des systèmes de surveillance internes, des tableaux de bord analytiques personnalisés ou des tableurs pour une analyse de tendances plus approfondie et une intégration avec des systèmes de gestion de projet plus larges.

Avantages Uniques

ccusage offre une valeur distinctive en se concentrant sur les détails granulaires et le contrôle des données par l'utilisateur.

Rapports Granulaires Alignés sur la Logique de la Plateforme

Nous ne nous contentons pas de fournir des résumés calendaires ; nous fournissons des 5-Hour Block Reports. Ce niveau de détail est crucial car il s'aligne sur les fenêtres de facturation sous-jacentes de Claude, vous donnant une compréhension fonctionnelle de l'utilisation que les rapports calendaires standards omettent.

Support Intégré pour les Écosystèmes de Développeurs

Le Model Context Protocol (MCP) Server intégré permet à ccusage d'interagir en douceur avec d'autres outils et systèmes de développement. Cette fonctionnalité positionne ccusage non seulement comme un visualiseur, mais comme un composant actif dans une chaîne d'outils plus vaste, permettant une automatisation et une intégration plus poussées.

Configuration Flexible et Contrôle du Fuseau Horaire

ccusage offre de nombreuses options de configuration, y compris des JSON Configuration Files avec support IDE pour la validation et l'autocomplétion, et un support flexible des fuseaux horaires et des paramètres régionaux (Timezone and Locale Support). Cela garantit que les rapports sont regroupés, affichés et formatés avec précision selon votre environnement opérationnel spécifique et votre emplacement géographique.

Conclusion

ccusage offre la clarté et le contrôle dont vous avez besoin pour maîtriser votre consommation de Claude Code. En transformant des données d'utilisation opaques en rapports détaillés et exploitables, vous gagnez la confiance nécessaire pour optimiser vos flux de travail, suivre les coûts avec précision et maximiser la valeur de votre investissement en IA.

Découvrez comment ccusage peut vous aider à prendre le contrôle de votre consommation dès aujourd'hui. Consultez l'outil et sa documentation sur GitHub.