Limite Claude raggiunto: cosa fare e quando riprovare

Quale limite di Claude hai raggiunto

Il messaggio che indica il raggiungimento di un limite di Claude specifica la finestra temporale da attendere. È questa finestra a determinare le operazioni successive. I limiti della sessione e settimanali si applicano contemporaneamente a tutti i modelli, quindi cambiare modello non ripristina l'accesso. L'eccezione è un limite che indica un solo modello: puoi cambiare modello e continuare a lavorare mentre quel modello resta bloccato.

Claude Code mostra nella stessa riga la finestra e l'ora del ripristino:

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

La finestra della sessione ha una durata mobile di cinque ore. Le finestre settimanali si ripristinano a un'ora fissa ogni settimana, assegnata al tuo account, quindi il giorno e l'ora restano uguali da una settimana all'altra. Un piano Pro include la finestra della sessione di cinque ore e un limite settimanale applicato a tutti i modelli. Un piano Max aggiunge un secondo limite settimanale applicato separatamente a una famiglia di modelli. I limiti numerici sono riportati nella panoramica completa dei limiti di utilizzo di Claude. Questa pagina parte dal punto in cui quella panoramica termina.

Questo è l'aspetto che spesso crea confusione. Ogni richiesta viene conteggiata contemporaneamente nella finestra della sessione e in quella settimanale, quindi un pomeriggio con un uso intenso può esaurire la quota settimanale mentre nella finestra di cinque ore è ancora disponibile capacità. Controlla l'ora del ripristino prima di pianificare il resto della giornata. Un ripristino alle 3:45pm equivale a una pausa caffè. Un ripristino lunedì a mezzanotte è un'altra cosa.

Controlla il consumo prima di fare ipotesi

Su claude.ai, apri Settings e quindi Usage. Le barre di avanzamento mostrano quanto hai consumato della finestra di sessione di cinque ore e di ciascuna finestra settimanale. Puoi così capire quale finestra è esaurita, senza procedere per ipotesi.

In Claude Code, esegui /usage. Il comando mostra le stesse barre relative al piano e una suddivisione dell'utilizzo recente, attribuita a skills, subagents, plugins e singoli server MCP (model context protocol), espressa come percentuale del totale. Premi d per visualizzare le ultime 24 ore e w per gli ultimi 7 giorni. Vengono inoltre segnalati i pattern che rappresentano almeno il 10% dell'utilizzo recente. I due pattern più comuni sono il contesto lungo e i cache miss.

Sono presenti due limitazioni. La suddivisione viene calcolata sulla cronologia delle sessioni memorizzata su quel computer. Di conseguenza, non include il lavoro svolto su un altro laptop o su claude.ai. Inoltre, l'importo in dollari nel blocco Session, in alto, viene calcolato usando le tariffe standard di listino per gli utenti dell'API (application programming interface). Se usi un abbonamento, quindi, non corrisponde all'importo della tua fattura.

Il passaggio a un modello più piccolo è utile?

Solo quando il messaggio specifica un modello. Dopo You've hit your Opus limit, esegui /model, seleziona Sonnet o Haiku e la sessione continua mantenendo tutto il contesto. Dopo You've hit your session limit o You've hit your weekly limit, /model non cambia nulla, perché queste finestre sono condivise da tutti i modelli.

Il passaggio è molto più utile prima di raggiungere il limite che dopo. Sonnet gestisce la maggior parte delle attività di sviluppo a una frazione del costo di Opus. Lasciare Opus come modello predefinito è quindi una delle due abitudini all'origine della maggior parte dei consumi imprevisti. L'altra è una sessione che non viene mai azzerata. Affida a Haiku le modifiche meccaniche e l'analisi preliminare dei log. Conserva Opus per la decisione progettuale su cui sei realmente bloccato. Scegliere tra Opus, Sonnet e Haiku spiega in quali casi ciascun modello giustifica il proprio costo.

Smetti di pagare per il contesto che non usi più

Claude Code invia l'intera conversazione con ogni richiesta e, ogni volta che Claude usa uno strumento, invia un'altra richiesta contenente quel blocco di risultati dello strumento. Il prompt caching fa rileggere la cronologia alla tariffa della cache invece che alla tariffa dell'input completo, quindi riduce i costi, ma non li azzera. Di conseguenza, anche una domanda di una riga in una sessione lasciata aperta dalla mattina continua a consumare risorse per l'intera conversazione.

