# Calculateur coût et empreinte - TokenClimate

Le calculateur public ([tokenclimate.com/calculator](https://tokenclimate.com/calculator)) estime le coût (USD), l'énergie (Wh), les émissions (gCO₂e) et la consommation d'eau estimée (mL) d'un volume mensuel de tokens sur les modèles du catalogue TokenClimate (Claude, GPT, Gemini, Mistral, DeepSeek, Llama). Tous les facteurs sont publiés et versionnés dans la [méthodologie](https://tokenclimate.com/methodology).

## Ce que compte le calculateur

Le champ principal est un volume de **tokens de sortie par mois** (les tokens générés par les modèles). Un profil d'usage étend ce volume aux quatre classes de tokens que le moteur compte : entrée (input), écriture de cache (cache write), lecture de cache (cache read) et sortie (output). Les profils sont des jeux de volumes de référence sourcés, documentés dans la section « Profils d'usage du calculateur public » de la méthodologie :

- **Sortie seule** (défaut) : seuls les tokens générés sont comptés, comportement historique.
- **Chat simple** : 1 000 tokens d'entrée pour 150 en sortie, sans cache (médiane d'une trace de production conversationnelle, Splitwise ISCA 2024).
- **Agent de code** : le profil d'une session Claude Code type, tiré de l'exemple chiffré de la méthodologie (3 000 000 de lectures de cache pour 30 000 tokens de sortie), corroboré par la trace TraceLab.

Un mode avancé accepte les quatre volumes saisis directement, pour qui a ses chiffres réels (console Anthropic, ccusage, CLI TokenClimate).

## Format d'URL

Un scénario se partage par URL, les chiffres sont recalculés à l'ouverture :

```
/calculator?a=claude-sonnet:80,claude-opus:20&v=10000000
```

- `a` (et `b` pour une comparaison) : le mix de modèles, `slug:part` séparés par des virgules.
- `v` : volume mensuel de tokens de sortie.
- `p` : profil d'usage (`chat`, `agent-code`). Omis = sortie seule.
- Mode avancé : `p=custom&ti=<input>&tw=<cache write>&tr=<cache read>`, `v` restant la sortie.

## FAQ

### Que compte exactement le calculateur ?

Les quatre classes de tokens facturées par les fournisseurs : entrée, écriture de cache, lecture de cache et sortie. Le périmètre est celui de la méthodologie TokenClimate : datacenter tiers, inférence seule, en location-based par défaut. Chaque facteur d'énergie est sourcé et versionné, la méthodologie complète est publique.

### Pourquoi les tokens de sortie ne suffisent-ils pas ?

Parce qu'en usage agentique ils ne sont qu'une petite partie de ce que la machine traite. Sur le profil agent de code, environ 91 % des tokens traités sont des lectures de cache. Une lecture de cache coûte environ 0,08 fois l'énergie d'un token d'entrée (voir la section « Énergie du cache » de la méthodologie) : c'est peu par token, mais le volume en fait un terme significatif du total.

### D'où viennent les ratios des profils d'usage ?

Chaque profil est un jeu de volumes de référence sourcé et versionné, affiché à l'écran avec son hypothèse. Le profil chat s'appuie sur la médiane d'une trace de production conversationnelle (Splitwise, ISCA 2024). Le profil agent de code vient de l'exemple chiffré de la méthodologie, corroboré par une mesure académique sur 2 676 sessions Claude Code réelles (TraceLab) : la part de cache retenue est même conservatrice. Le ratio réel varie d'une organisation à l'autre : le Bilan IA le mesure sur vos données réelles.

### Peut-on partager ou citer un scénario ?

Oui. L'URL encode le mix de modèles, le volume et le profil d'usage, rien d'autre. Les chiffres sont recalculés à chaque ouverture avec la version courante de la méthodologie, côté serveur pour les emails. Un scénario cité reste donc vérifiable et recalculable.