Riferimento degli errori

​

Trova il tuo errore

​

Tentativi automatici

• Errori del server, risposte sovraccariche e timeout delle richieste che arrivano prima che una qualsiasi risposta di Claude sia stata trasmessa.
• Un errore del server o una risposta sovraccarica che arriva dopo che Claude ha finito di pensare ma prima di aver iniziato un testo o una chiamata a uno strumento. Claude Code ritenta un errore del server a quel punto fino a due volte. Prima della v2.1.284, Claude Code terminava il turno con l’errore a quel punto.
• Connessioni interrotte. Quando una connessione si interrompe a metà di una richiesta prima che Claude abbia completato una qualsiasi parte della sua risposta, incluso il suo ragionamento, Claude Code invia nuovamente la richiesta con lo stesso backoff e il turno continua, anche se del testo aveva già iniziato a essere trasmesso. Quando si interrompe dopo che Claude ha finito di pensare ma prima di aver iniziato un testo o una chiamata a uno strumento, Claude Code invece invia nuovamente la richiesta fino a due volte in rapida successione, e termina il turno con Connection lost before a response was produced se la connessione continua a interrompersi a quel punto.
• Una connessione che Claude Code rileva è stata interrotta dal tuo computer che si è addormentato a metà di una richiesta. Claude Code la conta come una connessione interrotta secondo le regole sopra; una volta che l’etichetta di riprovazione nomina il motivo specifico, legge Connection lost while your computer was asleep, e se il turno termina dopo che Claude ha finito di pensare ma prima di un testo o di una chiamata a uno strumento, il messaggio legge Your computer went to sleep before a response was produced.
• Un flusso di risposta bloccato, quando le intestazioni di risposta sono arrivate ma nessuna risposta di Claude è arrivata, o quando Claude ha finito di pensare ma non ha iniziato un testo o una chiamata a uno strumento: Claude Code interrompe la connessione bloccata e trasmette nuovamente la richiesta in streaming al massimo una volta. Se la risposta si blocca una seconda volta dopo che Claude ha finito di pensare ma prima di un testo o di una chiamata a uno strumento, Claude Code termina il turno con The response stalled before a response was produced.
• Una richiesta di streaming a cui l’API non risponde mai con intestazioni di risposta, su una connessione dove il first-byte deadline runs: Claude Code la interrompe alla scadenza e la invia nuovamente al massimo una volta per richiesta di modello, entro il budget di riprovazione, quindi termina il turno con No response from API se anche quel tentativo rimane senza risposta. Quando imposti CLAUDE_CODE_RETRY_WATCHDOG, il limite di un tentativo non si applica.
• Una risposta in streaming che il filtro dei contenuti di output dell’API interrompe prima che Claude abbia finito il suo ragionamento o iniziato un testo o una chiamata a uno strumento. Claude Code invia nuovamente la richiesta una volta, entro il budget di riprovazione, e mostra Output blocked by content filtering policy se il filtro interrompe anche la seconda risposta.
• Throttle 429 temporanei, ma non il 429 del limite di spesa di un gateway, che non è un throttle; vedi Spend limit reached.
  • Quando sei connesso con un abbonamento claude.ai, questo include throttle 429 che non portano le intestazioni di quota del tuo piano. Prima della v2.1.199, Claude Code ritentava questi throttle solo per le chiavi API e gli accessi Enterprise.
• Una richiesta rifiutata perché l’input più max_tokens supera il limite di contesto. Inviarla nuovamente invariata fallirebbe allo stesso modo, quindi Claude Code ritenta con un max_tokens ridotto, e smette di ritentare e compatta invece in due casi:
  • Quando nessuna riduzione può adattarsi, ad esempio quando la conversazione stessa riempie quasi la finestra di contesto.
  • Quando un tentativo non può ridurre ulteriormente max_tokens. Prima della v2.1.218, Claude Code poteva inviare nuovamente una richiesta ridotta che ancora non si adattava, ad esempio quando il budget di ragionamento esteso superava il contesto rimanente, fino a quando il budget di riprovazione non si esauriva.
• Una credenziale Google Cloud scaduta o mancante su Google Cloud’s Agent Platform, o credenziali AWS che non riescono a caricarsi sulla tua macchina. Claude Code scarta le sue credenziali memorizzate nella cache e ritenta fino a due volte, quindi segnala l’errore in modo che tu possa autenticarti di nuovo subito, come descritto in Could not load AWS or Google Cloud credentials. Prima della v2.1.228, Claude Code ritentava una credenziale Google Cloud non riuscita attraverso il budget di riprovazione completo prima di mostrare l’errore.
• Un 401 o 403 dall’API Anthropic, direttamente o attraverso un LLM gateway, mentre uno script apiKeyHelper fornisce la credenziale. Claude Code esegue nuovamente lo script e ritenta con il suo output aggiornato, entro il budget di riprovazione completo. Quando lo script stesso fallisce al nuovo tentativo, Claude Code mostra Your apiKeyHelper script is failing invece.

• Un errore di convalida del certificato TLS, come un proxy che ispeziona TLS, un bundle NODE_EXTRA_CA_CERTS mancante, o un certificato scaduto. Claude Code segnala l’errore al primo tentativo, in modo che tu possa correggere subito la configurazione del certificato; vedi SSL certificate errors. Claude Code ritenta comunque condizioni TLS transitorie come un timeout di handshake. Prima della v2.1.199, Claude Code ritentava i guasti dei certificati attraverso il budget di riprovazione completo prima di mostrare l’errore.
• Un errore del server, una connessione interrotta, o un flusso bloccato che arriva dopo che Claude ha completato un blocco di testo o una chiamata a uno strumento, o ne ha iniziato uno dopo aver finito il suo ragionamento, ma prima di finire la risposta. Claude Code non esegue nuovamente la richiesta, perché ciò potrebbe eseguire le stesse chiamate agli strumenti due volte. Mantiene ciò che Claude ha completato, esegue le chiamate agli strumenti che Claude ha finito, e continua il turno dai loro risultati. Per ciò che vedi in una sessione interattiva e in una non interattiva, leggi The response above may be incomplete. Prima della v2.1.199, Claude Code scartava l’output parziale e segnalava l’intero turno come un errore quando un errore del server arrivava a metà del flusso.
• Un guasto che arriva dopo che Claude ha finito la risposta: non c’è nulla da ritentare, quindi Claude Code mantiene la risposta completa e termina il turno normalmente.
• Una Amazon Bedrock streaming response with an unexpected content-type, perché il gateway o il proxy che riscrive la risposta riscriverebbero il tentativo allo stesso modo. Richiede Claude Code v2.1.208 o successivo.
• Un tentativo non in streaming di una richiesta in streaming non riuscita che ottiene uno stato di successo ma no Claude API message in the body. Claude Code termina il turno con quell’errore.
• Una richiesta che il controllo della politica della tua organizzazione ha negato, che emerge come una riga API Error: che porta il messaggio di negazione. Gli amministratori della tua organizzazione hanno configurato il controllo con Inference hooks, una funzione Claude Enterprise, e il messaggio termina con le istruzioni che hanno configurato, o per impostazione predefinita ti dice di contattarli. Claude Code non invia nuovamente la richiesta negata allo stesso modello o a un fallback model, perché il diniego riguarda il contenuto della richiesta piuttosto che il modello. Prima della v2.1.239, Claude Code poteva inviare nuovamente una richiesta negata, senza streaming o su un fallback model configurato, prima di mostrarti il diniego.

​

Cosa vedi mentre Claude Code ritenta o attende

• Prima che Claude abbia completato un blocco di testo o una chiamata a uno strumento, o ne abbia iniziato uno dopo aver finito il suo ragionamento, Claude Code ritenta la richiesta o termina il turno con un errore. Automatic retries dice quali blocchi ritenta e quante volte.
• Dopo che Claude ha completato un blocco di testo o una chiamata a uno strumento, o ne ha iniziato uno dopo aver finito il suo ragionamento, ma prima che Claude abbia finito la risposta, Claude Code mantiene ciò che Claude ha completato, continua il turno da qualsiasi chiamata a uno strumento che Claude ha finito, e mostra The response above may be incomplete. In una sessione non interattiva, e per la risposta di un subagent in qualsiasi sessione, Claude Code potrebbe prima chiedere a Claude di continuare la risposta; quella voce dice quando lo fa e quando vedi ancora l’avviso lì.
• Dopo che Claude ha finito la risposta, Claude Code termina il turno normalmente.

​

Sintonizza il comportamento dei tentativi

​

Errori del server

​

API Error: 500 Internal server error

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

• Controlla status.claude.com o la pagina di stato del provider indicata nel messaggio per eventuali incidenti in corso
• Aspetta un minuto, quindi invia di nuovo il messaggio. Il tuo messaggio originale è ancora nella conversazione, quindi per un prompt lungo puoi digitare try again invece di incollarlo tutto.
• Se l’errore persiste senza alcun incidente pubblicato, esegui /feedback in modo che Anthropic possa indagare con i dettagli della tua richiesta. Consulta Segnalare un errore se /feedback non è disponibile nel tuo ambiente.

