Claude Code

Claude Code bei zugeklapptem MacBook weiterlaufen lassen

Beim Zuklappen geht ein MacBook in den Ruhezustand, und Claude Code stoppt mit. Eine Sitzung von Keep Mac Awake hält es ohne externes Display am Laufen.

Von , der Keep Mac Awake entwickelt. , aktualisiert am . 10 Min. Lesezeit. Markdown

Kurze Antwort: Beim Zuklappen geht ein MacBook in den Ruhezustand, und Claude Code läuft nur, solange der Mac wach ist: Der Prozess claude arbeitet erst weiter, wenn du den Deckel wieder öffnest. Für die Einstellung „Keep computer awake“ der Desktop-App von Claude (in der deutschen App „Computer aktiv halten“) und für die Batterieeinstellungen ist nicht dokumentiert, dass sie den Ruhezustand beim Zuklappen verhindern, und caffeinate hält ihn nur mit -s und nur im Netzbetrieb auf: Der Mac bleibt dann im Dark-Wake-Zustand, läuft also bei ausgeschaltetem Display weiter. Damit Claude Code zugeklappt weiterläuft, starte eine Sitzung von Keep Mac Awake, bevor du den Deckel schließt; sie braucht kein Display (oder schließe einen externen Monitor mit Netzteil, Tastatur und Maus an). Lass den Mac am Netzteil und an einem Ort mit Luftzirkulation.

In 20 Sekunden ansehen: Claude Code läuft über Nacht bei geschlossenem Deckel, auf YouTube.

Warum stoppt Claude Code, wenn ich das MacBook zuklappe?

Claude Code stoppt, weil ein MacBook beim Zuklappen in den Ruhezustand geht und Claude Code nur läuft, solange der Mac wach ist. Im Ruhezustand läuft nichts; öffnest du den Deckel, bemerkt Claude Code die abgebrochene Verbindung und versucht es erneut, aber die Zeit bei geschlossenem Deckel ist verloren.

Apple nennt das Zuklappen des Displays als einen Weg, einen Mac-Laptop in den Ruhezustand zu versetzen (Apple Support). Claude Code ist ein Prozess auf deinem Mac: Von dort liest es deine Dateien, führt deine Befehle aus und kommuniziert mit der API von Anthropic. Laut der Dokumentation von Anthropic (Stand: Oktober 2026) laufen lokale Aufgaben nur, solange dein Computer wach ist, und für eine Aufgabe, die weiterlaufen muss, während der Computer im Ruhezustand oder ausgeschaltet ist, verweist sie auf eine Cloud-Sitzung (geplante Aufgaben, Desktop).

Wacht der Mac auf, bemerkt Claude Code die unterbrochene Verbindung. Seine Fehlerreferenz nennt Meldungen wie Your computer went to sleep mid-response und Connection lost while your computer was asleep, und wo es geht, versucht Claude Code es erneut (Fehlerreferenz). Stoppt es aus einem anderen Grund, etwa wegen eines Nutzungslimits oder einer Anfrage, die auf dich wartet, hilft der Ratgeber Warum stoppt Claude Code immer wieder?.

Warum helfen Keep computer awake, caffeinate und die Batterieeinstellungen nicht?

