Erreurs de connexion de Claude Code : ECONNRESET, connexion perdue en cours de réponse, « En attente de la réponse de l’API », « Impossible de se connecter à l’API », erreurs de certificat SSL

Les messages

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)

Le problème vient-il de vous ou d’eux ? Une vérification en deux minutes

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

Si curl obtient rapidement un 401 et qu’aucune variable de proxy n’est définie, il s’agit presque certainement d’un incident en amont. C’est la catégorie décrite dans #87424 (ouvert : ECONNRESET intermittent dans l’application de bureau et la CLI, sans VPN ni proxy, depuis août 13, confirmé par plusieurs personnes jusqu’en août 21) et #86473 (ECONNRESET persistant sur toutes les interfaces alors qu’un HTTP direct vers l’API fonctionne). Aucune correction locale ne résout ces problèmes ; les nouvelles tentatives et le temps, si. Consultez status.claude.com et, si plusieurs personnes signalent le problème à la même heure dans le suivi des tickets, arrêtez le débogage.

« En attente de la réponse de l’API · vérifiez votre réseau »

Le message met votre réseau en cause, souvent à tort. #82155 (ouvert, 15 réactions) : des blocages de plusieurs minutes toute la journée, avec un délai entre les nouvelles tentatives dépassant deux minutes sur un réseau dont le bon fonctionnement avait été démontré. #76555 (ouvert) : une attente à chaque réponse, quel que soit le modèle. #72059 et #70534 : le même blocage survient précisément lorsque le modèle conseiller est consulté, puis une réponse normale arrive après le délai. Le délai entre les tentatives augmente de façon exponentielle ; l’effet visible est donc l’attente, pas l’échec. Les variables ci-dessous la raccourcissent.

Variables de nouvelle tentative et de délai d’attente

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

Réduire le délai d’attente du premier octet est ce qui change l’expérience sur une connexion instable : au lieu d’attendre les dix minutes complètes sur un flux qui ne répondra jamais, le client l’abandonne et réessaie. Réduire le nombre d’utilisations simultanées des outils aide sur les connexions qui se coupent lorsque plusieurs flux s’exécutent en même temps (points d’accès mobiles, certains VPN).

Proxys, VPN et réseaux d’entreprise

• Définissez les variables de proxy lues par Claude Code : HTTPS_PROXY (et HTTP_PROXY, NO_PROXY). Un proxy configuré uniquement dans le navigateur ou dans la configuration npm est invisible pour la CLI.
• Proxys inspectant le trafic TLS remplacent le certificat d’Anthropic par le leur : c’est unable to get local issuer certificate. Exportez le certificat racine de l’autorité de certification de l’entreprise vers un fichier PEM et définissez NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem. Ne désactivez pas la vérification.
• `CERT_HAS_EXPIRED` dans la version native (#71727, 2.1.19x) : le magasin de confiance intégré, pas votre horloge. claude update ; si le problème persiste, la version npm utilise le magasin système.
• `ConnectionRefused` sur macOS après une réinstallation (#75897) — un proxy local ou un client VPN désactivé, mais toujours configuré dans l’environnement ; effacez les variables de proxy et les paramètres de proxy système, puis réessayez.
• Changements de point de sortie du VPN en cours de session réinitialisent tous les flux ouverts : attendez-vous à un ECONNRESET par reconnexion.

Via une passerelle

Configurez Claude Code pour utiliser une passerelle (ANTHROPIC_BASE_URL=https://aiprimetech.io) et le chemin réseau change : le client communique avec la passerelle, qui maintient les connexions en amont et réessaie sur un autre compte lorsqu’un compte est saturé. Cela ne répare pas un réseau local défaillant, mais pour les personnes touchées par les *réinitialisations en amont* évoquées ci-dessus, cela supprime la dépendance à un seul compte, et la même clé continue de fonctionner pendant un incident lié à l’abonnement. Exécutez la vérification curl sur l’hôte de la passerelle pour confirmer le chemin avant de basculer.

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

Questions fréquentes

AI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.