​

API Error: Repeated 529 Overloaded errors

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

• Controlla status.claude.com o la pagina di stato del provider indicata nel messaggio per eventuali avvisi sulla capacità
• Riprova tra qualche minuto
• Esegui /model e passa a un modello diverso per continuare a lavorare, poiché la capacità è monitorata per modello. Claude Code ti chiede di farlo quando un modello è sotto un carico particolarmente elevato, ad esempio Opus is experiencing high load, please use /model to switch to Sonnet. Sui modelli Fable il messaggio indica Fable. In una sessione eseguita dall’app Claude Desktop, come la scheda Code o Cowork, il messaggio è Opus is experiencing high load. Switch to Sonnet. e cambi modello con il selettore di modelli dell’app.

​

Request timed out

Request timed out

• Riprova la richiesta
• Se la causa è una rete lenta o un proxy, aumenta API_TIMEOUT_MS come descritto in Nuovi tentativi automatici
• Se i timeout sono frequenti e la tua rete per il resto funziona correttamente, consulta Errori di rete e di connessione più avanti

​

No response from API

API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.

• Primo tentativo: CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS quando lo imposti su 1 o più, limitato a un valore compreso tra 10 secondi e 30 minuti. Altrimenti Claude Code usa il timeout del watchdog a livello di byte indicato in Watchdog di inattività dello streaming, quindi le variabili che modificano quel timeout modificano anche questa attesa. In entrambi i casi, Claude Code aggiunge un secondo per ogni 32KB del corpo della richiesta.
• Nuovo tentativo: un secondo in meno di API_TIMEOUT_MS, poco meno di 10 minuti per impostazione predefinita, in modo che il nuovo tentativo possa durare più a lungo di un proxy o gateway che trattiene la risposta fino al completamento della generazione. Su Amazon Bedrock, il nuovo tentativo usa la stessa scadenza del primo tentativo e il messaggio mostra una sola durata invece di due.

• Invia di nuovo il messaggio. Il tuo messaggio originale è ancora nella conversazione, quindi per un prompt lungo puoi digitare try again invece di incollarlo tutto.
• Se si ripete, trattalo come un problema di rete o di proxy.
• Se un proxy o gateway sulla tua rete trattiene le risposte fino al loro completamento, aumenta API_TIMEOUT_MS in modo che il nuovo tentativo attenda più a lungo. Su Amazon Bedrock, aumenta anche CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS.
• Se il primo tentativo continua ad andare in timeout e poi il nuovo tentativo riesce, aumenta CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS in modo che anche il primo tentativo attenda abbastanza a lungo.

​

The response above may be incomplete

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.
API Error: Part of the response never arrived. The response above may be incomplete.
API Error: The response stream was malformed. The response above may be incomplete.

• Server error mid-response: un errore di sovraccarico o un errore del server 5xx a metà flusso. Questa variante richiede Claude Code v2.1.199 o successivo; prima di allora, in questo caso l’output parziale veniva scartato e l’intero turno veniva segnalato come errore.
• Connection lost mid-response: la connessione si è interrotta. Vedi questa variante anche quando un proxy o gateway chiude regolarmente il corpo della risposta prima che la risposta sia terminata.
• Your computer went to sleep mid-response: Claude Code ha rilevato che il tuo computer è entrato in sospensione mentre la risposta era in streaming. Quando il computer si riattiva, Claude Code considera la connessione interrotta e smette di leggerla.
• Part of the response never arrived: un evento del flusso è andato perso tra l’API e Claude Code, quindi un evento successivo ha fatto riferimento a contenuto mai arrivato. Prima della v2.1.281, questo caso terminava il turno con API Error: Content block not found.
• The response stream was malformed: è arrivato un evento per un blocco di contenuto già terminato, oppure è arrivato un evento danneggiato. Un evento danneggiato è un evento i cui dati non sono JSON valido, il cui contenuto manca o il cui contenuto non corrisponde al tipo dell’evento. Prima della v2.1.284, quando un evento con JSON non valido arrivava dopo che Claude aveva completato il ragionamento, un blocco di testo o una chiamata a uno strumento, veniva invece mostrato l’errore grezzo del parser, ad esempio uno che inizia con API Error: JSON Parse error.
• The response stopped arriving: la connessione è rimasta aperta ma ha smesso di trasmettere dati, quindi il watchdog di inattività dello streaming l’ha interrotta. Prima della v2.1.222, Claude Code poteva segnalare questo errore anche sulle connessioni gateway raggiunte tramite ANTHROPIC_BASE_URL o ANTHROPIC_AWS_BASE_URL mentre i ping keep-alive del server continuavano ad arrivare, perché su quelle connessioni contava solo gli eventi di risposta analizzati; l’aggiornamento elimina quei timeout spuri su quei percorsi. I gateway raggiunti tramite un URL di base del provider come ANTHROPIC_BEDROCK_BASE_URL non sono coperti dal watchdog a livello di byte; consulta Watchdog di inattività dello streaming.

• Se Claude aveva completato solo il ragionamento, Claude Code invia di nuovo la richiesta. Quando i flussi inviati di nuovo si interrompono allo stesso modo, il turno termina con Part of the response never arrived and no response was produced. Try again. o The response stream was malformed and no response was produced. Try again.
• Se non era stato completato nulla, Claude Code invia invece di nuovo la richiesta senza streaming. Se hai disattivato quel fallback con CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK, il turno termina con API Error: Content block not found per un evento perso o con API Error: Content block already closed per un evento duplicato. Per un evento danneggiato con il fallback disattivato, il turno termina con API Error: Stream event unreadable o con l’errore grezzo del parser.

• Nelle fasi iniziali della risposta, Claude Code riprova dopo l’errore oppure termina il turno con un errore diverso. Consulta Nuovi tentativi automatici.
• Quando uno di questi errori arriva dopo che Claude ha terminato la risposta, Claude Code conserva la risposta completa e termina il turno normalmente, senza questo avviso. Prima della v2.1.222, Claude Code mostrava questo avviso quando la connessione si interrompeva o si bloccava dopo il completamento della risposta e segnalava il turno come errore anche se la risposta era completa.
• In una sessione non interattiva, come un’esecuzione -p, un’esecuzione dell’Agent SDK o una sessione cloud, non devi inviare tu continue quando la risposta interrotta si trova nella conversazione principale e contiene testo ma nessuna chiamata a uno strumento: Claude Code conserva l’output parziale e chiede a Claude di continuare da dove si era fermato, fino a tre volte di seguito. Vedi questo avviso per una risposta di questo tipo solo quando Claude Code ha esaurito quelle continuazioni. Prima della v2.1.246, Claude Code terminava un turno non interattivo con questo avviso alla prima interruzione.
• In un subagent, che la sessione sia interattiva o meno: quando la sua risposta interrotta contiene testo ma nessuna chiamata a uno strumento, Claude Code chiede al subagent di continuare. L’avviso diventa l’ultimo messaggio del subagent solo quando quelle continuazioni sono esaurite. Prima della v2.1.257, un subagent mostrava questo avviso alla prima interruzione.

• In una sessione interattiva, leggi la risposta che rimane sullo schermo: Claude Code conserva ogni blocco che Claude ha completato prima dell’errore, ma scarta un blocco finale interrotto quando il turno termina, quindi le frasi finali o le chiamate agli strumenti finali potrebbero mancare. Rispondi con continue per far riprendere Claude dal suo ultimo blocco completato.
• In modalità non interattiva (-p):
  • Con l’output di testo predefinito, Claude Code stampa l’ultimo blocco di testo completato che conserva ancora da un punto precedente del turno, seguito da questo messaggio. Quando non ne conserva nessuno, Claude Code stampa solo questo messaggio, ad esempio perché ha compattato la conversazione a metà turno e ha eliminato quel testo. Prima della v2.1.219, Claude Code stampava solo questo messaggio nell’output di testo di -p e scartava la risposta già prodotta.
  • Con --output-format json o stream-json, Claude Code riporta questo messaggio nel campo result.
  • Per continuare il turno quando la connessione è stabile, riprendi la sessione e invia continue come descritto in Continuare le conversazioni.

​

Auto mode cannot determine the safety of an action

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

• Riprova dopo qualche secondo; Claude vede lo stesso messaggio e di solito riprova da solo. Un errore temporaneo non è legato all’idoneità alla modalità auto; non devi modificare le impostazioni
• Se i nuovi tentativi continuano a non riuscire, prosegui con attività di sola lettura e torna più tardi all’azione bloccata
• Su Amazon Bedrock, se il messaggio si ripresenta a ogni nuovo tentativo, verifica che il tuo account possa invocare il modello indicato: per i modelli Amazon Bedrock standard, conferma che la tua policy IAM ne consenta l’invocazione; per gli ID modello Mantle, contatta il team del tuo account AWS
• Se il messaggio si ripresenta a ogni nuovo tentativo e indica il modello che hai impostato in CLAUDE_CODE_AUTO_MODE_MODEL, verifica che l’API o il provider cloud su cui viene eseguita la tua sessione serva quell’ID modello. In caso contrario, imposta la variabile su un ID modello che serve, oppure rimuovi la variabile per usare il modello del classificatore predefinito.

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

