Claude Code Status Line Uso del token: etichettare ogni contatore

Una linea di stato Claude Code affidabile non dovrebbe far crollare ogni segnale di utilizzo in un numero tokens. Indicare il contesto corrente, il costo cumulativo della sessione, la quota di abbonamento e la freschezza dei dati come ambiti separati. Per i totali cumulativi di token di sessione, indicare /usage ; i campi moderni di token di linea di stato non forniscono tale totale. Questa distinzione è importante perché il contratto ufficiale sul campo è cambiato. A partire dal codice Claude v2.1.132, context window.total input tokens e context window.total output tokens descrivono il contesto attuale a partire dalla più recente risposta API. Prima di tale versione, gli stessi campi erano totali cumulativi delle sessioni. Una riga di stato scritta contro il vecchio significato può continuare a funzionare dopo un aggiornamento, dando silenziosamente al numero una falsa etichetta. Il default di sicurezza è una riga come questa: E' meno accattivante di una singola barra di progresso. E' anche molto più difficile interpretare erroneamente. Date a ciascun contatore una portata Claude Code porta JSON al comando statusLine configurato. Secondo la Documentazione ufficiale della linea di stato, il comando viene eseguito localmente e non consuma token API. Si esegue quando inizia una sessione, dopo un nuovo messaggio assistente, dopo /compact , quando cambiano diverse modalità UI, e su un temporizzatore di aggiornamento opzionale. Il carico utile contiene diverse misurazioni che rispondono a diverse domande: Interrogazione Campo o comando documentato Portata di applicazione Etichetta onesta Quanto è pieno il contesto attivo? context window.used percentage Context attuale dell'ultima risposta API ctx 42% Quali sono i numeri di input e output in questo contesto? context window.total input tokens , total output tokens Context attuale su v2.1.132+ context , mai session total Quanto costa questa sessione? cost.total cost usd Stima locale cumulativa; ripristinamento su /clear nelle versioni attuali $0.12 est Qual è il totale cumulativo dei token di sessione? /usage Attuale sessione di Claude Code tokens use /usage Quanti abbonamenti vengono consumati? rate limits.five hour , rate limits.seven day Finestre del piano di rotazione per gli abbonati ammissibili quota 5h … · 7d … Quanti anni ha l'osservazione delle quote? Nessun timestamp nell'oggetto della linea di stato documentato Non conosciuto age unknown Ci sono due trappole in quel tavolo. In primo luogo, used percentage è una misura di input context. Claude Code lo calcola a partire da nuovi input, creazione di cache e token di lettura di cache. Non include i token di uscita. Questo lo rende utile per decidere se la conversazione attiva si sta avvicinando alla compressione, ma non è una percentuale della spesa delle sessioni o della quota di pianificazione. In secondo luogo, rate limits. .resets at è il momento in cui una finestra di quota viene riposta. Non e' il momento in cui Claude Code ha preso la percentuale. L'oggetto della linea di stato documentato non ha campo fetched at . Un tempo di ripristino non può dimostrare freschezza. Lo schermo separato /usage ha un contratto di dati obsoleti più forte. Il Guida ufficiale dei costi dice che se la richiesta di limite di piano è limitata, /usage può mostrare un istantaneo memorizzato degli ultimi 60 minuti e segnarlo esplicitamente come ultimo utilizzo conosciuto con la sua età. Il carico utile della linea di stato non documenta un campo di età equivalente. Se l'età influisce sulla decisione, aprire /usage invece di decorare la percentuale della linea di stato come live. Configurare una linea di stato con l'etichetta verità Salvare come ~/.claude/usage statusline.mjs : Rendi eseguibile lo script se la tua piattaforma lo richiede, quindi aggiungi una riga di stato supportata da comando a ~/.claude/settings.json : L'intervallo di aggiornamento è facoltativo. Gli aggiornamenti basati sugli eventi sono sufficienti per i cambiamenti di contesto. Un timer è utile quando la sessione principale è inattività mentre il lavoro di fondo continua, ma non rende i dati delle quote più freschi della fonte. Ripensare un valore non datato ogni 30 secondi ne lascia ancora l'età sconosciuta. Questo script evita anche una soluzione tentante ma non sicura: aggiungere context window.current usage a ogni invocazione di linea di stato per ricostruire un totale cumulativo. Il comando può essere eseguito per la compattazione, le modifiche di modalità di autorizzazione, le modifiche di Vim e i timer, non solo per le nuove chiamate API. Il carico utile documentato non fornisce un identificatore stabile delle richieste API oltre a current usage . L'aggiunta ripetuta può quindi contare la stessa risposta più di una volta. Utilizzare /usage per i token di sessione cumulativi. Il suo blocco di sessione segnala l'utilizzo per modello, inclusi input, output, lettura in cache e totali di scrittura in cache. La cifra in dollari rimane una stima locale basata sui tassi di lista standard, quindi può differire da un contratto scontato, prezzi promozionali, una bolletta di un fornitore cloud o un'indennità di abbonamento. Provare la versione e i percorsi nulli Una linea di stato è un codice operativo. Testare i carichi utili inconvenienti, non solo un esempio popolato copiato dalla documentazione. L'artefatto ispezionabile per questo articolo riproduce tre apparecchiature attraverso il renderer: 1. Una sessione attiva moderna ha un utilizzo di contesto del 42%, un costo di sessione stimato e entrambe le finestre di quota. 2. Una moderna sessione post compazione ha current usage: null , percentuali nulli e nessun oggetto di quota. 3. Una sessione v2.1.131 ha campi di token il cui significato documentato precede la modifica v2.1.132. Il risultato osservato è stato: Le tre affermazioni sono state approvate. Ancora più importante, nessuno dei percorsi di fallimento è diventato zero. Questo comportamento segue i confini ufficiali di nullabilità. context window.current usage può essere nullo prima della prima risposta API e immediatamente dopo /compact fino a quando non arriva un'altra risposta. Le percentuali di contesto possono anche essere nulli all'inizio di una sessione. rate limits appare solo per le sessioni di abbonamento Claude.ai ammissibili dopo la prima risposta API, e entrambe le finestre possono essere assenti in modo indipendente. Rendicando tali casi come 0% , si fanno tre affermazioni che il carico utile non supporta: il contesto è vuoto, nessuna quota è stata consumata e la misurazione è corrente. unknown e unavailable sono più utili perché dicono all'operatore di aspettare la prossima risposta o di consultare /usage . C'è un altro limite di versione che vale la pena mantenere nella prova. Prima di v2.1.132, i campi di input e output totali erano totali cumulativi delle sessioni. Nelle versioni attuali, si tratta di contanti di contesto corrente. Se il campo version manca o è vecchio, non indovinare quale significato si applica. O si ramifica deliberatamente per la versione distribuita o mostra lo stato semantico come sconosciuto. Sappi cosa non può dimostrare la linea. La linea di stato risponde a una ristretta domanda interattiva: cosa espone attualmente questa sessione locale di Claude Code? Essa non stabilisce: la fattura autorizzata per l'utilizzo dell'API o del fornitore di servizi cloud; attività totale derivante da altre macchine o da claude.ai ; un progresso verificabile o utile; costi per risultato di ingegneria completato; l'età dei dati relativi alle quote di abbonamento nel carico utile della linea di stato documentato. Questi confini influenzano l'azione. L'uso di un contesto elevato può giustificare l'ispezione se la conversazione serve ancora a un compito; non significa automaticamente che /compact sia sicuro. Una percentuale elevata di cinque ore può giustificare il controllo di /usage ; non dimostra quale progetto o subagente l'abbia causato. Un costo stimato in aumento può giustificare la fine di un ciclo improduttivo; non dimostra che una corsa costosa abbia fallito. Utilizzare la linea come router: le rotte ctx known verso una decisione di contesto; session … est percorre le domande di fatturazione alla console e le domande cumulative di token a /usage ; quota … age unknown percorre un lavoro sensibile ai limiti di /usage ; le rotte di osservazione unknown o unavailable , non un verdetto verde; Qualsiasi pretesa che il lavoro abbia superato le rotte di un controllo di consegna separato. Sidewisp tratta il tempo e il budget come segnali di salute insieme ai progressi e ai risultati, ma non trasforma un conto in un verdetto sanitario. Sidewisp è attualmente in anteprima privata. L'analisi dell'utilizzo dei token e gli adattatori Claude Code sono un territorio di prodotto pianificato, non una capacità di monitoraggio spedito.