Claude limiti utilizzo: cosa fare se bloccato

Quali sono i limiti di utilizzo di Claude?

I limiti di utilizzo di Claude si dividono in due sistemi distinti. Il primo passo consiste nell'identificare quale dei due ha interrotto l'operazione. Un abbonamento Claude (Pro, Max, Team o Enterprise) fornisce un limite di utilizzo rotante condiviso tra i modelli e la chat di Claude; in questo caso, l'interruzione avviene tramite un messaggio come You've hit your session limit · resets 3:45pm. L'API di Claude misura un parametro differente: la velocità con cui vengono inviati richieste e token, calcolata al minuto. L'interruzione avviene tramite un errore HTTP 429 di tipo rate_limit_error e un header retry-after che indica i secondi di attesa necessari.

Le soluzioni non hanno nulla in comune. Un limite di abbonamento dipende da quanto è stato utilizzato all'interno di una finestra temporale; pertanto, è necessario attendere il reset o acquistare maggiore utilizzo. Un limite di velocità (rate limit) dell'API dipende dalla velocità di invio attuale e si sblocca in pochi secondi rallentando il ritmo.

I limiti dei piani e i livelli di rate-limit cambiano frequentemente. Fornire un valore errato è peggiore che non fornirne alcuno, pertanto non sono riportati valori specifici qui. È possibile consultare i propri valori tramite i comandi riportati di seguito.

Quale limite hai raggiunto? Leggi il messaggio esatto

Claude Code indica il sistema specifico nel testo stampato. Verifica il tuo prima di apportare modifiche.

• You've hit your session limit · resets 3:45pm è un limite di abbonamento. Il consumo per la finestra temporale del tuo piano è esaurito.
• You've hit your weekly limit · resets Mon 12:00am è lo stesso sistema applicato a una finestra temporale più lunga.
• You've hit your Opus limit · resets 3:45pm è un limite di abbonamento applicabile solo alle richieste Opus. In questo caso, il cambio di modello può risolvere il problema.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. è un limite di velocità (rate limit) dell'API. Hai raggiunto il limite configurato per la tua API key, o per il tuo progetto Amazon Bedrock o Google Cloud.
• API Error: Server is temporarily limiting requests (not your usage limit) è un limite temporaneo (throttle) non relativo alla quota del tuo piano. Claude Code tenta automaticamente un nuovo accesso con backoff prima di mostrare questo messaggio.

Limiti di abbonamento: sessione, settimanali e finestra Opus

Un piano di abbonamento include una quota di utilizzo a scorrimento. Quando la quota è esaurita, Claude Code blocca ulteriori richieste fino all'orario di reset indicato nel messaggio. Due proprietà di questa quota causano la maggior parte dei dubbi.

• La quota è condivisa con la chat di Claude. L'attività svolta su claude.ai utilizza la stessa quota del lavoro nel terminale; un uso intensivo della chat nel pomeriggio riduce la disponibilità per la programmazione serale.
• La quota è condivisa tra i modelli. I limiti di sessione e settimanali non prevedono un budget per singolo modello, con l'unica eccezione del limite Opus.

Per Claude for Teams ed Enterprise, la struttura documentata prevede una quota per utente che si resetta su una finestra mobile di cinque ore e su una finestra settimanale. La quota è condivisa con Claude chat e Cowork e la dimensione dipende dal livello dell'utente (Standard o Premium). Per i piani Pro e Max, i dati affidabili sono l'orario di reset riportato nel messaggio e le proprie barre /usage, non i dati riportati in un post di un blog. Se non hai ancora scelto un piano, quale piano Claude ti serve confronta le restrizioni di ciascuno.

Perché il cambio di modello con /model non ripristina l'accesso

Questo è l'errore più comune. La documentazione è esplicita: i limiti di sessione e settimanali sono condivisi tra tutti i modelli. Cambiare modello non ripristina l'accesso. Selezionare un modello più piccolo dopo aver esaurito la finestra di sessione cambia solo il modello che risponde. Non cambia il limite residuo, poiché il limite non è assegnato per singolo modello. Il cambio di modello non può quindi rilasciare quote.

L'eccezione è il limite di Opus, che è un tetto massimo specifico per il modello. Se il messaggio riporta You've hit your Opus limit, allora la soluzione corretta è /model. Passare a un altro modello per continuare il lavoro, poiché sono stati bloccati solo i messaggi Opus.