Die meisten verhindern nur den automatischen Ruhezustand nach Inaktivität, nicht den Ruhezustand beim Zuklappen; die Ausnahme ist caffeinate -s im Netzbetrieb.

  • „Keep computer awake“ in der Desktop-App von Claude. Die Option liegt (Stand: Oktober 2026) unter „Settings > This computer > System“ (in der deutschen App „Einstellungen > Dieser Computer > System“) und verhindert den automatischen Ruhezustand. Die Dokumentation von Anthropic ergänzt: „Das Schließen des Laptop-Deckels versetzt ihn dennoch in den Ruhezustand“ (geplante Aufgaben). Der Tab „Code“ hat eine eigene Einstellung „Keep computer awake while Claude works“ unter Settings > Claude Code und im Sitzungsmenü den Eintrag „Keep computer awake for this session“; laut dem Changelog von Anthropic geht damit „der Computer nicht mehr in den automatischen Ruhezustand, während Claude im Tab ‚Code‘ arbeitet“ (Changelog der Claude-App), und dort steht nicht, dass das auch bei geschlossenem Deckel gilt.
  • Der eingebaute Befehl. caffeinate ohne Optionen und mit -i setzt eine Power-Assertion gegen den automatischen Ruhezustand (eine Anforderung an macOS, nicht in den Ruhezustand zu gehen), und laut der Entwicklerdokumentation von Apple zu dieser Assertion kann das System „beim Zuklappen trotzdem in den Ruhezustand gehen“ (Entwicklerdokumentation von Apple). Die Option -s gilt nur im Netzbetrieb (man caffeinate), und laut Apple erlaubt ihre Assertion dem System, „beliebig lange im Dark-Wake-Zustand zu bleiben“ (Entwicklerdokumentation von Apple): Im Netzbetrieb läuft ein zugeklapptes MacBook bei ausgeschaltetem Display weiter, solange caffeinate läuft, und geht in den Ruhezustand, sobald du das Netzteil abziehst (mehr dazu, was caffeinate bei geschlossenem Deckel bewirkt).
  • Der eigene Umgang von Claude Code mit dem Ruhezustand. Das Changelog erwähnt (Stand: Oktober 2026) einen caffeinate-Prozess unter macOS und in v2.1.287 einen Fix für Remote-Control-Sitzungen, die stoppten, „wenn der Mac in den automatischen Ruhezustand ging“ (Changelog). Für keinen der beiden ist beschrieben, dass er auch bei geschlossenem Deckel wirkt. Für eine Desktop-Aufgabe, die die ganze Nacht laufen muss, rät Anthropic, den Computer wach und online zu halten, „mit geöffnetem Deckel“ (Desktop).
  • Batterieeinstellungen. „Kein automatisches Aktivieren des Ruhezustands im Netzbetrieb bei ausgeschaltetem Display“ verhindert den automatischen Ruhezustand nach Inaktivität (Apple Support). Das Zuklappen des Displays ist ein anderer Weg in den Ruhezustand.

Wie halte ich ein MacBook zugeklappt wach?

Die erste Wahl ist eine Sitzung von Keep Mac Awake: Sie funktioniert bei geschlossenem Deckel und ohne Display, endet, wenn du oder Claude Code sie beendet oder ihre Zeit abgelaufen ist, und stellt den normalen Ruhezustand von selbst wieder her. Die anderen Wege sind ein externes Display, das Abschalten des Ruhezustands von Hand mit sudo pmset disablesleep 1 und ein offener Deckel bei ausgeschaltetem Display, jeder mit den Grenzen, die unten stehen.

Eine Sitzung von Keep Mac Awake

Keep Mac Awake hält ein MacBook mit Apple-Chip und macOS 26 oder neuer bei geschlossenem Deckel wach, ohne externes Display, Tastatur oder Maus, für eine Sitzung, die du oder Claude Code startet, und stellt danach den normalen Ruhezustand wieder her. Details und Einrichtung stehen in den nächsten Abschnitten.

Ein externes Display (Betrieb mit geschlossenem Display)

Apple unterstützt den Betrieb eines zugeklappten MacBooks, sobald ein externes Display angeschlossen ist (Benutzerhandbuch des MacBook Air), mit dem Mac am Netzteil und mit externer Tastatur und Maus (Apple Support). Das bindet den Mac an diesen Arbeitsplatz, der Mac geht in den Ruhezustand, wenn das Display getrennt wird, und es hilft nicht, wenn der Mac fern vom Arbeitsplatz zugeklappt bleiben muss.

pmset disablesleep von Hand

macOS hat einen systemweiten Schalter, der den Ruhezustand komplett abschaltet:

sudo pmset disablesleep 1      # sleep off for the whole Mac
pmset -g | grep SleepDisabled  # 1 means on
sudo pmset disablesleep 0      # back to normal

Achtung: disablesleep ist in der man-Seite von pmset nicht beschrieben. Es ist ein Schalter für den ganzen Mac, ohne Timer, ohne Mindestladestand, ohne Temperaturprüfung und ohne Watchdog (einen unabhängigen Überwachungsdienst), und er bleibt aktiv, auch nach einem Neustart, bis du ihn wieder auf 0 setzt. Vergisst du ihn ein einziges Mal, geht der Mac in deiner Tasche nicht in den Ruhezustand.

Deckel offen, Display aus

Dabei bleibt der Deckel offen; es ist also kein Weg für einen geschlossenen Deckel. Aktiviere unter Systemeinstellungen > Batterie > Optionen „Kein automatisches Aktivieren des Ruhezustands im Netzbetrieb bei ausgeschaltetem Display“ (Apple Support) und lass das Display ausgehen. Der Mac arbeitet weiter, steht aber aufgeklappt auf dem Tisch, und du kannst ihn nicht einpacken.

