token-guard

Un plugin per Claude Code che tiene sempre in vista i tuoi limiti d'uso e, prima di esaurirli, chiude il lavoro in ordine così da riprenderlo intatto.

Cosa vedi

Sopra il prompt c'è una barra sempre presente con i limiti di 5 ore e di 7 giorni, l'orario di ogni reset, il riempimento del contesto e i token usati nella sessione, nel progetto e in totale. Il colore è verde sotto il 70%, giallo fino al 90% e rosso oltre.

Con /token-dash si apre il pannello completo, con barre, percentuale residua e data e ora di ogni reset.

Cosa succede al 90%

  1. Un limite di 5 ore o di 7 giorni raggiunge il 90%.
  2. Claude finisce solo il passo in corso, non inizia altro, salva lo stato in HANDOFF.md ed elenca cosa resta.
  3. Compare la richiesta Compatta o Più tardi.
  4. Solo dopo la tua conferma la conversazione viene compattata con un riassunto pensato per ripartire.

Comandi

ComandoCosa fa
/token-dashApre la dashboard completa
/token-wrapupAvvia subito la chiusura ordinata
/token-compactCompatta e riassume il progetto per la prossima sessione
/token-backfillImporta lo storico dei token dai transcript passati (serve Node.js)
/token-resetVerifica se esiste un reset gratuito e mostra quando si azzera ogni finestra

Installa

Serve Claude Code 2.1.292 o successivo. Nel prompt di Claude Code scrivi:

/plugin install token-guard --marketplace Notifire37/token-guard

Rispondi y per aggiungere il marketplace e scegli lo scope utente. Il plugin è attivo subito e in ogni sessione successiva.

Cosa non può fare