• Riprova l’azione; di solito riesce al tentativo successivo
• Esegui claude --debug e ripeti l’azione per vedere i dettagli nel log di debug

Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

• A un subagent in background in un’esecuzione -p senza --input-format stream-json, Claude Code restituisce un risultato di errore contenente Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode
• In tutti gli altri casi, incluse le sessioni interattive e la conversazione principale di un’esecuzione -p, Claude Code restituisce quel rifiuto a Claude

• Non si tratta di una decisione sulla tua azione. Contenuti già presenti nella tua conversazione hanno attivato un filtro di sicurezza dell’API quando la modalità auto ha inviato la conversazione al classificatore
• Riprovare non servirà; gli stessi contenuti della conversazione attiveranno di nuovo il filtro
• In una sessione interattiva, passa a una modalità di permesso diversa in modo da poter approvare l’azione quando ti viene chiesto
• Avvia una nuova conversazione senza i contenuti che attivano il filtro

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

• In una sessione interattiva, la modalità auto ripiega su una normale richiesta di permesso per quell’azione, così puoi approvarla o negarla manualmente
• A un subagent in background in un’esecuzione -p non interattiva senza --input-format stream-json, Claude Code restituisce un risultato di errore contenente Agent aborted: auto mode classifier transcript exceeded context window in headless mode e l’esecuzione continua
• Altrove in un’esecuzione -p senza un --permission-prompt-tool, non c’è alcuna richiesta di permesso su cui ripiegare, quindi l’azione non viene eseguita e l’esecuzione continua

• In una sessione interattiva, approva o nega l’azione nella richiesta che appare
• In una sessione interattiva, esegui /compact per ridurre le dimensioni della conversazione in modo che le azioni successive rientrino di nuovo nella finestra del classificatore

​

The server returned no safety verdict

The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.

Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

• In una sessione interattiva, il messaggio appare come avviso nella trascrizione e il turno termina
• In un’esecuzione -p non interattiva, l’esecuzione termina e segnala un errore di esecuzione. Con l’output di testo predefinito, il messaggio viene stampato su stderr.
• Quando un subagent ha raggiunto il limite, il subagent si ferma prima di terminare e Claude riceve ciò che ha prodotto, con una nota che indica che la modalità auto lo ha fermato

• In una sessione interattiva, premi Ctrl+O per leggere il testo del rifiuto nel visualizzatore della trascrizione.
• Se il rifiuto indica (the conversation is too long for the check), esegui /compact al prompt di Claude Code per accorciare la conversazione. Finché la conversazione non è più breve, inviare un altro messaggio produce lo stesso rifiuto. Se hai disattivato la compattazione automatica, riattivala in modo che Claude Code compatti da solo la prossima volta.
• Invia un altro messaggio per far riprovare Claude. Il conteggio delle risposte riparte da zero.
• Se l’interruzione si ripete e le tue richieste passano attraverso un gateway o proxy LLM, verifica se tronca o riscrive le risposte in streaming. La sezione Revisione del classificatore lato server indica quale comportamento del gateway causa i rifiuti, e la guida alla compatibilità dei gateway elenca cosa deve essere inoltrato senza modifiche.
• Imposta CLAUDE_CODE_AUTO_MODE_SERVER=0 prima di avviare Claude Code per usare invece le sue richieste al classificatore. Prima della v2.1.281, Claude Code non leggeva la variabile su una connessione diretta ad Anthropic API.
• Per approvare tu stesso le azioni, esci dalla modalità auto

​

Was not reviewed and did not run

<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier. Claude Code will try to compact the conversation before the next request; if this action is still needed after that, issue it again and it will be reviewed normally.

• Un rifiuto gave no verdict (the conversation is too long for the check)
• Il messaggio Auto mode classifier transcript exceeded context window

• Se la compattazione annunciata dal messaggio riesce, non devi fare nulla.
• Se vedi uno di questi due messaggi, esegui /compact al prompt di Claude Code per accorciare tu stesso la conversazione. Se hai disattivato la compattazione automatica, riattivala in modo che Claude Code compatti da solo la prossima volta.

​

Agent terminated early due to an API error

Agent terminated early due to an API error: <error detail>

• Individua la sezione di questa pagina corrispondente al dettaglio dell’errore dopo i due punti, come Limiti di utilizzo o Errori del server, e segui i passaggi di quella sezione
• Una volta risolto l’errore sottostante, chiedi a Claude di riprovare l’attività o di riprendere il subagent

​

Limiti di utilizzo

​

You’ve hit your session limit

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm

• Attendi l’ora di ripristino mostrata nell’errore
• Nella scheda Code dell’app Desktop, la scheda session-limit offre una casella di controllo Auto-continue when limits reset. La scheda weekly-limit non lo fa. Quando è selezionata, l’app Desktop riprova il turno interrotto dopo il ripristino e mostra l’ora del nuovo tentativo sulla scheda. La casella di controllo Desktop e l’impostazione Continue automatically at usage limit della CLI in /config sono separate, quindi disattiva ciascuna per conto proprio.
• Per il limite Opus o Sonnet, esegui /model e passa a un modello al di fuori di quella famiglia per continuare a lavorare. Ogni modello ha la propria cache di prompt, quindi la richiesta successiva rilegge l’intera conversazione senza hit della cache; vedi Switching models
• Esegui /usage per vedere i limiti del tuo piano e quando si ripristinano
• Esegui /usage-credits per acquistare utilizzo aggiuntivo su Pro e Max, o per richiederlo al tuo amministratore su Team ed Enterprise. Vedi usage credits for paid plans per come viene fatturato.
• Per aggiornare il tuo piano per limiti di base più elevati, vedi claude.com/pricing

​

Usage credits required for 1M context

API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

• Esegui /model e seleziona la variante senza il suffisso [1m] per tornare alla finestra di contesto standard
• Dove il messaggio nomina /usage-credits, eseguilo per attivare la fatturazione a consumo per la variante 1M su Pro e Max, o per richiedere crediti di utilizzo al tuo amministratore su Team ed Enterprise. Una volta che i crediti di utilizzo sono attivati, riavvia Claude Code o avvia una nuova sessione, a seconda di quello che dice il messaggio. Fino al riavvio, la sessione rimane al limite di contesto standard.
• Se l’errore persiste dopo /model, un ID modello 1M potrebbe essere impostato altrove. Vedi Setting your model per i percorsi di configurazione da controllare in ordine di priorità.
• Per rimuovere completamente le varianti 1M dal selettore di modelli, imposta CLAUDE_CODE_DISABLE_1M_CONTEXT=1

​

The prompt to confirm went unanswered

Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

• Dove viene eseguita la sessione, al terminale o nell’applicazione che la ospita, invia un altro prompt e rispondi al prompt di consenso quando riappare. Per una sessione in background, collegati prima dalla vista agenti. Reinviare da un client Remote Control mostra di nuovo questo messaggio, perché il client non può visualizzare il prompt.
• Esegui /model per passare a un modello che non fattura i crediti di utilizzo
• Per darti più tempo, imposta dialogExpiry su un valore più lungo o "never"

​

Server is temporarily limiting requests

API Error: Server is temporarily limiting requests (not your usage limit)

• Attendi brevemente e riprova
• Controlla status.claude.com se persiste

​

Request rejected (429)

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

• Esegui /status e conferma che la credenziale attiva è quella che ti aspetti. Un ANTHROPIC_API_KEY dimenticato nel tuo ambiente può instradare le richieste attraverso una chiave di livello inferiore invece del tuo abbonamento.
• Controlla la console del tuo provider per i limiti attivi e richiedi un livello più elevato se necessario
• Per le chiavi API Anthropic, vedi il riferimento sui rate limit per come funzionano i livelli e come impostare i limiti per workspace
• Riduci la concorrenza: abbassa CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, evita di eseguire molti subagent in parallelo, o passa a un modello più piccolo con /model per esecuzioni script ad alto volume

​

You’ve hit your monthly spend limit

You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

• Su Pro e Max, aumenta il tuo limite di spesa mensile in Settings > Usage su claude.ai, o esegui /usage-credits
• Su Team ed Enterprise, aumenta il limite in Organization settings > Usage se gestisci la fatturazione, o chiedi a un amministratore di farlo. /usage-credits invia quella richiesta al tuo amministratore per te
• Per il limite di un canale, chiedi a un proprietario dell’organizzazione o al manager del canale di aumentarlo su claude.ai. Vedi Per-channel limits nella documentazione Claude Tag
• Se il messaggio nomina un’ora di ripristino per la finestra del tuo piano, puoi invece aspettare
• Esegui /usage per vedere le finestre del tuo piano e quando ciascuna si ripristina

​

Spend limit reached

spend limit reached (daily; resets 2026-08-09 00:00 UTC)

