CommunityImagegithub.com

token-report

Générez des rapports d'utilisation des tokens Claude Code, lectures/écritures du cache, valeur de la liste API, quotas et temps de réponse à partir des transcriptions locales de Claude Code.

Qu'est-ce que token-report ?

Token-report est un outil d'analyse locale pour Claude Code qui lit les transcriptions des sessions et l'historique capturé afin de produire un rapport détaillé de l'utilisation des tokens, des opérations sur le cache, des appels API, des quotas et des temps de réponse. Il se distingue par son approche axée sur la confidentialité : il n'envoie aucune donnée, n'installe aucune dépendance et ne nécessite que Python 3.8 ou supérieur. Le rapport présente un inventaire en octets étiqueté (et non une attribution de tokens Claude), ainsi que des compteurs de qualité des données. Les options en ligne de commande permettent de filtrer par période, session, style visuel, ou de générer un fichier JSON. Il intègre automatiquement l'historique capturé car Claude Code peut élaguer les transcriptions. Le script ne lit jamais les fichiers sensibles (credentials, résultats d'outils, URLs d'images) et ne peut être utilisé pour la publication publique ; celle-ci nécessite une commande distincte (`token-share`) et une demande explicite de l'utilisateur. Token-report est donc idéal pour les développeurs souhaitant surveiller leur consommation sans compromettre leur vie privée ou celle de leurs données.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stdcmms-lang/token-counter/tree/main/plugins/token-counter-claude/skills/token-report

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Construisez un rapport local d'utilisation de Claude Code avec ce script du plugin.

Le rapport lit les transcriptions de sessions Claude Code et l'historique local capturé. Son en-tête utilise les nombres de prompts enregistrés : entrée de base plus création de cache plus lectures du cache. Sa vue de composition est un inventaire binaire UTF-8 étiqueté, et non une attribution de tokens Claude. Il n'envoie rien et n'installe aucune dépendance.

Utilisez Python 3.8 ou une version ultérieure. Sur Windows, exécutez :

python "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open

Sur macOS ou Linux, exécutez :

python3 "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open

Ajoutez uniquement les options supportées par la demande de l'utilisateur :

  • --since YYYY-MM-DD et --until YYYY-MM-DD sélectionnent les jours locaux capturés inclus.
  • --session PREFIX sélectionne une famille de sessions, y compris ses sous-agents et continuations capturés.
  • --style clinical, --style matisse ou --style nocturne sélectionne le style d'ouverture.
  • --json PATH écrit des chiffres détaillés et des compteurs de qualité des données.
  • --metrics-only ignore l'inventaire textes/octets.
  • --no-account ignore entièrement le fichier de compte.
  • --sessions-root PATH sélectionne une autre racine de transcriptions et son état local séparé.
  • --live-only affiche uniquement les transcriptions actuellement présentes ; l'historique retenu reste capturé.
  • --no-cache contourne l'index jetable.
  • --rebuild efface uniquement l'index jetable, réextrait les fichiers vivants et fusionne sans supprimer l'historique retenu.
  • --doctor vérifie les chemins, le support d'analyse et l'état local sans écrire ni envoyer.
  • --out PATH choisit la destination HTML.

Utilisez python pour toutes les variantes Windows de chaque commande et python3 pour macOS/Linux. Conservez le chemin du script entre guillemets exactement comme indiqué.

Lisez le résumé du terminal et les compteurs matériels de qualité des données avant de décrire le résultat. Lie le HTML généré et tout JSON demandé. Expliquez les mesures manquantes ou partielles. Appelez le montant en dollars « valeur de la liste API », pas dépense ou facture. Distinguez les nombres de tokens enregistrés de la composition en octets, les nombres d'images inférées et les chiffres de temps de réponse ajustés.

L'historique capturé est inclus par défaut car Claude Code peut élaguer les transcriptions. Ne prétendez pas à une utilisation complète du compte ou du calendrier. Ne videz pas l'historique pour réparer l'index.

La page locale peut nommer le compte à partir d'un e-mail autorisé ou de métadonnées d'organisation. La sortie publique et les partages omettent cette identité. L'historique ne conserve que les champs du plan du compte et la date de création de l'abonnement analysée.

Les étiquettes historiques du plan utilisent les observations de compte capturées. Le script ne fournit un plan que lorsque sa règle d'observation et la garde de création d'abonnement passent ; sinon, il utilise null. N'inventez pas d'étiquettes de plan ou de déclarations datées.

Un changement de plan qui laisse subscriptionCreatedAt inchangé n'est pas détectable avant qu'une exécution ultérieure n'observe le nouveau niveau. Une fenêtre qui s'est terminée avant cette exécution peut donc porter l'ancien plan. Le fait que cette date change lors d'une montée ou descente de version n'est pas vérifié.

N'ouvrez jamais .credentials.json, d'autres fichiers d'identifiants, des fichiers de résultats d'outils externes ou des URLs d'images. N'inspectez ni ne répétez jamais le contenu des invites, sorties, réflexions ou outils. Ne récupérez pas de prix et n'installez pas de paquets.

Pour un partage public sur tokenusage.dev, utilisez la compétence séparée token-share uniquement lorsque l'utilisateur demande explicitement de partager, publier, mettre à jour ou supprimer son utilisation publique. L'exécution de ce rapport n'autorise pas le partage.

Skills associés