Ratgeber

Claude Code stoppt, wenn Ihr Mac schläft

Sie haben Claude Code eine lange Aufgabe gegeben, den Deckel zugeklappt und kommen zu einer toten Sitzung zurück. Am Agent liegt es nicht. macOS hat die Maschine in den Ruhezustand versetzt. Der Ruhezustand hält jeden Prozess an, trennt das Netzwerk und beendet jede SSH-Verbindung. Diese Seite zeigt die Einstellungen, die das verhindern, in der Reihenfolge, in der Sie sie probieren sollten. Und sie zeigt, ab wann die ehrliche Lösung eine andere Maschine ist.

Was beim Ruhezustand wirklich passiert

Wenn ein Mac schläft, führt die CPU Ihre Prozesse nicht mehr aus. Der Agent wird nicht beendet. Er wird eingefroren. Wenn die Maschine aufwacht, läuft der Prozess weiter. Bis dahin ist aber die API-Verbindung abgelaufen. Der Tool-Aufruf, der gerade lief, ist fehlgeschlagen. Bei einem Laptop bedeutet ein geschlossener Deckel Ruhezustand innerhalb von Sekunden, wenn nichts dagegen wirkt. Ein Sperrbildschirm löst keinen Ruhezustand aus. Ein Bildschirmschoner auch nicht. Das tun nur der Ruhezustand-Timer und der Deckel.

Lösung 1: caffeinate für eine einzelne Aufgabe

macOS bringt ein Tool mit, das die Maschine wach hält, solange ein Befehl läuft. Starten Sie den Agent darüber. Dann bleibt der Mac wach, bis der Agent sich beendet.

caffeinate -i claude

Das Flag verhindert den Ruhezustand bei Inaktivität. Mit einem zweiten Flag bleibt auch das Display an. Das ist nur für Tools wichtig, die den Bildschirm steuern.

caffeinate -di claude

Einen zugeklappten Laptop übersteht das nicht. Der Deckelschalter hat Vorrang vor jeder dieser Anweisungen. Außerdem wirkt es nicht mehr, wenn der Agent endet und Sie die nächste Aufgabe ohne caffeinate starten.

Lösung 2: den Ruhezustand für die Maschine abschalten

Bei einem Desktop-Mac oder einem Laptop am Netzteil stellen Sie den Ruhezustand-Timer auf nie und lassen ihn so. Diese Einstellungen nutzen wir auf jedem Agent-Mac.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10
sudo pmset -a womp 1

Das Display darf weiter schlafen. Das spart Strom und ändert nichts für einen Terminal-Prozess. Die letzte Zeile aktiviert das Aufwachen über das Netzwerk. Das hilft, falls die Maschine doch einmal einschläft.

Lösung 3: der geschlossene Deckel

Ein MacBook mit geschlossenem Deckel schläft. Die Ausnahme: Es hängt am Netzteil und ist mit einem externen Display, einer Tastatur oder einer Maus verbunden. Das ist Apples Clamshell-Regel. Ohne Display zwingt eine weitere Einstellung die Maschine, bei geschlossenem Deckel wach zu bleiben.

sudo pmset -a disablesleep 1

Später machen Sie es mit demselben Befehl und einer Null rückgängig. Zwei Warnungen. In einer Tasche oder auf dem Bett wird der Laptop warm, also stellen Sie ihn auf eine harte Fläche. Und wenn das Stromkabel herausrutscht, ist der Akku in ein paar Stunden leer. Dann geht er ohne sauberes Herunterfahren aus.

Lösung 4: das Terminal, nicht die Maschine

Manchmal blieb der Mac wach, und die Sitzung war trotzdem weg. Dann wurde das Terminalfenster geschlossen oder die SSH-Verbindung ist abgebrochen. Das schickt ein Hangup an alles, was darin läuft. Die Lösung ist ein Terminal-Multiplexer. Lassen Sie den Agent in einer tmux-Sitzung laufen. Dann übersteht er das geschlossene Fenster, den SSH-Abbruch und den WLAN-Aussetzer.

brew install tmux
tmux new -s agent
claude

Trennen Sie mit Ctrl-b und dann d. Später verbinden Sie sich mit einem Befehl wieder, von jedem Terminal oder per SSH vom Handy.

tmux attach -t agent

Für dieses Setup gibt es eine eigene Anleitung: eine Claude-Code-Sitzung mit tmux am Leben halten.

Lösung 5: nach einem Neustart weitermachen

Sicherheitsupdates starten die Maschine neu. Stromschwankungen auch. Nach einem Neustart läuft nichts, bis sich jemand anmeldet. Für eine Maschine, die unbeaufsichtigt laufen soll, aktivieren Sie in den Systemeinstellungen die automatische Anmeldung für den Agent-Benutzer. Dann fügen Sie einen LaunchAgent hinzu, der die tmux-Sitzung bei der Anmeldung neu anlegt. Die Checkliste für einen dauerhaft eingeschalteten Mac hat die ganze Liste, inklusive Notstrom per Akku.

Wann der Laptop die falsche Maschine ist

Alles oben funktioniert. Es macht Ihren Laptop aber auch zu einem Server, den Sie nirgendwohin mitnehmen können. Sobald der Agent nachts echte Arbeit erledigt, ziehen die meisten auf eine Maschine um, deren einzige Aufgabe es ist, an zu bleiben. Es gibt vier Möglichkeiten. Ein übriger Mac mini zu Hause. Eine Linux-Kiste, wenn Sie kein Xcode brauchen. Ein Mac in einer Cloud. Oder ein gehosteter Mac mini, den jemand anderes wach hält. Der Vergleich der Orte für einen 24/7-Agent stellt die Kosten nebeneinander.

Häufige Fragen

Hält caffeinate Claude Code bei geschlossenem Deckel am Laufen?

Nein. Bei einem MacBook hat der Deckelschalter Vorrang vor caffeinate. Die Maschine muss am Netzteil hängen und ein externes Display haben. Oder Sie nutzen die Energieeinstellung disablesleep.

Stoppen Sperrbildschirm oder Bildschirmschoner den Agent?

Nein. Sperren und Bildschirmschoner versetzen die Maschine nicht in den Ruhezustand. Das tun nur der Ruhezustand-Timer, ein fast leerer Akku oder ein geschlossener Deckel. Für einen Agent im Terminal ist ein gesperrter Bildschirm kein Problem.

Gilt das auch für Codex?

Ja. Codex CLI ist wie Claude Code ein Terminal-Prozess. Es gelten dieselben Ruhezustand-Einstellungen, caffeinate und tmux, und dieselbe Deckel-Regel.

Kann ich den Mac vom Handy aus wach halten?

Sie können eine Aufgabe vom Handy aus starten, mit Remote Control von Claude Code oder per SSH. Aber Sie können einen Mac nicht aus der Ferne vom Einschlafen abhalten, wenn er sich dafür entschieden hat. Stellen Sie die Energieeinstellungen einmal direkt an der Maschine ein.