Comprendre l'utilisation des jetons
dans Claude Code

Estimation empirique des limites — un chiffre qu'Anthropic ne publie jamais

Anthropic ne publie pas la limite de tokens réelle derrière un rate-limit hit — elle existe côté serveur et reste invisible, tant pour la fenêtre ancrée de 5 heures que pour le plafond hebdomadaire. Token Usage la rend visible de façon empirique : chaque rate-limit hit détecté dans vos propres fichiers de session locaux devient un point de données, et suffisamment de points de données donnent une estimation de vos propres limites de session et hebdomadaire. Pas une supposition, pas un argument marketing — un chiffre construit à partir de ce qui s'est réellement passé sur votre compte.

Cette estimation n'est pas une photo figée. Elle devient discrètement plus précise à mesure que vous utilisez Claude Code — chaque nouveau rate-limit hit l'affine davantage, si bien que le chiffre affiché aujourd'hui est plus fiable que celui de votre première semaine. Comme elle est entièrement construite à partir de vos propres données locales, il n'y a rien à configurer ni à activer : l'estimation s'améliore simplement d'elle-même à mesure que vous continuez à travailler.

Vous trouverez l'estimation actuelle à deux endroits : la bannière budget tout en haut du tableau de bord, et la section Situation actuelle de la barre latérale avec ses trois anneaux (fenêtre 5 h, aujourd'hui, cette semaine). La ligne sous les anneaux indique explicitement l'estimation des 5 heures et sur combien de dépassements observés elle repose. Les deux surfaces proviennent exactement du même calcul, elles ne peuvent donc jamais se contredire.

L'estimation sur 5 heures est affichée sous la forme d'une médiane accompagnée d'une plage habituelle : la moitié centrale de vos dépassements observés. La même limite est rarement atteinte au même total exact, car d'autres usages de Claude que Token Usage ne voit pas (par exemple claude.ai dans le navigateur) puisent dans la même limite ; un chiffre seul paraîtrait plus précis qu'il ne l'est. Chaque dépassement est mesuré dans sa propre fenêtre ancrée de 5 heures, exactement comme l'anneau compte, les deux sont donc directement comparables. Dans la barre latérale, la plage occupe sa propre ligne sous l'estimation ; dans le tableau de bord, elle remplace l'ancienne étendue min-max de la bannière budget, et l'export CSV contient les deux bornes.

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.

Il existe deux types de cache writes, facturés différemment : une écriture de cache de 5 minutes coûte 1,25× le prix standard de l'input, une écriture de cache d'1 heure coûte 2×. Dans nos propres journaux, environ 90 % des cache writes de Claude Code sur un abonnement étaient du type 1 heure, tandis que les sous-agents écrivaient des caches de 5 minutes. Depuis la 2.1.0, survoler une ligne C.Write dans le panneau latéral affiche la répartition. C'est un investissement : vous payez plus au départ pour que les requêtes suivantes n'aient pas à retraiter le même contenu. Les cache writes comptent aussi pour la limite de 5 heures, voir Ce qui compte pour une limite.

Le plugin affiche C.Write en bleu-vert dans tout le panneau latéral.

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 ne coûtent qu'une fraction du prix standard de l'input : 0,1× sur la plupart des modèles, 0,05× sur Opus 5.5 et Sonnet 5.5, 0,025× sur Fable 5.1. 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 violet 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 bleu-vert et C.Read en violet — les mêmes couleurs que dans le panneau latéral.

Fenêtre de 5 h en cours

Claude Code applique une fenêtre de 5 heures, et elle est ancrée, et non glissante. La fenêtre s'ouvre avec votre premier message et dure exactement cinq heures ; une nouvelle ne commence qu'une fois ce délai entièrement écoulé, enchaînée par blocs fixes de cinq heures, quelle que soit la pause entre deux. Ce ne sont pas « les cinq dernières heures comptées à rebours depuis maintenant » — et c'est indépendant de la réinitialisation hebdomadaire, qui suit son propre calendrier sans démarrer une nouvelle fenêtre de 5 heures en même temps.

Le plugin reconstruit ces fenêtres réelles à partir de votre activité et additionne celle qui est ouverte, en affichant Input, Output, C.Write et C.Read en lignes séparées. Cela compte précisément au moment où une fenêtre se renouvelle : un calcul glissant additionnerait la fin de la fenêtre qui vient de se fermer et le début de celle qui vient de s'ouvrir, produisant un chiffre qui n'appartient à aucune des deux — justement quand vous voulez voir que vous disposez d'un budget neuf.

C'est la vue la plus immédiate de votre travail en cours. La fenêtre reflète ce que vous avez consommé depuis son ouverture.

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é : Fenêtre de 5 h en cours, 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
Fenêtre de 5 h en cours	Fenêtre ancrée : tout depuis son ouverture	À l'expiration — le message suivant ouvre une fenêtre neuve, par blocs fixes de cinq heures quelle que soit la pause entre deux
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 » : une fenêtre ouverte hier soir franchit minuit, et tout ce qu'elle contient compte toujours pour la même limite. À l'inverse, les deux peuvent être identiques — si votre fenêtre s'est ouverte ce matin et que vous n'aviez pas travaillé avant aujourd'hui, les deux chiffres affichent la même valeur jusqu'à sa fermeture.

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.

Ce qui compte pour une limite

Anthropic applique deux limites et rien d'autre : la fenêtre de 5 heures et un plafond hebdomadaire réinitialisé un jour et à une heure fixes. Il n'existe pas de limite quotidienne — le panneau « Aujourd'hui » n'est donc pas un quota (voir L'anneau Aujourd'hui).

Les tokens d'entrée et de sortie comptent, et le cache n'est pas gratuit. Des mesures comparées aux pourcentages officiels que Claude Code transmet (octobre 2026) indiquent que les écritures de cache comptent nettement pour la fenêtre de 5 heures et les lectures de cache un peu. Une analyse antérieure des dépassements observés allait dans l'autre sens. Les nouvelles mesures sont plus directes. Les chiffres du plugin ne comptent toujours que l'entrée et la sortie. Lorsqu'une longue session doit reconstruire son cache, par exemple dans une nouvelle fenêtre de 5 heures après une pause ou lorsqu'un grand contexte est chargé pour la première fois, le chiffre officiel peut donc devancer le plugin. En pratique : les longues sessions au contexte volumineux consomment la fenêtre de 5 heures plus vite par réponse que les sessions courtes et récentes.

