---
title: "„Unable to connect to API“ in Claude Code auf dem Mac · Kilobat Anleitungen"
url: "https://kilobat.app/de/guides/claude-code-unable-to-connect-to-api"
description: "Claude Code auf deinem Mac gibt „Unable to connect to API“ aus. Prüfe deine Verbindung, ein VPN, das den API-Host blockiert, und einen Proxy, den du setzen musst."
---

# “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 beheben**Kopiert 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](https://kilobat.app/de/guides/dns-server-not-found).
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](https://kilobat.app/de/guides/recipes/why-cant-it-connect).

## 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

- [Claude Code: Error reference](https://code.claude.com/docs/en/errors.md)
- [Claude Code: Enterprise network configuration](https://code.claude.com/docs/en/network-config.md)

Geprüft am 29. Oktober 2026.

## Verwandte Anleitungen

- [“Request timed out” in Claude Code auf dem Mac](https://kilobat.app/de/guides/claude-code-request-timed-out): Claude Code gibt Request timed out aus, wenn die API vor Ablauf der Verbindungsfrist nicht antwortet.
- [“Unable to connect to API: SSL certificate verification failed” auf dem Mac](https://kilobat.app/de/guides/claude-code-ssl-certificate-verification-failed): Claude Code gibt das aus, wenn ein Zertifikat von einer Stelle stammt, der es nicht vertraut.
- [„curl: (6) Could not resolve host“ auf dem Mac](https://kilobat.app/de/guides/curl-could-not-resolve-host): curl-Exit-Code 6 bedeutet, dass curl keine Adresse für den Hostnamen ermitteln konnte.
- [Proxy-Einstellungen blockieren App-Verbindungen auf dem Mac](https://kilobat.app/de/guides/proxy-settings-breaking-apps): Eine Proxy-Einstellung leitet den Datenverkehr über einen anderen Server.
