Token Weather in Claude Code: leggere la finestra di contesto

Token Weather è una demo ufficiale di Claude Code Mods che rende visibile l’occupazione della finestra di contesto. Disegna una banda sopra il prompt con percentuale, token usati e un andamento dei turni. Per capire la query «Claude Code Token Weather context window» la distinzione essenziale è questa: misura il contesto, non il costo totale né la correttezza di ciò che Claude ricorda. README ufficiale Token Weather.

Le fonti sono verificate il 9 ottobre 2026. Qui trovi una guida alla lettura della demo, senza attribuire a Giallo screenshot o esperimenti Anthropic. Se non conosci ancora il rapporto fra modello e contesto, parti da cosa sono i token AI e dal confronto sulla finestra di contesto.

Quale problema risolve un indicatore del contesto?

Durante una sessione lunga è facile perdere il senso di quanto materiale è stato accumulato. Il team legge file, discute alternative e aggiunge output. Un indicatore aiuta a collegare questi passaggi a un dato osservabile. Non deve però diventare una diagnosi automatica: un contesto ampio può essere pertinente, mentre uno piccolo può già contenere informazioni confuse.

La decisione utile è quale materiale serve alla prossima attività. Se stai terminando una review circoscritta, non devi necessariamente cambiare sessione solo perché la banda cresce. Se hai concluso una fase e stai aprendo un tema diverso, conviene preparare un riepilogo verificato e scegliere il percorso adatto. Il grafico informa questa scelta, ma non la prende al posto del responsabile.

Questa è una buona ragione per conoscere cosa sono i Mods: Token Weather aggiunge una rappresentazione a un dato dell’ambiente. Non allena il modello, non cambia la finestra disponibile e non garantisce che tutte le informazioni siano usate con lo stesso peso. Un buon utilizzo resta legato a obiettivi chiari e materiale pertinente.

Percentuale della finestra e soglia di compaction: perché differiscono?

Due percentuali possono entrambe essere coerenti se hanno denominatori differenti. Il README specifica che Token Weather considera la finestra completa, mentre l’avviso interno di Claude Code può riferirsi al punto di auto-compaction. Non è corretto definire una delle due misure sbagliata soltanto perché il numero è diverso. Limiti dichiarati della demo.

Un esempio puramente aritmetico chiarisce il principio. Immagina 60 unità di materiale: rispetto a un contenitore da 100 sono il 60%; rispetto a una soglia operativa da 80 sono il 75%. Non sono valori reali misurati su Claude Code e non descrivono la sua soglia effettiva. Mostrano soltanto perché un numero senza denominatore non basta per confrontare due indicatori.

Quando annoti un dato per il team, scrivi quindi «percentuale della finestra» oppure «percentuale rispetto alla soglia mostrata dal prodotto», evitando la sola parola «uso». La stessa disciplina vale nelle conversazioni sui costi: input, output, cache e occupazione del contesto non sono una singola grandezza. Un grafico leggibile non elimina queste differenze.

Come leggere le barre della storia dei turni?

Il grafico relativo serve a rendere visibile una variazione anche quando i valori assoluti sono ancora bassi. Nel README le barre sono scalate rispetto al turno più pieno tra quelli rappresentati. La barra più alta può quindi apparire grande senza indicare una finestra quasi piena. Per capire l’occupazione usa la percentuale, per capire l’andamento guarda la sequenza.

Se una barra cresce dopo aver letto un file, puoi formulare un’ipotesi sul contributo di quel materiale. Per dimostrarla devi però conoscere le altre operazioni del turno. Un turno può includere messaggi, risultati e altre letture. Il dato aggregato non separa automaticamente ogni causa. Questa cautela è utile per evitare di accusare un documento o una funzione senza aver osservato il resto del lavoro.

Inoltre, una variazione non è necessariamente un problema. Può rappresentare proprio il materiale necessario per il task. Il criterio di qualità è la pertinenza: quali parti serviranno a produrre o verificare il risultato? Una riduzione del numero ottenuta eliminando requisiti essenziali peggiora il processo, anche se il grafico appare più tranquillo.

