AI Code With

Claude Code · Fehlerbehebung

Claude Code API-Verbindungsfehler: Timeouts und Lösungen

Ein Verbindungsfehler bedeutet, dass Claude Code nie eine Antwort von der API erhalten hat: Die Anfrage hat sie nicht erreicht, oder die Antwort hat zu lange gedauert. Anders als bei 4xx- und 5xx-Fehlern liegt die Ursache meist im Netzwerkpfad oder in der Endpunktadresse.

Zuletzt geprüft

Claude Code Einrichtungsanleitung öffnenAlle Claude Code-Fehler

Der Fehlertext

Claude Code
API Error (Connection error.) · Unable to connect to API (ECONNREFUSED) · Request timed out

Schritt-für-Schritt-Lösung

  1. 1. Adresse prüfen

    Führe /status aus. Der Endpunkt muss api.aicodewith.ai über https sein, ohne /v1 oder Tippfehler.

    ~/.claude/settings.json
    {
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

  2. 2. Netzwerk testen

    Führe curl -I https://api.aicodewith.ai im selben Terminal aus. Wenn es hängt oder fehlschlägt, liegt das Problem im Netzwerk, nicht in Claude Code.

  3. 3. Proxy und Firewall

    Wenn du einen Proxy verwendest, exportiere HTTPS_PROXY in diesem Terminal (oder füge es dem env-Block hinzu). Unternehmensfirewalls müssen api.aicodewith.ai möglicherweise zulassen.

  4. 4. Timeout erhöhen

    Bei langsamen oder langen Anfragen füge "API_TIMEOUT_MS": "600000" zum env-Block hinzu und starte neu.

Häufige Ursachen

SymptomWahrscheinliche Ursache
ECONNREFUSED oder ENOTFOUNDFalscher Host oder DNS/Proxy blockiert ihn
Schlägt nur im VPN oder Firmennetzwerk fehlFirewall- oder Proxy-Regeln
Timeout nur bei langen AntwortenTimeout für das Netzwerk zu kurz
Funktioniert mit curl, schlägt in Claude Code fehlUnterschiedliche Proxy-Einstellungen zwischen Shells oder IDE

Werden fehlgeschlagene Anfragen berechnet?

Fehlgeschlagene Anfragen (4xx/5xx, Timeouts, abgebrochene Verbindungen) werden nicht berechnet — berechnet werden nur Anfragen, die erfolgreich abgeschlossen werden. Wenn ein Upstream-Fehler automatisch erneut versucht wird und erfolgreich ist, wird einmal berechnet.

Weiterhin Fehler?

  • Prüfe die Modellseite auf aicodewith: Sie zeigt den aktuellen Zustand für jeden Kanal.
  • Suche die Anfrage in den Nutzungsdaten deines Dashboards, um Modell, Status und Kosten zu sehen.
  • Sende eine E-Mail an support@aicodewith.com mit der Uhrzeit des Fehlers, dem Modell und dem Fehlertext (niemals deinen vollständigen API-Schlüssel).

Modellstatus und PreiseSupport kontaktierenDokumentation

FAQ

Was bedeutet "API Error (Connection error)" in Claude Code?

Claude Code konnte die API nicht erreichen oder hat nicht rechtzeitig eine Antwort erhalten. Prüfe die Base-URL, dann Netzwerk, Proxy und Firewall.

Wie richte ich einen Proxy für Claude Code ein?

Exportiere HTTPS_PROXY in dem Terminal, in dem du Claude Code startest, oder füge es dem env-Block in ~/.claude/settings.json hinzu.

Wie erhöhe ich das Claude Code Timeout?

Setze API_TIMEOUT_MS (in Millisekunden) im env-Block von settings.json und starte Claude Code neu.

Liegt ein Verbindungsfehler an meinem Schlüssel?

Nein. Probleme mit dem Schlüssel führen zu 401. Ein Verbindungsfehler bedeutet, dass keine HTTP-Antwort angekommen ist.

Warum funktioniert es in curl, aber nicht in meiner IDE?

Die IDE übernimmt möglicherweise nicht deine Shell-Proxy-Einstellungen. Lege HTTPS_PROXY im env-Block von settings.json ab, damit jeder Claude Code-Client es verwendet.

Werden fehlgeschlagene Anfragen berechnet?

Fehlgeschlagene Anfragen (4xx/5xx, Timeouts, abgebrochene Verbindungen) werden nicht berechnet — berechnet werden nur Anfragen, die erfolgreich abgeschlossen werden. Wenn ein Upstream-Fehler automatisch erneut versucht wird und erfolgreich ist, wird einmal berechnet.

Bereit zum Ausprobieren?

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben. Es gelten Limits für Rate und Parallelität, und du kannst für jeden API-Schlüssel tägliche, monatliche oder gesamte Ausgabenlimits festlegen.

Claude Code Einrichtungsanleitung öffnenModellpreise ansehen

Ähnliche Themen

529 überlastet429 Rate Limit401 nicht autorisiert400 fehlerhafte AnfrageAlle Claude Code-FehlerClaude Code EinrichtungsanleitungClaude Code API-SchlüsselClaude Code Nutzungslimits

Quellen

Claude und Claude Code sind Marken von Anthropic PBC. aicodewith ist eine unabhängige Plattform und steht in keiner Verbindung zu Anthropic und wird von Anthropic nicht unterstützt. Fehlerformate sind aus Claude Code zitiert und können sich ändern. Geprüft am 2026-10-10.