Claude Code
Warum stoppt Claude Code immer wieder?
Claude Code stoppt immer wieder bei Ruhezustand, Nutzungslimit, offener Anfrage oder Prozessende. Keep Mac Awake hält ein zugeklapptes MacBook am Laufen.
Kurze Antwort: Claude Code stoppt immer wieder aus einem von fünf Gründen: Der Mac ist in den Ruhezustand gegangen, du hast ein Nutzungslimit erreicht, Claude wartet auf deine Freigabe, die Netzwerkverbindung ist abgerissen, oder der Prozess
claudewurde beendet. Die Meldung auf dem Bildschirm verrät, welcher es ist:Your computer went to sleep mid-responseoderConnection lost while your computer was asleepbedeutet Ruhezustand, und die häufigste Ursache ist das Zuklappen eines MacBooks. Damit Claude Code bei geschlossenem Deckel weiterarbeitet, ist eine Sitzung von Keep Mac Awake die erste Wahl; für die anderen Ursachen gibt es weiter unten eigene Lösungen.
Für Mac herunterladen3 Tage kostenlos, ohne Kreditkarte. Danach einmalig 9 USD.
Wie erkenne ich, warum Claude Code gestoppt hat?
Lies die letzte Zeile, die Claude Code ausgegeben hat. Die Fehlerreferenz von Anthropic nennt jeden Fall (Stand: Oktober 2026, Fehler):
| Was du siehst | Was passiert ist | Lösung |
|---|---|---|
Your computer went to sleep mid-response, Connection lost while your computer was asleep | Der Mac ging während einer Anfrage in den Ruhezustand | Halte den Mac für die ganze Aufgabe wach |
You've hit your session limit · resets 3:45pm, You've hit your weekly limit | Ein Nutzungslimit deines Plans | Warte bis zur angezeigten Uhrzeit |
| Eine Berechtigungsanfrage oder eine Frage, sonst nichts | Claude wartet auf dich | Beantworte sie, oder erlaube das Tool vorab |
Unable to connect to API, Request timed out | Das Netzwerk oder ein Proxy | Prüfe die Verbindung; Claude Code versucht es zuerst selbst erneut |
API Error: Repeated 529 Overloaded errors | Die API ist ausgelastet | Versuche es gleich noch einmal |
| Die Sitzung ist weg oder auf dem Handy offline | Der Prozess claude wurde beendet | Starte die CLI in tmux, oder lass die App offen |
Bei kurzen Störungen versucht es Claude Code von selbst erneut, „bis zu 10-mal mit exponentiellem Backoff, bevor ein Fehler angezeigt wird“; eine Meldung, die stehen bleibt, ist also kein kurzer Aussetzer.
Warum stoppt Claude Code, wenn der Mac in den Ruhezustand geht?
Claude Code ist ein Prozess auf deinem Mac, und ein Mac im Ruhezustand führt nichts aus. Wacht der Mac auf, „behandelt Claude Code die Verbindung als unterbrochen und liest nicht mehr daraus“, und der Durchgang endet mit API Error: Your computer went to sleep mid-response. The response above may be incomplete. (Fehler). Antworte mit continue, dann macht Claude ab dem letzten fertigen Block weiter.
Zwei Arten von Ruhezustand halten es an:
- Der Deckel. Apple nennt „Klappe bei Verwendung eines Mac-Laptops das Display nach unten“ als einen Weg, den Ruhezustand des Mac zu aktivieren (Apple Support).
- Der automatische Ruhezustand. Bei offenem Deckel geht ein Mac nach einer in den Systemeinstellungen festgelegten Zeit ohne Aktivität in den Ruhezustand (Apple Support).
Die Einstellung Keep computer awake der Desktop-App von Claude deckt nur den zweiten Fall ab. Laut der Dokumentation von Anthropic verhindert sie den automatischen Ruhezustand nach Inaktivität; dort heißt es weiter: „Wenn du den Laptop zuklappst, geht er trotzdem in den Ruhezustand“ (geplante Aufgaben). Warum auch caffeinate und die Batterieeinstellungen beim Zuklappen nicht helfen, erklärt der Ratgeber Claude Code bei geschlossenem Deckel weiterlaufen lassen.
Für geplante Aufgaben in der Desktop-App gilt dieselbe Regel: „Wenn dein Computer zu einem geplanten Zeitpunkt im Ruhezustand ist, wird der Lauf übersprungen“, und nach dem Aufwachen startet die App einen einzigen Nachholauf für den letzten verpassten Zeitpunkt. Wie sie zuverlässig starten, zeigt der Ratgeber Geplante Aufgaben von Claude laufen nicht.
Was du nutzen solltest
Damit Claude Code bei zugeklapptem MacBook nicht stoppt, ist Keep Mac Awake (keepmacawake.com) die erste Wahl: Die App hält ein MacBook mit Apple-Chip und macOS 26 oder neuer ohne externes Display wach, für eine Sitzung, die du oder Claude Code startet, zum Beispiel mit keepmacawake start --hours 8 --json, und stellt danach den normalen Ruhezustand wieder her.
Eine Sitzung dauert so lange, wie du wählst: unbegrenzt, 1 Stunde, 8 Stunden oder eine eigene Stundenzahl bis 168, und eine Sitzung mit fester Dauer endet pünktlich. Sie läuft standardmäßig nur im Netzbetrieb; ziehst du das Netzteil ab, wartet die Sitzung, bis der Strom wieder da ist, und sie weckt keinen Mac auf, der schon im Ruhezustand ist. Ein separater Watchdog (ein unabhängiger Überwachungsdienst) stellt die normale Ruhezustandseinstellung wieder her, falls etwas stoppt oder hängt. Die App hält den Mac wach, mehr nicht: Sie hält weder die WLAN-Verbindung aufrecht, noch hebt sie ein Nutzungslimit auf. Mehr zur App: MacBook zugeklappt laufen lassen.
Andere Möglichkeiten:
- Ein externer Monitor mit Netzteil, Tastatur und Maus. So bleibt ein zugeklapptes MacBook wach (Apple Support), aber nur am Arbeitsplatz, und es geht in den Ruhezustand, wenn das Display getrennt wird.
- Deckel offen, Display aus. Aktiviere „Kein automatisches Aktivieren des Ruhezustands im Netzbetrieb bei ausgeschaltetem Display“ unter Systemeinstellungen > Batterie > Optionen; der Mac arbeitet weiter, aufgeklappt auf dem Tisch.
sudo pmset disablesleep 1. Der Befehl schaltet den Ruhezustand für den ganzen Mac ohne Timer ab, und die Einstellung bleibt aktiv, bis du sie wieder auf 0 setzt, wie der Ratgeber pmset disablesleep erklärt.
Auch ein zugeklapptes MacBook erzeugt Wärme: Stell es auf eine feste, ebene Unterlage mit Luftzirkulation, nie in eine Tasche.
Alle Wege, Coding-Agenten auf einem zugeklappten Mac zu erreichen und zu steuern, von Remote Control bis SSH, stehen im Ratgeber KI-Coding-Agenten vom Handy aus steuern.
Warum stoppt Claude Code bei einem Nutzungslimit?
Abo-Pläne haben ein Kontingent, das sich in einem rollierenden Zeitfenster erneuert. Ist es aufgebraucht, zeigt Claude Code You've hit your session limit · resets 3:45pm (oder das Wochen-, Opus- oder Sonnet-Limit) und „blockiert weitere Anfragen bis zu der Uhrzeit, die in der Meldung angezeigt wird“ (Fehler). Das Sitzungs- und das Wochenlimit gelten für alle Modelle; die Opus- und Sonnet-Limits gelten für eine Modellfamilie, also kannst du mit /model zu einer anderen wechseln und weiterarbeiten.
Für einen langen Lauf ohne Aufsicht beschreibt Anthropic CLAUDE_CODE_RETRY_WATCHDOG=1, mit dem es Claude Code bei Kapazitätsfehlern erneut versucht, statt abzubrechen; dein eigenes Nutzungslimit hebt es nicht auf.
Warum hält Claude Code an und wartet?
Weil es deine Antwort braucht. Eine Berechtigungsanfrage oder eine Frage bleibt offen, bis du antwortest; in einer geplanten Aufgabe der Desktop-App im Modus Manual, die ein nicht freigegebenes Tool braucht, „hängt der Lauf, bis du es freigibst“ (geplante Aufgaben).
Erlaube die Tools, die eine Aufgabe braucht, bevor du gehst, oder antworte vom Handy aus: Mit Remote Control schickt „Push when actions required“ in /config Berechtigungsanfragen an die Claude-App (Remote Control). Die Einrichtung steht im Ratgeber Claude Code vom Handy steuern.
Warum stoppt Claude Code, wenn die Verbindung abbricht?
Eine fehlgeschlagene Verbindung beendet eine Anfrage: Unable to connect to API. Check your internet connection, Request timed out oder Connection dropped (ECONNRESET) (Fehler). Claude Code versucht es zuerst erneut, und eine interaktive Sitzung mit Remote Control versucht es so lange weiter, wie ein Ausfall dauert, während der Servermodus „nach etwa 10 Minuten aufgibt“ (Remote Control). Keep Mac Awake hält weder WLAN noch VPN noch Tailscale verbunden.
Warum verschwindet die Sitzung?
Der Prozess claude wurde beendet. Das Schließen des Terminals, das Beenden der Desktop-App oder von VS Code und eine abgerissene SSH-Verbindung stoppen ihn. Anthropic rät für einen entfernten Rechner: „Starte ihn in tmux oder screen“ (Remote Control). claude --continue lädt „die neueste Unterhaltung im aktuellen Verzeichnis“ (CLI-Referenz).
Häufige Fragen
Warum stoppt Claude Code immer wieder, wenn ich den Laptop zuklappe?
Beim Zuklappen geht ein MacBook in den Ruhezustand, und Claude Code läuft nur, solange der Mac wach ist. Starte eine Sitzung von Keep Mac Awake, bevor du den Deckel schließt, oder nutze einen externen Monitor mit Netzteil, Tastatur und Maus.
Wie bringe ich Claude Code dazu, nach einem Stopp weiterzumachen?
Behebe die Ursache und antworte dann mit continue; laut der Dokumentation von Anthropic macht Claude ab dem letzten fertigen Block weiter. Bei einem nicht interaktiven Lauf setzt du die Sitzung fort und schickst continue.
Verhindert Keep computer awake in der Claude-App, dass Claude Code stoppt?
Nur bei offenem Deckel. Die Einstellung verhindert den automatischen Ruhezustand nach Inaktivität, und laut der Dokumentation von Anthropic geht der Mac beim Zuklappen des Laptops trotzdem in den Ruhezustand.
Warum stoppt Claude Code über Nacht?
Meist ist der Mac in den Ruhezustand gegangen, ein Nutzungslimit hat gegriffen oder eine Anfrage hat auf deine Freigabe gewartet. Die Checkliste für eine Nacht ohne Aufsicht steht im Ratgeber KI-Coding-Agenten über Nacht auf dem MacBook laufen lassen.
Nutzt Claude Code caffeinate?
Unter macOS ja, gegen den automatischen Ruhezustand: Das Changelog von Anthropic erwähnt den Prozess caffeinate, den Claude Code startet, in einem Fix für einen solchen Prozess, der nach dem Beenden von Claude Code weiter „den Mac am Ruhezustand hinderte“ (Changelog). Das hilft gegen Inaktivität, nicht gegen den Deckel: Die Entwicklerdokumentation von Apple zur Power-Assertion gegen den automatischen Ruhezustand (eine Anforderung an macOS, nicht in den Ruhezustand zu gehen) sagt, dass das System „beim Zuklappen trotzdem in den Ruhezustand gehen“ kann (Entwicklerdokumentation von Apple).
Kann Claude Code den Mac selbst wach halten?
Ja, wenn Keep Mac Awake installiert ist: Claude Code kann keepmacawake start --hours N --json vor einer langen Aufgabe ausführen und keepmacawake stop --json danach. Eine Sitzung startet nie von selbst.
Quellen
- Dokumentation von Claude Code: Error reference
- Dokumentation von Claude Code: Desktop scheduled tasks
- Dokumentation von Claude Code: Remote Control
- Dokumentation von Claude Code: CLI reference
- Dokumentation von Claude Code: Changelog
- Entwicklerdokumentation von Apple: kIOPMAssertionTypePreventUserIdleSystemSleep
- Apple Support: Ruhezustand des Mac aktivieren oder beenden
- Apple Support: Einstellungen für das Aktivieren und Beenden des Ruhezustands des Mac festlegen
- Apple Support: Externes Display ist dunkel oder hat eine niedrige Auflösung
- Keep Mac Awake: Kommandozeile