Wie läuft Claude Code bei geschlossenem MacBook-Deckel weiter?

Ohne externes Display heißt das: sudo pmset -a disablesleep 1 oder eine App wie Clamshell für Mac (auf Englisch), eine Menüleisten-App, die ein MacBook mit Apple Silicon bei geschlossenem Deckel wach hält, ohne sudo und ohne Administratorrechte. caffeinate allein reicht nicht.

Du startest einen langen Agenten-Lauf, klappst das MacBook zu und findest später eine hängende Sitzung vor. Beim Schließen des Deckels wechselt der Mac normalerweise in den Ruhezustand, lokale Arbeit pausiert, und Netzwerkverbindungen können abbrechen. Diese Anleitung zeigt, wie du mit geschlossenem Deckel arbeitest, ohne externes Display und ohne Administratorrechte, und wie du herausfindest, ob der Ruhezustand wirklich dein Problem ist.

Claude Code hält an, sobald du aufs Smartphone wechselst?

Die Remote-Control-Dokumentation von Anthropic erklärt, dass die Arbeit weiterhin auf deinem Computer läuft. Dein Smartphone steuert diese lokale Sitzung, verlagert den Job aber nicht in die Cloud. Remote Control kann sich nach dem Ruhezustand wieder verbinden, doch solange der Mac schläft, geht lokale Arbeit nicht voran.

Ist der Ruhezustand beim Schließen die Ursache, stell den Mac auf einen gut belüfteten Tisch, mit Netzteil und stabiler Verbindung. Aktiviere Clamshell über die Menüleiste und prüfe, dass es aktiv ist, bevor du den Deckel schließt. Teste mit der siebentägigen Testphase deinen eigenen Workflow; die App kostet einmalig 9,99 $ für einen Mac. Lies vor dem Download die Systemanforderungen.

Was Clamshell einem Keep-Awake-Befehl voraushat

Bleibt der Deckel offen, kann caffeinate den Ruhezustand bei Inaktivität für einen Terminal-Job verhindern. Clamshell ist dafür da, ein MacBook mit Apple Silicon bei geschlossenem Deckel arbeiten zu lassen, ohne externen Monitor und ohne Administratorzugriff.

• Der Überhitzungsschutz ist immer aktiv. Clamshell überwacht die thermische Belastung von macOS. Wird sie hoch oder kritisch, deaktiviert sich Clamshell, sodass wieder der normale Ruhezustand beim Schließen gilt, und blockiert die Aktivierung, bis der Mac abgekühlt ist. Sorge trotzdem für Belüftung; dieser Schutz ersetzt keine Luftzirkulation.
• Agenten können den Bildschirm nutzen, während das Display schwarz bleibt. Ist die Einstellung „Bildschirmzugriff für Agenten“ eingeschaltet (Standard), bleibt der Bildschirm während einer aktiven Sitzung mit geschlossenem Deckel für Screenshots und Desktop-Interaktion verfügbar, während das integrierte Display schwarz bleibt. Schaltest du sie aus, geht das Display bei geschlossenem Deckel stattdessen in den Ruhezustand, was weniger Akku verbraucht. Beim Öffnen des Deckels wird dein Mac gesperrt. Der Agent braucht weiterhin eigene Berechtigungen und eine funktionierende Verbindung.
• Du kannst einen Batterieschutz festlegen. Schalte Bei niedrigem Batteriestand deaktivieren in den allgemeinen Einstellungen ein und wähle einen Schwellenwert. Diese Option ist standardmäßig aus.

Lade die siebentägige kostenlose Testversion und prüfe deinen echten Agenten-Workflow, bevor du kaufst. Die Direktlizenz kostet einmalig 9,99 $ für einen Mac. Apple Silicon, macOS 14+. Von Apple notarisiert. 3,6 MB.

Eine Smartphone-Sitzung mit geschlossenem Deckel einrichten

Du brauchst ein MacBook mit Apple Silicon ab macOS 14, installiertes Clamshell und eine funktionierende lokale Agenten-Sitzung. Stell den Mac auf einen gut belüfteten Tisch, mit Netzteil und Internetverbindung. Trenne für diese Einrichtung alle externen Displays.

1. Verbinde dein Smartphone bei geöffnetem Deckel. Gib in einer bestehenden Claude-Code-Sitzung im Terminal /remote-control ein und folge dem Verbindungslink oder QR-Code. Die Kontovoraussetzungen findest du in der aktuellen Anleitung von Anthropic. Schick eine kleine Anfrage vom Smartphone und prüfe, ob der Mac antwortet.
2. Du nutzt stattdessen Happy? Folge der Installations- und Kopplungsanleitung von Happy und starte dann happy claude oder happy codex in deinem Projekt. Prüfe, ob eine Anfrage vom Smartphone diese Sitzung erreicht, bevor du weitermachst. Das sind alternative Smartphone-Verbindungen; du brauchst nur eine.
3. Aktiviere Clamshell. Nutze das Menüleistensymbol oder führe den Befehl unten aus. Öffne das Menü und prüfe, ob Clamshell aktiv ist. Ein wegen eines externen Displays pausierter Zustand bedeutet nicht, dass diese Einrichtung aktiv ist.

   open "clamshell://arm"

Beweisen, dass die Arbeit weiterläuft

1. Bitte deinen verbundenen Agenten, diesen harmlosen Zeitstempel-Test in seinem Terminal auszuführen.

   for i in {1..12}; do
     date -u '+%Y-%m-%dT%H:%M:%SZ'
     sleep 10
   done

2. Bestätige den Befehl bei geöffnetem Deckel und schließe den Deckel während des zweiminütigen Laufs.
3. Frag nach zwei Minuten vom Smartphone aus nach der Ausgabe und einem frischen Zeitstempel. Bestanden: Die Zeitstempel liefen bei geschlossenem Deckel im Abstand von etwa zehn Sekunden weiter, und die neue Anfrage wird abgeschlossen, bevor du den Deckel wieder öffnest.

Manche Clients puffern die Terminalausgabe; ein stiller Smartphone-Bildschirm allein ist also kein Fehlschlag. Eine Anzeige „verbunden“ allein heißt aber auch nicht, dass der Test bestanden ist.

Wenn es fehlschlägt: Öffne den Deckel und prüfe die Lücken zwischen den Zeitstempeln, den Zustand von Clamshell, das Terminal und offene Berechtigungsanfragen. Eine lange Lücke deutet auf eine Unterbrechung hin, nennt aber nicht von sich aus die Ursache. Behebe Fehler zuerst bei geöffnetem Deckel und wiederhole den Test, bevor du dich auf einen langen Job verlässt.

Die Sitzung beenden

Öffne den Deckel, stoppe oder beende die Aufgabe deines Agenten und deaktiviere Clamshell dann über das Menü oder mit dem Befehl unten. Prüfe, dass Clamshell nicht mehr aktiv ist, bevor du den Mac wegpackst. Eine Aktivierung per Rechtsklick oder über Kurzbefehle bleibt auch nach dem Öffnen des Deckels bestehen, bis du sie deaktivierst. Das Öffnen allein beendet diese Modi also nicht.

open "clamshell://disarm"

Clamshell bietet in der Kurzbefehle-App außerdem die Aktionen Aktivieren, Deaktivieren, Umschalten und Status. Füge sie in einen eigenen Kurzbefehl ein. Ein wacher Mac umgeht keine Agenten-Berechtigungen, behebt keinen Netzwerkausfall und macht einen schlafenden Mac nicht aus der Ferne aufweckbar.

Warum lokale Arbeit beim Zuklappen pausiert

1. Du schließt den DeckelmacOS leitet den Ruhezustand beim Schließen ein.
2. Der Mac schläft einEin laufender Agent hält ihn nicht davon ab.
3. Der Agent stoppt mitten in der AufgabeBuilds, Downloads und SSH-Sitzungen stoppen ebenfalls.

Der Ruhezustand beim Schließen ist nicht der Ruhezustand bei Inaktivität. Eine aktive Aufgabe verhindert ihn nicht von selbst. Ohne unterstützte Konfiguration mit geschlossenem Display oder eine Übersteuerung des Ruhezustands kann das Zuklappen einen Agenten mitten in der Aufgabe anhalten. Schläft der Mac, kommen Claude Code, Codex, Builds, Downloads und SSH-Sitzungen nicht mehr voran. Je nach Tool erholt sich die Sitzung beim Aufwachen oder auch nicht; die Stunden dazwischen sind so oder so verloren.

Was nicht funktioniert, und warum

• caffeinate und die meisten Keep-Awake-Apps in der Menüleiste verhindern nur den Ruhezustand bei Inaktivität. Der Ruhezustand beim Schließen ignoriert sie, lokale Arbeit pausiert also trotzdem. Manche Apps wie KeepingYouAwake sagen ausdrücklich, dass der Betrieb mit geschlossenem Deckel nicht unterstützt wird.
• sudo pmset -a disablesleep 1 funktioniert zwar, ist aber ein globaler Schalter auf Administratorebene: Er deaktiviert jede Art von Ruhezustand, auch im Akkubetrieb, bis du daran denkst, ihn zurückzusetzen. Vergisst du es, läuft sich der Mac in deiner Tasche leer.
• Ein externes Display oder ein HDMI-Dummy-Stecker erfüllt die Bedingungen für den offiziellen Clamshell-Modus von macOS. Das ist aber Hardware, die du besitzen, mit Strom versorgen und mitnehmen musst.

Die Lösung in zwei Sekunden

