# Comment les économies sont mesurées

> Tokenade compte les tokens avant et après chaque intervention, déduit ce que l'agent aurait tronqué de toute façon et sépare les estimations.

Source: https://tokenade.net/fr/docs/savings-measurement · Updated: 2026-10-16

Tokenade mesure chaque économie là où elle se produit : la taille de la sortie avant son intervention, la taille après, et la différence. Il corrige ensuite ce chiffre selon ce que votre agent aurait réellement reçu, et range ce qu'il ne peut pas mesurer directement dans une estimation séparée et clairement étiquetée. Cette page détaille chaque étape, pour que vous puissiez juger les chiffres affichés par `tokenade gain` et le dashboard.

## Le registre

Chaque fois que Tokenade modifie ce qui atteint le modèle, il ajoute une ligne à `~/.tokenade/gain.jsonl`. Tous les projets écrivent dans ce même fichier. Chaque ligne note le moment, le canal (hook, wrap, proxy…), ce qui a agi, l'agent et le modèle quand ils sont connus, le répertoire de travail, le nom du programme, et les tokens avant, après et économisés.

Le fichier tourne à 10 Mio et conserve les 30 derniers jours de lignes. Vos totaux sur une période plus longue sont conservés dans un cumul.

## Le comptage des tokens

Les tokens sont comptés localement, à quelques pour cent près. Le même compteur sert des deux côtés de chaque ligne : avant et après restent donc toujours comparables. Aucun texte n'est envoyé où que ce soit pour être compté.

## Trois corrections appliquées à chaque ligne

### 1. Seules les vraies économies sont comptées

- Si la sortie après Tokenade est plus grosse qu'avant, l'économie vaut zéro (et c'est la sortie brute qui a été renvoyée).
- Les économies négligeables ne sont pas enregistrées : c'est du bruit de mesure, pas une économie.
- Les lignes invraisemblables sont mises à zéro et journalisées.

### 2. Les propres limites de l'agent sont prises en compte

Les agents tronquent ou refusent déjà les très gros résultats d'outils. Compter toute la taille brute comme « économisée » surestimerait le gain : Tokenade plafonne donc chaque ligne à ce que l'agent aurait réellement transmis au modèle.

Quand la sortie brute aurait été tronquée, seule la partie que l'agent aurait vue compte, plus un crédit limité pour les lectures supplémentaires qu'entraîne généralement un résultat tronqué ou refusé. Ce crédit est signalé comme approximatif : `tokenade gain` l'affiche sur sa propre ligne, et un [reçu](https://tokenade.net/fr/docs/gain-dashboard-receipt) le mentionne à part.

### 3. Ce que Tokenade ajoute est décompté

Tokenade ajoute un peu de texte à lui : la note de [style](https://tokenade.net/fr/docs/style-statusline), les consignes qu'il écrit dans le fichier d'instructions de votre agent. Ce coût est enregistré comme surcoût et déduit à chaque requête qui le transporte, sur tous les agents. Le texte ajouté en cours de conversation est compté jusqu'à ce que la conversation soit compactée ou effacée ; le fichier de consignes, que l'agent recharge, l'est pendant toute la session, sous-agents qui le chargent compris.

## Mesuré ou estimé

Certains bénéfices ne se mesurent pas après coup. Ils vont dans un registre séparé, `~/.tokenade/gain_estimated.jsonl`, chaque ligne marquée `"estimated": true`, et ne sont jamais ajoutés à `saved:`.

| Estimation | Pourquoi on ne peut pas la mesurer exactement |
| --- | --- |
| Intelligence de code (`skeleton`, `query`, `map`, `impact`, `semantic`) | L'entrée est mesurée, mais l'alternative (lire le fichier entier) est supposée |
| Relectures évitées | Un résultat replié continue d'économiser à chaque requête suivante qui l'aurait renvoyé, compté requête par requête d'après le journal de session de l'agent, jusqu'à la compaction suivante ; une requête qui a raté le cache compte au prix d'écriture du cache |
| Pages web | La page qu'aurait produite l'outil web de votre agent n'est pas observée ; une page servie par Tokenade est créditée à trois fois ce qu'elle livre, l'économie mesurée sur des tâches web complètes |
| Regroupement et reprises | Moins d'allers-retours et moins de tentatives sont déduits, pas observés |

`tokenade gain` les affiche sur des lignes `est.:` sous le total mesuré. Le dashboard les présente comme « estimated », à côté du chiffre mesuré, jamais dedans.

## Le proxy LLM

Pour les agents servis par le [proxy LLM](https://tokenade.net/fr/docs/llm-proxy), seuls les tours auxquels le fournisseur a répondu avec succès sont comptés. Chaque bloc replié est compté une fois, comme mesuré, à son premier envoi. Quand des requêtes suivantes le renvoient replié, elles sont comptées prudemment comme relectures estimées. La note de style ajoutée par le proxy est décomptée sur chaque requête qui la porte.

## Montants en argent

Le dashboard valorise chaque ligne au tarif du modèle qui l'a réellement traitée, d'après le modèle noté sur la ligne ou, à défaut, celui de la session. Les tarifs d'entrée, de lecture de cache et de sortie s'appliquent aux tokens correspondants, et le surcoût est déduit.

## Où voir les chiffres

Pour les explorer, ouvrez le dashboard local (`tokenade dashboard`) dans votre navigateur ; `tokenade gain` en affiche un résumé rapide dans le terminal. Les deux, comme la barre d'état, lisent votre registre local. Tout est calculé sur votre machine : aucun chiffre n'est envoyé nulle part (voir [ce que Tokenade envoie](https://tokenade.net/fr/docs/privacy-telemetry)). Les lignes estimées restent toujours séparées du total mesuré.

## Vérifiez vous-même

```bash
tokenade gain --history        # one line per ledger row
tokenade gain --json           # totals, by_op[], by_source[]
tokenade receipt --json        # signed summary, verifiable with --verify
```

## Voir aussi

- [gain, dashboard et receipt](https://tokenade.net/fr/docs/gain-dashboard-receipt)
- [Compaction des sorties et stash](https://tokenade.net/fr/docs/compaction)
- [Ce que Tokenade envoie et stocke](https://tokenade.net/fr/docs/privacy-telemetry)
- Article : [Mesurer la consommation de tokens d'un agent](https://tokenade.net/fr/articles/measure-agent-token-usage)