Was du nutzen solltest

Um Claude Code bei zugeklapptem MacBook weiterlaufen zu lassen, 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, und stellt danach den normalen Ruhezustand wieder her; Claude Code kann sie mit keepmacawake start --hours 8 --json starten.

Keep Mac Awake ist eine Menüleisten-App mit dem Befehl keepmacawake. Die App hält den Mac auch bei geschlossenem Deckel über die systemweite Einstellung SleepDisabled wach, nicht mit caffeinate oder Power-Assertions, und nur für eine Sitzung (unbegrenzt, 1 Stunde, 8 Stunden oder eine eigene Stundenzahl bis 168); danach setzt sie die Einstellung zurück. Bei geschlossenem Deckel wird das integrierte Display dunkel. Eine Sitzung läuft standardmäßig nur im Netzbetrieb und wartet, wenn du das Netzteil abziehst; der Akkubetrieb ist optional, bis zu einem Mindestladestand, den du festlegst. Ein separater Watchdog stellt die normale Ruhezustandseinstellung wieder her, falls der Hintergrunddienst von Keep Mac Awake oder der Systemdienst stoppt oder hängt, und auch das Beenden der App stellt sie wieder her. Keep Mac Awake ist 3 Tage kostenlos (Sitzungen bis 8 Stunden, ohne Kreditkarte), danach kostet die App einmalig 9 USD pro Mac inklusive Steuern. Sie hält die WLAN-Verbindung nicht aufrecht und weckt keinen Mac auf, der schon im Ruhezustand ist. Für Läufe, die tagelang dauern sollen, oder wenn du über einen zweiten Mac nachdenkst, hilft der Ratgeber Mac mini oder MacBook für KI-Agenten, die immer laufen. Mehr zur App: MacBook zugeklappt laufen lassen.

Wie richte ich Claude Code ein, damit es zugeklappt weiterläuft?

Starte eine Sitzung von Keep Mac Awake, starte Claude Code, gib ihm die Aufgabe und schließe dann den Deckel. Im Einzelnen:

  1. Schließe den Mac an das Stromnetz an.
  2. Starte eine Sitzung über die Menüleiste oder im Terminal mit keepmacawake start --hours 8. Wähle etwas mehr Zeit, als die Aufgabe braucht.
  3. Öffne dein Projekt, starte Claude Code mit claude und gib ihm die Aufgabe. Willst du die Arbeit vom Handy aus verfolgen, starte es stattdessen mit claude --remote-control; mehr dazu im Ratgeber Claude Code Remote Control bei geschlossenem Deckel. Willst du stattdessen Aufgaben vom Handy an die Desktop-App von Claude schicken, hilft der Ratgeber Claude Code Remote Control oder Dispatch.
  4. Schließe den Deckel. Lass den Mac auf einem Tisch oder einer anderen festen Unterlage liegen, nie in einer Tasche oder unter einem Kissen.
  5. Wenn die Arbeit fertig ist, führe keepmacawake stop aus, oder lass die Sitzung mit fester Dauer von selbst enden. Der normale Ruhezustand kommt zurück.

Wie kann Claude Code die Sitzung selbst starten und beenden?

Claude Code kann vor einer langen Aufgabe keepmacawake start --hours N --json und danach keepmacawake stop --json ausführen, und ein paar Zeilen in ~/.claude/CLAUDE.md sorgen dafür, dass es das von selbst tut.

keepmacawake start --hours 4 --json   # confirmed, or refused with a reason
keepmacawake status --json            # phase and time left
keepmacawake stop --json              # ends it and restores normal sleep

Jeder Aufruf gibt ein JSON-Objekt aus. Exit-Codes: 0 Erfolg, 1 fehlgeschlagen, 2 ungültige Argumente, 4 du bist gefragt (Netzbetrieb oder Kauf), 5 läuft bereits oder nichts zu beenden, 6 nicht installiert, 7 keine Antwort in der vorgesehenen Zeit. Claude Code lädt ~/.claude/CLAUDE.md in all deinen Projekten (Memory-Dokumentation); füge hinzu:

Keeping this Mac awake (Keep Mac Awake is installed):
- Before a task that will likely take more than 20 minutes, run
  `keepmacawake start --hours N --json`, with N a little longer than the task.
  Never use sudo, and never use --unlimited unless I ask.
