Notifiche quota

CLACOROO può mostrare notifiche di sistema quando una delle tue quote Claude (Session, Weekly, Weekly Sonnet) supera una soglia. Risultato: ricevi un avviso sul desktop prima di essere tagliato fuori a metà sessione, invece di scoprirlo quando una richiesta fallisce.

Le notifiche funzionano sia che tu sia loggato a claude.ai sia che usi una chiave API — la sorgente è la stessa quota che la Dashboard mostra.

Panoramica

Il pannello Notifiche vive in Impostazioni, sotto il pannello chiave API. Ha:

• Un toggle master per attivare / disattivare le notifiche quota
• Una riga per soglia (80% warning, 95% critical, 100% raggiunta), ognuna toggle-abile in modo indipendente
• Un bottone Test notifica per verificare che il tuo OS le consegni davvero
• Un selettore Frequenza aggiornamento dati per scegliere ogni quanto i dati della Dashboard vengono ricontrollati (vedi sotto)
• Una nota breve che spiega che le notifiche sono con rate-limit (una notifica per soglia ogni 12h, per evitare spam)

Cosa mostra

Soglie

Di default, CLACOROO sorveglia tre soglie per quota:

Soglia	Significato
80%	Warning — hai usato quattro quinti della quota
95%	Critical — quasi finita, pianifica di conseguenza
100%	Raggiunta — la quota è esaurita; le richieste saranno limitate fino al reset

Quando una soglia viene superata per una quota, CLACOROO lancia una notifica di sistema per combinazione quota+soglia, poi aspetta 12 ore prima di lanciare di nuovo la stessa — così una Weekly che oscilla attorno all’80% non ti spamma.

Cadenza di check (configurabile)

Quanto spesso CLACOROO aggiorna i dati lo decidi tu. Nel pannello Notifiche trovi Frequenza aggiornamento dati: scegli un intervallo da 30 secondi fino a 60 minuti, oppure Manuale per aggiornare solo quando premi il pulsante Refresh. Il primo aggiornamento parte subito all’apertura dell’app.

Questa stessa frequenza governa tutti i dati live della Dashboard, non solo le quote:

• le barre quota (Session, Weekly, Weekly Sonnet);
• la stima del contesto (token sempre attivi / on-invoke dei plugin);
• le statistiche e i KPI (plugin, skill, agent, MCP, hook…);
• Plugin per peso (context window);
• l’utilizzo di Claude Code (sessioni, messaggi, token, valore API stimato, streak, modello preferito…) e i dati per progetto.

Un’unica impostazione, niente cadenze separate da tenere allineate.

• Intervalli brevi tengono tutto più aggiornato ma usano di più l’API; intervalli lunghi (o Manuale) la usano meno.
• La frequenza scelta viene applicata subito, senza riavviare l’app.
• Se l’app è chiusa, nessun check parte — le notifiche di sistema sono legate alle app in esecuzione su tutte le piattaforme.

Se vedi la nota “Aggiornamento in pausa — l’API sta limitando le richieste”, l’API di Anthropic sta applicando un rate-limit: CLACOROO si ferma da solo e riprende più tardi. Per evitarlo, aumenta l’intervallo di aggiornamento (es. da 30 s a 5 min): meno richieste, meno probabilità di rate-limit.

Badge “Ultimo aggiornamento”

Al centro dell’header della Dashboard c’è un badge “Ultimo aggiornamento”: un contatore live in minuti e secondi (es. 1m 23s) che ti dice quanto sono recenti i dati, seguito dalla modalità attiva — “Auto ogni 30 s” (o l’intervallo che hai scelto) oppure “Manuale”. Riguarda l’intera Dashboard, non solo le quote.

• In modalità Auto il contatore si azzera puntuale a ogni aggiornamento.
• Premendo Refresh (in alto a destra) tutto si aggiorna e il contatore riparte da zero (forza un fetch reale, non la cache).
• Nel pannello Account la stessa informazione compare come riga discreta sotto le barre quota.

”Test notifica”

Un bottone che manda una notifica immediata adesso. Utile per:

• Verificare che il tuo sistema operativo abbia concesso il permesso
• Controllare che “Non disturbare” o focus mode non stiano filtrando l’app
• Vedere com’è fatta davvero la notifica sulla tua macchina

La notifica di test ha un’etichetta “test” chiara, così non la confondi mai con una reale.

Operazioni comuni

Come attivare le notifiche

1. Apri Impostazioni → Notifiche
2. Accendi il toggle master
3. (Opzionale) Spegni singole soglie se ti interessano solo, diciamo, 95% e 100% ma non 80%
4. Clicca Test notifica — se la vedi, hai finito

Come testare le notifiche

1. Clicca Test notifica nel pannello Notifiche
2. Cerca una notifica di sistema con l’icona di CLACOROO
3. Controlla anche il tuo Centro Notifiche in caso “Non disturbare” l’abbia nascosta
4. Il toast in-app si attiva sempre (“Notifica inviata — se non la vedi, controlla i permessi”) così sai che il click ha registrato

Come disattivare le notifiche temporaneamente

Usa il “Non disturbare” / focus mode del tuo sistema operativo invece di disattivare CLACOROO. Così non ti dimentichi di riaccendere i warning domani.

Suggerimenti e scorciatoie

• Le notifiche usano alert a livello di sistema (Centro Notifiche macOS, Action Center Windows, notifiche desktop Linux) — sopravvivono ai riavvii dell’app
• Il cooldown di 12 ore per soglia è per-quota: superare 80% su Session non sopprime una notifica 80% su Weekly
• Le barre quota della Dashboard e queste notifiche condividono la stessa sorgente — se la Dashboard mostra 82%, una notifica scatterebbe se hai superato 80% dall’ultimo check
• Conferma toast in-app: dopo il click su “Test notifica”, il toast in-app scatta sempre indipendentemente dal fatto che la notifica di sistema appaia. Ti conferma che il click è stato registrato.

Casi limite ed errori

• “Test notifica” ha successo in-app ma non vedo una notifica. Molto probabilmente il tuo OS la sta sopprimendo:
  • Non disturbare / Focus mode è attivo — apri il Centro Notifiche e cerca una in coda
  • Permesso notifiche negato — macOS: Impostazioni di sistema → Notifiche → CLACOROO → Consenti notifiche. Windows: Impostazioni → Sistema → Notifiche → CLACOROO. Linux: dipende dal tuo desktop environment.
  • Stile banner è Temporanee su macOS — la notifica lampeggia e va al Centro Notifiche; è lì, hai solo sbattuto le palpebre
• Ricevo troppe notifiche. Abbassa soglie (disabilita 80%) o fai affidamento solo sul 100%. O usa Non disturbare durante blocchi di focus.
• Non ricevo notifiche anche se ho superato una soglia. Controlla il toggle master e i toggle delle soglie. Se sono entrambi accesi, clicca Test notifica — se il test fallisce, è un problema di permessi OS (vedi sopra).
• Le notifiche mostrano ancora la mia vecchia email / vecchio piano. Le notifiche quota usano le informazioni account correnti, non valori in cache; se appaiono info vecchie, riavvia l’app per pulire eventuale stato stantio.

Correlati

• Account Claude — stessa sorgente quota, ma sempre visibile nel pannello
• Chiave API — le quote con l’API sono riportate allo stesso modo
• Dashboard — vedi le percentuali live senza aspettare una notifica
• Stats — la vista estesa di come sei arrivato a quelle percentuali