Source: https://aiprimetech.io/it/claude-code/errors/connection-lost/ [Home](/it/) › [Claude Code](/it/claude-code/) › [Errori](/it/claude-code/errors/) › Errori di connessione [Panoramica](/it/claude-code/)[Installazione](/it/claude-code/install/)[riferimento della CLI](/it/claude-code/cli/)[Prezzi e limiti](/it/claude-code/pricing/)[Agent SDK](/it/claude-code/sdk/)[Skill e plugin](/it/claude-code/skills/)[GitHub](/it/claude-code/github/)[Web, desktop e IDE](/it/claude-code/web-and-desktop/)[Modelli](/it/claude-code/models/)[Errori](/it/claude-code/errors/)[È open source?](/it/claude-code/open-source/)[Tutorial](/it/claude-code/tutorial/)[Per studenti](/it/claude-code/for-students/)[Automazione QA](/it/claude-code/qa-automation/)[Confronto con Cursor](/it/claude-code/vs-cursor/)[Confronto con Codex e OpenCode](/it/claude-code/vs-codex/)[Subagenti](/it/claude-code/subagents/)[Hook](/it/claude-code/hooks/)[MCP](/it/claude-code/mcp/)[Ecosistema](/it/claude-code/ecosystem/)[VS Code](/it/claude-code/vscode/)[OpenRouter](/it/claude-code/openrouter/)[Limiti di frequenza](/it/claude-code/rate-limits/)[Guida in cinese](/claude-code/zh/) Ultimo aggiornamento: 11 ottobre 2026 # Errori di connessione di Claude Code: ECONNRESET, connessione persa durante la risposta, "In attesa della risposta API", "Impossibile connettersi all'API", errori dei certificati SSL Questi errori indicano che la richiesta non è mai stata completata: la connessione TCP è stata reimpostata, l'handshake TLS non è riuscito, un proxy ha rifiutato l'host oppure lo stream ha semplicemente smesso di trasmettere. Claude Code riprova automaticamente: è questo che indicano le righe *Nuovo tentativo tra Ns · tentativo x/y* e *In attesa della risposta API*. Il tracker mostra due gruppi molto diversi, ed è importante capire a quale appartieni: problemi della rete locale risolvibili con un'impostazione del proxy o della CA e incidenti lato Anthropic per i quali l'unica soluzione è aspettare. ## TLDR - Retrying in 0s · attempt 1/10 / Waiting for API response · will retry in … — nuovo tentativo automatico in corso; l'attesa aumenta a ogni tentativo. - Connection dropped (ECONNRESET) / Connection lost mid-response — la connessione è stata interrotta; se curl funziona direttamente e non c'è un proxy, il problema è solitamente a monte. - Unable to connect to API / fetch failed / ConnectionRefused — nulla ha raggiunto l'endpoint: DNS, VPN, proxy, firewall. - unable to get local issuer certificate / CERT_HAS_EXPIRED — un proxy che ispeziona TLS o un archivio CA obsoleto; fai puntare NODE_EXTRA_CA_CERTS al certificato radice aziendale. ## I messaggi ``` API Error: Connection dropped (ECONNRESET) API Error: Connection lost mid-response API Error: fetch failed Unable to connect to API (ConnectionRefused) Retrying in 0s · attempt 1/10 Waiting for API response · will retry in 2m 35s · check your network API Error: Socket is closed SSL certificate verification failed: unable to get local issuer certificate Error: certificate has expired (CERT_HAS_EXPIRED) ``` ## Il problema è tuo o loro? Un controllo di due minuti ``` curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" https://api.anthropic.com/v1/models -H "x-api-key: x" -H "anthropic-version: 2023-06-01" # 401 in under a second = network path is fine, the problem is upstream or in Claude Code # timeout / SSL error / 000 = the problem is on your side of the wire env | grep -i -E "proxy|anthropic|node_extra|ssl" claude --debug # per-request timing and retry reasons in the log ``` Se curl riceve rapidamente un 401 e non ci sono variabili proxy, quasi certamente si tratta di un incidente a monte. È il gruppo descritto in [#87424](https://github.com/anthropics/claude-code/issues/87424) (aperto: ECONNRESET intermittente nell'app desktop e nella CLI, senza VPN né proxy, da agosto 13, confermato da diverse persone fino ad agosto 21) e [#86473](https://github.com/anthropics/claude-code/issues/86473) (ECONNRESET persistente su tutte le interfacce mentre HTTP diretto verso l'API funziona). Nessun intervento locale risolve questi problemi; servono nuovi tentativi e tempo. Controlla status.claude.com e, se più persone segnalano la stessa ora sul tracker, smetti di cercare il problema. ## "In attesa della risposta API · controlla la rete" Il messaggio attribuisce la colpa alla tua rete, e spesso si sbaglia. [#82155](https://github.com/anthropics/claude-code/issues/82155) (aperto, 15 reazioni): blocchi di diversi minuti per tutta la giornata, con l'attesa tra i tentativi che superava i due minuti su una rete di cui era stato dimostrato il corretto funzionamento. [#76555](https://github.com/anthropics/claude-code/issues/76555) (aperto): l'attesa si verifica a ogni singola risposta, su tutti i modelli. [#72059](https://github.com/anthropics/claude-code/issues/72059) e [#70534](https://github.com/anthropics/claude-code/issues/70534): lo stesso blocco si verifica specificamente quando viene consultato il modello consulente, seguito da una risposta normale allo scadere del timer. L'attesa tra i tentativi cresce in modo esponenziale, quindi l'effetto visibile è l'attesa, non il fallimento; le variabili seguenti la riducono. ## Variabili per nuovi tentativi e timeout ``` export CLAUDE_CODE_MAX_RETRIES=15 # default 10, capped at 15 export CLAUDE_CODE_RETRY_WATCHDOG=1 # keep retrying instead of giving up (unattended runs) export API_TIMEOUT_MS=600000 # per-request timeout, default 10 minutes export CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS=60000 # give up on a silent stream sooner and retry export CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 # fewer parallel streams on a flaky link ``` Un timeout più breve per il primo byte è ciò che cambia l'esperienza con una connessione instabile: invece di attendere tutti i dieci minuti per uno stream che non risponderà mai, il client lo abbandona e riprova. Ridurre la concorrenza nell'uso degli strumenti aiuta sulle connessioni che si interrompono quando più stream sono attivi contemporaneamente (hotspot mobili, alcune VPN). ## Proxy, VPN e reti aziendali - Imposta le variabili proxy lette da Claude Code: HTTPS_PROXY (e HTTP_PROXY, NO_PROXY). Un proxy configurato solo nel browser o nella configurazione npm è invisibile alla CLI. - I proxy che ispezionano TLS sostituiscono il certificato di Anthropic con il proprio: questo causa unable to get local issuer certificate. Esporta la CA radice aziendale in un file PEM e imposta NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem. Non disabilitare la verifica. - `CERT_HAS_EXPIRED` nella build nativa ([#71727](https://github.com/anthropics/claude-code/issues/71727), 2.1.19x): il problema è l'archivio dei certificati attendibili incluso, non l'orologio. claude update; se il problema persiste, la build npm usa l'archivio di sistema. - `ConnectionRefused` su macOS dopo una reinstallazione ([#75897](https://github.com/anthropics/claude-code/issues/75897)) — un proxy locale o un client VPN disattivato, ma ancora configurato nell'ambiente; cancella le variabili proxy e le impostazioni proxy di sistema, quindi riprova. - I cambi del nodo di uscita della VPN durante una sessione reimpostano tutti gli stream aperti: aspettati un ECONNRESET a ogni riconnessione. ## Tramite un gateway Configura Claude Code perché usi un gateway (ANTHROPIC_BASE_URL=https://aiprimetech.io) e il percorso di rete cambia: il client comunica con il gateway, che mantiene le connessioni upstream e ritenta su un altro account quando uno è saturo. Non risolve i problemi di una rete locale malfunzionante, ma per i casi di *reset upstream* descritti sopra elimina la dipendenza da un singolo account, e la stessa chiave continua a funzionare durante un incidente che riguarda l'abbonamento. Esegui il controllo con curl sull'host del gateway per verificare il percorso prima di passare al gateway. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_gateway_key claude ``` ## Stanco di lottare con questo problema? Esegui invece Claude Code tramite il gateway di AI Prime Tech: gli stessi modelli Claude sugli account a monte del gateway, due variabili d'ambiente per passare al gateway, e i nuovi account ricevono $5 di credito API gratuito con il codice FIXIT — senza carta. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crea un account con il codice FIXIT](/register?promo=FIXIT) ## Domande frequenti Come risolvo 'Errore API: connessione interrotta (ECONNRESET)' in Claude Code? Esegui curl verso l'API: se risponde rapidamente e non usi un proxy, il reset avviene upstream; lascia procedere i tentativi e controlla status.claude.com. Se anche curl fallisce, correggi le variabili del proxy, la VPN o il certificato CA.Che cosa significa 'In attesa della risposta API · nuovo tentativo tra … · controlla la rete'? Claude Code non ha ricevuto una risposta dall'API entro il timeout e sta attendendo prima di riprovare. Nonostante il messaggio, spesso il problema non è la tua rete; riduci CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS affinché il client abbandoni prima i flussi che non inviano dati.Come risolvo 'impossibile ottenere il certificato dell'emittente locale' in Claude Code? Un proxy sta rifirmando i certificati TLS. Esporta il certificato radice aziendale in formato PEM e imposta NODE_EXTRA_CA_CERTS sul percorso di quel file. Non disabilitare mai la verifica dei certificati.Che cosa significa 'Nuovo tentativo tra 0s · tentativo 1/10'? Una richiesta è fallita e Claude Code sta riprovando; per impostazione predefinita sono previsti 10 tentativi con intervalli crescenti, CLAUDE_CODE_MAX_RETRIES aumenta il numero a 15 e CLAUDE_CODE_RETRY_WATCHDOG=1 continua a riprovare nelle esecuzioni non presidiate. ## Esegui Claude Code sul gateway Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice FIXIT.[Ottieni una chiave API](/register?promo=FIXIT) [Scopri i piani illimitati](/it/plans/) AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway. ## Altre guide su Claude Code [Errori di Claude Code e come risolverli](/it/claude-code/errors/)["Errore API: 500" di Claude Code: cosa significa e cosa lo risolve davvero](/it/claude-code/errors/api-error-500/)[Errore "Sovraccarico" di Claude (errore API 529): cosa significa e cosa fare](/it/claude-code/errors/overloaded-529/)[Errore API 400 di Claude Code: prompt troppo lungo, concorrenza nell'uso degli strumenti e gli altri casi](/it/claude-code/errors/api-error-400/)[Errori OAuth di Claude Code: timeout di 15000ms superato e codice di stato 500](/it/claude-code/errors/oauth-error/)["Il processo Claude Code è terminato con il codice 1": come individuare il vero errore e risolverlo](/it/claude-code/errors/process-exited-code-1/)[Claude "Prompt troppo lungo", "Input troppo lungo per il modello richiesto" e "Limite di contesto raggiunto": cosa riempie la finestra e come recuperare spazio](/it/claude-code/errors/prompt-too-long/)[Limite di utilizzo di Claude raggiunto: limiti di sessione, settimanali e di Opus, "limiti di utilizzo API specificati", "saldo dei crediti insufficiente" — e cosa fare](/it/claude-code/errors/usage-limit-reached/)[Claude Code 401 e 403: credenziali di autenticazione non valide, chiave API non valida, "Accesso non effettuato", host_not_allowed](/it/claude-code/errors/auth-401-403/)[Claude Code si blocca o smette di rispondere: come capire dove si è bloccato e sbloccarlo](/it/claude-code/errors/claude-code-hangs/)[Claude.ai non funziona: "Qualcosa è andato storto", limiti di capacità, "limite di 5 ore raggiunto", "errore durante l'accesso" e gli altri casi](/it/claude-code/errors/claude-ai-not-working/)