Comprendre l'utilisation des jetons
dans Claude Code

Qu'est-ce qu'un jeton ?

Un jeton est un petit fragment de texte — environ trois quarts d'un mot en anglais, un peu moins en français du fait des accents et des mots composés. Ce n'est ni exactement un mot ni exactement un caractère. La phrase « Bonjour, comment allez-vous aujourd'hui ? » se découpe en environ 10 jetons. Les mots longs ou inhabituels peuvent coûter plus cher ; les mots courts et courants en partagent souvent un seul.

Input et Output

Input désigne tout ce que Claude reçoit dans une même requête : votre message, le prompt système, le contenu des fichiers, les résultats d'outils et l'historique de la conversation renvoyé à chaque nouveau tour d'échange.

Output désigne ce que Claude renvoie. Les jetons Output sont systématiquement plus chers que les jetons Input, quel que soit le modèle.

Une simple question coûte peu. Les coûts augmentent avec le volume, la taille du contexte et la répétition — pas avec la complexité de ce que vous demandez.

C.Write — Cache Write

Lorsque Claude Code envoie un bloc de texte volumineux et répété (fichiers de projet, long prompt système, base de code entière), l'infrastructure d'Anthropic peut le mettre en cache. La première fois que ce bloc est traité, il est écrit dans le cache. C'est un cache write.

Les cache writes coûtent environ 1,25× le prix standard de l'input — légèrement plus cher qu'un input normal. C'est un investissement ponctuel : vous payez un peu plus au départ pour que les requêtes suivantes n'aient pas à retraiter le même contenu.

Le plugin affiche C.Write en violet dans tout le panneau latéral pour signaler ce coût plus élevé.

C.Read — Cache Read

Une fois qu'un bloc est en cache, Claude peut le lire depuis le cache lors des requêtes suivantes au lieu de le retraiter depuis zéro. C'est un cache read.

Les cache reads coûtent seulement environ 10 % du prix standard de l'input — dix fois moins cher qu'un input normal. Si le même contexte est réutilisé de nombreuses fois, les cache reads rendent les longues sessions nettement plus abordables.

Le plugin affiche C.Read en ambre pour signaler un volume élevé à faible coût par jeton.

C.Write vs C.Read — le facteur de réutilisation

Le rapport entre ces deux valeurs raconte comment vous travaillez.

Facteur	Ce qu'il indique
En dessous de 2×	Beaucoup de nouveau contexte, peu de réutilisation. Mode exploratoire.
2× à 8×	Équilibré. Le cache est rentable, mais le contexte change régulièrement.
Au-dessus de 8×	Mode concentration profonde — mêmes fichiers, session longue, le cache travaille dur pour vous.

Un facteur de réutilisation élevé est généralement bon signe : vous travaillez en profondeur sur le même sujet et le cache vous fait économiser. Le tableau de bord affiche ce ratio dans la section Cache Efficiency, avec un graphique linéaire où C.Write apparaît en violet et C.Read en ambre — les mêmes couleurs que dans le panneau latéral.

Les 5 dernières heures

Claude Code fonctionne en interne avec une fenêtre glissante de 5 heures pour ses limites de débit. Le plugin suit la même fenêtre : il additionne toute l'activité des 5 dernières heures et affiche Input, Output, C.Write et C.Read en lignes séparées.

C'est la vue la plus immédiate de votre session en cours. Si vous travaillez depuis quelques heures sans longue pause, cette fenêtre reflète à peu près ce que vous avez consommé depuis le début.

Pourquoi le compte à rebours affiche un tilde (~)

Le compte à rebours dans le pied du panneau latéral indique « Claude 5h resets in: ~Xh Ym ». Le tilde est intentionnel — il signale qu'il s'agit d'une approximation, pas d'une valeur exacte.

Claude Code écrit les données de session dans des fichiers locaux après que chaque réponse soit entièrement terminée, pas au moment exact où vous envoyez votre premier message. Au début d'une session, la première requête est souvent longue : chargement du contexte, lecture de fichiers, réflexion. Cette première réponse peut prendre 10 à 25 minutes. Pendant ce temps, rien n'est encore écrit dans le journal de session local. Le premier horodatage que le plugin peut lire n'est donc pas le véritable début de votre session — c'est le moment où votre première réponse est arrivée.

