“Request timed out” in Claude Code auf dem Mac

Claude Code gibt „Request timed out“ aus, wenn die API vor Ablauf der Verbindungsfrist nicht antwortet. Das Standard-Timeout für Anfragen beträgt 10 Minuten.

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

Mein Mac hat dieses Problem: „Request timed out“ in Claude Code auf dem Mac. Lies https://kilobat.app/de/guides/claude-code-request-timed-out.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 nach langem Warten Request timed out aus.
  • Das passiert in langsamen Netzwerken, über Proxys oder bei großen Anfragen.
  • Manche Wiederholungen klappen.

Mögliche Ursachen

  • Ein langsames Netzwerk oder ein langsamer Proxy. Laut Dokumentation kann beides die Ursache sein.
  • Eine hängende Verbindung. Ein VPN oder eine Firewall kann Pakete zurückhalten, sodass keine Antwort ankommt.
  • Eine große Anfrage. Eine Anfrage ohne Streaming behält in einer lokalen Sitzung ein Limit von 300 Sekunden.
  • Ein Timeout von null in einer alten Version. In Versionen vor v2.1.305 kann API_TIMEOUT_MS=0 dazu führen, dass jede Anfrage scheitert.

So prüfst du es

  1. Teste den API-Host aus derselben Shell.

    curl -I https://api.anthropic.com
  2. Prüfe deine Version.

    claude --version
  3. Zeige die Proxy-Variablen an.

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

    /doctor

So behebst du es

  1. Wiederhole die Anfrage.

  2. Erhöhe bei einem langsamen Netzwerk oder Proxy das Timeout.

    export API_TIMEOUT_MS=900000
  3. Aktualisiere Claude Code, wenn du das Timeout auf 0 gesetzt hast.

  4. Wenn Timeouts häufig auftreten, teste ein anderes Netzwerk und das VPN.

Mit Kilobat

  1. Der Verbindungsdoktor von Kilobat testet den API-Host Schicht für Schicht. Er nennt die Schicht, die ausfällt oder langsam ist.

    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

Wie lautet das Standard-Timeout?

Die Dokumentation von Claude Code nennt 10 Minuten für das Anfrage-Timeout.

Schaltet API_TIMEOUT_MS=0 jede Frist ab?

Nein. Die Frist für das erste Byte und das Idle-Timeout des Bodys bleiben aktiv.

Quellen

Geprüft am 29. Oktober 2026.