• Attendi l’ora di ripristino che il messaggio nomina, o segui le istruzioni dell’operatore se il messaggio le contiene
• Chiedi al tuo operatore del gateway di aumentare il limite se lo raggiungi regolarmente

​

Credit balance is too low

Credit balance is too low

• Se hai un piano Pro, Max, Team o Enterprise e vedi questo, esegui /status e controlla la riga API key. Un ANTHROPIC_API_KEY approvato nel tuo ambiente instrada le richieste attraverso quella chiave invece del tuo abbonamento. Annullalo nella shell corrente e rimuovilo dal tuo profilo shell, quindi riavvia claude. Esegui /login se non hai ancora effettuato l’accesso con il tuo abbonamento.
• Aggiungi crediti su platform.claude.com/settings/billing, e considera di abilitare il ricaricamento automatico lì in modo che il saldo si riempia prima di raggiungere lo zero
• Imposta i limiti di spesa per workspace nella Console per evitare che un singolo progetto esaurisca il saldo dell’organizzazione. Vedi Manage costs effectively.

​

Could not update your spend limit

Could not update your spend limit: <reason from the server>

• Se il messaggio include un motivo, scegli un limite che lo soddisfi, come un importo inferiore
• Se il messaggio mostra solo la forma generica, riprova; il fallimento potrebbe essere transitorio
• Se la modifica continua a fallire, effettuala invece dalle tue impostazioni di fatturazione claude.ai nel browser

​

Errori di autenticazione

​

Accesso non effettuato

Not logged in · Please run /login

• Esegui /login per autenticarti con il tuo abbonamento Claude o il tuo account Console
• Se ti aspettavi che una variabile d’ambiente ti autenticasse, verifica che ANTHROPIC_API_KEY sia impostata ed esportata nella shell in cui hai avviato claude
• Per CI o automazioni in cui l’accesso interattivo non è possibile, configura uno script apiKeyHelper che recuperi una chiave all’avvio
• Consulta Precedenza dell’autenticazione per capire quale credenziale usa Claude Code quando ne sono presenti diverse

​

Impossibile determinare il metodo di autenticazione

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

• Aggiorna alla v2.1.176 o successiva se questo messaggio compare in una sessione in background o cloud e le tue credenziali sono già configurate
• Verifica che ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN o le credenziali del tuo provider cloud siano impostate nell’ambiente che avvia il worker, non solo nella tua shell interattiva
• Per l’Agent SDK, consulta la configurazione dell’autenticazione nella guida rapida
• Esegui /status in una sessione interattiva nello stesso ambiente per verificare quale origine delle credenziali viene risolta

​

Chiave API non valida

Invalid API key · Fix external API key

• Controlla eventuali errori di battitura e verifica che la chiave non sia stata revocata nella Console
• Nella stessa shell, esegui env | grep ANTHROPIC, oppure in PowerShell Get-ChildItem Env:ANTHROPIC*. Strumenti come direnv, i plugin di shell per dotenv e i terminali degli IDE possono caricare una chiave obsoleta da un file .env nel tuo progetto senza che tu la imposti esplicitamente.
• Rimuovi ANTHROPIC_API_KEY ed esegui /login per usare invece l’autenticazione tramite abbonamento
• Se la chiave proviene da uno script apiKeyHelper, esegui lo script direttamente per verificare che stampi una chiave valida su stdout
• Esegui /status per verificare quale origine delle credenziali sta effettivamente usando Claude Code

​

Il tuo script apiKeyHelper non funziona

• Il comando è terminato con un errore o è andato in timeout
• Il comando non ha stampato nulla su stdout
• Il comando ha stampato qualcosa oltre alla chiave, come un banner di accesso o una riga di log. Il pannello mostra returned output that cannot be used as an API key e indica cosa non va, senza ripetere l’output. Prima della v2.1.227, Claude Code inviava qualunque cosa il comando stampasse, dopo aver rimosso gli spazi iniziali e finali.

Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

• Esegui direttamente nella tua shell il comando configurato in apiKeyHelper per riprodurre l’errore
• Se il comando segnala una sessione scaduta, autenticati di nuovo con il tuo provider di credenziali, ad esempio accedendo di nuovo al tuo SSO o al tuo vault dei segreti
• Correggi il comando in modo che stampi su stdout solo la chiave, come singolo token di caratteri ASCII stampabili lungo al massimo 16.384 caratteri, e termini con codice di uscita 0. Consulta ruotare le credenziali con apiKeyHelper per una configurazione funzionante.
• Esegui /status per vedere l’errore e verificare che apiKeyHelper sia l’origine delle credenziali attiva. La riga apiKeyHelper mostra Failing con i dettagli dell’ultimo errore, come il codice di uscita e l’output di errore del comando, e scompare dopo la successiva esecuzione riuscita. Prima della v2.1.274, /status mostrava solo l’origine delle credenziali, non l’errore.
• Ogni volta che il comando fallisce, il suo codice di uscita e il suo output di errore compaiono anche in un pannello Authentication nel terminale. Prima della v2.1.212, il pannello si intitolava Cloud authentication.

​

Valore dell’intestazione della richiesta non valido

Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable

• Invalid auth token: un bearer token da ANTHROPIC_AUTH_TOKEN o CLAUDE_CODE_OAUTH_TOKEN
• Invalid ANTHROPIC_CUSTOM_HEADERS: un nome o un valore di intestazione che hai impostato in ANTHROPIC_CUSTOM_HEADERS. La descrizione indica quale coppia Name: Value è responsabile, ad esempio distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS, senza ripetere il nome o il valore, dato che li hai scelti tu.
• Invalid request header from the environment: un valore che Claude Code copia in un’intestazione della richiesta da un’altra variabile d’ambiente, come CLAUDE_AGENT_SDK_CLIENT_APP. La descrizione indica la variabile da correggere.

Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).

• Reimposta la variabile o l’impostazione indicata dal messaggio, digitando di nuovo i caratteri intorno alla posizione segnalata anziché incollarli di nuovo dalla stessa fonte
• Per ANTHROPIC_CUSTOM_HEADERS, mantieni una coppia Name: Value per riga e riscrivi la coppia indicata dal messaggio
• Esegui /status per verificare quale origine delle credenziali è attiva

​

Questa organizzazione è stata disabilitata

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.

• Rimuovi ANTHROPIC_API_KEY nella shell corrente e dal profilo della tua shell, poi riavvia claude
• Se il messaggio dice Update or unset, non hai un accesso salvato a cui ripiegare. Rimuovi la chiave ed esegui /login, oppure sostituisci la chiave con una di un’organizzazione Console attiva.
• Esegui /status in seguito per verificare che la credenziale attiva sia il tuo abbonamento
• Se nessuna variabile d’ambiente è impostata e l’errore persiste, contatta l’assistenza o accedi con un account diverso.

​

La tua organizzazione ha disabilitato l’autenticazione con chiave API

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Sign in again with your claude.ai account

• Se il messaggio indica ANTHROPIC_API_KEY, rimuovila nella shell corrente e dal profilo della tua shell o dal file .env, poi riavvia claude
• Se il messaggio indica apiKeyHelper, rimuovi l’impostazione apiKeyHelper dal tuo settings.json
• Esegui /login per accedere con il tuo account claude.ai
• Esegui /status in seguito per verificare che la credenziale attiva sia il tuo abbonamento e non una chiave API
• Se hai bisogno dell’autenticazione con chiave API per le automazioni, chiedi all’amministratore della tua organizzazione di riattivarla nella Console

​

La tua organizzazione ha disabilitato l’accesso tramite abbonamento Claude

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

• Chiedi al tuo amministratore di abilitare l’accesso a Claude Code per la tua organizzazione
• Autenticati con una chiave API della Console invece che con il tuo abbonamento. Consulta Autenticazione con Claude Console per la configurazione.
• Se sei l’amministratore e non vedi un’opzione per abilitare l’accesso, contatta l’assistenza Anthropic

​

Le routine sono disabilitate dal criterio della tua organizzazione

Routines are disabled by your organization's policy.

• Chiedi a un Owner della tua organizzazione di attivare l’interruttore Routine su claude.ai/admin-settings/claude-code
• Per lavori pianificati una tantum che non richiedono routine a livello di organizzazione, consulta attività pianificate

​

Remote Control richiede l’API Anthropic

Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.

• Una variabile del provider CLAUDE_CODE_USE_*, come CLAUDE_CODE_USE_BEDROCK per Amazon Bedrock o CLAUDE_CODE_USE_VERTEX per Agent Platform di Google Cloud
• ANTHROPIC_BASE_URL che punta a un host diverso da api.anthropic.com, come un gateway LLM o un proxy, anche quando accedi con claude.ai; prima della v2.1.196, un URL di base personalizzato non bloccava Remote Control
• ANTHROPIC_UNIX_SOCKET impostata, per cui la sessione invia le sue richieste tramite un socket locale anziché a api.anthropic.com
• Un accesso tramite gateway cloud aziendale effettuato con /login, che non supporta Remote Control e non ha alcuna variabile da rimuovere

