Limiti di Claude Code nel 2026: 8 regole per non esaurire i token

Documentazione di riferimento di Ailoot: ailoot.ai/docs/.

Come funzionano i limiti di Claude Code nel 2026 e perché li raggiungi?#

Al 20 maggio 2026, i piani Claude Code a pagamento funzionano così:

Dati dalla pagina ufficiale di Anthropic. Oltre alla finestra di 5 ore, c'è anche un limite settimanale, che per gli utenti intensivi inizia a farsi sentire verso venerdì.

Cos'è stato il raddoppio del 6 maggio?

Alla conferenza Code with Claude SF del 6 maggio 2026, Anthropic ha annunciato un accordo con SpaceX Colossus 1: 220,000 schede grafiche NVIDIA, 300 MW di capacità, online entro un mese. Subito:

• I limiti di 5 ore sono raddoppiati per tutti i piani a pagamento.
• È stato rimosso il limite giornaliero nelle ore di punta, che in precedenza riduceva le quote durante le ore di punta.
• Per l'API: i token di input massimi al minuto per Opus sono saliti da 30K a 500K (+1500%) e quelli di output massimi da 8K a 80K.

È attiva un'altra promozione temporanea dal 13 maggio al 13 luglio: +50% ai limiti settimanali per Pro / Max / Team. Dopo il 13 luglio, le quote settimanali torneranno ai livelli precedenti.

Quanto usa davvero un vibe coder?

Anthropic fornisce dati di riferimento nella documentazione ufficiale:

• Gli sviluppatori spendono in media $13 / giorno, $150-250 / mese.
• Il 90% degli utenti rimane entro $30 / giorno.
• I team di agenti in Plan Mode consumano circa 7 volte più token di una sessione standard.

La dimensione della finestra di contesto dipende dal modello. Secondo la documentazione di Anthropic, a settembre 2026 Opus 4.7 e successivi, Sonnet 5 e i modelli Fable hanno una finestra di 1M token con qualsiasi piano, incluso Pro, e la compattazione automatica (auto-compact) si attiva per impostazione predefinita intorno a 967K. Opus 4.6 e Sonnet 4.6 senza contesto esteso hanno una finestra di 200K e la compattazione si attiva al limite di 200K. Puoi impostare la tua soglia con il comando /autocompact, per esempio /autocompact 500k. Quando ammassi mezza giornata di lavoro in un'unica chat, il contesto si gonfia, Claude perde il filo, inizia a rileggere gli stessi file e i token si consumano da 1,5 a 2 volte più velocemente.

Nell'esperienza descritta dall'autore, l'abbonamento da $200 basta grazie alle 8 regole illustrate di seguito. Senza di esse, anche Max 20x si esaurisce entro l'ora di pranzo.

Regola 1. Perché «un'attività, una conversazione» fa risparmiare più token?#

La regola non significa «aprire 5 chat in parallelo», ma proprio «non raschiare la chat precedente per usarla per l'attività successiva».

Nell'approccio descritto, funziona così. A ogni messaggio, Claude vede non solo la nuova richiesta, ma anche l'intera conversazione precedente. Se al mattino hai discusso di una landing page, poi sei passato a una campagna email e infine gli hai chiesto di correggere un'istruzione per un workshop, al momento della terza richiesta tutta la cronologia è inclusa nel contesto. I token vengono spesi per «ricordare la landing page», anche se tu te ne sei già dimenticato.

Perché funziona «svuotare la mente»?

Chiudi la chat non appena l'attività è terminata. Non si tratta nemmeno di token: è un modo per liberare l'attenzione.

Se l'attività è davvero finita, non tenere aperta la chat «nel caso ci torni». Aprine una nuova. Puoi ritrovare quella vecchia con claude --resume o /resume usando un indicatore qualsiasi (nome del branch, ID della PR, tag).

Cosa fare se un'attività si protrae per due giorni?

Se l'attività deve davvero continuare, non lasciare la chat «in sospeso». Prima di chiuderla, chiedi a Claude di scrivere un prompt per una chat vicina (vedi la Regola 7). Questo comprime 50K token di cronologia in un prompt di 500 token e domani la nuova chat riprende il contesto senza dover riscrivere tutto.

Regola 2: mantieni CLAUDE.md entro 200 righe, non 500#

CLAUDE.md è il primo file che Claude legge quando avvia una nuova sessione. Questa sezione riguarda specificamente il risparmio di token.

Quante righe sono normali?

Perché un CLAUDE.md lungo rende l'agente meno intelligente?

La spiegazione è semplice: /init descrive il repository «al modello», aggiungendo al contesto informazioni che il modello già conosce o può scoprire da solo osservando la struttura a colpo d'occhio. Questa duplicazione consuma token e sfoca la concentrazione.

La regola della densità: ogni parola cambia il comportamento

Se posso rimuovere una riga da CLAUDE.md e il comportamento di Claude non cambia, quella riga è superflua. Usa questo test:

1. Apri CLAUDE.md e passa in rassegna ogni paragrafo.
2. Chiediti: «Se lo rimuovo, Claude inizierà a commettere errori?»
3. Se no, eliminalo o spostalo in una Skill.

Tutte le regole che si applicano solo in situazioni specifiche vanno nelle skills (.claude/skills/<name>/SKILL.md). CLAUDE.md serve solo per ciò che è necessario sempre.

Regola 3. Perché tenere il piano Claude Code in un file separato?#

Plan Mode è una modalità di Claude Code attivata con Shift+Tab. In questa modalità Claude esplora la codebase, legge file e fa domande prima dell’implementazione. Nel flusso seguente separa le modifiche al repository: rivedi il piano, poi salvalo manualmente in plans/ oppure esci esplicitamente da Plan Mode e autorizza quel file prima di aprire una nuova chat.

Perché un piano in un file è più solido di un piano nella testa di Claude?

Ho una cartella plans/ in ogni progetto. Quando inizio un'attività:

1. Chiedo a Claude in Plan Mode di esplorare e suggerire un approccio.
2. Rivedo il piano e salvo personalmente il testo in plans/YYYY-MM-DD-task-name.md; in alternativa esco da Plan Mode e autorizzo Claude a scriverlo. Verifico il contenuto prima di chiudere la chat.
3. Chiudo la chat.
4. In una nuova chat dico: «leggi plans/YYYY-MM-DD-...md e implementa la fase 1».

Cosa ottengo:

• Il piano è fissato: Claude non «dimentica» ciò che abbiamo deciso un'ora prima.
• Posso modificare il piano a mano: vedo 5 passaggi, capisco che il terzo non serve, lo elimino e procedo.
• Il piano sopravvive al riavvio: torno domani, apro il file e continuo.
• Posso affidarlo agli agenti in sequenza: una chat scrive il piano, un'altra lo implementa, una terza lo revisiona.

Plan Mode non interrompe la cache

Un dettaglio importante: Plan Mode invalida solo la cache della conversazione (i messaggi), mentre il prompt di sistema e il contesto del progetto (CLAUDE.md) restano caldi. Questo significa che passare a Plan Mode e tornare indietro costa quasi zero token, a differenza del cambio di modello con /model, che interrompe la cache per il 90% del prezzo di input e costringe a ricalcolare l'intero prefisso.

Anche l'ingegneria del contesto consiste nel tenere il piano in un posto che duri, non in una chat destinata a scomparire tra 5 ore.

Regola 4: le Skills si caricano quando si attiva un trigger, non all'inizio della sessione#

Le Skills utilizzano un caricamento a tre livelli:

1. Metadati sempre disponibili: all'avvio della sessione Claude vede solo il name e la description di ogni skill. Budget: ~100 token per skill.
2. Istruzioni quando si attiva il trigger: quando l'utente dice qualcosa di pertinente, Claude carica il contenuto di SKILL.md. Budget: fino a 5000 token.
3. Risorse su richiesta: i file inclusi (esempi, modelli) vengono recuperati solo quando il modello stesso li richiede.

Come cambia l'economia dei token?

Nell'esempio descritto, le regole per scrivere istruzioni didattiche, le regole per le mailing e quelle per la revisione del codice erano in CLAUDE.md. Il file è arrivato a 500 righe e a ogni avvio di sessione pagavo per tutte e 500, anche se la conversazione riguardava una landing page.

In questo esempio, CLAUDE.md contiene 200 righe di navigazione e principi di base. I 4 gruppi di regole sono nelle skills:

.claude/skills/
├── write-tutorial/SKILL.md         # trigger: “write a guide”
├── deploy-checklist/SKILL.md       # trigger: “check before publishing”
├── send-broadcast/SKILL.md         # trigger: “send a mailing”
└── debug-payment-webhook/SKILL.md  # trigger: “check the payment”

All'avvio Claude vede solo le intestazioni: 400 token. Quando dico «scrivi una guida», carica il relativo SKILL.md e lo segue. Quando dico «invia una mailing», ne carica un altro.

Una citazione dalle regole di scrittura delle skill nella documentazione ufficiale di Anthropic:

Se una skill sembra sospetta, non installarla

Le Skills sono istruzioni eseguibili con accesso diretto ai tuoi file e alle chiavi API. Prima di installare la raccolta di qualcun altro, apro ogni SKILL.md e lo leggo personalmente. Se contiene blocchi bash: con link a URL esterni, è un segnale d'allarme: non la installo.

Regola 5. Quando affidare un'attività a un sub-agente invece che alla sessione principale?#

Dalla documentazione ufficiale:

Quali attività si possono delegare ai sub-agenti?

• Cercare in una codebase di grandi dimensioni. Un sub-agente legge 30 file e restituisce «la funzione pertinente si trova in src/lib/payment/cloudpayments.ts:142». Non vedo il contenuto dei 30 file nel contesto principale.
• Eseguire test e analizzare i log. Un sub-agente esegue npm test, intercetta 200 righe di output e restituisce «3 test non sono riusciti in X, Y, Z per questo motivo».
• Refactoring su più file. Un sub-agente per file, in parallelo.
• Controllare i link in una guida. Un sub-agente visita 30 URL tramite WebFetch e restituisce «5 link restituiscono 404».

A maggio 2026, Anthropic ha annunciato ufficialmente Multi-Agent Orchestration come funzionalità di prima classe. In precedenza i sub-agenti potevano essere avviati nel codice solo tramite SDK; ora possono essere avviati direttamente in Claude Code con comandi slash.

Dove i sub-agenti incontrano difficoltà

Perciò non lascio mai i sub-agenti senza controllo per mezza giornata. La regola è: più deleghi in parallelo, più spesso dovresti controllare i risultati intermedi. Per le attività più ampie, attivo Plan Mode separatamente per ogni sub-agente.

Regola 6. Come scegliere un modello Claude (Opus / Sonnet / Haiku) per un'attività?#

Prezzi API (per milione di token):

Fonte: pagina ufficiale di Anthropic. I prezzi non sono visibili con un abbonamento, ma il rapporto è lo stesso. Opus 4.7 ha una particolarità: rispetto a Opus 4.6, il nuovo tokenizer può usare fino a +35% di token in più per lo stesso testo. Il prezzo per token non è aumentato, ma è aumentato il costo effettivo per richiesta. Se fai passare tutto da Opus senza pensarci, il tuo limite si esaurirà 5 volte più velocemente rispetto a usare Sonnet o Haiku per metà delle attività.

Esempio di scelta di un modello

Cambia modello con il comando /model. Però cambiare modello invalida la cache. Se passi da Sonnet a Opus a metà di una sessione, la richiesta successiva ricalcola da zero l'intero prefisso al prezzo pieno di input, non a quello della cache. Quindi è meglio scegliere il modello all'inizio invece di passare continuamente da uno all'altro.

/effort: un'impostazione meno aggressiva

Ad aprile 2026, Anthropic ha introdotto /effort: 5 livelli di profondità di ragionamento: minimal / low / medium / high / xhigh. Claude Code con Opus 4.7 usa xhigh per impostazione predefinita.

Cosa faccio:

• Per classificazione, estrazione di dati e riepiloghi brevi: /effort low. Fa risparmiare il 30-70% nei tipi di attività che non richiedono ragionamenti approfonditi.
• Per attività di programmazione semplici: /effort medium.
• Per architetture complesse: lo lascio su xhigh.

/effort non cambia il modello, ma solo la profondità del suo ragionamento. La cache rimane intatta.