Considerare il limite come un bug è il secondo errore comune. Reinstallare o effettuare nuovamente l'autenticazione non cambia nulla. Il limite viene ripristinato al reset della finestra temporale o con l'acquisto di crediti di utilizzo.

Cosa fare quando si raggiunge il limite di abbonamento

1. Controlla l'orario di reset. La finestra di sessione è breve. La finestra settimanale non richiede di attendere alla scrivania.
2. Se si raggiunge il limite di Opus, esegui /model e seleziona un altro modello.
3. Esegui /usage per visualizzare i limiti del piano, le barre di avanzamento e la data di reset. /cost è un alias per la stessa schermata.
4. Esegui /usage-credits per continuare a lavorare oltre il limite. Su Pro e Max apre le impostazioni di fatturazione. Su Team e Enterprise apre le impostazioni di utilizzo dell'organizzazione o invia una richiesta agli amministratori se non si ha l'accesso alla fatturazione.
5. Se si raggiunge lo stesso limite ogni settimana, il piano non è adatto al proprio flusso di lavoro.

/usage-credits richiede un abbonamento a claude.ai effettuato tramite /login. Non è disponibile con autenticazione tramite API key, poiché una API key non possiede un limite di piano da estendere.

I crediti di utilizzo hanno un effetto collaterale importante. La durata della cache dei prompt è di un'ora con un abbonamento e scende a cinque minuti una volta utilizzati i crediti; di conseguenza, più interazioni iniziano senza cache e l'uso dei token di Claude Code aumenta per lo stesso lavoro.

Messaggi che sembrano limiti di utilizzo ma non lo sono

Quattro errori di Claude Code vengono riportati come limiti di utilizzo, ma non lo sono.

• Un avviso di context o auto-compact non è un limite di utilizzo. /context stampa una riga come Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue. quando la conversazione supera la context window del modello. La cronologia precedente viene riassunta per liberare spazio; il limite del tuo piano rimane invariato.
• Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again. significa che /compact stesso è fallito, poiché non c'è abbastanza context libero per contenere il riassunto prodotto.
• Credit balance is too low significa che l'organizzazione sul Console ha esaurito i crediti prepagati. Aggiungi crediti su platform.claude.com/settings/billing, dove è disponibile anche l'auto-reload.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context è un controllo di entitlement, non una quota esaurita. Seleziona la variante del modello senza il suffisso [1m], oppure imposta CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Un altro errore proviene dall'API. Un errore 413 request_too_large indica un limite di dimensione su una singola richiesta, non un limite di rate limit.

API rate limits: cosa conta realmente l'errore 429

La Messages API misura tre parametri, separatamente per ogni classe di modello.

• requests per minute (RPM)
• input tokens per minute (ITPM)
• output tokens per minute (OTPM)

L'organizzazione ha anche un limite di spesa, che è un parametro distinto: un costo massimo mensile per l'utilizzo delle API. Una volta raggiunto il limite di spesa del proprio tier, l'utilizzo delle API viene sospeso fino al mese successivo, a meno che non si richieda un limite superiore. Nessun ciclo di tentativi (retry loop) può risolvere questo problema.

Quattro meccanismi determinano quando viene restituito l'errore 429.

• I limiti sono per classe di modello. Si applicano separatamente a ogni modello; è possibile utilizzare modelli diversi contemporaneamente fino ai rispettivi limiti. Alcune famiglie condividono un unico contatore: il limite di rate limit per Opus è il totale di Claude Opus 4.8, Opus 4.7, Opus 4.6 e Opus 4.5, mentre Claude Sonnet 5 ha un proprio limite dedicato.
• La capacità si ricarica continuamente. L'API utilizza un algoritmo token bucket, quindi la capacità si ripristina continuamente invece di resettarsi in un momento fisso. Un limite di 60 richieste al minuto può essere applicato come una richiesta al secondo; pertanto, inviare 60 richieste simultaneamente causerà comunque un errore.
• Solo l'input non memorizzato nella cache conta per l'ITPM sulla maggior parte dei modelli. input_tokens e cache_creation_input_tokens sono conteggiati. cache_read_input_tokens non viene conteggiato sulla maggior parte dei modelli Claude, con l'eccezione documentata di Claude Haiku 3.5. Il caching garantisce quindi maggiore margine per il rate limit e uno sconto. Per quanto riguarda l'output, un alto max_tokens non incide sull'OTPM, poiché l'OTPM conta solo i token effettivamente prodotti.
• I limiti sono applicati a livello di organizzazione. A un workspace può essere assegnato un limite inferiore, ma i limiti dell'organizzazione si applicano sempre anche se la somma dei limiti dei workspace è superiore. Un limite non sovrascritto su un workspace viene ereditato dall'organizzazione e non rimane illimitato.

