“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.
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.
Symptome
- Claude Code gibt
Unable to connect to API. Check your internet connectionaus. - 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_PROXYgesetzt 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
Teste den API-Host aus derselben Shell.
curl -I https://api.anthropic.comZeige die Proxy-Variablen an.
env | grep -i proxyFühre die Prüfungen in Claude Code aus.
/doctorTeste den Hostnamen über macOS.
dscacheutil -q host -a name api.anthropic.com
So behebst du es
Wenn DNS scheitert, behebe das. Siehe DNS löst auf dem Mac nicht auf.
Setze hinter einem Firmenproxy diesen vor dem Start.
export HTTPS_PROXY=http://proxy.example.com:8080Wenn du ein Gateway verwendest, setze
ANTHROPIC_BASE_URLauf dessen Adresse.Schalte das VPN für einen kurzen Test aus. Schalte es danach wieder ein.
Mit Kilobat
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.comDiese Kilobat-Prüfungen sind kostenlos. KI-Agenten führen sie über MCP mit
diagnose_connectionunddiagnose_networkaus. 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.