- Exit code 4: tell me what it needs (AC power or a purchase). Do not work around it.
- Exit code 5: a session is already running. Leave it alone and do not stop it later.
- When the task is done, or you stop early, run `keepmacawake stop --json`
  for the session you started.
- Remind me to keep the Mac ventilated if I close the lid.

Damit Claude nicht bei einer Berechtigungsanfrage stehen bleibt, füge Bash(keepmacawake start *), Bash(keepmacawake status *) und Bash(keepmacawake stop *) zu permissions.allow in ~/.claude/settings.json hinzu (Berechtigungen). Statt der Zeilen in CLAUDE.md kannst du den Agent Skill von https://keepmacawake.com/skill/keep-mac-awake/SKILL.md installieren; wie das geht, zeigt der Leitfaden für Agenten. Um die Arbeit vom Handy aus im Blick zu behalten, hilft der Ratgeber KI-Coding-Agenten vom Handy aus steuern.

Häufige Fragen

Läuft Claude Code weiter, wenn ich den Laptop zuklappe?

Standardmäßig nicht. Beim Zuklappen geht ein MacBook in den Ruhezustand, und Claude Code läuft nur, solange der Mac wach ist. Bei geschlossenem Deckel läuft es während einer Sitzung von Keep Mac Awake weiter, die kein Display braucht und am Ende den normalen Ruhezustand wiederherstellt. Ein externer Monitor mit Netzteil, Tastatur und Maus hält es ebenfalls am Laufen, am Arbeitsplatz, und das tut auch sudo pmset disablesleep 1, das systemweit gilt und ohne Timer aktiv bleibt, bis du es rückgängig machst.

Kann Claude Code bei zugeklapptem Laptop laufen?

Ja, solange der Mac wach bleibt, und die erste Wahl, um ihn wach zu halten, ist Keep Mac Awake: Starte eine Sitzung, zum Beispiel mit keepmacawake start --hours 8, bevor du den Deckel schließt, dann arbeitet Claude Code ohne externes Display weiter, bis die Sitzung endet und der normale Ruhezustand zurückkommt. Ohne Sitzung geht ein zugeklapptes MacBook in den Ruhezustand, und Claude Code stoppt mit ihm; selbst wenn Keep computer awake in der Desktop-App von Claude eingeschaltet ist, heißt es in der Dokumentation von Anthropic: „Das Schließen des Laptop-Deckels versetzt ihn dennoch in den Ruhezustand.“ Ein externer Monitor mit Netzteil, Tastatur und Maus hält es ebenfalls am Laufen, am Arbeitsplatz.

Funktioniert Keep computer awake in der Desktop-App von Claude bei geschlossenem Deckel?

Nein. Die Einstellung verhindert (Stand: Oktober 2026) den automatischen Ruhezustand, und laut der Dokumentation von Anthropic geht der Mac beim Zuklappen des Laptops trotzdem in den Ruhezustand.

Kann caffeinate Claude Code bei geschlossenem Deckel am Laufen halten?

Nur mit -s und nur im Netzbetrieb: Der Mac bleibt dann im Dark-Wake-Zustand bei ausgeschaltetem Display, solange caffeinate läuft, und geht in den Ruhezustand, sobald du das Netzteil abziehst. Laut der Dokumentation von Apple kann das System beim Zuklappen trotzdem in den Ruhezustand gehen, während die Power-Assertion gegen den automatischen Ruhezustand aktiv ist, die caffeinate standardmäßig setzt.

Ist es sicher, ein MacBook zugeklappt laufen zu lassen?

Es erzeugt weiter Wärme, also stell es auf eine feste, ebene Unterlage mit Luftzirkulation, nie in eine Tasche oder unter ein Kissen. Keep Mac Awake läuft standardmäßig nur im Netzbetrieb, und im Akkubetrieb endet eine Sitzung außerdem, sobald der thermische Zustand „ernst“ (serious) oder der Mindestladestand erreicht ist, den du festlegst (mehr dazu im Ratgeber MacBook zugeklappt im Akkubetrieb wach halten).

Kann Claude Code Keep Mac Awake selbst ein- und ausschalten?

Ja. Es kann vor einer langen Aufgabe keepmacawake start --hours N --json ausführen und danach keepmacawake stop --json. Eine Sitzung startet nie von selbst; sie startet nur, wenn du oder dein Agent den Befehl ausführt oder auf die Schaltfläche klickt.

Quellen