I tier denominati Start, Build, Scale e Custom stabiliscono i valori effettivi, assegnati automaticamente in base alla cronologia di utilizzo e allo stato dell'account. Le nuove organizzazioni potrebbero iniziare con valori inferiori ai limiti standard pubblicati, quindi un primo errore 429 può verificarsi prima di quanto previsto in tabella. Un aumento repentino dell'utilizzo attiva i limiti di accelerazione, che restituiscono 429 anche se si è ancora all'interno del proprio tier; pertanto, aumentare il traffico gradualmente. Ogni valore pubblicato è un tetto massimo: i limiti documentati sono l'utilizzo massimo consentito, non minimi garantiti. Per richiedere un aumento, utilizzare il controllo "Request rate limit increase" nella pagina Limits della Claude Console.

Lettura di un 429: retry-after, gli header e i retry degli SDK

Ogni errore API restituisce lo stesso contenitore: un oggetto error annidato che contiene il tipo e il messaggio, più un request_id di primo livello.

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

Gli header contengono il resto delle informazioni.

• retry-after indica il numero di secondi da attendere prima di ripetere la richiesta. I tentativi anticipati falliranno.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining e anthropic-ratelimit-requests-reset descrivono il budget della richiesta.
• anthropic-ratelimit-input-tokens-* e anthropic-ratelimit-output-tokens-* operano allo stesso modo per ITPM e OTPM, utilizzando gli stessi suffissi limit, remaining e reset.
• anthropic-ratelimit-tokens-* mostra i valori per il limite più restrittivo attualmente in vigore.

Gli header di reset sono timestamp in formato RFC 3339. Gli header dei token rimanenti sono arrotondati al millesimo più vicino; utilizzali come indicatore approssimativo. La modalità Fast ha un proprio pool e i propri header anthropic-fast-*. È possibile leggere tutti questi valori da qualsiasi chiamata riuscita:

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

Ogni risposta contiene anche un header request-id univoco, come ad esempio req_018EeWyXxfu5pfWkrYcMdjWG. Appare come request_id nei corpi degli errori e come _request_id nelle risposte degli SDK Python e TypeScript. Citatelo quando contattate il supporto.

Verificate se è necessario implementare un ciclo di backoff prima di scriverne uno. Gli SDK ufficiali gestiscono automaticamente i tentativi per gli errori transitori, inclusi errori di connessione, limiti di velocità (rate limits) ed errori del server 5xx, utilizzando un backoff esponenziale. Di default, i tentativi sono due e rispettano l'header retry-after quando presente. Ogni client accetta l'opzione maximum-retries per modificare o disabilitare questo comportamento.

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

529 overloaded_error non è colpa tua

Un errore 429 indica che hai inviato troppe richieste in poco tempo. Un errore 529 overloaded_error indica che l'API è temporaneamente sovraccarica; questo accade quando l'API riceve un traffico elevato da tutti gli utenti. Il problema non dipende dalla tua chiave o dal tuo codice. Riprova utilizzando l'exponential backoff, procedura già implementata dagli SDK per le risposte 5xx, e controlla status.claude.com se l'errore persiste. Un errore 500 api_error è un errore interno e va gestito con la stessa modalità di retry; nessuno dei due errori è un limite di rate limit.

Leggi i tuoi limiti invece di consultare una tabella

Per un abbonamento, /usage è la schermata rilevante. Mostra le barre di utilizzo del piano e il dettaglio dei consumi; d o w permette di passare dalle ultime 24 ore agli ultimi 7 giorni. Due avvertenze. Il blocco Session mostra l'utilizzo dei token API ed è destinato agli utenti API; gli abbonati possono ignorare il valore in dollari. I dati derivano dalla cronologia delle sessioni locali su quella macchina; l'utilizzo da altri dispositivi o da claude.ai non è incluso.

