“Unable to connect to API” in Claude Code auf dem Mac

Claude Code gibt „Unable to connect to API“ aus, wenn eine Anfrage api.anthropic.com nicht erreicht. Die Dokumentation von Claude Code nennt als häufige Ursachen fehlenden Internetzugang, ein VPN, das den Host blockiert, oder einen nicht gesetzten Firmenproxy.

Mit deinem Agenten behebenKopiert einen Prompt für Claude Code, Codex oder jeden Agenten, der das Terminal nutzen kann.

Mein Mac hat dieses Problem: „Unable to connect to API“ in Claude Code auf dem Mac. Lies https://kilobat.app/de/guides/claude-code-unable-to-connect-to-api.md und geh es mit mir durch. Installiere die Kilobat-CLI, falls sie fehlt: brew install seifip/kilobat/kilobat. Führe die Terminal- und kilobat-Checks aus der Anleitung selbst aus und sag mir, was du findest. Liste die Schritte auf, die nur ich erledigen kann. Frag nach, bevor du eine Einstellung änderst.

Gilt für: Claude Code in einem Terminal unter allen aktuellen macOS-Versionen.Geprüft: 29. Oktober 2026

Symptome

  • Claude Code gibt Unable to connect to API. Check your internet connection aus.
  • Die Meldung kann mit einem Code enden, etwa ENOTFOUND, EHOSTUNREACH oder ECONNRESET.
  • Anfragen scheitern, aber andere Apps funktionieren möglicherweise.

Mögliche Ursachen

  • Kein Internetzugang. Der Mac ist offline oder hat kein DNS.
  • Ein VPN, das den API-Host blockiert. Die Dokumentation von Claude Code nennt das als häufige Ursache.
  • Ein Proxy, der nicht gesetzt ist. Ein erforderlicher Firmenproxy muss vor dem Start mit HTTPS_PROXY gesetzt werden.
  • Ein Proxy, der den Tunnel ablehnt. ERR_PROXY_TUNNEL bedeutet, dass der Proxy den Tunnel abgelehnt hat. Prüfe seine Zugangsdaten und ob er diesen Host erlaubt.

So prüfst du es

  1. Teste den API-Host aus derselben Shell.

    curl -I https://api.anthropic.com
  2. Zeige die Proxy-Variablen an.

    env | grep -i proxy
  3. Führe die Prüfungen in Claude Code aus.

    /doctor
  4. Teste den Hostnamen über macOS.

    dscacheutil -q host -a name api.anthropic.com

So behebst du es

  1. Wenn DNS scheitert, behebe das. Siehe DNS löst auf dem Mac nicht auf.

  2. Setze hinter einem Firmenproxy diesen vor dem Start.

    export HTTPS_PROXY=http://proxy.example.com:8080
  3. Wenn du ein Gateway verwendest, setze ANTHROPIC_BASE_URL auf dessen Adresse.

  4. Schalte das VPN für einen kurzen Test aus. Schalte es danach wieder ein.

Mit Kilobat

  1. Der Verbindungsdoktor von Kilobat testet den API-Host Schicht für Schicht: Netzwerk, Proxy, DNS, Regeln, IPv4, IPv6, TLS und Server.

    kilobat why https://api.anthropic.com
  2. Diese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit diagnose_connection und diagnose_network aus. Siehe Herausfinden, warum eine Website oder API keine Verbindung bekommt.

Fragen

Ist der Code in Klammern wichtig?

Ja. ENOTFOUND weist auf DNS hin, EHOSTUNREACH auf eine Route, ECONNRESET auf einen Reset und ERR_PROXY_TUNNEL auf einen Proxy.

Muss ich Claude Code neu starten, nachdem ich eine Variable gesetzt habe?

Ja. Die Seite zur Netzwerkkonfiguration sagt, dass eine laufende Sitzung spätere Änderungen an der Shell nicht übernimmt.

Quellen

Geprüft am 29. Oktober 2026.