Où est passée mon utilisation de Claude ? Voir l’utilisation par projet

Dernière mise à jour : 30 septembre 2026

Claude Code écrit chaque session dans un fichier sur ton ordinateur, sous ~/.claude/projects, un dossier par projet. Chaque réponse y porte ses nombres de tokens. Additionne-les par dossier et tu obtiens ton utilisation par projet — à condition de compter chaque message une seule fois, et seulement pour les 30 derniers jours, car c’est la durée pendant laquelle Claude Code garde les fichiers par défaut. Ce que tu as fait sur claude.ai ou dans les apps Claude n’y figure pas.

Cette page montre où se trouvent les chiffres, les deux pièges de l’addition et ce qu’aucun fichier local ne peut te dire. Les faits sur Claude Code viennent de la documentation d’Anthropic, listée à la fin.

Où Claude Code l’enregistre

Dans les transcriptions de session sous ~/.claude/projects, un dossier par projet et un fichier JSONL par session. Chaque réponse du modèle contient un bloc usage avec les tokens d’entrée, de sortie et de cache.

Chemin : ~/.claude/projects/<project>/<session>.jsonl. Le nom du dossier est le chemin du projet avec les barres obliques remplacées par des tirets, par exemple -Users-you-work-my-repo. Les sous-agents écrivent dans un dossier subagents/ à côté de la session.
Format : un objet JSON par ligne. Les lignes du modèle contiennent un message avec son id, le model et un bloc usage : input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens.
Texte brut : les fichiers ne sont pas chiffrés. Tout ce qui est passé par un outil s’y trouve — contenu de fichiers, sortie de commandes, texte collé.

Anthropic documente où se trouvent les fichiers et ce qu’ils contiennent, pas la structure de chaque ligne. Elle peut changer à chaque version, donc un script qui les lit doit ignorer les lignes qu’il ne connaît pas plutôt que d’échouer.

Pourquoi une simple somme est trop élevée

Claude Code peut écrire plusieurs fois la même réponse dans la transcription, par exemple pendant le streaming ou quand une session se ramifie. Compte chaque ID de message une seule fois, sinon le total sort bien trop élevé.

Le même ID de message apparaît alors sur plusieurs lignes, chacune avec un bloc usage. Garde une ligne par ID — celle qui a la plus grande sortie — et écarte les autres. Sur ma propre machine, une simple somme sortait environ 2,7 fois trop élevée. D’un fichier à l’autre, c’est pareil : une session reprise ou ramifiée peut copier d’anciennes réponses dans un nouveau fichier.

30 jours, puis plus rien

Seulement aussi loin que vont les transcriptions. Claude Code les supprime quand elles ont plus de cleanupPeriodDays, soit 30 jours par défaut. Augmente cette valeur ou garde tes propres totaux si tu veux remonter plus loin.

Le réglage : cleanupPeriodDays dans ~/.claude/settings.json, par exemple {"cleanupPeriodDays": 90}. La plus petite valeur est 1 ; 0 est refusé.
Une exception : les sessions que tu as démarrées ou poursuivies en dernier dans Claude Desktop ou Cowork sont conservées quel que soit leur âge, sauf si tu définis desktopSessionCleanupPeriodDays (Claude Code 2.1.248 ou plus récent).
Le prix : une durée plus longue garde plus de texte brut sur le disque. Si tu ne veux que les chiffres, il est plus sûr d’enregistrer les totaux ailleurs et de laisser la durée courte.

Les tokens par projet, à peu près

Après la déduplication, additionne l’utilisation par dossier de projet. Trois points rendent le résultat plus juste :

Worktrees : chaque worktree a son propre dossier. Ajoute-les au dépôt auquel ils appartiennent.
Le poids, pas seulement le nombre : un million de lectures de cache coûte bien moins qu’un million de tokens de sortie. Chiffrer chaque type aux prix catalogue de l’API donne un poids plus juste. C’est un repère, pas une facture — sur Pro ou Max, tu ne paies aucun prix par token.
Part de la fenêtre, à titre d’estimation : Anthropic ne dit pas comment les tokens se convertissent en pourcentage de ta fenêtre de 5 heures ou hebdomadaire. Toute part par projet est une estimation, et doit être présentée comme telle.

Ce qui reste invisible

Les chats sur claude.ai et dans les apps Claude ne laissent aucune transcription sur ton ordinateur. Ils puisent pourtant dans les mêmes limites de session et hebdomadaire, donc une partie de la fenêtre ne peut pas être rattachée à un projet.

Il en va de même pour Claude Code sur un autre ordinateur, pour les transcriptions déjà supprimées et pour un deuxième compte sur la même machine. Si ta fenêtre a monté plus que tes tokens locaux ne l’expliquent, c’est généralement là que le reste est passé.

Dans AI Cockpit

À partir de Mac 6.8, la fenêtre Utilisation fait ce travail pour toi. Elle montre où est passé ton quota Claude et Codex — par projet, modèle, effort et heure, jusqu’à 365 jours en arrière.

Deux mesures côte à côte : les tokens bruts et l’équivalent aux prix catalogue de l’API, présenté comme n’étant pas une facture.
Part estimée des fenêtres de 5 heures et de 7 jours, plus une carte thermique jour de la semaine × heure.
Compté une fois : les réponses sont dédupliquées par ID de message. Les worktrees comptent pour leur dépôt parent.
Au-delà des 30 jours : l’app relit ce que Claude Code conserve encore et, à partir de là, enregistre elle-même les totaux — uniquement des chiffres, stockés en local, jamais le texte de tes sessions.
Créer l’analyse enregistre un rapport HTML autonome ; export CSV aussi. Les noms de projets peuvent être anonymisés.

La fenêtre n’existe que sur le Mac ; elle lit des fichiers de la machine. Les limites elles-mêmes — à quel point chaque fenêtre est pleine et quand elle se réinitialise — sont traitées dans Suivre les limites d’utilisation de Claude.

Réponses courtes

Où Claude Code stocke-t-il mon utilisation de tokens ?

Pourquoi mon total de tokens est-il trop élevé ?

Jusqu’où puis-je remonter dans mon utilisation de Claude Code ?

Pourquoi mon utilisation de claude.ai n’apparaît-elle pas ?

Sources

Anthropic modifie souvent Claude Code ; les pages ci-dessous ont été vérifiées le 29 septembre 2026.

Explore the .claude directory — transcriptions, conservation, stockage en texte brut
Settings reference: cleanupPeriodDays
Use Claude Code with your Pro or Max plan — limites partagées