Pour une personne, la réponse tient en une commande : 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, par projet et par modèle, sans rien installer sur les postes. 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 regardent pas la même chose.
CodeCarbon mesure la machine. Il lit la consommation du processeur et de la carte graphique pendant que le code s'exécute, puis convertit en CO₂ avec le mix électrique de la région. Utile pour un entraînement ou un modèle auto-hébergé. Sur un appel à Claude, il ne voit rien : le calcul a lieu dans un datacenter tiers.
EcoLogits estime l'appel. Une librairie ajoutée dans le code qui appelle le modèle, avec un modèle paramétrique (taille estimée, 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, donc EcoLogits ne peut pas s'y brancher.
claude-carbon et TokenClimate lisent ce qui a déjà tourné. Le plugin lit les transcripts locaux de Claude Code, le SaaS lit la comptabilité d'usage du fournisseur. Rien à instrumenter. L'estimation est de même nature que celle d'EcoLogits, mais elle part de l'usage réel et non d'un appel de test.
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 SQLite 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.
Pour un besoin ponctuel, le Bilan IA produit un rapport partageable en quelques minutes à partir de la même clé, sans qu'elle soit stockée. Les deux outils partagent leurs vecteurs de test, ce qui garantit qu'une session chiffré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 d'abord. Les facteurs d'énergie de la gamme Claude s'étalent sur un facteur huit entre Haiku et Fable. Un chiffre sans la répartition par modèle ne se compare à rien.
Les quatre classes de tokens ensuite. Entrée fraîche, écriture de cache, lecture de cache et sortie n'ont pas le même poids ; un outil qui ne distingue pas la lecture de cache sur-estime 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, enfin. Une estimation vaut ce que valent ses sources. 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, projet et modèle, sans installation 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 partagent la même méthodologie, un chiffre calculé d'un côté se retrouve de 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