Cela signifie que le compte à rebours du plugin peut retarder de 10 à 25 minutes sur l'affichage propre de Claude. Pour l'heure exacte de réinitialisation, consultez la section d'utilisation de votre forfait dans Claude Code ou sur claude.ai. La valeur du plugin est une orientation fiable, mais l'affichage de Claude reste la source qui fait foi.

Les trois vues temporelles — comment elles se rejoignent

Le panneau latéral affiche trois résumés différents de votre activité : Last 5 Hour Session, This Session et Today. Ce sont trois découpages indépendants des mêmes données — ils ne s'emboîtent pas automatiquement les uns dans les autres comme le feraient des heures, des jours et des semaines.

Vue	Ce qu'elle couvre	Se réinitialise quand
Last 5 Hour Session	Fenêtre glissante : tout depuis 5 heures jusqu'à maintenant	En continu — l'entrée la plus ancienne disparaît au fil du temps
This Session	Toutes les entrées portant l'ID de session actuel, quelle que soit la date	Quand vous démarrez une nouvelle session Claude Code (nouveau fichier JSONL)
Today	Jour calendaire : tout depuis minuit	Chaque jour à minuit

La conséquence essentielle : une session peut s'étendre sur plusieurs jours. Si vous avez démarré une longue session hier et l'avez poursuivie aujourd'hui, « This Session » affichera plus de jetons que « Today ». C'est normal — la session s'accumule au-delà des limites calendaires, tandis que « Today » ne compte qu'à partir de ce minuit.

De même, la fenêtre de 5 heures n'est pas un sous-ensemble de « Today » si l'heure actuelle est avant 05h00 — la fenêtre glissante remonte alors dans la journée d'hier. À partir de 05h00, la fenêtre de 5 heures est toujours entièrement contenue dans la journée en cours.

Le plugin rend cela visible : un petit sous-libellé sous chaque titre de section explique son périmètre. « This Session » indique quand la session a démarré, pour voir immédiatement si les chiffres couvrent plusieurs jours.

Archive et données à long terme

Claude Code supprime automatiquement ses propres fichiers de session — 30 jours par défaut, ou selon la valeur définie sous conservation des données Claude dans les réglages. Sans copie ailleurs, tout ce qui est plus ancien disparaît définitivement.

L'archive résout ce problème : chaque jour où vous utilisez Claude Code, le plugin écrit un petit fichier récapitulatif dans Token Usage Archive/ de votre vault — uniquement des totaux agrégés, jamais vos conversations réelles. Chaque fois que vous ouvrez Obsidian, il vérifie tous les jours encore disponibles et complète tout jour qui n'a pas encore de fichier, y compris les écarts dus à une période où le plugin n'était pas actif.

La limite honnête : l'archive ne peut sauvegarder que ce qui existe encore au moment où vous ouvrez l'application. Si Obsidian reste fermé plus longtemps que votre période de conservation, les jours intermédiaires disparaissent avant même que le plugin ait eu la chance de les voir — impossible d'y remédier sans une exécution continue. Augmentez la conservation (Réglages → Claude data retention) si vous ouvrez Obsidian moins d'une fois par jour, pour donner au plugin une marge de sécurité plus large.

Barre latérale NextGen

Le panneau latéral propose deux apparences, modifiables à tout moment sous Réglages → Apparence de la barre latérale. Classic est la vue d'origine sur une seule page et reste la valeur par défaut. NextGen bascule vers une barre d'icônes avec des pages dédiées Today, Overview et Settings, remplace le graphique quotidien à barres par une carte thermique d'activité sur 7 jours, et affiche les résumés sur 7 jours et N jours sous forme de tuiles KPI colorées avec sparklines.

Dans NextGen, chacune des quatre lignes de jetons d'Aujourd'hui reçoit également un repère compact — un point vert lorsque la valeur est proche de votre moyenne récente, une flèche ambre lorsqu'elle est nettement plus élevée. La fenêtre de comparaison suit votre conservation des données Claude, pas un nombre de jours fixe.

Basculer entre Classic et NextGen est entièrement réversible et n'affecte aucune donnée sous-jacente ni le tableau de bord.