Lato API, la pagina Usage nella Claude Console genera due grafici: "Rate Limit - Input Tokens" e "Rate Limit - Output Tokens". Il grafico di input riporta il massimo orario di input token non in cache al minuto rispetto al limite ITPM attuale, con il tasso di cache affiancato; questo permette di monitorare l'avvicinamento al limite invece di raggiungerlo in produzione.

Per leggere i limiti configurati programmaticamente:

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

È necessaria una Admin API key; GET /v1/organizations/workspaces/{workspace_id}/rate_limits esegue la stessa operazione per workspace. Entrambe sono in sola lettura: per modificare un limite, usa la scheda Limits nella Console.

Utilizzo di less, per rispettare meno limiti

Entrambi i sistemi monitorano lo stesso parametro; pertanto, queste opzioni sono applicabili a entrambi.

• Consumare meno token per turno. Sessioni continue mantengono la cache attiva; /clear tra task non correlati non ha costi aggiuntivi. Utilizzo token di Claude Code descrive dettagliatamente queste opzioni.
• Ridurre l'impegno computazionale. I livelli sono low, medium, high, xhigh e max. Il menu /effort offre anche ultracode, che aumenta il consumo invece di ridurlo. L'uso di ragionamento profondo per un rinominare meccanico è inutile.
• Ridurre la concorrenza dopo un errore 429. Abbassa CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY ed evita l'uso di molti subagent paralleli. Usa anche /status: un ANTHROPIC_API_KEY errato instrada le richieste tramite una chiave di basso livello invece della tua sottoscrizione.
• Spostare il lavoro non interattivo sulla Message Batches API. Esegue grandi volumi in modo asincrono con uno sconto del 50% sui token di input e output. Opera con i propri limiti di velocità, evitando che un job notturno competa con la tua sessione.

Il lavoro intermittente gestito da un programma anziché da una persona richiede l'uso di una API key fin dall'inizio. La tua prima app Claude API su un VPS spiega la gestione delle chiavi e dei tentativi di ripristino; un agente in esecuzione prolungata non si interrompe in caso di disconnessione se mantieni Claude Code in esecuzione su un VPS dentro tmux.

FAQ

Perché il cambio di modello non risolve il limite di utilizzo di Claude?

I limiti di sessione e settimanali sono condivisi tra tutti i modelli. Il limite è associato al piano e non al singolo modello; pertanto, /model cambia il modello che risponde, ma non il limite residuo. L'unica eccezione è You've hit your Opus limit, che si applica solo alle richieste Opus. In quel caso, il cambio di modello è la soluzione documentata.

Cosa significa l'errore 429 rate_limit_error e quanto devo aspettare?

Significa che l'account ha raggiunto il limite di velocità per quella classe di modelli: richieste al minuto, token di input al minuto o token di output al minuto. La risposta include un header retry-after con i secondi di attesa; i tentativi precedenti falliscono. Gli SDK ufficiali gestiscono già i retry per i rate limit e gli errori 5xx con exponential backoff, due volte per impostazione predefinita, rispettando tale header. Un errore 429 che si verifica mentre si è ancora entro i limiti del proprio tier indica un limite di accelerazione dovuto a un picco improvviso di richieste.

Come posso visualizzare i limiti di utilizzo di Claude e i tempi di reset?

In Claude Code, esegui /usage per visualizzare le barre del piano, gli orari di reset e il dettaglio dell'utilizzo; /cost è un alias, mentre d o w permette di passare dalle ultime 24 ore agli ultimi 7 giorni. Questi dati derivano dalla cronologia locale della sessione; pertanto, non includono l'utilizzo effettuato da altri dispositivi o da claude.ai. Sull'API, la Console mostra i rate limit e GET /v1/organizations/rate_limits restituisce i limiti configurati tramite una Admin API key.

Posso continuare a lavorare dopo aver raggiunto il limite del piano Claude?

In alcuni casi. Esegui /usage-credits per acquistare utilizzo extra oltre il limite su piani Pro e Max, o per richiederlo a un amministratore su piani Team ed Enterprise; è necessario un login su claude.ai tramite /login e non è disponibile con autenticazione tramite API key. In caso contrario, attendi l'orario di reset, cambia modello se il limite era relativo a Opus, oppure sposta il lavoro su una API key, che misura il consumo al minuto invece che per finestra temporale.