/context
/clear
/compact Focus on the failing tests and the files we changed

/clear non costa nulla, perché elimina il contesto invece di leggerlo. /compact deve leggere la conversazione che riassume, quindi compattare un contesto molto grande è a sua volta una richiesta di grandi dimensioni. Usa /clear quando passi a un'attività non correlata e /compact solo quando sei nel mezzo di un'attività e devi mantenere il contesto. Esegui /rename prima di cancellare il contesto, così potrai ritrovare la sessione con /resume.

La durata della cache è più importante di quanto molti si aspettino. Con un abbonamento, la cache rimane disponibile per un'ora. Scende a cinque minuti quando utilizzi i crediti di consumo, e cinque minuti è anche il valore predefinito per una API key. Il primo messaggio dopo una lunga pausa non trova la cache e rielabora l'intero contesto alla tariffa completa dell'input. Per questo il consumo aumenta spesso senza una ragione visibile. Quando il prompt caching diventa conveniente illustra i calcoli.

Nella stessa area sono disponibili altri tre strumenti di ottimizzazione. /mcp elenca i server configurati, così puoi disattivare quelli non necessari per l'attività corrente. Un file CLAUDE.md lungo viene caricato all'avvio della sessione, indipendentemente dal fatto che l'attività ne abbia bisogno; sposta quindi le istruzioni specializzate nelle skills, che vengono caricate solo quando vengono invocate. Inoltre, il extended thinking viene conteggiato come token di output, cioè la parte più costosa: riducilo con /effort, disattivalo in /config oppure imposta MAX_THINKING_TOKENS=8000 su un modello con un budget di thinking fisso.

Suddividi il lavoro in modo che rientri in una sola finestra

Premi Shift+Tab per passare alla modalità di pianificazione prima di apportare una modifica estesa. Claude analizza la codebase e propone un approccio da approvare. Se in questa fase individui una direzione errata, il costo è un piano invece di due ore di modifiche e del relativo rifacimento.

Assegna le operazioni che producono molto output ai subagent. L'esecuzione di una suite di test o la lettura di un log di 10,000 righe all'interno di un subagent mantiene l'output grezzo nel contesto di quel subagent. Nella conversazione principale viene restituito soltanto il riepilogo.

Premi Escape non appena Claude prende una direzione errata. /rewind ripristina sia la conversazione sia il codice a un checkpoint precedente, evitando di dover annullare lavoro che non avevi richiesto.

Acquistare crediti per l'utilizzo o usare l'API?

I crediti per l'utilizzo consentono a un account Pro o Max di continuare a funzionare oltre il limite previsto dal piano, con addebito alle tariffe API standard. Attivali in Settings, quindi Usage, su claude.ai dopo aver associato un metodo di pagamento, oppure esegui /usage-credits in Claude Code: il comando apre nel browser le impostazioni di fatturazione. I crediti si applicano alle conversazioni Claude e all'utilizzo del terminale Claude Code, con un limite giornaliero di riscatto di $2000. Il comando richiede un accesso tramite abbonamento, quindi non è disponibile quando esegui l'autenticazione con una API key.

L'alternativa consiste nell'usare una semplice API key dalla Claude Console, con addebito per token e senza alcuna finestra di sessione o settimanale. Esiste però un rischio: una ANTHROPIC_API_KEY presente nell'ambiente indirizza Claude Code tramite quella key invece che tramite l'abbonamento, senza indicarlo. Te ne accorgi dalla fattura oppure con questo comando:

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

Quel 429 indica il rate limit applicato alla key, non al piano. Esegui /status e verifica che la credenziale attiva sia quella prevista.

Quanto costa un pomeriggio di utilizzo dell’API?

L’esempio seguente mostra un pomeriggio di coding con agenti: 200,000 token di input non memorizzati nella cache, 1.8 milioni di letture dalla cache e 150,000 token di output. I prezzi sono quelli pubblicati da Anthropic ad agosto 2026.

[
  {
    "label": "Opus 5",
    "input_usd_per_mtok": 5,
    "cache_read_usd_per_mtok": 0.5,
    "output_usd_per_mtok": 25,
    "afternoon_usd": 5.65
  },
  {
    "label": "Sonnet 5",
    "input_usd_per_mtok": 2,
    "cache_read_usd_per_mtok": 0.2,
    "output_usd_per_mtok": 10,
    "afternoon_usd": 2.26
  },
  {
    "label": "Haiku 4.5",
    "input_usd_per_mtok": 1,
    "cache_read_usd_per_mtok": 0.1,
    "output_usd_per_mtok": 5,
    "afternoon_usd": 1.13
  }
]