Aucune des deux limites n'est publiée. Les deux estimations proviennent de votre propre historique, et c'est pourquoi le plugin ne peut les afficher qu'après vous avoir vu atteindre une limite au moins une fois. Jusque-là, il le dit au lieu d'inventer un chiffre. L'estimation hebdomadaire issue des dépassements correspond à la semaine la plus basse ayant atteint le plafond et peut être nettement trop basse, car le cache que le plugin ne compte pas vous y mène aussi. Avec le flux de ligne d'état (voir Pourcentages officiels de votre ligne d'état), le plugin utilise les chiffres officiels.

L'anneau Aujourd'hui

Il n'existe pas de limite quotidienne. Anthropic limite uniquement la fenêtre de 5 heures et la semaine. L'anneau « Aujourd'hui » compare votre consommation du jour à votre propre moyenne par jour actif, calculée sur tous les jours que Claude Code conserve (votre réglage de conservation des données, cleanupPeriodDays).

200 % signifie que vous travaillez deux fois plus que d'habitude aujourd'hui, rien de plus. Une journée chargée est un changement dans votre façon de travailler, pas un avertissement. Seuls les anneaux de la fenêtre de 5 heures et de la semaine indiquent à quel point vous êtes proche d'une limite. C'est pourquoi, depuis la 2.1.0, l'anneau reste gris neutre.

Pourcentages officiels de votre ligne d'état

Facultatif, depuis la 2.1.0. Token Usage fonctionne aussi sans. Claude Code connaît les pourcentages officiels de votre forfait, les chiffres qu'affiche /usage. Deux petits scripts du dépôt du plugin les écrivent dans ~/.claude/ratelimit-log.jsonl. Lorsque ce fichier existe, le plugin y ancre ses anneaux. Le guide complet (en anglais) se trouve dans le dossier extras sur GitHub.

Ce que vous y gagnez

	Sans flux	Avec flux
Début de la fenêtre de 5 heures	Reconstruit à partir de votre premier message enregistré	Le début officiel, même si la fenêtre a été ouverte sur claude.ai, un autre appareil ou un autre outil
Anneau 5 heures	Vos tokens face à la médiane de vos propres dépassements	Exactement le pourcentage officiel à chaque relevé, puis il continue de compter avec vos tokens
Anneau hebdomadaire	Vos tokens face à la semaine la plus basse ayant atteint le plafond, ce qui peut être nettement trop bas	Exactement le pourcentage officiel à chaque relevé
Nécessite d'abord un dépassement	Oui	Non

Prérequis

• Un abonnement Pro ou Max avec lequel Claude Code est connecté. Avec une clé API, il n'y a pas de pourcentages de forfait.
• Node.js, car les deux scripts sont de petits programmes Node. Vérifiez avec node --version. S'il manque, installez la version LTS depuis le site de Node.js. Claude Code installé avec l'installateur natif n'apporte pas Node.js.
• Une version récente de Claude Code, et pour l'interrogation la ligne de commande Claude Code claude.

De quel script ai-je besoin ?

Où vous travaillez	Script
Dans un terminal	ratelimit-statusline.js comme ligne d'état. Gratuit, les relevés arrivent pendant que vous travaillez
Dans Obsidian, un éditeur ou un autre programme sans ligne d'état	ratelimit-poll.js, exécuté selon un planning
Les deux	Les deux. Ils écrivent dans le même fichier

Une ligne d'état ne s'exécute que tant que le terminal interactif de Claude Code est ouvert. Les programmes qui intègrent Claude Code ne l'exécutent pas, la ligne d'état seule y produit donc peu ou pas de relevés.

Option A : script de ligne d'état

Copiez le script dans ~/.claude/ratelimit-statusline.js et ajoutez cette entrée à ~/.claude/settings.json, à côté des clés déjà présentes :

"statusLine": { "type": "command", "command": "node ~/.claude/ratelimit-statusline.js" }

Sous Windows, utilisez le chemin complet avec des barres obliques, par exemple node C:/Users/<vous>/.claude/ratelimit-statusline.js. Redémarrez Claude Code, la ligne d'état affiche alors 5h 12% | week 34%. Vous avez déjà votre propre ligne d'état ? Gardez-la et ajoutez-y la partie journalisation de notre script.

Option B : interrogation planifiée

Avant de la mettre en place : chaque exécution est une vraie requête, très petite (le prompt ok envoyé à Haiku, sans session enregistrée), et compte dans votre consommation. Si aucune fenêtre de 5 heures n'est ouverte à ce moment, la requête en ouvre une, votre prochaine fenêtre commence alors à l'heure de l'interrogation. Planifiez-la à des heures où vous travaillez de toute façon ; trois fois par jour suffisent largement.

Copiez le script dans ~/.claude/ratelimit-poll.js et lancez-le une fois à la main avec node ~/.claude/ratelimit-poll.js. Il affiche 5h 12% | week 34%. Ensuite, planifiez-le.

Windows (PowerShell, s'exécute à 12:00, 17:00 et 22:00 et rattrape les exécutions manquées si l'ordinateur était éteint) :

$node     = (Get-Command node).Source
$script   = "$env:USERPROFILE\.claude\ratelimit-poll.js"
$action   = New-ScheduledTaskAction -Execute $node -Argument "`"$script`""
$triggers = '12:00','17:00','22:00' | ForEach-Object { New-ScheduledTaskTrigger -Daily -At $_ }
$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable
Register-ScheduledTask -TaskName 'TokenUsageLimitPoll' -Action $action -Trigger $triggers -Settings $settings

macOS et Linux (crontab -e, avec les chemins complets donnés par which node et which claude, car cron s'exécute avec un PATH minimal) :

0 12,17,22 * * * CLAUDE_BIN=/chemin/complet/vers/claude /chemin/complet/vers/node /Users/<vous>/.claude/ratelimit-poll.js

Sous Linux, le dossier personnel est généralement /home/<vous>. Les erreurs des exécutions planifiées sont écrites dans ~/.claude/ratelimit-poll-errors.log. Si le script ne trouve pas la ligne de commande Claude Code, définissez CLAUDE_BIN avec son chemin complet.

Vérifier que cela fonctionne

• Le fichier ~/.claude/ratelimit-log.jsonl existe et reçoit de nouvelles lignes.
• Dans le panneau latéral, la ligne sous les trois anneaux se termine par « déduite du pourcentage officiel de votre flux de ligne d'état ». L'info-bulle de l'anneau hebdomadaire indique la même chose pour la limite hebdomadaire.
• Juste après un relevé, /usage dans Claude Code et les anneaux du plugin affichent les mêmes pourcentages.

Comment le plugin utilise les relevés

Chaque relevé contient le moment où la fenêtre de 5 heures en cours se réinitialise. Le plugin connaît ainsi le vrai début de la fenêtre. Le dernier relevé de la fenêtre ouverte sert de base à l'anneau 5 heures ; entre deux relevés, vos nouveaux tokens s'ajoutent au rythme qu'ont réellement eu vos dernières fenêtres. Le dernier relevé de la semaine en cours à partir de 10 % fixe la limite hebdomadaire. Les relevés sous 10 % sont trop grossiers, car les valeurs arrivent en pourcentages entiers. Si aucun relevé ne convient, le plugin revient à ses propres estimations, comme avant.

Limites connues

Entre deux relevés, le plugin ne compte que l'entrée et la sortie. Officiellement, les écritures de cache comptent aussi pour la fenêtre de 5 heures, une reconstruction du cache (un nouveau chat, ou le premier message après une longue pause dans une longue session) n'apparaît donc qu'au relevé suivant. Les relevés n'existent que tant qu'une ligne d'état est affichée, ou aux heures planifiées.

Dépannage

Ce que vous voyez	Que faire
La ligne d'état est vide	Node.js est introuvable. Vérifiez node --version ; sous Windows, indiquez le chemin complet de node.exe dans la commande
5h ? | week ?	Aucun pourcentage n'arrive. Connectez-vous avec votre abonnement au lieu d'une clé API, mettez Claude Code à jour
Interrogation : « Claude Code CLI not found »	Définissez CLAUDE_BIN avec le chemin complet de claude
Interrogation : « No rate_limit_event in the output »	Lancez claude une fois à la main et connectez-vous avec votre abonnement
Le plugin affiche encore les anciens textes	Pas encore de relevé dans la fenêtre ou la semaine en cours. Lancez l'interrogation une fois à la main, puis actualisez le panneau latéral

Confidentialité et suppression

Tout reste sur votre machine. Chaque ligne contient un horodatage, les deux pourcentages avec leurs heures de réinitialisation et, depuis la ligne d'état, l'ID de session et l'ID du modèle. Le plugin lit seulement le fichier et n'exécute jamais les scripts lui-même. Pour tout retirer, supprimez l'entrée statusLine, la tâche planifiée (Unregister-ScheduledTask -TaskName 'TokenUsageLimitPoll') ou la ligne cron, et si vous le souhaitez le fichier journal. Le plugin revient alors à ses propres estimations.

Mis à jour le 10 octobre 2026 : la première version de cette section ne mentionnait pas Node.js et ne proposait que la ligne d'état, qui ne s'exécute pas dans des programmes comme Obsidian. Les deux sont ajoutés.

Réinitialisation hebdomadaire

La limite hebdomadaire se réinitialise un jour et à une heure fixes qui diffèrent selon le compte. Tout ce qui concerne la semaine en dépend : l'anneau hebdomadaire, la prévision, la carte d'activité et l'estimation hebdomadaire elle-même.

En principe, vous n'avez rien à régler. Lorsque vous atteignez une limite hebdomadaire, Claude inscrit la prochaine heure de réinitialisation dans le message, et le plugin la lit depuis là — les réglages affichent alors une coche verte et la date du dépassement dont provient la valeur. Tant que cela n'est jamais arrivé, il suppose dimanche 18h00 et le dit.

Vous pouvez le définir à la main sous Réglages → Réinitialisation hebdomadaire. Un réglage manuel l'emporte : la détection automatique ne l'écrase pas, elle ne fait que le confirmer. Un coup d'œil s'impose après un changement d'heure si votre réinitialisation semble avoir bougé d'une heure.

La barre latérale, la carte d'activité et le calendrier

Une barre d'icônes à gauche permet de passer entre quatre pages. Depuis la version 2.0, c'est la seule mise en page — l'ancienne vue « Classic » et le réglage qui basculait entre les deux ont été supprimés.

Page	Ce qu'elle contient
Today	Trois anneaux (fenêtre 5 h, aujourd'hui, cette semaine), la carte d'activité de la semaine de facturation en cours, votre dernière action et la répartition des tokens
Calendrier	Les deux derniers mois sous forme de grilles mensuelles
Analytics	Les résumés sur 7 et N jours en tuiles KPI avec sparklines, ainsi que la répartition par modèle
Réglages	Les mêmes réglages que dans l'onglet des paramètres d'Obsidian, sans quitter la barre latérale

Tout ce qui figure sur Today provient d'aujourd'hui ou de la semaine en cours, par conception ; ce qui couvre une période plus longue se trouve sur Analytics ou dans le tableau de bord. Dans l'en-tête, Dashboard et Report génèrent des fichiers, CSV exporte dans votre vault, et la flèche actualise immédiatement.

Chacune des quatre lignes de tokens d'Aujourd'hui porte 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 réglage de rétention des données Claude, et non un nombre de jours fixe.

Carte d'activité

La grille de la page Today couvre votre semaine de facturation en cours. Une ligne par jour calendaire, une case par tranche de deux heures, douze cases par jour.

Elle compte huit lignes et non sept : une semaine allant par exemple du dimanche 18h00 au dimanche 17h59 touche huit dates calendaires, les première et dernière lignes sont donc volontairement partielles. Les cases hors de la fenêtre sont dessinées en contour vide — c'est ce qui rend visible la limite de votre cycle, au lieu de la masquer dans des tranches artificielles de 24 heures.

La couleur indique le rythme, pas le volume. Une fenêtre de 5 heures contient deux tranches et demie de 2 heures ; consommer tout le budget de façon régulière représente donc 40 % par tranche — le rythme qui vous amène exactement au mur à la fermeture de la fenêtre. Le rouge marque ce rythme ou plus rapide ; les paliers en dessous sont un quart, la moitié et jusqu'à ce rythme. La nuance au sein d'un palier indique où s'y situe exactement la valeur.

Trois sortes de vide restent distinctes : hors fenêtre (contour seul), pas encore atteint (pâle) et réellement aucune activité (plein). Seule la dernière dit quelque chose sur le déroulement de votre semaine. À côté de la grille, Jours actifs compte les jours de cette semaine de facturation avec de l'activité.

Calendrier d'activité

La page Calendrier affiche les deux derniers mois l'un sous l'autre. Deux plutôt qu'un, car en début de mois une seule grille ne montrerait qu'une poignée de jours utiles et masquerait précisément la montée en charge que l'on cherche. Les flèches déplacent la paire vers le passé, aussi loin que l'archive le permet ; le calendrier ne va jamais dans le futur.

Chaque jour passé porte une pastille colorée, pondérée par rapport à votre propre moyenne quotidienne récente : vert en dessous, ambre autour, rouge pour un pic (2× ou plus). Les jours sans activité n'ont pas de pastille. Un clic sur un jour ajoute une note privée — elle est stockée dans les réglages du plugin, jamais dans vos données de session.

Exporter vos données (CSV)

Trois fichiers CSV : la vue des projets, la matrice jour par vault et les indicateurs clés. Deux chemins pour les obtenir, et ils n'aboutissent pas au même endroit.

Bouton CSV dans l'en-tête de la barre latérale — le plugin écrit les fichiers dans votre vault, dans le dossier défini sous Réglages → Dossier d'export CSV. Le menu nomme ce dossier avant que vous cliquiez. Les mêmes exports figurent dans la palette de commandes sous « Export ».

Menu CSV Export du tableau de bord — le tableau de bord est une page web, il remet donc le fichier au navigateur, et c'est le navigateur qui décide où il atterrit, généralement votre dossier de téléchargements. Une page web ne peut pas choisir un dossier cible ; c'est une règle du navigateur, pas une fonction manquante.

Les deux chemins produisent des nombres bruts et des dates ISO, directement exploitables dans Excel, Sheets ou un script. Tout est généré localement — aucun envoi, aucun réseau, comme le reste du plugin.

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'octobre 2026 :

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

* Haiku 5.5 pour des prompts jusqu'à 100 000 tokens, au-delà $0,50 input / $2,50 output.
** Sonnet 5 a été lancé à $2 / $10 comme tarif de lancement jusqu'au 31 août 2026. Anthropic en a depuis fait le tarif standard ; la hausse annoncée à $3 / $15 n'a pas eu lieu. La version précédente de cette page disait encore le contraire.

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

• C.Write : 1,25× le prix standard de l'input du modèle pour un cache de 5 minutes, 2× pour un cache d'1 heure (le cas habituel pour Claude Code sur un abonnement)
• C.Read : 0,1× le prix standard de l'input ; 0,05× sur Opus 5.5 et Sonnet 5.5, 0,025× sur Fable 5.1

Coût et limites se calculent différemment. Les tokens de cache coûtent de l'argent selon leur propre tarif. D'après des mesures récentes, ils comptent aussi pour la limite : nettement pour les écritures de cache, peu pour les lectures. Voir Ce qui compte pour une limite.

Pourquoi les coûts s'accumulent

Une requête isolée est rarement chère. Calcul rapide avec Sonnet 5 à son tarif standard de $2 / $10 par million :

• 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 octobre 2026. Les prix peuvent changer — toujours vérifier les tarifs actuels sur le site d'Anthropic.