Calendrier d'activité. Depuis la v1.8, NextGen ajoute aussi un calendrier mensuel en bas de chaque page. Chaque jour passé reçoit une pastille colorée proportionnelle à votre propre moyenne quotidienne récente — vert en dessous, ambre autour, rouge pour un pic de 2× ou plus ; les jours sans activité restent vides. Vous remontez aussi loin que votre archive le permet ; le calendrier ne va jamais dans le futur et sert uniquement d'affichage. Désactivez-le sous Réglages → Calendrier d'activité si vous préférez une barre latérale plus courte.

Modèles

Claude Code oriente les requêtes vers différents modèles selon la tâche. Le panneau latéral affiche une barre de pourcentage empilée de la répartition des modèles sur les 7 derniers jours, chaque famille de modèle ayant sa propre couleur :

Modèle	Couleur dans la sidebar	Rôle typique
Haiku	Cyan	Tâches rapides et légères, coût le plus bas
Sonnet	Bleu	Équilibre entre capacité et coût
Opus	Violet	Raisonnement complexe, tâches exigeantes
Fable	Ambre	Capacité la plus élevée, coût le plus élevé
Autre	Gris	Chaîne de modèle non reconnue ou future

Connaître la répartition de vos modèles explique une grande partie des variations de coût au jour le jour. Une journée chargée en Opus a un profil de coût très différent d'une journée passée surtout sur Haiku.

Sessions

Claude Code écrit un fichier journal JSONL par session. Le plugin lit tous les fichiers sous ~/.claude/projects/ et regroupe l'utilisation par session. Le tableau Top Sessions du tableau de bord montre quels passages individuels ont consommé le plus de jetons — utile pour repérer des sessions anormalement coûteuses.

Vault Token Usage Controlling

Si vous utilisez Claude Code sur plusieurs vaults Obsidian — un vault distinct par client, ou un vault personnel à côté d'un vault professionnel —, la vue Projects du tableau de bord HTML répartit le total des jetons consommés par vault, et par sous-projet au sein d'un vault chaque fois que votre répertoire de travail a changé pendant une session.

Chaque vault obtient sa propre ligne : total de jetons, part de la consommation globale, jours actifs, ainsi que premier et dernier jour d'activité. Un tableau de détail jour par vault affiche la même répartition par jour calendaire, et un export autonome Vault_Token_Usage_Projects.md (palette de commandes ou réglages) est conçu pour les tableurs — utile pour répartir les coûts entre clients ou projets lors de la facturation.

Ici, « vault » désigne en réalité le dossier dans lequel une session a démarré — le plus souvent votre coffre Obsidian, mais aussi les sessions en mode agent de l'application de bureau Claude (affichées comme Claude Desktop (Agent Mode)) ou tout répertoire dans lequel vous avez lancé Claude Code. Les dossiers représentant moins de 1 % du total sont regroupés dans une seule ligne Other pour garder la liste lisible.

