Home › Claude Code › Errori › Sovraccarico / 529
PanoramicaInstallazioneriferimento della CLIPrezzi e limitiAgent SDKSkill e pluginGitHubWeb, desktop e IDEModelliErroriÈ open source?TutorialPer studentiAutomazione QAConfronto con CursorConfronto con Codex e OpenCodeSubagentiHookMCPEcosistemaVS CodeOpenRouterLimiti di frequenzaGuida in cinese
Ultimo aggiornamento: 11 ottobre 2026

Errore "Sovraccarico" di Claude (errore API 529): cosa significa e cosa fare

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}} significa che il modello è operativo, ma al momento non ha capacità disponibile per la tua richiesta. Non è un limite del tuo account: tutti gli utenti di quel modello lo riscontrano contemporaneamente. Le soluzioni consistono nell'attendere in modo intelligente ed evitare un'ondata di richieste simultanee.

TLDR

  • 529 = il modello è saturo per tutti. Non dipende dalla tua chiave né dal tuo piano.
  • Claude Code riprova autonomamente ("Nuovo tentativo tra N secondi… tentativo x/10"); lascialo fare.
  • Passare a un altro livello con /model spesso funziona immediatamente: la capacità è specifica di ciascun modello.
  • Avviare molti sottoagenti contemporaneamente rende correlati gli errori 529; eseguine meno in parallelo.

Che cosa vedi

API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 1 seconds… (attempt 1/10)
API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 2 seconds… (attempt 3/10)

Quelle righe provengono da #3572, l'ondata di luglio 2025 che ha raccolto 274 commenti — molti da utenti del piano Max da $200, ed è proprio questo il punto: 529 riguarda la capacità, e un abbonamento più costoso non ne riserva alcuna. L'errore continua a essere segnalato: #91817 ("troppi tentativi di ripetizione"), #91849 e #91825 sono state tutte aperte il 3 settembre 2026.

Perché succede

  • Picchi di domanda su un singolo modello. Le nuove versioni e le mattine dei giorni feriali negli Stati Uniti sono i picchi tipici; il modello di punta più recente è quello più richiesto.
  • Il tuo parallelismo. #90043 ha analizzato 60 giorni di trascrizioni e ha rilevato che la maggior parte degli errori 529 arrivava a raffiche: un orchestratore avvia N agenti insieme, questi chiamano l'API contemporaneamente e la maggior parte del gruppo fallisce nello stesso minuto.
  • Lavoro perso. #89267 e una segnalazione correlata indicano che un 529 può terminare un sottoagente in background invece di riprovare — quindi una raffica non si limita a rallentarti, ma fa perdere attività.

Soluzioni

  • 1. Lascia che il meccanismo integrato riprovi. La maggior parte degli errori 529 si risolve entro i 10 tentativi.
  • 2. Cambia fascia di modello: /model passa a Sonnet (o Opus) per il passaggio corrente; torna al modello precedente più tardi.
  • 3. Esegui meno sottoagenti contemporaneamente e scagliona gli avvii in parallelo; una raffica di prime richieste simultanee è ciò che trasforma un 529 in dieci.
  • 4. Esegui di nuovo i sottoagenti interrotti esplicitamente — verifica che ogni unità avviata in parallelo abbia effettivamente completato il lavoro.
  • 5. Orari di minor traffico per i lavori più grandi: le lunghe esecuzioni autonome hanno molte meno probabilità di raggiungere i limiti di capacità al di fuori dell'orario lavorativo statunitense.

529 vs 500 vs 429

  • 529 Sovraccarico — capacità, riguarda tutti, temporaneo. Attendi o cambia modello.
  • 500 — errore del server. Vedi Errore API 500.
  • 429 — un tuo limite (richieste, token, concorrenza). Vedi limiti di frequenza.

Su questo gateway

Il gateway distribuisce il traffico su diversi account a monte e, prima di rinunciare, riprova un 529 su un altro account, così un singolo account saturo non interrompe la sessione. Quando un modello è saturo ovunque, vedrai comunque l'errore — scegli un'altra fascia di modello con /model. La configurazione è quella di sempre: ANTHROPIC_BASE_URL=https://aiprimetech.io e una chiave del gateway.

Stanco di lottare con questo problema?

Esegui invece Claude Code tramite il gateway di AI Prime Tech: gli stessi modelli Claude sugli account a monte del gateway, due variabili d'ambiente per passare al gateway, e i nuovi account ricevono $5 di credito API gratuito con il codice FIXIT — senza carta.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Crea un account con il codice FIXIT

Domande frequenti

Che cosa significa l'errore di sovraccarico di Claude?

Il modello non ha capacità disponibile in quel momento (HTTP 529, overloaded_error). Riguarda tutti gli utenti di quel modello e si risolve da solo.

Come risolvo l'errore API 529 di Claude?

Lascia che Claude Code riprovi, cambia fascia di modello con /model ed esegui meno sottoagenti in parallelo. Per i lavori più grandi, scegli orari di minor traffico.

Un abbonamento Max evita gli errori di sovraccarico?

No. 529 riguarda la capacità, non i limiti del piano — gli utenti Max lo segnalano con la stessa frequenza degli altri.

Esegui Claude Code sul gateway

Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice FIXIT.

Ottieni una chiave API Scopri i piani illimitati

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.

Altre guide su Claude Code

Errori di Claude Code e come risolverli"Errore API: 500" di Claude Code: cosa significa e cosa lo risolve davveroErrore API 400 di Claude Code: prompt troppo lungo, concorrenza nell'uso degli strumenti e gli altri casiErrori OAuth di Claude Code: timeout di 15000ms superato e codice di stato 500"Il processo Claude Code è terminato con il codice 1": come individuare il vero errore e risolverloClaude "Prompt troppo lungo", "Input troppo lungo per il modello richiesto" e "Limite di contesto raggiunto": cosa riempie la finestra e come recuperare spazioLimite di utilizzo di Claude raggiunto: limiti di sessione, settimanali e di Opus, "limiti di utilizzo API specificati", "saldo dei crediti insufficiente" — e cosa fareClaude Code 401 e 403: credenziali di autenticazione non valide, chiave API non valida, "Accesso non effettuato", host_not_allowedErrori di connessione di Claude Code: ECONNRESET, connessione persa durante la risposta, "In attesa della risposta API", "Impossibile connettersi all'API", errori dei certificati SSLClaude Code si blocca o smette di rispondere: come capire dove si è bloccato e sbloccarloClaude.ai non funziona: "Qualcosa è andato storto", limiti di capacità, "limite di 5 ore raggiunto", "errore durante l'accesso" e gli altri casi