Claude Code Remote Control bricht beim Schließen des Laptops ab – mit Lösung
Mit Remote Control lässt sich eine Claude-Code-Sitzung per QR-Code vom Smartphone aus weiter steuern. Beim Zuklappen des Rechners wird die Funktion allerdings unterbrochen, es gibt aber einen praktikablen Fix.
Claude Codes Remote Control ist grossartig: Man fuehrt claude remote-control aus (oder /remote-control in einer Sitzung), scannt den QR-Code mit der Claude-App, und schon kann man die Sitzung bequem vom Sofa aus mit dem Handy weiter steuern. Aktiviert man in /config die Option Push when actions required, kommen Berechtigungsanfragen und Fragen als Push-Benachrichtigungen an.
Dann schliesst man den MacBook-Deckel, und die Sitzung verstummt.
Die Sitzung laeuft auf dem Mac. Remote Control ist ein Fenster hinein, keine Kopie. Wenn der Mac in den Ruhezustand geht, stoppt Claude. Die Dokumentation sagt genau das:
Wenn Ihr Laptop einschlaeft oder Ihre Verbindung abreisst, verbindet sich Claude Code automatisch wieder, sobald Ihre Maschine wieder online ist.
Es verbindet sich also danach wieder. Waehrend der Mac schlaeft, laeuft nichts, und die Nachricht, die man vom Handy aus geschickt hat, wartet, bis der Deckel wieder geoeffnet wird.
Das Schliessen des Deckels versetzt einen MacBook ohne externes Display in den Ruhezustand, unabhaengig von caffeinate. Claude Code fuehrt bereits caffeinate -i aus, waehrend es arbeitet, was nur den Leerlauf-Schlafmodus verhindert.
Deckel offen, am Netzteil. Nichts zu tun. caffeinate -i haelt den Mac wach, solange ein Durchlauf laeuft. Wenn das Licht stoert, schaltet pmset displaysleepnow den Bildschirm aus, ohne den Schlafmodus auszuloesen.
Deckel geschlossen (in der Tasche, am Bett). Das Einzige, was den Deckel-Schlafmodus verhindert, ist:
sudo pmset -a disablesleep 1 Enter fullscreen mode Exit fullscreen mode Zwei Dinge sollte man wissen, bevor man das macht:
Wissen, wann es fertig ist. Neben den eigenen Pushes von Remote Control kann ein Stop-Hook eine Benachrichtigung senden. Kopierfaehige Versionen davon (und davon, wie man AskUserQuestion aus einem Hook beantwortet) finde ich in claude-code-hooks-recipes.
Ich habe Lidnight entwickelt, eine Menu-Bar-App, die genau den Teil uebernimmt, den Remote Control auslaesst: Sie nutzt die Hooks von Claude Code und Codex, um den Mac nur wachzuhalten, waehrend ein Durchlauf laeuft (auch bei geschlossenem Deckel und im Akkubetrieb), und sobald jede Sitzung zehn Minuten lang still war, stellt sie disablesleep zurueck und laesst den Mac einschlafen. Sie macht zudem ein uebrig gebliebenes disablesleep beim Booten rueckgaengig, sodass ein Absturz den Mac nicht dauerhaft wach halten kann.
Remote Control bleibt genau so, wie es ist. Man steigt vom Handy aus wieder ein, laesst den Deckel geschlossen, und der Mac schlaeft von selbst ein, wenn die Arbeit erledigt ist.
Automatisch übersetzt. Das Original auf Englisch ist unten aufklappbar.
Original (Englisch) anzeigen
Claude Code's Remote Control is great: run claude remote-control (or /remote-control in a session), scan the QR code with the Claude app, and you can keep steering the session from your phone on the couch. Turn on Push when actions required in /config and permission prompts and questions arrive as pushes.
Then you close the MacBook lid, and the session goes quiet.
The session runs on your Mac. Remote Control is a window into it, not a copy of it. When the Mac sleeps, Claude stops. The docs say exactly this:
if your laptop sleeps or your network drops, Claude Code reconnects automatically when your machine comes back online.
So it reconnects afterwards. Nothing runs while the Mac is asleep, and the message you sent from your phone waits until the lid opens again.
Closing the lid without an external display puts a MacBook to sleep regardless of caffeinate. Claude Code already runs caffeinate -i while it works, which only blocks idle sleep.
Lid open, on power. Nothing to do. caffeinate -i keeps the Mac awake while a turn runs. If the light bothers you, pmset displaysleepnow turns the screen off without sleeping.
Lid closed (bag, bedside). The only thing that stops lid-close sleep is:
sudo pmset -a disablesleep 1 Enter fullscreen mode Exit fullscreen mode Two things to know before you do that:
Knowing when it's done. Besides Remote Control's own pushes, a Stop hook can ping you. I keep copy-paste versions of that (and of answering AskUserQuestion from a hook) in claude-code-hooks-recipes.
I build Lidnight, a menu bar app that takes just the part Remote Control leaves out: it uses Claude Code's and Codex's hooks to keep the Mac awake only while a turn is running (lid closed, on battery too), and once every session has been quiet for ten minutes it restores disablesleep and lets the Mac sleep. It also undoes a leftover disablesleep at boot, so a crash can't leave your Mac stuck awake.
Remote Control stays exactly as it is. Continue from your phone, leave the lid closed, and the Mac sleeps on its own when the work is done.