• Rimuovi la variabile indicata dal messaggio, come CLAUDE_CODE_USE_BEDROCK o ANTHROPIC_BASE_URL, e riavvia la sessione, oppure avvia Remote Control da una sessione che comunica direttamente con l’API Anthropic
• Se la variabile non è impostata nella tua shell, controlla la chiave env nei tuoi file di impostazioni, che applica variabili d’ambiente a ogni sessione
• Per questo e gli altri messaggi di avvio di Remote Control, consulta Risoluzione dei problemi di Remote Control

​

Remote Control non è riuscito ad aggiornare il tuo accesso

Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
Remote Control disconnected — Signed out of Claude — run /login, then /remote-control

• Claude.ai login expired e Claude.ai login was rejected: claude.ai non accetta più il tuo token di accesso salvato, perché è scaduto o è stato revocato
• OAuth token unavailable: Claude Code non aveva alcun token di accesso salvato quando la credenziale della connessione doveva essere rinnovata
• OAuth token refresh failed: claude.ai ha rifiutato il tuo token di accesso salvato mentre Claude Code si stava riconnettendo, e l’aggiornamento del token non ne ha prodotto uno nuovo
• JWT refresh failed: no OAuth token: Claude Code non ha trovato alcun token di accesso salvato con cui rinnovare
• Signed out of Claude: sei uscito su questa macchina, ad esempio eseguendo /logout in un altro terminale, quindi Claude Code non ha più alcun accesso salvato con cui rinnovare la connessione

• Esegui /login per accedere di nuovo
• Esegui /remote-control per riconnettere la sessione. I messaggi che terminano con run /login to restore Remote Control non richiedono questo passaggio: Claude Code si riconnette da solo una volta effettuato l’accesso.

​

Remote Control could not renew this computer’s connection

Remote Control could not renew this computer's connection: claude.ai did not accept the sign-in it uses. Run `claude /login` to sign in again. The connection keeps working for about 26 hours; if it still cannot sign in then, it stops.

• Se l’avviso ti dice di eseguire claude /login, apri un altro terminale sulla macchina su cui è in esecuzione il server, esegui lì claude /login e accedi con il tuo account claude.ai
• Se il server non riesce ancora ad accedere una volta scaduta la credenziale della connessione, stampa un errore contenente Poll: Authentication failed (401) e si arresta. Accedi di nuovo come indica la seconda frase dell’avviso, poi esegui di nuovo claude remote-control nel terminale in cui il server si è arrestato.

​

Remote Control interrotto perché l’account con cui hai effettuato l’accesso è cambiato

Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

• Esegui /remote-control per avviare una nuova sessione Remote Control con l’account o l’organizzazione corrente
• Per tornare indietro, esegui /login e accedi di nuovo all’account o all’organizzazione precedente. Poi esegui /remote-control.

​

Remote Control interrotto perché l’app che esegue la sessione è uscita o ha cambiato account

Remote Control stopped — the app running this session is now signed in to a different Claude account
Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on

• Se l’app non ha un accesso attivo, accedi di nuovo, poi riattiva Remote Control nell’app
• Se l’app ha cambiato account, Claude Code non può continuare la sessione terminata con il nuovo account. Avvia una nuova sessione Remote Control con quell’account.

​

Token OAuth revocato o scaduto

OAuth token revoked · Please run /login
Please run /login · API Error: 401 OAuth token has expired ...

Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
Failed to authenticate. API Error: 401 OAuth token has expired ...

• Esegui /login nel prompt di Claude Code per accedere di nuovo
• Se il tuo comando -p o il tuo programma Agent SDK usa un accesso salvato, esegui claude nello stesso ambiente, completa /login, poi esegui di nuovo il comando o il programma. Per le automazioni che non possono accedere in modo interattivo, autenticati con ANTHROPIC_API_KEY oppure genera un token di lunga durata con claude setup-token.
• Se ti autentichi con la variabile d’ambiente CLAUDE_CODE_OAUTH_TOKEN, Claude Code continua a inviare il valore che hai impostato dopo che una richiesta fallisce con un 401, anziché passare al token di un accesso salvato. /status mostra questa credenziale come una riga Auth token con valore CLAUDE_CODE_OAUTH_TOKEN. Genera un nuovo token con claude setup-token e riavvia con esso, oppure rimuovi la variabile ed esegui /login. Prima della v2.1.225, Claude Code poteva sostituire a metà sessione il valore della variabile con il token di accesso di breve durata di un accesso salvato, e la sessione tornava a fallire con errori 401 una volta scaduto quel token.
• Per richieste ripetute di accesso a ogni avvio, consulta i controlli dell’orologio di sistema e i passaggi di ripristino dell’archiviazione delle credenziali su macOS in Risoluzione dei problemi
• Per altri errori, inclusi 403 Forbidden e i problemi del browser con OAuth, consulta Accesso e autenticazione

​

API Error: 401 Invalid authentication credentials

Please run /login · API Error: 401 Invalid authentication credentials

• Se /status mostra una riga API key non contrassegnata come non in uso, una ANTHROPIC_API_KEY approvata è la credenziale attiva e ha la precedenza sul tuo accesso, quindi /login non la sostituisce. Ruota la chiave nella Claude Console, oppure torna al tuo abbonamento eseguendo unset ANTHROPIC_API_KEY, o in PowerShell Remove-Item Env:ANTHROPIC_API_KEY.
• Se /status mostra solo il tuo accesso, esegui /login una volta. Se la credenziale è stata revocata, un nuovo accesso la sostituisce.
• Se lo stesso messaggio ricompare per lo stesso account di accesso, l’account o l’organizzazione non è più attivo. Controlla l’account e l’organizzazione riportati da /status e chiedi all’amministratore della tua organizzazione di ripristinare l’accesso.
• Se ANTHROPIC_BASE_URL punta a un gateway LLM, il testo dopo 401 è il messaggio del tuo gateway e non di Anthropic, e /login non lo modifica. Correggi invece la credenziale che il tuo gateway si aspetta.

​

Accesso scaduto

Login expired · Please run /login

Failed to authenticate: OAuth session expired and could not be refreshed

• Esegui /login per accedere di nuovo. Riprovare senza accedere mostra lo stesso messaggio a ogni richiesta.
• Se accedi con il tuo account claude.ai in un’altra finestra di Claude Code, consulta Accesso non effettuato per sapere quando questa sessione inizia a usare quell’accesso da sola.
• In modalità non interattiva, esegui claude nello stesso ambiente, completa /login, poi esegui di nuovo il tuo comando. Per le automazioni che non possono accedere in modo interattivo, autenticati con ANTHROPIC_API_KEY oppure genera un token di lunga durata con claude setup-token.
• Se l’accesso continua a non riuscire, consulta Accesso e autenticazione

​

Impossibile aggiornare il tuo accesso perché un altro processo di Claude Code lo sta aggiornando

Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

• Riprova tra un minuto. Se un altro processo completa prima l’aggiornamento, questa sessione usa l’accesso rinnovato.
• Se il messaggio continua a ripresentarsi, chiudi le altre finestre e gli altri processi di Claude Code, poi riprova.
• Se si ripresenta senza altri processi di Claude Code in esecuzione, esegui /login. Accedere di nuovo non attende il lock di aggiornamento.

​

Impossibile salvare il tuo accesso

Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
Couldn't save your login. Try logging in again.

• Su macOS, sblocca il portachiavi di login, poi esegui di nuovo /login
• Sulle altre piattaforme, esegui di nuovo /login
• Se l’accesso continua a non essere salvato, consulta Accesso non effettuato o token scaduto per il comando di sblocco del portachiavi e altri passaggi di ripristino dell’archiviazione delle credenziali

​

Impossibile avviare il server di callback OAuth

Failed to start OAuth callback server: Failed to start server. Is port 0 in use?

• Per accedere subito senza il listener locale: se usi un abbonamento claude.ai, esegui claude setup-token su una macchina in cui l’accesso funziona e imposta il token che stampa come CLAUDE_CODE_OAUTH_TOKEN su questa macchina. Altrimenti imposta ANTHROPIC_API_KEY con una chiave della Claude Console. Precedenza dell’autenticazione spiega come Claude Code sceglie tra le credenziali.
• Per usare invece l’accesso tramite browser su questa macchina, Claude Code deve potersi mettere in ascolto su 127.0.0.1. Se viene eseguito in una sandbox, verifica che il criterio della sandbox consenta l’ascolto su porte locali, poi esegui di nuovo /login. Se dovrebbe poterlo fare e continua a fallire, esegui /feedback in modo che la segnalazione includa i dettagli del tuo ambiente.

​

Accesso Claude non accettato

Claude login not accepted · Run /login, then try again

• Esegui /login, completa l’accesso, poi avvia di nuovo la sessione

​

Gli artefatti richiedono un accesso claude.ai

Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