Quando viene aggiornato il dato?

La demo documenta una lettura all’avvio e dopo i turni del ciclo principale, saltando i turni dei subagent. La banda non si aggiorna continuamente durante il turno. Prima della prima risposta il dato può essere zero perché non è ancora disponibile l’uso riportato. La Mods API descrive l’accesso ai dati di sessione usato da queste personalizzazioni.

Per l’utente questo significa riconoscere la cadenza. Durante un’operazione lunga non assumere che il numero sia stato appena aggiornato. Attendi il punto previsto, poi confronta rilevazioni equivalenti. Una schermata presa a metà del turno e una alla fine possono descrivere istanti diversi; non sono una base corretta per un confronto di produttività.

Se realizzi un indicatore tuo, considera di spiegare quando il dato è stato letto. La domanda «è aggiornato?» spesso conta più della precisione apparente di una cifra. La guida al primo mod TypeScript aiuta a trasformare questa esigenza in un requisito piccolo, con stato e comportamento di reload espliciti.

Dove appare Token Weather e cosa controllare prima della prova?

Il README richiede il terminale per la banda AbovePrompt e indica Claude Code 2.1.287 o successiva come percorso d’uso. Le prove su build precedenti riportate dall’autore restano prove di quel README, non un requisito consigliato per una nuova adozione. La gallery Mods offre componenti di UI, ma i suoi frammenti non sono automaticamente plugin completi.

Controlla quale banda occupano altre personalizzazioni. Uno spazio condiviso può produrre competizione fra indicatori: se il componente manca, potrebbe non esserci un problema nei dati. Il percorso di diagnosi dei Mods distingue codice non caricato, UI non supportata e conflitti di presentazione.

Prima di caricare una demo esamina la fonte e valida il pacchetto. Segui poi una prova per una sessione con materiale controllato, senza utilizzare documenti aziendali sensibili soltanto per far salire il grafico. La guida a installazione e aggiornamento spiega scope e copia attiva. Non è necessario installare tutte le demo del playground per valutarne una.

Perché il grafico non è una memoria del progetto?

La storia della demo è temporanea: il README documenta il reset all’avvio o al reload. Non è un archivio delle fasi né una prova del contenuto conservato. Se dopo una ricarica la sequenza è scomparsa, non dedurre che il modello abbia perso nello stesso modo tutte le istruzioni. Stato del mod, contesto del modello e file del progetto sono livelli distinti.

Il riepilogo di una fase dovrebbe contenere decisioni, file coinvolti, verifiche e lavoro ancora da completare. La banda non può sostituirlo perché non conosce quel significato. Per progetti documentali, la guida a Claude per documenti lunghi aiuta a impostare sezioni e domande; per lo sviluppo serve una traccia coerente con il repository.

Il grafico è sparito dopo il reload: cosa è davvero cambiato?

Controlla prima se è stato azzerato soltanto lo stato temporaneo della demo. Verifica poi sessione, istruzioni del progetto e materiale necessario al task attraverso i rispettivi strumenti. Non usare l’assenza della storia visiva per dichiarare perduto il contesto o per ricostruire una cronologia che non è stata registrata.

Come annotare una rilevazione confrontabile?

Se vuoi discutere l’andamento con il team, accompagna il dato con una nota: sessione osservata, modello o finestra di riferimento, punto del turno e attività pertinente. Non occorre conservare tutti i contenuti letti. Serve poter distinguere un cambio di denominatore, un reset della storia e un incremento avvenuto dopo un lavoro diverso. Due screenshot senza questo contesto possono sembrare un confronto anche quando descrivono condizioni incompatibili.

Mantieni inoltre coerente il punto di osservazione. Una nota dopo il turno e una durante il lavoro non vanno usate come se fossero due letture equivalenti. La cadenza dichiarata della demo deve accompagnare il confronto.