Lo stesso pomeriggio costa $5.65 con Opus 5 e $1.13 con Haiku 4.5. È l’output a incidere maggiormente sul totale: a $25 per milione di token con Opus 5, contro $5 con Haiku 4.5, i 150,000 token generati da Claude costano più dei 2 milioni di token letti. Per questo ridurre il budget di ragionamento fa risparmiare più che ridurre i file.

È importante considerare una data. Sonnet 5 applica prezzi introduttivi di $2 e $10 per milione di token di input e output fino al 31 agosto 2026. Dal 1 settembre 2026 i prezzi passano a $3 e $15. Il costo dello stesso pomeriggio passa quindi da $2.26 a circa $3.39.

Per avere un riferimento, la documentazione di Anthropic indica una spesa media per Claude Code di circa $13 per sviluppatore al giorno di attività nelle installazioni aziendali e inferiore a $30 per giorno di attività per il 90% degli utenti, ad agosto 2026. La fatturazione a consumo per token non è automaticamente più economica di un abbonamento. È vantaggiosa quando il carico è discontinuo, perché le giornate senza attività non hanno costi, ma lo è meno quando si lavora ogni giorno. Il confronto tra API e abbonamento, con numeri reali mostra il punto di pareggio.

Esegui il job lungo su un VPS durante la notte

Alcuni job non richiedono supervisione: un refactoring esteso, una migrazione di test o una revisione completa della documentazione. Questi job non devono neppure consumare la finestra del tuo abbonamento. Eseguili su un VPS (virtual private server) con una API key: useranno la fatturazione a consumo per token, mentre la quota del piano resterà disponibile per il lavoro interattivo del giorno successivo.

Installa Claude Code su un server Ubuntu e verifica che sia in esecuzione:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version dovrebbe stampare una stringa di versione come 2.1.211 (Claude Code). Un command not found in questo punto indica che ~/.local/bin non è ancora presente nel tuo PATH; apri quindi una nuova shell e riprova.

Inserisci la chiave in un file invece di lasciarla nella cronologia della shell. Crea ~/.claude-env con un editor e inserisci una sola riga, export ANTHROPIC_API_KEY=sk-ant-your-key-here, quindi limita i permessi del file e caricalo:

chmod 600 ~/.claude-env
. ~/.claude-env
printenv ANTHROPIC_API_KEY | cut -c1-10

L'ultima riga stampa i primi dieci caratteri. È sufficiente per verificare che la variabile sia impostata senza visualizzare l'intera chiave.

Ora avvia il job all'interno di tmux, in modo che continui a essere eseguito anche quando chiudi il laptop:

tmux new -s overnight
claude --bare -p "Convert every test under ./tests from unittest to pytest, run the suite, and fix what fails" \
  --allowedTools "Read,Edit,Bash" \
  --append-system-prompt-file ./CLAUDE.md \
  --output-format json > ~/overnight.json

Scollegati con Ctrl-b e poi d, quindi chiudi la connessione. Puoi ricollegarti in seguito con tmux attach -t overnight. Claude Code in una sessione tmux su un VPS descrive in dettaglio la gestione delle sessioni.

--bare è importante in questo caso. Disabilita l'auto-discovery di hook, skill, plugin e CLAUDE.md e non legge mai le credenziali OAuth. L'esecuzione usa quindi la API key e nient'altro. In questo modo il job non consuma la quota dell'abbonamento. Significa anche che le regole del progetto non vengono caricate; per questo --append-system-prompt-file le fornisce esplicitamente. Senza --bare, un ANTHROPIC_API_KEY impostato attiva una richiesta di approvazione una tantum a cui un'esecuzione non interattiva non può rispondere.

Al mattino, leggi il risultato e il costo dal JSON:

jq -r '.result' ~/overnight.json
jq -r '.total_cost_usd' ~/overnight.json

Claude Code termina con codice 0 in caso di successo e con un codice diverso da zero se l'esecuzione non riesce. Uno script wrapper può quindi verificare lo stato di uscita e inviarti un'email in caso di errore. Prima di lasciare il job in esecuzione, imposta un limite di spesa per lo workspace nella Claude Console: un agent in un ciclo di retry alle 3 del mattino può generare una spesa reale. Riduci CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY se vuoi anche rallentare l'esecuzione. Controllo dei costi per gli agent lasciati in esecuzione illustra i limiti che conviene impostare per primi.