• Esegui /login e seleziona Claude account with subscription. L’opzione Anthropic Console account non fornisce credenziali claude.ai.
• Quando il messaggio indica una credenziale che ha la precedenza, come ANTHROPIC_API_KEY, un’impostazione apiKeyHelper o una chiave Console salvata da un precedente /login, rimuovila nel modo indicato dal messaggio, poi esegui /login
• Quando il messaggio dice che questa sessione remota si autentica tramite la macchina che l’ha avviata, accedi a claude.ai su quella macchina, poi riconnetti la sessione
• Quando il messaggio dice che la credenziale è fornita dall’ambiente host della sessione, non puoi modificarla in quella sessione; avvia una sessione con accesso effettuato a claude.ai
• Consulta Disponibilità per gli altri requisiti degli artefatti, come piano, provider del modello e criterio dell’organizzazione

​

Il criterio dell’amministratore richiede un accesso tramite Cloud gateway

Not signed in to the Cloud gateway — run /login.

Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.

To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.

• Per Not signed in to the Cloud gateway, esegui /login e completa l’accesso nella schermata Cloud gateway
• Per il messaggio di avvio, rimuovi la credenziale seguendo i passaggi alla fine del messaggio
• Se ritieni che la macchina non debba richiedere il gateway, chiedi all’amministratore che la gestisce di rimuovere forceLoginMethod e forceLoginGatewayUrl dalle sue impostazioni gestite

​

Il tuo account è sospeso

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

• Apri il link nel messaggio per visualizzare i dettagli della sospensione o presentare ricorso
• Se hai un altro account Claude o una chiave API non interessati dalla sospensione, puoi continuare a lavorare mentre la sospensione viene risolta: esegui /login con quell’account, oppure imposta la chiave con ANTHROPIC_API_KEY

​

Accesso del profilo Anthropic scaduto

Anthropic profile login expired · Re-authenticate your Anthropic profile
Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile

• Se il messaggio inizia con Login expired, esegui /login per accedere di nuovo
• Per rinnovare un profilo scritto dall’accesso alla Console senza chiave o da ant auth login della CLI di Claude Platform, esegui /login su una macchina che offre l’accesso senza chiave. Scegli l’account Anthropic Console, poi Sign in with your Console account. Claude Code sostituisce la credenziale scaduta in quel profilo
• Per rinnovare un profilo creato da un altro strumento, accedi di nuovo con quello strumento. Se invece scegli Sign in with your Console account in /login, Claude Code lascia il profilo così com’è e crea una chiave API
• Se la credenziale del profilo è stata fornita da un amministratore, chiedigli di emetterne una nuova
• Esegui /status per verificare l’origine delle credenziali attiva e il nome del profilo
• Per smettere di usare il profilo, rimuovi ANTHROPIC_PROFILE se l’hai impostata, poi autenticati in un altro modo, ad esempio con /login o ANTHROPIC_API_KEY

• Quando Claude Code ha rilevato il profilo dalla tua directory di configurazione e la sua modalità di autenticazione è user_oauth, il messaggio inizia con Login expired e propone prima /login. Claude Code dà a un /login funzionante la precedenza sul profilo rilevato e si autentica quindi con il tuo account claude.ai. Dalla v2.1.234 fino alla v2.1.277, questa forma era Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile. Prima della v2.1.234, anche in questo caso Claude Code mostrava la forma Re-authenticate your Anthropic profile.
• Quando hai selezionato il profilo con ANTHROPIC_PROFILE, il messaggio inizia con Anthropic profile login expired.

​

Requisito di scope OAuth

OAuth token does not meet scope requirement: user:profile

• Esegui /login per ottenere un nuovo token con gli scope attuali. Non è necessario uscire prima.

​

claude.ai ha rifiutato il token di sessione

claude.ai rejected the session token. Run /login, then reconnect.

• Esegui /login per accedere di nuovo
• Riconnetti il connettore da /mcp, oppure esegui /mcp reconnect <server>. Riconnettersi prima di accedere di nuovo lascia il connettore nello stesso stato. L’opzione Reconnect del pannello /mcp segnala your claude.ai session token was rejected; la forma digitata /mcp reconnect <server> segnala una riconnessione riuscita anche se il token è ancora rifiutato.

​

Il server MCP richiede di accedere di nuovo

MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate

​

URL del server MCP mancante o non valido

Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.

• Imposta l’url della voce sull’endpoint reale del server dove il server è configurato, oppure imposta la variabile d’ambiente indicata dal suo riferimento ${VAR}, poi esegui di nuovo l’accesso.

​

Mancata corrispondenza dell’emittente nella risposta di autorizzazione

Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

• Riprova l’accesso da /mcp
• Se l’errore si ripete, segnalalo al gestore del server. La correzione è lato server: il server di autorizzazione deve restituire nel parametro iss lo stesso emittente che dichiara nei suoi metadati
• Per connetterti mentre il server viene corretto, avvia Claude Code con MCP_SDK_GENERATION=v1, il cui runtime non esegue questo controllo. Questo rimuove una protezione contro gli attacchi di mix-up, quindi preferisci la correzione lato server

​

Rifiuto di inviare credenziali a un endpoint token non https

Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).

• Servi quell’endpoint token tramite HTTPS, ad esempio mettendo il server dietro un reverse proxy o un tunnel che termina TLS e configurando il server in modo che dichiari l’indirizzo https://
• Per connetterti senza modificare il server, avvia Claude Code con MCP_SDK_GENERATION=v1, il cui runtime non applica questa regola e invia la richiesta di token tramite HTTP semplice. Questa scelta dura finché non esci e si applica a ogni server. Il runtime v1 salta anche il controllo dell’emittente, quindi preferisci servire l’endpoint tramite HTTPS

​

Credenziali AWS scadute o non valide

AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

• Se il suggerimento dice che le credenziali sono gestite da questo ambiente, l’app che ha avviato Claude Code possiede la credenziale e gli altri passaggi qui non si applicano: riprova, oppure contatta il tuo amministratore
• Se awsAuthRefresh è impostato, esegui il comando indicato nel messaggio, come aws sso login --profile myprofile, in un altro terminale e completa l’accesso nel browser, poi riprova. Altrimenti aggiorna tu stesso la credenziale AWS che usi: il tuo accesso SSO, le chiavi di accesso, la chiave API o il token del proxy
• Con awsAuthRefresh impostato in una sessione interattiva, puoi invece eseguire /login, scegliere 3rd-party platform, poi selezionare Claude Platform on AWS · refresh credentials in Using 3rd-party platforms per eseguire lo stesso comando senza riavviare Claude Code. Consulta Configurare le credenziali AWS
• Se l’errore si ripete dopo che il comando di aggiornamento è riuscito, verifica che l’identità sia valida al di fuori di Claude Code con aws sts get-caller-identity nella stessa shell e con lo stesso profilo

​

Autenticazione AWS non riuscita

AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

• Se il suggerimento dice che le credenziali sono gestite da questo ambiente, l’app che ha avviato Claude Code possiede la credenziale e gli altri passaggi qui non si applicano: riprova, oppure contatta il tuo amministratore
• Aggiorna le tue credenziali AWS nel caso in cui la causa sia una credenziale scaduta: esegui il comando awsAuthRefresh indicato nel messaggio quando ne è impostato uno, oppure aggiorna tu stesso il tuo accesso SSO, le chiavi di accesso, la chiave API o il token del proxy
• Se le tue credenziali sono aggiornate, verifica che i permessi IAM indicati in Configurazione IAM siano associati all’identità che stai usando e che il modello selezionato sia abilitato per il tuo account e la tua regione
• Esegui aws sts get-caller-identity per verificare quale identità usano le tue richieste

​

Credenziali Google Cloud scadute o non valide

Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

• Se il suggerimento dice che le credenziali sono gestite da questo ambiente, l’app che ha avviato Claude Code possiede la credenziale e gli altri passaggi qui non si applicano: riprova, oppure contatta il tuo amministratore
• Se ti autentichi con le credenziali predefinite dell’applicazione, esegui il comando gcpAuthRefresh indicato nel messaggio, oppure gcloud auth application-default login, e completa l’accesso, poi riprova
• Se instradi tramite un gateway LLM con CLAUDE_CODE_SKIP_VERTEX_AUTH impostata, aggiorna il token del gateway in ANTHROPIC_AUTH_TOKEN o ANTHROPIC_CUSTOM_HEADERS, poi riprova
• Se ti autentichi con un file di chiave di un service account, verifica che GOOGLE_APPLICATION_CREDENTIALS punti a una chiave valida. Consulta Configurare le credenziali GCP
• Se l’errore si ripete dopo un aggiornamento, verifica che l’identità funzioni al di fuori di Claude Code con gcloud auth application-default print-access-token nella stessa shell

​

Autenticazione Google Cloud non riuscita

Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

• Se il suggerimento indica che le credenziali sono gestite da questo ambiente, la credenziale appartiene all’app che ha avviato Claude Code e gli altri passaggi qui non si applicano: riprova oppure contatta il tuo amministratore
• Verifica che i ruoli indicati in Configurazione IAM siano concessi all’identità con cui ti autentichi
• Verifica che il modello sia abilitato per il tuo progetto. Consulta Richiedere l’accesso al modello

​

Autenticazione Microsoft Foundry non riuscita

Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

