Quando Claude Code mostra «limite raggiunto», iniziate identificando il limite: abbonamento, velocità API, limite di spesa o problema dell'account. Il rimedio corretto può essere attendere una reimpostazione, attivare crediti ufficiali, ridurre le chiamate simultanee o correggere una chiave. Acquistare un altro piano prima di questa diagnosi rischia di lasciare invariato il problema.
Quale messaggio vedete?
| Sintomo | Verifica | Azione appropriata |
|---|---|---|
| Quota del piano raggiunta, con indicazione dell'ora di ripresa | Account Claude e pagina di utilizzo | Attendere, confrontare un altro piano o i crediti di utilizzo |
| API 429 con indicazione della velocità | Messaggio, richieste simultanee e intestazione di ripresa | Rallentare e rispettare il ritardo comunicato |
| Limite di spesa o pagamento rifiutato | Saldo, limiti dell'account e fatturazione | Correggere il limite o il pagamento interessato |
| API 401 o 403 | Chiave, dominio di destinazione e autorizzazioni | Correggere l'identificazione o l'autorizzazione |
| Conversazione troppo lunga | Dimensione del contesto e messaggio esatto | Riassumere il lavoro e ridurre il contesto utile |
I codici sotto descrivono l'API Anthropic. Se Claude Code passa da un altro provider, consultate anche la relativa documentazione: un intermediario può presentare messaggi e limiti propri.
1. Se utilizzate un abbonamento Claude
Aprite le impostazioni di utilizzo dell'account connesso. Rilevate la quota interessata e l'ora indicata, invece di dedurre una durata universale da un messaggio trovato altrove. Verificate anche che Claude Code utilizzi effettivamente l'account previsto.
Anthropic distingue i limiti di utilizzo e di lunghezza. L'utilizzo di Claude e Claude Code può condividere la stessa allocazione dell'account. Aprire una nuova finestra o una nuova conversazione non crea quindi una quota aggiuntiva. Alleggerire un contesto diventato voluminoso può invece ridurre il lavoro richiesto al modello nelle chiamate successive.
Per continuare dopo l'allocazione inclusa, i piani personali idonei dispongono di crediti di utilizzo ufficiali. Sono fatturati separatamente, alle tariffe API standard. Nelle impostazioni di utilizzo, verificate l'attivazione, i fondi disponibili e il limite di spesa. È un'opzione da confrontare con l'attesa, il cambio di piano o un account API distinto.
2. Se l'API restituisce 429
Consultate il testo dell'errore e i limiti API. Per un limite di velocità, riducete le attività simultanee e rispettate il ritardo retry-after quando presente. Riavviare immediatamente più agenti può mantenere lo stesso blocco.
Un 429 può anche corrispondere al limite mensile del livello API o ad alcuni limiti di spesa dello spazio Claude Code. Un limite mensile può non fornire un tempo di ripresa. In tal caso verificate la fatturazione e il limite associato all'account; un ciclo di tentativi non li aumenta. L'assenza di un'intestazione, da sola, non basta per concludere: leggete anche il messaggio.
3. Se il problema riguarda il saldo o l'autenticazione
La documentazione degli errori Anthropic distingue in particolare 401 per l'autenticazione, 403 per le autorizzazioni e 402 per la fatturazione. Alcuni limiti di spesa possono comparire anche con il codice 400. Il solo codice HTTP non sostituisce quindi il dettaglio dell'errore.
Verificate il dominio a cui viene inviata la richiesta e l'account che ha creato la chiave. Un abbonamento Claude, un saldo Console e un saldo presso un provider di terze parti non sono intercambiabili. Una ricarica presso un provider non finanzia automaticamente gli altri. Dopo la correzione, utilizzate una piccola richiesta per confermare quale account viene addebitato prima di riprendere un'attività importante.
4. Continuare con una fatturazione API separata
La documentazione dei gateway precisa che un identificativo di gateway attivo sostituisce l'identità dell'abbonamento per la sessione. Definire solo l'indirizzo di base non effettua questo cambiamento: la connessione registrata può rimanere attiva. Configurate quindi insieme indirizzo, identificativo e modello previsti.
La guida prezzi e configurazione di Claude Code spiega come utilizzare Kunavo in francese. Il catalogo mostra attualmente Claude Sonnet 4.6 a $2,10 in input e $10,50 in output per milione di token. La guida ai prezzi dell'API Claude descrive in dettaglio le unità da confrontare. Un'attività può comprendere più chiamate; il suo costo dipende anche dal contesto, dalla cache e dai nuovi tentativi.
Se questa separazione vi è adatta, create il vostro account Kunavo, configurate una chiave, poi controllate la prima chiamata nella vostra cronologia di utilizzo. Questo account ha vincoli propri; non trasforma Claude Code in un servizio illimitato.
Preparare una richiesta di assistenza utile
Se il blocco persiste, conservate le informazioni seguenti. Consentono di distinguere un problema di configurazione da un limite applicato all'account corretto, senza pubblicare la vostra chiave segreta:
Interface et version de Claude Code :
Compte utilisé : abonnement / Console / fournisseur tiers
Modèle et nom de domaine de l'API :
Message exact et code HTTP éventuel :
Heure de réinitialisation affichée :
En-tête retry-after, s'il existe :
Identifiant de requête, s'il existe :Conservate anche il lavoro locale e lo stato dell'attività. Dopo il ripristino dell'accesso, chiedete all'agente di verificare i file già modificati prima di ricominciare, per evitare di ripetere passaggi completati o perdere il contesto della correzione.
Domande frequenti
Cosa fare quando Claude Code mostra «limite raggiunto»?
Identificate innanzitutto l'account che fornisce le risposte. Per un abbonamento, controllate l'ora di reimpostazione e le opzioni per i crediti di utilizzo. Per un'API, leggete il messaggio completo: velocità, limite di spesa, fatturazione e autenticazione richiedono correzioni diverse.
Un codice 429 significa sempre che bisogna aspettare?
No. L'API Claude usa 429 anche per alcuni limiti di spesa. Il superamento del limite di velocità può richiedere un'attesa e un numero inferiore di richieste simultanee; un limite finanziario richiede di verificare i limiti e la fatturazione dell'account. Il messaggio e le intestazioni permettono di scegliere il percorso corretto.
Una nuova conversazione azzera la quota?
No. Una nuova conversazione può ridurre il contesto trasmesso, ma non reimposta l'allocazione dell'account. Il limite di lunghezza di una conversazione e il limite di utilizzo dell'abbonamento sono due vincoli distinti.
Una chiave Kunavo rimuove tutti i limiti?
No. Una configurazione API con una chiave Kunavo utilizza un account e una fatturazione separati dall'abbonamento Claude. Rimane soggetta al saldo, ai limiti e ai modelli disponibili su Kunavo. Cambiare solo l'indirizzo di base senza configurare l'identificativo corretto non basta a cambiare la fatturazione.
Fonti ufficiali verificate il 17 settembre 2026.