Clamshell ist eine Menüleisten-App genau dafür. Halte die Wahltaste gedrückt und schließe den Deckel: Der Bildschirm wird dunkel, der Mac bleibt wach, und dein Agent arbeitet weiter. Bei der Geste „Wahltaste + Deckel schließen“ beendet das Öffnen des Deckels diese einmalige Sitzung, und eine Aktivierung über das Menü in der Menüleiste gilt ebenfalls nur für den nächsten Schließvorgang. Eine Aktivierung per Rechtsklick oder über Kurzbefehle hält Clamshell aktiv, bis du es deaktivierst. Administratorrechte sind nicht nötig: kein sudo, keine Kernel-Erweiterung, kein privilegierter Helper.

Clamshell hält deinen Mac bei geschlossenem Deckel wach. 7 Tage kostenlos, danach einmalig 9,99 $.

Kostenlos testen

Apple Silicon, macOS 14+. Von Apple notarisiert. 3,6 MB.

Aktivierung aus dem Terminal

Clamshell nimmt Anfragen zum Aktivieren und Deaktivieren über sein URL-Schema an. Dieses Shell-Beispiel fordert die Aktivierung vor einer Aufgabe an und die Deaktivierung, wenn die Shell endet. Der Befehl open übermittelt nur eine Anfrage; er bestätigt nicht, dass Clamshell erfolgreich aktiviert wurde. Prüfe den Zustand in der App, bevor du den Deckel schließt. Ein EXIT-Trap ist nach einem Shell-Absturz oder einem erzwungenen Beenden keine Garantie.

set -e
open "clamshell://arm"
trap 'open "clamshell://disarm" || true' EXIT

# your long-running task
claude -p "run the test suite and fix the failures"

Hast du die Aktivierung geprüft, brauchst du keine Wahltaste mehr. Es gibt auch clamshell://toggle, und die Kurzbefehle-Aktionen von Clamshell (Aktivieren, Deaktivieren, Umschalten, Status) lassen sich in eigene Kurzbefehle und Automationen einbauen.

Claude Code, Codex, Cursor, Builds und SSH

Dem Deckel ist egal, welcher Prozess die Arbeit erledigt. Schläft der Mac, pausieren lokale Coding-Agenten, Kindprozesse stoppen, Netzwerkverbindungen können abbrechen, und entfernte Sitzungen können in ein Timeout laufen. Bleibt die Maschine wach, bleibt die gesamte Arbeitsumgebung erhalten:

Über Nacht, auch im Akkubetrieb

Bei geschlossenem Deckel bleibt das integrierte Display schwarz. Ansonsten läuft der Mac wie bei geöffnetem Deckel: Leichte Agenten-Arbeit braucht wenig Strom, schwere Arbeit so viel wie immer. Wenn Agenten den Bildschirm nicht nutzen müssen, schalte diese Einstellung aus; dann geht das Display in den Ruhezustand und spart Akku. Clamshell übersteht das Ein- und Ausstecken mitten im Lauf, und ein optionaler Batterieschutz (standardmäßig aus, in den Einstellungen) lässt den Mac in den Ruhezustand wechseln, wenn der Ladestand unter einen von dir gewählten Wert fällt. So muss ein nächtlicher Lauf den Akku nicht leer ziehen. Der Mac bleibt außerdem im Netzwerk, SSH und Bildschirmfreigabe funktionieren also auch bei geschlossenem Deckel.

Kompatibilität

MacBooks mit Apple Silicon ab macOS 14. Die Geste „Wahltaste + Deckel schließen“ nutzt den Deckelwinkelsensor im MacBook Air M2 (2022) oder neuer und im MacBook Pro mit 14 oder 16 Zoll (2021) oder neuer; auf anderen Laptops mit Apple Silicon aktivierst du Clamshell stattdessen über die Menüleiste. Mehr dazu in den häufigen Fragen. Wenn du dich zwischen Methoden entscheidest, vergleiche Clamshell, Amphetamine, pmset, caffeinate und Apples Display-Konfiguration (auf Englisch).

Häufige Fragen

Weitere Anleitungen

• Codex bei geschlossenem Deckel weiterlaufen lassen
• MacBook im Clamshell-Modus ohne externes Display nutzen
• Was sudo pmset disablesleep 1 bewirkt und wie du es rückgängig machst
• KI-Agenten über Nacht auf einem MacBook laufen lassen (auf Englisch)
• Einen Cursor-Agenten bei geschlossenem Deckel weiterlaufen lassen (auf Englisch)
• Warum caffeinate bei geschlossenem Deckel nicht funktioniert (auf Englisch)
• Ein MacBook zugeklappt im Akkubetrieb laufen lassen (auf Englisch)
• Was das eingebaute caffeinate von Claude Code abdeckt und was nicht (auf Englisch)
• Clamshell-Preise: einmalig 9,99 $ nach 7 Tagen kostenloser Testphase

Clamshell ist eine unabhängige App und steht in keiner Verbindung zu Anthropic oder OpenAI und wird von ihnen weder unterstützt noch empfohlen. Claude Code und Codex sind Marken ihrer jeweiligen Inhaber. Diese Seite ist die deutsche Übersetzung der englischen Anleitung.