Claude Code-Verbindungsfehler: ECONNRESET, Verbindung während der Antwort unterbrochen, „Warten auf API-Antwort“, „Verbindung zur API nicht möglich“, SSL-Zertifikatfehler

Die Meldungen

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)

Liegt es bei Ihnen oder beim Anbieter? Eine Prüfung in zwei Minuten

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

Wenn curl schnell ein 401 erhält und keine Proxy-Variablen gesetzt sind, handelt es sich mit sehr hoher Wahrscheinlichkeit um einen Upstream-Vorfall. Das ist die Gruppe in #87424 (offen: zeitweilige ECONNRESET in der Desktop-App und der CLI, kein VPN, kein Proxy, seit August 13, von mehreren Personen bis August 21 bestätigt) und #86473 (dauerhafte ECONNRESET auf allen Oberflächen, während direktes HTTP zur API funktioniert). Lokal lässt sich das nicht beheben; Wiederholungsversuche und Abwarten helfen. Prüfen Sie status.claude.com, und wenn mehrere Personen im Issue-Tracker Probleme zur selben Stunde melden, stellen Sie die Fehlersuche ein.

„Warten auf API-Antwort · prüfen Sie Ihr Netzwerk“

Die Meldung macht Ihr Netzwerk verantwortlich, und damit liegt sie oft falsch. #82155 (offen, 15 Reaktionen): den ganzen Tag minutenlange Verzögerungen, wobei die Wartezeit zwischen Wiederholungsversuchen auf über zwei Minuten steigt, obwohl das Netzwerk nachweislich einwandfrei funktionierte. #76555 (offen): Wartezeiten bei jeder einzelnen Antwort über alle Modelle hinweg. #72059 und #70534: dieselbe Verzögerung speziell dann, wenn das Beratungsmodell hinzugezogen wird, danach eine normale Antwort nach Ablauf des Timers. Die Wartezeit zwischen Wiederholungsversuchen steigt exponentiell; die spürbare Beeinträchtigung ist daher die Wartezeit, nicht der Fehler. Die folgenden Variablen verkürzen sie.

Variablen für Wiederholungsversuche und Zeitlimits

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

Ein kürzeres Zeitlimit für das erste Byte verändert das Verhalten bei einer instabilen Verbindung spürbar: Statt die vollen zehn Minuten auf einen Stream zu warten, der nie antworten wird, gibt der Client ihn auf und versucht es erneut. Weniger parallele Tool-Aufrufe helfen bei Verbindungen, die abbrechen, wenn mehrere Streams gleichzeitig laufen (mobile Hotspots, einige VPNs).

Proxys, VPNs und Unternehmensnetzwerke

• Setzen Sie die Proxy-Variablen, die Claude Code ausliest: HTTPS_PROXY (und HTTP_PROXY, NO_PROXY). Ein Proxy, der nur im Browser oder in der npm-Konfiguration eingerichtet ist, ist für die CLI unsichtbar.
• Proxys mit TLS-Inspektion ersetzen das Zertifikat von Anthropic durch ihr eigenes: Das ist unable to get local issuer certificate. Exportieren Sie die Unternehmens-Stamm-CA in eine PEM-Datei und setzen Sie NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem. Deaktivieren Sie die Überprüfung nicht.
• `CERT_HAS_EXPIRED` beim nativen Build (#71727, 2.1.19x): der mitgelieferte Zertifikatsspeicher, nicht Ihre Systemuhr. claude update; falls Sie nicht weiterkommen: Der npm-Build verwendet den Systemspeicher.
• `ConnectionRefused` unter macOS nach einer Neuinstallation (#75897) — ein lokaler Proxy- oder VPN-Client, der ausgeschaltet, aber weiterhin in der Umgebung konfiguriert ist; entfernen Sie die Proxy-Variablen und die Proxy-Einstellungen des Systems und versuchen Sie es erneut.
• Änderungen des VPN-Ausgangs während einer Sitzung setzen jeden offenen Stream zurück: Rechnen Sie mit einem ECONNRESET pro erneuter Verbindung.

Über ein Gateway

Richten Sie Claude Code auf ein Gateway aus (ANTHROPIC_BASE_URL=https://aiprimetech.io) und der Netzwerkpfad ändert sich: Der Client kommuniziert mit dem Gateway, und das Gateway hält die Upstream-Verbindungen aufrecht und wiederholt Anfragen bei einem ausgelasteten Konto über ein anderes. Ein defektes lokales Netzwerk wird dadurch nicht funktionsfähig, aber für die oben beschriebenen Fälle von *Upstream-Verbindungsabbrüchen* entfällt die Abhängigkeit von einem einzigen Konto, und derselbe Schlüssel funktioniert auch bei einer Störung des Abonnements weiter. Führen Sie die curl-Prüfung gegen den Gateway-Host aus, um den Pfad vor dem Wechsel zu bestätigen.

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

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen.