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

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 (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 (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 (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 (aperto): l'attesa si verifica a ogni singola risposta, su tutti i modelli. #72059 e #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, 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) — 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

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

Domande frequenti

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.