Regola 7: passa un prompt a una nuova chat invece di usare /compact#

/compact è un comando ufficiale di Claude Code che sostituisce la cronologia con un riepilogo. Se lo esegui subito dopo l'ultimo messaggio, mentre la cache è calda (il TTL dell'abbonamento è 1 ora), il riepilogo viene memorizzato nella cache e letto al 10% del prezzo standard. Se lo esegui dopo un'ora, la cache è fredda e paghi il prezzo pieno.

/compact può essere personalizzato:

/compact Focus on code samples and API usage

Oppure puoi specificare in CLAUDE.md l'orientamento predefinito del riepilogo:

# Compact instructions
When you are using compact, please focus on test output and code changes

Di solito, però, faccio diversamente.

Passare un prompt a una chat vicina: un esempio

Passaggi:

1. Nella chat attuale, quando vedo che il contesto ha superato il 50%, dico: «Scrivimi un prompt per una chat vicina che prosegua il lavoro senza perderne il senso. Includi: a cosa stavamo lavorando, cosa è già stato fatto, cosa resta da fare, file chiave e costanti».
2. Claude mi restituisce un prompt di 300-800 token.
3. Chiudo la chat attuale con /clear oppure ne apro semplicemente una nuova.
4. Incollo il prompt e inizio con CLAUDE.md e il contesto del progetto già caricati, ma con una memoria della conversazione pulita.

Cosa ottengo rispetto a /compact:

• Controllo su cosa finisce nella nuova chat. /compact riepiloga secondo la propria interpretazione; io posso modificare il prompt a mano prima di iniziare.
• Posso salvare il prompt in un file plans/ e riprenderlo domani.
• La nuova chat parte con una cache della conversazione pulita; da quel momento lavori al prezzo dell'input memorizzato nella cache.

Quando è meglio usare /compact?

• Quando sei in Plan Mode e non vuoi perdere il piano attuale.
• Quando l'attività è uniforme e il contesto è coerente (per esempio, tradurre un documento lungo).
• Quando /compact viene eseguito subito dopo la risposta di Claude: così il riepilogo entra nella cache calda e costa il 10%.

/clear: l'ultima risorsa

/clear cancella tutto, compreso il contesto del progetto. Lo uso solo quando passo a un argomento del tutto diverso e non voglio conservare nulla di ciò che c'era prima. Dopo /clear, la richiesta successiva paga il prezzo pieno per ricaricare CLAUDE.md.

Regola 8. Cosa invalida la cache di Claude Code e perché si paga?#

Con un abbonamento, il TTL della cache è 1 ora (si estende ogni volta che viene consultata). Sull'API, il valore predefinito è 5 minuti. Ciò significa che, se riprendi a lavorare dopo 40 minuti, la cache è ancora attiva e la richiesta successiva costa pochissimo per l'input. Dopo 1 ora, la cache scade e paghi il prezzo pieno.

