Source: https://aiprimetech.io/it/claude-code/errors/ [Home](/it/) › [Claude Code](/it/claude-code/) › Errori [Panoramica](/it/claude-code/)[Installazione](/it/claude-code/install/)[riferimento della CLI](/it/claude-code/cli/)[Prezzi e limiti](/it/claude-code/pricing/)[Agent SDK](/it/claude-code/sdk/)[Skill e plugin](/it/claude-code/skills/)[GitHub](/it/claude-code/github/)[Web, desktop e IDE](/it/claude-code/web-and-desktop/)[Modelli](/it/claude-code/models/)[Errori](/it/claude-code/errors/)[È open source?](/it/claude-code/open-source/)[Tutorial](/it/claude-code/tutorial/)[Per studenti](/it/claude-code/for-students/)[Automazione QA](/it/claude-code/qa-automation/)[Confronto con Cursor](/it/claude-code/vs-cursor/)[Confronto con Codex e OpenCode](/it/claude-code/vs-codex/)[Subagenti](/it/claude-code/subagents/)[Hook](/it/claude-code/hooks/)[MCP](/it/claude-code/mcp/)[Ecosistema](/it/claude-code/ecosystem/)[VS Code](/it/claude-code/vscode/)[OpenRouter](/it/claude-code/openrouter/)[Limiti di frequenza](/it/claude-code/rate-limits/)[Guida in cinese](/claude-code/zh/) Ultimo aggiornamento: 11 ottobre 2026 # Errori di Claude Code e come risolverli Claude Code mostra gli errori API con lo stato HTTP nel messaggio, quindi il numero spiega già gran parte del problema. Ecco cosa significa ciascuno nel contesto di una sessione dell'agente e la soluzione che funziona davvero. ## TLDR - 500 / 529 — il servizio del modello presenta un guasto o è saturo; riprova con attese progressive o cambia modello: non c'è nulla da correggere nella configurazione. - 400 — di solito il contesto è troppo lungo per il modello; usa /compact o /clear, oppure passa a una variante con contesto 1M. - 429 — limite di frequenza; gli stream paralleli di Claude Code raggiungono prima il limite di concorrenza. - 401 — chiave errata per l'endpoint; una chiave della console usata con un URL del gateway o viceversa. - Limite di utilizzo / limite settimanale — una finestra di utilizzo dell'abbonamento, non un errore API; si azzera automaticamente e l'accesso tramite API non prevede una finestra del genere. ## Guide dettagliate per ogni errore - [Errore API: 500 (errore interno del server)](/it/claude-code/errors/api-error-500/) — interruzioni del servizio, guasti di singoli modelli, compattazione al 0%. - [Sovraccarico / errore API 529](/it/claude-code/errors/overloaded-529/) — capacità, nuovi tentativi, picchi di richieste dei sottoagenti. - [Errore API 400](/it/claude-code/errors/api-error-400/) — prompt troppo lungo, concorrenza nell'uso degli strumenti e altre richieste rifiutate. - [Errori OAuth](/it/claude-code/errors/oauth-error/) — timeout di 15000ms superato, codice di stato 500 durante l'accesso. - [Processo terminato con codice 1](/it/claude-code/errors/process-exited-code-1/) — arresti anomali dell'estensione di VS Code e dell'app desktop. - [Limite di frequenza raggiunto / 429](/it/claude-code/rate-limits/) — i tre limiti e come aumentarli. - [Prompt troppo lungo / limite di contesto raggiunto](/it/claude-code/errors/prompt-too-long/) — cosa riempie la finestra, falsi allarmi, errori di compattazione, limiti di lunghezza claude.ai. - [Limite di utilizzo raggiunto](/it/claude-code/errors/usage-limit-reached/) — finestre di utilizzo della sessione, settimanali e di Opus, "limiti di utilizzo API specificati", "saldo crediti troppo basso". - [Autenticazione 401 / 403](/it/claude-code/errors/auth-401-403/) — credenziali non valide, chiave API non valida, "accesso non effettuato", host_not_allowed. - [Errori di connessione](/it/claude-code/errors/connection-lost/) — ECONNRESET, "in attesa della risposta API", certificati, proxy, variabili per i nuovi tentativi. - [Si blocca, resta fermo, non risponde](/it/claude-code/errors/claude-code-hangs/) — dove si blocca, tasti per uscire, bug noti che causano blocchi, memoria. - [claude.ai non funziona](/it/claude-code/errors/claude-ai-not-working/) — "si è verificato un errore", vincoli di capacità, limite di 5 ore, errori di accesso. ## Errore API 500 (e 529 per sovraccarico) Un 500 indica un guasto a monte; 529 è il codice esplicito di Anthropic per "modello al limite della capacità". Nessuno dei due è causato dal tuo prompt. Claude Code riprova autonomamente alcune volte; se rinuncia, attendi un minuto e riprendi con claude -c. Cambiare livello con /model spesso funziona immediatamente perché la capacità è specifica per ogni modello. Su questo gateway, se un account a monte è saturo, il traffico viene trasferito automaticamente a un altro: ecco perché gli errori 529 sono più rari qui che con un singolo account. ## Errore API 400 — richiesta non valida / contesto troppo lungo In Claude Code, un 400 significa quasi sempre che la conversazione e i file letti non rientrano più nella finestra di contesto del modello. /compact riassume la cronologia; /clear ricomincia da zero; oppure passa a una (1M) variante del modello. Altri errori 400: un parametro non supportato dopo un aggiornamento (esegui claude update), oppure un'immagine o un file che il modello non può accettare. ## Errore API 429 — limite di frequenza / frequenza superata Si applicano tre limiti: richieste al minuto, token al minuto e richieste simultanee. Le sessioni con agenti raggiungono prima il limite di concorrenza: ogni sottoagente è una richiesta parallela in streaming che occupa uno slot fino al completamento. Riduci il parallelismo, attendi il tempo indicato da retry-after e, per un lavoro prolungato, richiedi un limite di concorrenza più alto per il tuo account del gateway. ## Errore OAuth: timeout di 15000ms superato La procedura /login non è riuscita a raggiungere il servizio di autenticazione di Anthropic entro 15 secondi. È un problema di rete, non dell'account: un proxy aziendale, una VPN che interrompe il callback o una regione in cui l'endpoint di autenticazione è lento. Riprova una volta; se il problema persiste, imposta HTTPS_PROXY per la tua rete, oppure evita del tutto OAuth usando una chiave API: con ANTHROPIC_API_KEY (e ANTHROPIC_BASE_URL per un gateway), Claude Code non avvia mai la procedura di accesso. ## Errore OAuth: richiesta fallita con codice di stato 500 Il servizio di autenticazione ha risposto con un errore del server durante l'accesso o il rinnovo del token. La causa non è dalla tua parte; attendi qualche minuto ed esegui nuovamente /login. Se devi lavorare subito, l'accesso tramite chiave API descritto sopra aggira OAuth, e claude setup-token su una macchina dove l'accesso funziona produce un token di lunga durata che puoi trasferire su quella dove non funziona. ## Errore: processo di Claude Code terminato con codice 1 È l'estensione dell'IDE o l'app desktop a segnalare che la CLI avviata si è arrestata in modo anomalo all'avvio: l'errore effettivo si trova al livello sottostante. Apri un terminale ed esegui claude direttamente: vedrai il messaggio effettivo, che quasi sempre riguarda una versione di Node.js precedente a 18, un PATH danneggiato dopo un'installazione tramite npm, un'installazione nativa corrotta o un file settings.json con JSON non valido (una virgola fuori posto in un blocco di hook è un classico). claude doctor verifica i primi tre; un linter per JSON rileva il quarto. Reinstallare con il programma di installazione nativo risolve la maggior parte degli altri problemi. ## 401 / errori di autenticazione invalid x-api-key o authentication_error significa che la chiave non appartiene all'endpoint. Se ANTHROPIC_BASE_URL punta al gateway, la chiave deve essere una chiave del gateway; una chiave della console Anthropic verrà rifiutata, e vale anche il contrario. /status mostra quali endpoint e chiave sono attivi. Se usi /login e una chiave API contemporaneamente, prevale la chiave. I cicli di rinnovo del token, Not logged in dopo un accesso riuscito e gli errori 403 dei proxy sono trattati nella [pagina 401 / 403](/it/claude-code/errors/auth-401-403/). ## "Nessun upstream funzionante" Non è un errore API: è il bilanciatore di carico davanti a un servizio che segnala l'assenza di backend disponibili. Sull'endpoint ufficiale indica un'interruzione del servizio; su un gateway significa che l'intero pool a monte è inattivo o soggetto a limitazioni. Attendi e riprova; non modificare la configurazione. ## Claude Code non funziona affatto - Si avvia e poi si chiude senza messaggi → esegui claude /doctor; di solito è un problema della versione di Node o di PATH. - Si blocca all'avvio o durante la sessione → vedi [blocchi e sessioni ferme](/it/claude-code/errors/claude-code-hangs/) e [errori di connessione](/it/claude-code/errors/connection-lost/). - command not found → vedi la guida all'installazione. - Gli strumenti non funzionano a causa di errori di autorizzazione → /permissions, oppure --allowedTools negli script. ## 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](/register?promo=FIXIT) ## Domande frequenti Perché Claude Code continua a restituire l'errore API 500? Il backend del modello presenta un guasto o è sovraccarico (529 è la forma esplicita). Riprova dopo una pausa, cambia livello con /model oppure riprendi con claude -c. Il problema non è la tua configurazione.Come risolvo l'errore 400 di Claude Code relativo alla lunghezza del contesto? Esegui /compact per riassumere la sessione, /clear per reimpostarla oppure passa a una variante del modello con contesto da 1M.Perché Claude Code segnala una chiave API non valida? La chiave non corrisponde all'endpoint in ANTHROPIC_BASE_URL. L'URL del gateway richiede una chiave del gateway; l'URL di Anthropic richiede una chiave della console. ## 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](/register?promo=FIXIT) [Scopri i piani illimitati](/it/plans/) 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 [Claude Code: la guida completa](/it/claude-code/)[Come installare Claude Code](/it/claude-code/install/)[Documentazione della CLI di Claude Code: comandi e flag](/it/claude-code/cli/)[Prezzi e limiti di Claude Code, spiegati](/it/claude-code/pricing/)[L'SDK di Claude Code, ora Claude Agent SDK](/it/claude-code/sdk/)[Skill e plugin di Claude Code](/it/claude-code/skills/)[Claude Code in GitHub: App, Action e @claude](/it/claude-code/github/)[Claude Code ha un'interfaccia web? Le versioni web, desktop e per IDE spiegate](/it/claude-code/web-and-desktop/)[Quale modello usa Claude Code e come cambiarlo](/it/claude-code/models/)[Claude Code è open source?](/it/claude-code/open-source/)[Tutorial di Claude Code: la tua prima sessione reale](/it/claude-code/tutorial/)[Claude per studenti: Claude Code, l'API e ciò che offre davvero il settore education](/it/claude-code/for-students/)[Come usare Claude Code per l'automazione QA](/it/claude-code/qa-automation/)[Claude Code e Cursor a confronto: quale scegliere, quando — e come usarli entrambi](/it/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: confronto tra gli agenti da terminale](/it/claude-code/vs-codex/)[Subagenti di Claude Code: come funzionano, come definirli e team di agenti](/it/claude-code/subagents/)[Hook di Claude Code: controllo deterministico su ciò che fa l'agente](/it/claude-code/hooks/)[MCP in Claude Code: connessione ai server, ambiti, MCP remoto ed esempi concreti](/it/claude-code/mcp/)[L'ecosistema Claude Code: router, framework, plugin e gli elenchi che li raccolgono](/it/claude-code/ecosystem/)[Claude Code in VS Code: l'estensione, l'uso dal terminale e gli errori](/it/claude-code/vscode/)[Come usare OpenRouter in Claude Code (e quando evitarlo)](/it/claude-code/openrouter/)[Errore di limite di frequenza di Claude: cosa significa "Errore API: limite di frequenza raggiunto" e come risolverlo](/it/claude-code/rate-limits/)[Come usare Claude Code: dall'installazione all'uso quotidiano](/claude-code/zh/)