• Se il suggerimento indica che le credenziali sono gestite da questo ambiente, la credenziale appartiene all’app che ha avviato Claude Code e gli altri passaggi qui non si applicano: riprova oppure contatta il tuo amministratore
• Aggiorna la credenziale che hai configurato in Configurare le credenziali Azure: ruota ANTHROPIC_FOUNDRY_API_KEY, genera un nuovo ANTHROPIC_FOUNDRY_AUTH_TOKEN oppure esegui az login in modo che la catena di credenziali predefinita di Microsoft Entra possa accedere di nuovo
• Se la credenziale è aggiornata, verifica che l’identità abbia accesso alla risorsa Foundry. Consulta Configurazione RBAC di Azure

​

Impossibile caricare le credenziali AWS o Google Cloud

API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.

• Esegui il comando di accesso del tuo provider, ad esempio aws sso login --profile myprofile o gcloud auth application-default login, quindi riprova. Credenziali Bedrock, Agent Platform o Foundry non caricate mostra come verificare le credenziali al di fuori di Claude Code
• Se il dettaglio riporta AWS default-chain credential resolve timed out, la catena si è bloccata anziché fallire, quindi segui invece Timeout nella risoluzione delle credenziali della catena predefinita AWS

​

Timeout nella risoluzione delle credenziali della catena predefinita AWS

API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

• Esegui aws sts get-caller-identity nella stessa shell con lo stesso AWS_PROFILE. Se si blocca anche questo, correggi il profilo; un comando credential_process che chiede input in modo interattivo è una causa comune.
• Completa il passaggio di accesso prima di avviare Claude Code, ad esempio aws sso login --profile myprofile
• Se la tua catena esegue un accesso interattivo che richiede legittimamente più di 60 secondi, come SSO con MFA tramite un wrapper come aws-vault, aumenta il limite in millisecondi con CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

​

Timeout della verifica della configurazione di Bedrock in attesa di AWS

Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

A request to AWS timed out. Check your network and proxy settings, then try again.

• Esegui aws sts get-caller-identity nella stessa shell. Se si blocca anche questo, il blocco è al di fuori di Claude Code, nella tua rete, nel tuo proxy o nell’helper delle credenziali del tuo profilo AWS; risolvi prima quello.
• Completa qualsiasi accesso interattivo prima di aprire la procedura guidata, ad esempio aws sso login --profile myprofile
• Se un helper delle credenziali nel tuo profilo AWS ha legittimamente bisogno di più di 60 secondi per chiederti l’input, aumenta il limite in millisecondi con CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

​

Sessione del gateway cloud scaduta

Cloud gateway session expired — run /login to reconnect.

Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

• Esegui /login nella sessione e completa l’accesso dal browser
• Per un avvio non interattivo, avvia claude nello stesso ambiente, esegui /login, quindi esegui di nuovo il tuo comando

​

Accesso scaduto in attesa che tu proseguissi

Sign-in timed out while waiting for you to continue. Try again.

• Esegui di nuovo /login e conferma l’account prima che l’accesso scada

​

Il gateway ha rifiutato la richiesta

Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

• Chiedi all’amministratore del gateway di esaminare la richiesta. La parte finale API Error: contiene il rifiuto restituito dal gateway
• Per gli amministratori: una regola di controllo degli accessi sul gateway restituisce un 403 che il log di audit registra con il relativo motivo, e il rifiuto di autorizzazione di un upstream viene inoltrato secondo quanto descritto in Messaggi di errore upstream

​

Errori di rete e connessione

​

Unable to connect to API

Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
Request timed out. Check your internet connection and proxy settings

• Conferma di poter raggiungere l’host API dalla stessa shell eseguendo curl -I https://api.anthropic.com. Su Windows PowerShell usa curl.exe -I https://api.anthropic.com in modo che l’alias Invoke-WebRequest integrato non sia utilizzato.
• Se sei dietro un proxy aziendale, imposta HTTPS_PROXY prima di avviare Claude Code e vedi Network configuration
• Se instradi attraverso un gateway LLM o un relay, imposta ANTHROPIC_BASE_URL al suo indirizzo. Vedi Connect Claude Code to an LLM gateway per la configurazione.
• Assicurati che il tuo firewall consenta gli host elencati in Network access requirements
• I guasti intermittenti vengono ritentati automaticamente; i guasti persistenti indicano un problema di rete locale

• Controlla se ANTHROPIC_BASE_URL è impostato eseguendo echo $ANTHROPIC_BASE_URL, o echo $env:ANTHROPIC_BASE_URL in PowerShell, e cercalo nel blocco env dei tuoi settings files. Quando è impostato, Claude Code invia le richieste del modello a quell’indirizzo invece di api.anthropic.com, quindi un valore residuo che punta a un proxy locale o gateway che non è più in esecuzione produce Connection refused anche se curl raggiunge l’API. Rimuovilo dal tuo profilo shell o dalle impostazioni e avvia Claude Code da un nuovo terminale.
• Su Linux e WSL, controlla /etc/resolv.conf per un nameserver non raggiungibile. WSL in particolare può ereditare un resolver rotto dall’host.
• Su macOS, un client VPN che è stato disconnesso o disinstallato può lasciare dietro un’interfaccia tunnel o una regola di routing. Controlla ifconfig per interfacce utun stantie e rimuovi l’estensione di rete della VPN in Impostazioni di Sistema.
• Docker Desktop e runtime di container simili possono intercettare il traffico in uscita. Chiudili e riprova per escludere questa possibilità.

​

Unable to connect to Anthropic services

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.

• Se il messaggio nomina una variabile proxy, controlla che il suo valore punti al proxy giusto e chiedi al tuo team di rete di consentire connessioni HTTPS attraverso di esso all’host nel messaggio. Vedi Network configuration.
• Lavora attraverso i controlli in Unable to connect to API. Il test curl e la guida del firewall lì si applicano anche a questo controllo.
• Se la tua rete è aperta e il guasto persiste, Claude Code potrebbe non essere disponibile nel tuo paese

​

Socket is closed

• Se vedi questo errore, aggiorna a v2.1.214 o successivo con claude update, quindi invia di nuovo il tuo messaggio
• Se i turni continuano a fallire dietro lo stesso proxy dopo l’aggiornamento, lavora attraverso Unable to connect to API e controlla la configurazione del proxy in Network configuration

​

API returned an empty or malformed response

API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.

• Una clausola Response: con il tipo di contenuto, il tipo di corpo, come body is an HTML page o empty body, la sua dimensione in byte, e se la risposta ha portato un id di richiesta Anthropic. Quando la risposta nomina un server riconoscibile, come nginx o cloudflare, o porta intestazioni intermediarie, come cf-ray o via, la clausola elenca anche quelli.
• Una frase che nomina l’id della richiesta in streaming fallita e il guasto che ha attivato il nuovo tentativo. Quando uno stream si era aperto prima del guasto, segnala anche quanti eventi di stream sono arrivati e, se ce ne sono stati, quanto tempo lo stream era stato silenzioso quando il tentativo è fallito.

• Leggi la clausola Response: per vedere quale sistema ha risposto. Un corpo HTML, nessun id di richiesta Anthropic, o un server nominato come nginx o cloudflare significa che qualcosa tra Claude Code e l’API ha risposto al suo posto
• Se instradi attraverso un LLM gateway, testa il percorso con una richiesta diretta e correggi l’hop che restituisce la risposta non-API
• Su una rete con una pagina di accesso, come Wi-Fi ospite, completa l’accesso in un browser, quindi riprova
• Se solo il percorso non in streaming attraverso il tuo gateway è rotto, imposta CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 per disattivare questo fallback, tranne quando l’endpoint di streaming stesso restituisce 404, dove Claude Code continua comunque a usare il fallback

​

Streaming response ended before any complete data was received

Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.

• Configura qualsiasi proxy o gateway tra Claude Code e il tuo provider di modelli per passare i corpi della risposta in streaming e le loro intestazioni senza modifiche
• Su Amazon Bedrock, vedi Streaming errors behind a gateway or proxy per i requisiti di intestazione e corpo

​

Bedrock streaming response has an unexpected content-type

Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

• Configura il gateway per passare il corpo della risposta InvokeModelWithResponseStream e la sua intestazione Content-Type senza modifiche. Un intermediario che ri-emette lo stream come server-sent events è una causa comune.
• Impostare CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 nasconde questo errore, ma Claude Code non decodifica un corpo binario sotto un’intestazione riscritta, quindi quelle richieste ripiegano su un percorso più lento non in streaming. Vedi Streaming errors behind a gateway or proxy.

​

SSL certificate errors

Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config

SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

• Esporta il bundle CA della tua organizzazione e punta Claude Code ad esso con NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
• Vedi Network configuration per le istruzioni di configurazione complete
• Non impostare NODE_TLS_REJECT_UNAUTHORIZED=0, che disabilita completamente la convalida del certificato

​

Host not allowed in a cloud session

HTTP 403
x-deny-reason: host_not_allowed

