Utilisation des jetons de la ligne de statut du code Claude: Étiquettez chaque compteur

Une ligne d'état Claude Code fiable ne devrait pas faire tomber chaque signal d'utilisation en un seul numéro tokens. Afficher le contexte actuel, le coût cumulé de la session, le quota d'abonnement et la fraîcheur des données en tant que champs séparés. Pour les totals cumulés de jetons de session, indiquez /usage ; les champs modernes de jetons de ligne de statut ne fournissent pas ce total. Cette distinction est importante parce que le contrat officiel de terrain a changé. Depuis le code Claude v2.1.132, context window.total input tokens et context window.total output tokens décrivent le contexte actuel à partir de la réponse API la plus récente. Avant cette version, les mêmes champs étaient des totaux cumulés de sessions. Un script de ligne d'état écrit contre l'ancienne signification peut continuer à fonctionner après une mise à niveau tout en donnant silencieusement au numéro une fausse étiquette. La ligne de sécurité par défaut est la suivante: C'est moins flashy qu'une seule barre de progression. C'est aussi beaucoup plus difficile de mal lire. Donnez à chaque compteur une portée Claude Code conduit JSON à la commande statusLine configurée. Selon le documentation officielle de la ligne d'état, la commande s'exécute localement et ne consomme pas de jetons API. Il s'exécute lorsqu'une session démarre, après un nouveau message d'assistant, après /compact , lorsque plusieurs modes d'interface utilisateur changent, et sur un temporiseur de rafraîchissement optionnel. La charge utile contient plusieurs mesures qui répondent à différentes questions: La question est posée champ ou commande documenté Scope Étiquette honnête Quelle est la pleine nature du contexte actif? context window.used percentage Le contexte actuel de la dernière réponse API ctx 42% Quels sont les nombres d'entrée et de sortie dans ce contexte? context window.total input tokens , total output tokens Context actuel sur v2.1.132+ context , jamais session total Combien a coûté cette séance ? cost.total cost usd Estimation locale cumulée; réinitialisation sur /clear dans les versions actuelles $0.12 est Quels sont les totals cumulés des jetons de session ? /usage Séance actuelle du code Claude tokens use /usage Combien d'allocations d'abonnement sont consommées ? rate limits.five hour , rate limits.seven day Les fenêtres du plan roulant pour les abonnés admissibles quota 5h … · 7d … Quel est l'âge de l'observation des quotas ? Aucun timestamp dans l'objet de ligne d'état documenté Je ne sais pas. age unknown Il y a deux pièges dans cette table. Tout d'abord, used percentage est une mesure de contexte d'entrée. Claude Code le calcule à partir de nouvelles entrées, de la création de cache et des jetons de lecture de cache. Il n'inclut pas de jetons de sortie. Cela rend utile pour décider si la conversation active approche de la compaction, mais ce n'est pas un pourcentage de la durée de la session ou du quota de planification. Deuxièmement, rate limits. .resets at est le moment où une fenêtre de quotas est réinitialisée. Ce n'est pas le moment où Claude Code a obtenu le pourcentage. L'objet de ligne d'état documenté n'a pas de champ fetched at . Un temps de réinitialisation ne peut pas prouver la fraîcheur. L'écran séparé /usage a un contrat de données périmées plus fort. Le Guide officiel des coûts indique que si la demande de limite de régime est limitée, /usage peut afficher un instantané caché des 60 dernières minutes et le marquer explicitement comme la dernière utilisation connue avec son âge. La charge utile de la ligne d'état ne détermine pas un champ d'âge équivalent. Si l'âge affecte une décision, ouvrez /usage au lieu de décorer le pourcentage de la ligne d'état en direct. Configurer une ligne d'état étiquetée vérité Les éléments suivants sont conservés sous la forme de ~/.claude/usage statusline.mjs : Faites exécuter le script si votre plate forme en a besoin, puis ajoutez une ligne d'état supportée par commande à ~/.claude/settings.json : L'intervalle de rafraîchissement est facultatif. Les mises à jour basées sur des événements suffisent pour les changements de contexte. Un chronomètre est utile lorsque la session principale est inactive pendant que le travail de fond se poursuit, mais il ne rend pas les données relatives aux quotas plus fraîches que leur source. Refaire une valeur indéterminée toutes les 30 secondes laisse son âge inconnu. Ce script évite également une solution tentante mais dangereuse: ajouter context window.current usage à chaque invocation de ligne de statut pour reconstruire un total cumulé. La commande peut être exécutée pour la compression, les modifications de mode d'autorisation, les modifications de Vim et les temporisateurs, pas seulement pour les nouveaux appels API. La charge utile documentée ne fournit pas d'identifiant de demande d'API stable à côté de current usage . L'ajout répété peut donc compter la même réponse plus d'une fois. Utilisez /usage pour les jetons de session cumulés. Son bloc de session rapporte l'utilisation par modèle, y compris les entrées, sorties, lectures de cache et les totaux d'écriture de cache. Le chiffre en dollars reste une estimation locale basée sur des taux de liste standard, il peut donc être différent d'un contrat à prix réduit, d'un prix promotionnel, d'une facture de fournisseur cloud ou d'une indemnité d'abonnement. Testez la version et les chemins nuls Une ligne d'état est un code opérationnel. Testez les charges utiles inconvénientes, pas seulement un exemple peuplé copié de la documentation. L'artefact inspectable pour cet article passe trois fixations à travers le renduur: 1. Une session active moderne a 42% d'utilisation contextuelle, un coût de session estimé et les deux fenêtres de quota. 2. Une session post compaction moderne a current usage: null , des pourcentages nuls et aucun objet de quota. 3. Une session v2.1.131 a des champs de jetons dont la signification documentée précède la modification v2.1.132. Les résultats observés sont les suivants: Les trois affirmations sont passées. Plus important encore, aucun des chemins d'échec n'est devenu zéro. Ce comportement suit les limites officielles de nullité. context window.current usage peut être nul avant la première réponse API et immédiatement après /compact jusqu'à l'arrivée d'une autre réponse. Les pourcentages contextuels peuvent également être nuls au début d'une session. rate limits apparaît uniquement pour les sessions d'abonnement Claude.ai éligibles après la première réponse API, et l'une ou l'autre fenêtre peut être absente indépendamment. En présentant ces cas comme 0% , il est fait valoir trois éléments que la charge utile ne supporte pas: le contexte est vide, aucun quota n'a été consommé et la mesure est actuelle. unknown et unavailable sont plus utiles parce qu'ils disent à l'opérateur d'attendre la prochaine réponse ou de consulter /usage . Il y a une autre limite de version qui mérite d'être conservée dans l'essai. Avant la v2.1.132, les champs d'entrée et de sortie totaux étaient des totaux cumulés de séances. Dans les versions actuelles, il s'agit d'un contextuel actuel. Si le champ version manque ou est ancien, ne devinez pas quelle signification s'applique. Soit brancher délibérément pour la version déployée, soit montrer l'état sémantique comme inconnu. Savoir ce que la ligne ne peut pas prouver La ligne d'état répond à une question interactive étroite: que révèle actuellement cette session locale de Claude Code ? Elle ne prévoit pas: la facture faisant autorité pour l'utilisation de l'API ou du fournisseur de services cloud; l'activité totale provenant d'autres machines ou de claude.ai ; un progrès vérifiable ou utile; le coût par résultat d'ingénierie achevé; l'âge des données relatives aux quotas d'abonnement dans la charge utile documentée de la ligne d'état. Ces limites affectent l'action. L'utilisation élevée du contexte peut justifier l'inspection de la fonctionnalité de la conversation; cela ne signifie pas automatiquement que /compact est sûr. Un pourcentage élevé de cinq heures peut justifier la vérification de /usage ; elle ne prouve pas quel projet ou sous agent l'a causé. Une augmentation du coût estimé peut justifier la fin d'une boucle improductive; elle ne prouve pas qu'une course coûteuse a échoué. Utilisez la ligne comme routeur: les itinéraires ctx known vers une décision de contexte; session … est route les questions de facturation vers la console et les questions de jetons cumulatifs vers /usage ; les routes quota … age unknown effectuent des travaux sensibles aux limites à /usage ; les routes d'observation unknown ou unavailable , pas un verdict vert; toute réclamation selon laquelle le travail a suivi des itinéraires vers un contrôle de livrabilité séparé. Sidewisp traite le temps et le budget comme des signaux de santé en plus des progrès et des résultats, mais il ne transforme pas un contre en un verdict de santé. Sidewisp est actuellement en préversion privée. L'analyse de l'utilisation des jetons et les adaptateurs Claude Code sont un territoire produit planifié, et non une capacité de surveillance expédiée.