Definisci inoltre il motivo della rilevazione. Se cerchi ridondanza, controlla il materiale ripetuto. Se cerchi una fase da separare, controlla quali requisiti devono passare al prossimo task. Non trasformare la percentuale in un voto al collega o al modello. Il dato riguarda una risorsa del workflow e va letto insieme all’obiettivo. Una nota minima permette di discuterne senza attribuire all’indicatore precisioni che non offre, mantenendo la prova utile e la raccolta dei dati proporzionata.

Due scenari ipotetici per leggere il dato senza forzarlo

Esempio ipotetico: uno studio tecnico di Bergamo prepara una funzione per leggere capitolati. Gli sviluppatori usano documenti sintetici e una domanda circoscritta. Dopo ogni fase guardano la rilevazione per capire quanto materiale hanno introdotto. Non puntano a una percentuale minima: verificano che le clausole necessarie siano presenti e che il risultato richiami la fonte corretta.

Una crescita marcata li porta a riesaminare il metodo. Hanno caricato l’intero fascicolo quando bastava una sezione? Hanno aggiunto output ripetuto? La risposta deve venire dai passaggi osservati, non dal simbolo meteorologico. Se scelgono una selezione più piccola, ricontrollano che non manchi una condizione importante. Il grafico aiuta a porre la domanda, mentre il documento conferma la scelta.

Esempio ipotetico: un e-commerce di Brescia modifica un’integrazione del gestionale. Una sviluppatrice legge file, verifica dipendenze e poi apre un problema diverso. L’indicatore mostra che la sessione sta accumulando materiale. Prima di continuare prepara una nota con branch, decisioni e controlli già eseguiti. Decide poi se proseguire o aprire una fase distinta.

Un collega riprende il lavoro dopo un reload e non trova la storia del grafico. Usa la nota e il diff, senza interpretare l’assenza come prova che nulla sia stato fatto. Se vuole conoscere la sequenza delle edit, valuta Replay Theater, sapendo che anche quel componente ha confini propri. Ogni rappresentazione risponde a una domanda diversa.

Quali interpretazioni sono sbagliate?

Una percentuale elevata non dimostra un errore del modello. Può indicare materiale utile o ridondante: devi esaminarlo. Una barra alta non significa esaurimento. La scala è relativa. Un valore basso non garantisce memoria perfetta. Il dato non certifica comprensione e richiamo di ogni requisito. La scomparsa del grafico non cancella il repository. È un evento dello stato della demo.

Un altro errore è promettere risparmio. Il README spiega che il mod non chiama un modello e che la sua lettura senza breakdown non genera una richiesta di conteggio token; questo non descrive il prezzo del lavoro nella sessione. Per discutere consumi serve distinguere le operazioni e usare la guida ufficiale ai costi, senza ricavare euro da un indicatore meteorologico.

Come usare Token Weather nel workflow del team?

Decidi una sola domanda operativa: riconoscere quando stai accumulando materiale poco pertinente, confrontare fasi del task o rendere visibile il riferimento del dato. Spiega ai colleghi denominatore, cadenza e reset. Una legenda breve accanto al percorso di adozione evita che persone diverse usino la stessa percentuale con significati incompatibili.

Quando valuti la prova, osserva se l’indicatore aiuta una decisione reale. Se tutti lo guardano ma nessuno cambia un passaggio o chiarisce un dubbio, forse occupa spazio senza un beneficio definito. Puoi disattivarlo e conservare il metodo di selezione del contesto. La prova rimane utile se produce una scelta motivata, anche quando non porta all’adozione della demo.

Per progettare strumenti che mostrino dati comprensibili nel tuo workflow, la consulenza AI di Giallo può partire dalle decisioni del team e dalle informazioni necessarie. Le guide a Claude Code e ai Mods aiutano a scegliere se basta l’indicatore ufficiale o serve una personalizzazione diversa.