• Apri il tuo ambiente per la modifica, o dalla routine’s form o dal environment selector dove avvii sessioni cloud.
• Nella finestra di dialogo Edit cloud environment, cambia Network access da Trusted a Custom, quindi aggiungi il dominio bloccato a Allowed domains. Inserisci un dominio per riga. Seleziona Also include default list of common package managers per mantenere l’allowlist predefinita insieme ai tuoi domini personalizzati. Seleziona Full invece se desideri accesso senza restrizioni.
• Fai clic su Save changes. La prossima esecuzione utilizza l’allowlist aggiornata. Per una sessione cloud che è già aperta, vedi quando una modifica dell’accesso di rete raggiunge le sessioni esistenti.

​

The proxy refused the connection

artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)

• HTTP 407: il proxy richiede credenziali che non ha ricevuto. Mettile nell’URL del proxy, come mostra Basic authentication.
• HTTP 403: il proxy rifiuta di fare tunnel a *.frame.claudeusercontent.com. Chiedi a chiunque gestisca il proxy di consentire quell’host, che Network access requirements elenca.
• Qualsiasi altro stato, come HTTP 502: il proxy non ha aperto il tunnel per suo motivo, come il mancato raggiungimento dell’host. Cerca lo stato nei log del proxy.
• unreadable reply al posto di uno stato: qualunque cosa sia all’indirizzo del proxy non ha risposto con una riga di stato HTTP. Controlla che l’indirizzo sia un proxy HTTP.

• Controlla l’indirizzo e le credenziali nella variabile proxy, come descrive Proxy configuration, quindi esegui curl -x http://proxy.example.com:8080 -I https://api.anthropic.com dalla shell in cui avvii Claude Code, usando il tuo URL proxy. Su Windows PowerShell, esegui curl.exe. Se questa sonda fallisce allo stesso modo, correggi prima la configurazione del proxy. Se ha successo, il rifiuto è specifico dell’host dell’artefatto.
• Se la tua rete consente a Claude Code di raggiungere l’host dell’artefatto direttamente, aggiungi .frame.claudeusercontent.com a NO_PROXY. Mantieni la voce stretta: una voce .claudeusercontent.com più ampia bypassa anche il proxy per bridge.claudeusercontent.com, che le organizzazioni con IP allowlisting devono mantenere sul proxy.

​

The cloud environments service returned an empty or unexpected response

The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.

• Ritenta l’azione. Claude Code richiede di nuovo l’elenco ogni volta
• Se il messaggio continua ad apparire, controlla status.claude.com per gli incidenti attivi

​

Failed to fetch session from Sessions API

Failed to fetch session from Sessions API: Failed to fetch session logs

• Esegui di nuovo lo stesso teleport. Se fallisce allo stesso modo, segnala il problema

​

Couldn’t reconnect to your Remote Control session

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

• Esegui /remote-control per ritentare la connessione
• Avvia una nuova sessione con claude --remote-control per creare una nuova sessione Remote Control
• Per altri messaggi di avvio di Remote Control, vedi Troubleshoot Remote Control

​

Sessions ended while this machine was offline

2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.

• Quando Claude Code elenca i worktree mantenuti sotto questo messaggio, recupera da essi qualsiasi lavoro non committato
• Esegui claude remote-control per avviare un ambiente nuovo

​

Couldn’t share the transcript

Couldn't share the transcript.

• Esegui /feedback per inviare la trascrizione con una descrizione di ciò che è accaduto. Vedi Report an error se /feedback non è disponibile nel tuo ambiente
• Se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi Unable to connect to API

​

Couldn’t send feedback

Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

• : not signed in. Run /login, then retry.: la finestra di dialogo carica solo quando Claude Code ha trovato credenziali Anthropic mentre si apriva, e nessuna era utilizzabile al momento dell’invio. Ad esempio, sei uscito dall’account su questa macchina nel frattempo, o il tuo login non poteva più essere aggiornato.
• Una parentesi: (server returned <status>) è il codice di risposta del servizio; (request timed out) e (couldn't reach the service) sono guasti di rete. Quando Claude Code non riesce a nominare un motivo, la parentesi è assente.

• Per la dicitura non-signed-in, esegui /login e invia di nuovo
• Altrimenti, invia di nuovo; se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi Unable to connect to API
• Se continua a fallire, apri una segnalazione su github.com/anthropics/claude-code/issues, come dice il messaggio

​

Errori di richiesta

​

Prompt is too long

Prompt is too long

Context limit reached · /compact or /clear to continue

Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

Prompt is too long · automatic compaction failed: <the underlying error>

• Quando non può riassumere alcuno scambio completo, Claude Code mantiene il tuo prompt più recente parola per parola e riassume tutto prima di esso.
• In quel caso, quando la conversazione non termina con il tuo prompt, Claude Code riassume l’intera conversazione.

Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.

• Esegui /compact per riassumere i turni precedenti e liberare spazio, oppure /clear per ricominciare da capo. Se /compact risponde Not enough messages to compact., la conversazione è un singolo scambio senza nulla di precedente da riassumere, quindi lo spazio è occupato da quel prompt e da quello che Claude Code invia con ogni richiesta: esegui /clear e reinvia con meno testo incollato o allegati più piccoli, oppure riduci le definizioni degli strumenti e i file di memoria utilizzando i passaggi seguenti
• Esegui /context per vedere una suddivisione di ciò che consuma la finestra: prompt di sistema, strumenti, file di memoria e messaggi
• Disabilita i server MCP che non stai utilizzando con /mcp disable <name> per rimuovere le loro definizioni di strumenti dal contesto
• Taglia i file di memoria CLAUDE.md di grandi dimensioni, oppure sposta le istruzioni in regole con ambito di percorso che si caricano solo quando rilevanti
• La compattazione automatica è attiva per impostazione predefinita e normalmente previene questo errore. Se l’hai disattivata in /config o con DISABLE_AUTO_COMPACT, riattivala. Se la mantieni disattivata, esegui /compact tu stesso prima che la finestra si riempia.
• Se l’errore appare vicino a 200K token su un modello che ne accetta di più, una possibile causa è un ID modello che Claude Code non riconosce. Claude Code presume una finestra di 200K per un ID del genere, quindi per continuare a lavorare oltre quel punto, fornisci la reale finestra di contesto del modello.

​

Il contesto supera il limite di token

Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.

• In una conversazione multi-turno, esegui /compact per riassumere i turni precedenti e liberare spazio. Per ricominciare da capo, esegui /clear
• Per altri modi per ridurre l’utilizzo, vedi Prompt is too long

​

Request too large

Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.

• Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).: le immagini o i documenti hanno spinto la richiesta oltre il limite. Claude Code ritenta con essi rimossi.
• Request too large for the API's 32MB request limit: i messaggi da soli superano il limite, quindi il messaggio dice compacting cannot make it fit e Claude Code non ritenta. In modalità non interattiva, il messaggio ti dice di ridurre l’input o avviare una nuova sessione.

• Se il messaggio dice compacting cannot make it fit, premi Esc due volte per tornare indietro oltre il turno che ha aggiunto il contenuto di grandi dimensioni, oppure esegui /clear per ricominciare da capo
• Altrimenti, esegui /compact, che elimina le immagini e gli allegati accumulati
• Fai riferimento ai file di grandi dimensioni per percorso invece di incollarne il contenuto, in modo che Claude possa leggerli in blocchi
• Per le immagini, vedi Image was too large di seguito

​

Image was too large

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
API Error: an image in the conversation could not be processed and was removed.

• Prima della v2.1.299, in una conversazione lunga con molte immagini, Claude Code poteva rimuovere le immagini che avevi allegato per ultime invece di quella che superava il limite. La riga was removed si ripeteva quindi a ogni turno e Claude non vedeva le tue nuove immagini.
• Prima della v2.1.299, in VS Code, nell’app Desktop e nell’Agent SDK, le immagini allegate mentre Claude stava lavorando non venivano ridimensionate come le altre immagini allegate. Raggiungevano l’API alla loro dimensione originale, causando errori ripetuti relativi alle immagini nelle conversazioni lunghe.
• Prima della v2.1.166, un’immagine incollata poteva rimanere nella conversazione, e lo stesso errore si ripeteva quindi a ogni messaggio successivo

• Ridimensiona l’immagine prima di incollarla. L’API accetta immagini fino a 8000 pixel sul lato più lungo per una singola immagine, o 3000 pixel quando nel contesto ci sono più di 20 immagini.
• Fai uno screenshot più stretto della regione rilevante invece dello schermo intero

​

Unable to resize image

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.

• Se il messaggio ti chiede di convertire l’immagine, convertila in PNG, JPEG, GIF o WebP e allegala di nuovo. Claude Code può verificare le dimensioni per questi formati dall’intestazione del file, senza decodificare l’immagine.
• Se il messaggio segnala un limite di dimensione o dimensione, ridimensiona o ricomprimi l’immagine al di sotto di quel limite prima di allegare.
• Se il messaggio nomina una causa, come un JPEG CMYK, un WebP animato o un file possibilmente danneggiato, risalva l’immagine nel formato che il messaggio suggerisce e allegala di nuovo.

​

Request rejected as unprocessable by the model