Ce qui est mesuré (et ce qui ne l'est pas)

Le plugin lit ce que Claude Code écrit sur le disque. Toutes les façons d'utiliser Claude Code sont donc couvertes : dans un terminal, dans Obsidian, dans un éditeur comme VS Code, ainsi que le mode agent intégré à l'application de bureau Claude. Celle-ci exécute Claude Code en mode intégré et écrit le même format de session à un emplacement distinct, que le plugin lit également (depuis la v1.8). Tout cela alimente les mêmes chiffres.

Ce qu'il ne peut pas afficher, c'est le chat classique — les conversations menées dans l'application de bureau ou sur claude.ai. Aucun décompte de jetons n'y est enregistré sur votre machine. Le seul indicateur disponible est un pourcentage arrondi de votre limite actuelle, et non les valeurs par requête sur lesquelles repose ce plugin.

Grille tarifaire de l'API

Tarifs API d'Anthropic par million de jetons — input / output standard, en date d'août 2026 :

Modèle	Input / 1M	Output / 1M
Haiku 4.5	$1,00	$5,00
Sonnet 5 *	$2,00	$10,00
Sonnet 4.6	$3,00	$15,00
Opus 5	$5,00	$25,00
Fable 5	$10,00	$50,00

* Tarif de lancement de Sonnet 5 valable jusqu'au 31 août 2026. Ensuite : $3,00 input / $15,00 output.

Tarifs de cache en supplément du prix standard de l'input :

• C.Write : environ 1,25× le prix standard de l'input du modèle
• C.Read : environ 0,10× le prix standard de l'input (10× moins cher)

Pourquoi les coûts s'accumulent

Une requête isolée est rarement chère. Calcul rapide avec Sonnet 5 au tarif de lancement :

• 10 000 jetons d'input × $2 / 1M = $0,02
• 2 000 jetons d'output × $10 / 1M = $0,02
• Total : environ $0,04

C'est presque rien. Le problème vient de la répétition et de la croissance du contexte. Chaque nouveau message d'une session renvoie généralement l'historique de la conversation et les fichiers ouverts en tant qu'input. Après dix échanges, le dixième message porte les neuf tours précédents ainsi que tous les documents joints — le total d'input augmente donc à chaque étape, même si vous ne tapez qu'une courte question.

La question elle-même est rarement ce qui coûte cher. C'est ce qui l'accompagne.

Ce qui fait grimper les coûts

• Les sessions longues où une large fenêtre de contexte est renvoyée à chaque requête
• Les fichiers volumineux ou bases de code entières joints qui voyagent en input à chaque message
• Les requêtes rapides et fréquentes sur une courte période
• L'utilisation d'un modèle haut de gamme pour des tâches qu'un modèle moins cher gère tout aussi bien

Conseils pratiques

Mesurer d'abord. Le graphique quotidien et le tableau des sessions du plugin montrent où vont réellement les jetons. On n'optimise pas ce qu'on n'a pas regardé.

Éviter le contexte inutile. Les fichiers volumineux joints « au cas où » s'ajoutent à chaque input. Ne joindre que ce dont Claude a besoin pour la tâche en cours.

Choisir le modèle selon la tâche. Toutes les requêtes n'ont pas besoin d'Opus. Les questions rapides, les tâches de mise en forme et les modifications de code simples fonctionnent souvent très bien avec Haiku ou Sonnet, pour une fraction du coût. Comparer la qualité et le coût total par tâche accomplie, pas seulement le prix par jeton.

Comprendre le cache. Un pic de C.Write en début de session est normal — un large contexte vient d'être établi. Ce qui compte, c'est si C.Read suit ensuite. Si le même contexte est réutilisé sur de nombreuses requêtes, le coût initial d'écriture s'amortit rapidement et le coût effectif par requête baisse nettement.

Utiliser le tableau de bord. Le tableau de bord HTML (ouvert via le bouton graphique dans le panneau latéral) montre votre historique d'utilisation — 30, 60, 180 ou 360 jours via le sélecteur de période dans l'en-tête —, ainsi que la répartition des modèles et la tendance d'efficacité du cache. Observer les données sur plusieurs jours révèle des schémas qu'une seule vue de session ne peut pas montrer.

Compatibilité et mises à jour de Claude Code

Token Usage lit les fichiers de session JSONL que Claude Code écrit localement. Anthropic met à jour Claude Code régulièrement — parfois d'une manière qui affecte l'enregistrement des données de session ou le comptage de la télémétrie interne.

Nous examinons les notes de version d'Anthropic à chaque mise à jour majeure de Claude Code et adaptons le plugin si nécessaire. Les changements de compatibilité importants sont documentés dans le changelog du plugin sur GitHub.

À propos de ce plugin

Token Usage est un plugin communautaire open source pour Obsidian. Il lit des fichiers JSONL locaux écrits par Claude Code — aucune donnée n'est envoyée nulle part.

• Manuel détaillé (en anglais) : Token Usage Docs — installation, sources de données, concepts clés, référence des réglages et FAQ, le tout sur une seule page
• GitHub : beolatn/TokenUsage
• Répertoire des plugins Obsidian : Token Usage
• Auteur : Björn-Olaf Lange · langeatn.de

Les prix cités sur cette page proviennent de la documentation officielle d'Anthropic. Dernière mise à jour août 2026. Les prix peuvent changer — toujours vérifier les tarifs actuels sur le site d'Anthropic.