“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.
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.
Symptome
- Claude Code gibt nach langem Warten
Request timed outaus. - 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
Teste den API-Host aus derselben Shell.
curl -I https://api.anthropic.comPrüfe deine Version.
claude --versionZeige die Proxy-Variablen an.
env | grep -i proxyFühre die Setup-Prüfungen in Claude Code aus.
/doctor
So behebst du es
Wiederhole die Anfrage.
Erhöhe bei einem langsamen Netzwerk oder Proxy das Timeout.
export API_TIMEOUT_MS=900000Aktualisiere Claude Code, wenn du das Timeout auf 0 gesetzt hast.
Wenn Timeouts häufig auftreten, teste ein anderes Netzwerk und das VPN.
Mit Kilobat
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.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
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.