Cosa interrompe la cache (evita queste cose a metà di un'attività)

1. /model: cambiare modello a metà sessione. Ogni modello ha la sua cache. Dopo /model opus, la richiesta successiva ricalcola da zero l'intero prefisso per Opus.
2. Attivare Plan Mode con l'impostazione opusplan. In questa modalità, Plan Mode = Opus e la modalità normale = Sonnet. Ogni Shift+Tab equivale a un cambio di modello e invalida la cache.
3. Connessione / disconnessione del server MCP. Anche la riconnessione automatica dopo un errore temporaneo. Se il server MCP è instabile, paghi due volte.
4. Regole di diniego con nomi semplici (Bash, WebFetch): cambiano le definizioni degli strumenti nel prompt di sistema.
5. /compact: invalida il livello della conversazione (per progettazione).
6. Aggiornare Claude Code a una nuova versione: una nuova versione comporta un nuovo prompt di sistema e una nuova cache.

Cosa NON interrompe la cache?

• Modificare i file nel repository (vengono letti su richiesta).
• Modificare CLAUDE.md a metà sessione (ma le modifiche non si applicano fino al riavvio: vedi la Regola 2).
• Cambiare lo stile di output.
• Cambiare la modalità dei permessi (se opusplan non è coinvolto).
• Attivare Skills / comandi (aggiunti al livello della conversazione).
• /recap (un nuovo comando, riepilogo senza invalidare la cache).
• /rewind (tornare a un prefisso già riscaldato).
• Avviare un sub-agente (la cache del genitore non viene influenzata).

Come sfruttare la cache a proprio vantaggio

• Non cambiare /model senza motivo. Scegli il modello all'inizio dell'attività.
• Non attivare 10 server MCP «per sicurezza». Ognuno aggiunge contenuto al prompt di sistema e interrompe la cache quando si riconnette.
• Non modificare CLAUDE.md tra un'attività e l'altra: fai tutte le modifiche insieme e poi riavvia.
• Usa /recap invece di /compact quando ti serve solo vedere un riepilogo, non liberare contesto.

Che cosa è successo alla proposta di crediti per l’automazione del 15 giugno?#

La divisione proposta tra pool interattivo e programmatico è stata sospesa. L’aggiornamento di assistenza Anthropic dice che Agent SDK, claude -p e app di terze parti possono ancora usare i limiti dell’abbonamento. Non aggiungere gli importi della proposta abbandonata come seconda fattura obbligatoria.

I crediti API mensili separati introdotti in ottobre per piani Max e Team idonei sono una quota inclusa in un’organizzazione Console collegata. Non sostituiscono i limiti interattivi. La guida attuale ai crediti API distingue accesso con abbonamento e chiave API e identifica le superfici di avvio escluse.

Prima del budget di un’attività pianificata, registra autenticazione, superficie di avvio, modello e consumo effettivo. Il solo comando claude -p non dimostra il saldo usato. La spesa API aggiuntiva dipende dalla fatturazione dell’organizzazione. Per spiegazione e calcolatore attuali consulta fatturazione dell’automazione Claude Code.

Una giornata nella vita di un vibe coder che usa Claude Code#

Un esempio di giornata:

1. 9:00. Apro l'attività n. 1: una modifica a un modello email. Apro una nuova chat, uso Plan Mode e chiedo a Claude di esplorare. Il piano è pronto in 3 minuti; passo all'accettazione automatica e la modifica richiede 10 minuti. Chiudo la chat.
2. 9:30. Attività n. 2: scrivere una guida didattica. Apro una nuova chat, dove si attiva la mia skill per scrivere guide. Carica 4000 token di metodologia. Ci lavoro e la guida è pronta in 40 minuti. Fatto.
3. 11:00. Attività n. 3: un problema architetturale complesso. /model opus, Plan Mode, discussione. Rivedo il piano, lo salvo manualmente in plans/2026-05-20-...md o autorizzo la scrittura dopo essere uscito da Plan Mode, verifico il file e chiudo la chat.
4. 12:00. Nuova chat: «leggi plans/2026-05-20-...md e implementa la fase 1». 6 sub-agenti lavorano in parallelo, uno per file. La fase 1 è pronta in 45 minuti. La chiudo.
5. 14:00. Attività n. 4: una modifica a una landing page. /model sonnet. Nuova chat. Piano e implementazione richiedono 30 minuti. La chiudo.
6. 15:00. Attività n. 5: debug in produzione. /model opus, Plan Mode: serve profondità. Dopo un'ora di discussione, chiedo di scrivere un prompt per una chat vicina con la causa individuata e la correzione proposta. Lo copio in una nuova chat e implemento in 20 minuti.

A fine giornata: 6 attività, 8 chat chiuse, nemmeno un /compact. Il limite è consumato al 40-60%. Più che sufficiente.

Il limite si esaurisce per chi:

• Ammassa un'intera attività in una chat che ha già usato il 50% del contesto.
• Tiene CLAUDE.md a 600 righe perché «potrebbe tornare utile».
• Passa a /model opus per ogni modifica semplice.
• Attiva 8 server MCP «per sicurezza».
• Non usa mai i sub-agenti e trascina tutto nella conversazione principale.

Il limite non si esaurisce per chi costruisce un secondo cervello nei file del progetto e lavora con Claude come con un ingegnere del team: gli assegna attività chiare, non riversa tutto in un'unica conversazione e usa strumenti diversi per attività diverse.

Puoi continuare a esplorare Ailoot su ailoot.ai.