Assegna al job un utente non privilegiato dedicato e un branch Git separato. Un agent che modifica un repository senza supervisione può occasionalmente eseguire un'azione che avresti interrotto; un branch trasforma questo caso in un git checkout invece che in un incidente. Eseguire in sicurezza un coding agent su un VPS descrive l'isolamento.

Per il lavoro di massa completamente non interattivo, ad esempio la classificazione di migliaia di record, la Batch API elabora le richieste in modo asincrono con uno sconto del 50% sia sui token di input sia su quelli di output. È il percorso con il costo per token più basso pubblicato da Anthropic e una finestra notturna offre esattamente la latenza richiesta.

Cosa non ripristina l'accesso

Avviare una nuova conversazione non ripristina la quota disponibile. L'utilizzo viene conteggiato sul tuo account, non sulla singola conversazione. Tuttavia, ogni messaggio successivo costa meno, perché una conversazione nuova non contiene una cronologia da rileggere. Per questo conviene comunque farlo. Riduce i costi, ma non esegue un reset.

Eliminare le conversazioni precedenti non restituisce nulla. I token sono stati consumati quando le conversazioni sono state elaborate.

Cambiare modello dopo aver raggiunto il limite della sessione o dei messaggi settimanali non serve, perché queste finestre sono condivise da tutti i modelli. Solo un messaggio che specifica un modello risponde a /model.

Riprovare in un ciclo non serve e mantiene occupato il terminale. L'orario di reset mostrato nel messaggio è l'informazione corretta, mentre /usage mostra lo stesso orario senza l'errore.

FAQ

Tra quanto tempo si reimposta il mio limite Claude?

Il messaggio indica il momento. I limiti della sessione seguono una finestra mobile di cinque ore e il messaggio mostra un orario, ad esempio resets 3:45pm. I limiti settimanali si reimpostano ogni settimana a un orario fisso assegnato al tuo account e il messaggio mostra il giorno, ad esempio resets Mon 12:00am. Per visualizzare entrambe le barre e i relativi orari di reimpostazione prima di raggiungere il limite, esegui /usage in Claude Code oppure apri Settings e quindi Usage su claude.ai.

Passare a Sonnet mi permette di riprendere il lavoro?

Solo quando il messaggio indica un modello. Dopo You've hit your Opus limit, esegui /model, scegli un modello diverso e la sessione continua mantenendo il contesto. Dopo You've hit your session limit o You've hit your weekly limit, la scelta del modello non cambia il risultato, perché queste finestre conteggiano insieme tutti i modelli. Passare a un modello più economico prima di raggiungere il limite è il modo effettivo per prolungare la finestra.

Avviare una nuova chat reimposta il mio limite di utilizzo?

No. L'utilizzo viene conteggiato sul tuo account, quindi una nuova chat parte dallo stesso margine residuo. Tuttavia, ogni messaggio successivo costa meno, perché una nuova conversazione non contiene una cronologia che Claude debba rileggere. /clear in Claude Code esegue la stessa operazione e non ha costi, mentre /compact deve leggere la conversazione che riepiloga. Di conseguenza, compattare una sessione molto grande è già una richiesta costosa.

L'API costa meno rispetto all'upgrade del piano?

Dipende dalla regolarità dell'utilizzo. L'attività pomeridiana descritta in questa pagina costa $2.26 con Sonnet 5 e $1.13 con Haiku 4.5, alle tariffe di listino di agosto 2026. Un abbonamento è un costo fisso per un margine di utilizzo limitato, quindi conviene quando lavori quasi ogni giorno. La fatturazione per token conviene quando il carico è variabile, perché nei giorni senza utilizzo non paghi nulla.

Posso lasciare un'attività in esecuzione mentre attendo la reimpostazione?

Sì, se la sposti fuori dal tuo abbonamento. Eseguila su un VPS con ANTHROPIC_API_KEY impostato nell'ambiente: verrà fatturata per token invece di utilizzare la finestra del piano, quindi i due utilizzi non entrano mai in concorrenza. claude --bare -p all'interno di tmux sopravvive alla chiusura del laptop e --output-format json scrive un campo total_cost_usd che puoi controllare al mattino con jq.