Pour une personne, une commande suffit : installer claude-carbon, un plugin open source qui affiche le CO₂e de la session en cours dans la barre d'état de Claude Code, à côté du coût, et qui produit un bilan sur demande. Pour une équipe, TokenClimate lit l'export d'usage Anthropic par la clé Admin et ventile coût et CO₂e par personne et par modèle, sans rien installer. Pour le détail par projet, il faut le CLI TokenClimate sur les postes : aucune API Anthropic ne connaît le dépôt. Dans les deux cas, le chiffre est une estimation calculée à partir des tokens, pas une mesure au wattmètre : l'inférence tourne chez Anthropic, personne d'autre n'y branche un capteur. Ce guide compare les outils disponibles et dit ce que chacun voit. Pour le poids d'une session poste par poste, voir l'empreinte carbone de Claude Code.
Mesurer, estimer ou lire l'usage
Trois familles d'outils existent pour chiffrer l'IA, et elles ne mesurent pas la même chose.
CodeCarbon lit la consommation du processeur et de la carte graphique pendant que le code s'exécute, puis la convertit en CO₂ avec le mix électrique de la région. Il convient à un entraînement ou à un modèle auto-hébergé. Sur un appel à Claude, il ne voit rien, puisque le calcul a lieu dans un datacenter tiers.
EcoLogits s'ajoute au code qui appelle le modèle et estime chaque appel avec un modèle paramétrique : taille estimée du modèle, tokens générés, hypothèses d'infrastructure. Il faut être développeur et instrumenter chaque appel. Claude Code n'expose pas ses appels internes à une librairie tierce, et EcoLogits ne peut donc pas s'y brancher.
claude-carbon et TokenClimate partent de l'usage déjà enregistré, sans rien instrumenter : le plugin lit les transcripts locaux de Claude Code, le SaaS lit la comptabilité d'usage du fournisseur. L'estimation est de même nature que celle d'EcoLogits, et elle porte sur l'usage réel.
Les extensions de navigateur, dont carbon-llm, estiment le CO₂e des réponses d'un chat dans Chrome, Edge ou Firefox. Claude Code s'exécute dans un terminal : une extension de navigateur ne voit aucune de ses sessions.
| Outil | Ce qu'il regarde | Voit une session Claude Code | Pour qui |
|---|---|---|---|
| CodeCarbon | La consommation électrique de votre machine | Non, l'inférence est chez Anthropic | Modèle auto-hébergé, entraînement |
| EcoLogits | Chaque appel API instrumenté dans votre code | Non, Claude Code n'expose pas ses appels | Développeur qui appelle l'API lui-même |
| Extension navigateur (carbon-llm) | Les réponses d'un chat dans le navigateur | Non, Claude Code tourne dans un terminal | Utilisateurs de ChatGPT ou Claude.ai au bureau |
| claude-carbon | Les transcripts locaux de Claude Code, session par session | Oui, en direct dans la barre d'état | Un développeur, sur son poste |
| TokenClimate | L'export d'usage Anthropic de l'organisation | Oui, pour tous les postes, sans installation | Une équipe, un tech lead, une direction RSE ou FinOps |
Mesurer sa propre session : claude-carbon
Une commande, la même pour installer et pour mettre à jour :
curl -fsSL https://raw.githubusercontent.com/gwittebolle/claude-carbon/main/install.sh | bash
Sur Windows, un script PowerShell équivalent est fourni ; avec Node.js, npx claude-carbon fait la même chose. Après redémarrage de Claude Code, la barre d'état affiche le coût de la session et son CO₂e, mis à jour au fil des tours.
Ce que le plugin fait ensuite : chaque session est enregistrée dans une base locale, ce qui conserve l'historique au-delà de la purge des transcripts à 30 jours. Il relit aussi les transcripts déjà présents dans ~/.claude pour reconstituer le passé. Trois commandes complètent l'affichage : /carbon-report pour un bilan texte, /carbon-card pour une carte partageable en PNG, /carbon-pr pour l'empreinte d'une pull request. Le code est sous licence MIT et les facteurs d'émission sont publiés avec leurs sources.
Un détail qui change les chiffres : un transcript rejoue les messages précédents quand une session reprend ou se compacte. Une somme brute sur-compte d'environ trois fois. claude-carbon déduplique par identifiant de message avant de sommer. Si vous écrivez votre propre script, faites-le aussi.
Mesurer une équipe : TokenClimate
Sur dix ou cinquante postes, demander à chacun d'installer un plugin et d'envoyer son rapport ne tient pas. TokenClimate part de l'autre bout : la clé Admin de l'organisation Anthropic donne accès à l'usage réel, token par token et modèle par modèle, pour toutes les personnes. Le tableau de bord ventile coût en euros, énergie, CO₂e et eau par équipe, par personne et par modèle, avec la même méthodologie que claude-carbon, publiée et versionnée.
Le plugin et le tableau de bord sont testés sur les mêmes cas chiffrés : une session calculée par le plugin et la même session vue depuis l'export donnent le même résultat.
Quatre points à vérifier avant de publier un chiffre
- Le mix de modèles. Les facteurs d'énergie de la gamme Claude s'étalent sur un facteur seize entre Haiku et Fable. Sans la répartition par modèle, un chiffre n'est comparable à rien.
- Les quatre classes de tokens. Entrée fraîche, écriture de cache, lecture de cache et sortie n'ont pas le même poids. Un outil qui traite la lecture de cache comme de l'entrée fraîche surestime une session agentique, où plus de 90 % du volume est du contexte relu.
- La déduplication des sessions reprises, décrite plus haut.
- La version des facteurs. Les facteurs utilisés par claude-carbon et TokenClimate sont publiés sur chaque fiche modèle avec leur source et leur niveau de confiance, et le numéro de version de la méthodologie accompagne chaque chiffre.
FAQ
Quel outil pour mesurer le CO₂ de Claude Code ?
claude-carbon pour une personne : plugin open source, installé en une commande, qui affiche le CO₂e de la session dans la barre d'état de Claude Code et produit un bilan avec /carbon-report. TokenClimate pour une équipe : il lit l'export d'usage Anthropic par la clé Admin et ventile le coût et le CO₂e par personne et par modèle, sans installation sur les postes ; le découpage par projet vient du CLI TokenClimate installé sur les postes.
claude-carbon mesure-t-il vraiment la consommation ?
Non, il estime. L'inférence tourne chez Anthropic, aucun outil externe n'y mesure l'électricité. claude-carbon lit les tokens de chaque session dans les transcripts locaux et applique des facteurs d'énergie par modèle, publiés avec leurs sources. C'est la même nature d'estimation que les autres outils du marché sur un modèle hébergé.
Faut-il être développeur pour l'utiliser ?
Non. L'installation est une commande à coller dans le terminal, et le résultat s'affiche tout seul dans Claude Code. Pour une équipe, TokenClimate ne demande aucune installation : la clé Admin de l'organisation suffit.
claude-carbon ou TokenClimate ?
claude-carbon pour voir son propre usage, gratuitement, sur son poste. TokenClimate quand la question devient collective : combien émet l'équipe, qui utilise quel modèle, que mettre dans le BEGES ou dans une réponse d'appel d'offres. Les deux appliquent la même méthodologie : une session donne le même chiffre dans l'un et dans l'autre.
Sources
- claude-carbon, dépôt GitHub, licence MIT, méthodologie et facteurs publiés
- Méthodologie TokenClimate : équations, facteurs par famille, traitement du cache
- CodeCarbon, mesure de la consommation du code exécuté localement
- EcoLogits, estimation de l'impact d'un appel API à un modèle génératif
- carbon-llm, extension de navigateur pour le CO₂e des réponses IA
- Jegham et al., How Hungry is AI?, arXiv 2505.09598, source des facteurs d'énergie