Home › Claude Code › Errori › Errore API 500
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 API: 500" di Claude Code: cosa significa e cosa lo risolve davvero

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} indica che il lato modello dell'API non riesce a rispondere. È l'errore più segnalato nella storia di Claude Code — una ricerca di "Errore API: 500" nel tracker delle segnalazioni di anthropics/claude-code restituisce 881 segnalazioni, e ogni settimana ne vengono ancora aperte di nuove. Quasi mai dipende da te; quasi sempre si risolve in meno di un minuto.

TLDR

  • 500 = l'API ha avuto un errore interno. La chiave, il prompt e la configurazione sono corretti.
  • Controlla prima status.claude.com — durante gli incidenti, centinaia di persone riscontrano l'errore contemporaneamente.
  • Riprendi con claude -c; se si ripete, /model a un'altra fascia di modelli (gli errori 500 sono spesso specifici del modello).
  • Un 500 proprio quando il contesto raggiunge il 0% significa che la compattazione è fallita: /compact o /clear, poi continua.

I messaggi esatti

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}}
API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"},"request_id":null}
[Bug] Anthropic API Error: 500 Internal Server Error

Tutti e tre indicano lo stesso errore. I primi due sono quelli visualizzati dalla CLI; il terzo è il titolo delle segnalazioni di bug generate automaticamente che Claude Code invia tramite /bug, ed è per questo che il tracker ne contiene centinaia identiche — le più recenti di questo gruppo sono state aperte il settembre 16 e 22 settembre 2026, e l'ultima segnala insieme errori 500 e 529.

Perché succede

  • Incidente a monte. È di gran lunga la causa più comune. Quando Anthropic subisce un'interruzione parziale, tutti gli utenti di un modello vedono errori 500 contemporaneamente — all'ondata di gennaio 2026 in #9066 il personale di Anthropic ha risposto con un solo link: la pagina di stato.
  • Un modello ha problemi, gli altri funzionano. Gli errori 500 riguardano spesso singoli modelli. In #3127 la soluzione più votata era semplicemente passare da Opus a Sonnet; la stessa sessione ha poi funzionato.
  • Contesto esaurito, compattazione fallita. La segnalazione originale #3127 ha riscontrato 500 "quando il contesto residuo è esattamente al 0% e Claude Code non è riuscito a compattarlo automaticamente". Una richiesta troppo grande può manifestarsi come 500 anziché con il più chiaro Prompt is too long 400.
  • Una struttura specifica della richiesta che il backend non riesce a gestire. Più raro; #91801 ha riprodotto errori 500 legati a determinati prefissi del prompt. Se un messaggio genera sistematicamente un errore 500 e gli altri no, modifica quel messaggio.

Soluzioni, nell'ordine in cui provarle

  • 1. Controlla status.claude.com. Se c'è un incidente, nessun intervento da parte tua sarà utile: attendi che si risolva.
  • 2. Riprendi, senza riavviare: claude -c continua l'ultima sessione; il turno incompleto viene ritentato.
  • 3. Passa a un'altra fascia di modelli per l'attività corrente: /model → Sonnet se stavi usando Opus/Fable, o viceversa. Capacità ed errori dipendono dal singolo modello.
  • 4. Se l'indicatore del contesto era vicino al 0%: /compact (oppure /clear e fornisci di nuovo le istruzioni), quindi continua. Anche passare a una (1M) variante del modello funziona.
  • 5. Aggiorna: claude update. Nel tempo sono stati corretti lato client diversi bug correlati a 500.
  • 6. L'errore persiste con un messaggio specifico? Riformulalo o dividilo: un errore 500 legato alla struttura della richiesta è deterministico.
claude -c              # resume the session
/model claude-sonnet-5 # inside the session: another tier
/compact               # if the context was exhausted
claude update          # latest CLI

500 vs 529 vs 429

  • 500 — si è verificato un errore del server. Riprova, cambia modello, controlla lo stato.
  • 529 — il server è operativo ma ha raggiunto la capacità massima (overloaded_error). Consulta la guida al sovraccarico.
  • 429 — *hai* superato un limite. Consulta limiti di frequenza.
  • 400 — la richiesta stessa è stata rifiutata. Consulta Errore API 400.

Perché i gateway ne riscontrano meno

Un errore 500 proveniente da un account del fornitore a monte è un singolo punto di guasto solo se disponi di un unico account a monte. Questo gateway ne raggruppa diversi e inoltra la richiesta a un altro quando uno restituisce 500 o 529, quindi la maggior parte degli errori 500 transitori non arriva mai al tuo terminale. Un vero incidente che coinvolge l'intero fornitore, invece, arriva comunque: nessuno può aggirare l'indisponibilità del modello. Configura Claude Code per usarlo con 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 Claude Code API Error 500?

L'API di Claude ha riscontrato un errore interno durante la risposta ({"type":"api_error","message":"Errore interno del server"}). È un errore lato server, non un problema della tua chiave o configurazione.

Come risolvo API Error: 500 in Claude Code?

Controlla status.claude.com, riprendi con claude -c, cambia fascia di modelli con /model e usa /compact se il contesto era quasi pieno. Se il problema persiste, aggiorna con claude update.

Perché continuo a ricevere errori 500 da Claude?

Di solito è dovuto a un incidente in corso presso il fornitore a monte o a un modello con prestazioni degradate. Se un solo messaggio lo provoca ogni volta, il problema è la richiesta stessa: riformulala o dividila.

Claude è fuori servizio quando ricevo l'errore 500?

Spesso sì, almeno per un modello. Durante un incidente, sia la pagina di stato sia il sistema di segnalazione dei problemi su GitHub si riempiono di segnalazioni nel giro di pochi minuti.

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 risolverliErrore "Sovraccarico" di Claude (errore API 529): cosa significa e cosa fareErrore 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