Codex weiterlaufen lassen, wenn du den MacBook-Deckel schließt.

Läuft Codex weiter, wenn ich den Laptop zuklappe?

Nur Aufgaben in Codex Cloud, weil sie auf den Servern von OpenAI laufen. Läufe in der Codex CLI und der Desktop-App finden auf deinem Mac statt; beim Zuklappen schläft der Mac ein und pausiert sie. Damit ein lokaler Lauf bei geschlossenem Deckel weitergeht, halte den Mac mit einem externen Display, mit sudo pmset -a disablesleep 1 oder mit einer App gegen den Ruhezustand beim Schließen wie Clamshell wach. Die Codex-Einstellung „Keep this Mac awake“ deckt einen geschlossenen Deckel nicht ab (auf Englisch).

Es kommt darauf an, wo Codex läuft. Die Codex CLI und Codex-Chats in der Desktop-App von OpenAI arbeiten auf deinem Mac und kommen daher nicht mehr voran, wenn ein geschlossener Deckel den Mac schlafen legt. Aufgaben in Codex Cloud laufen in der Cloud von OpenAI und arbeiten weiter, während dein Computer schläft; sie brauchen nichts von deinem Mac. Damit ein lokaler Codex-Lauf bei geschlossenem Deckel und ohne externen Monitor weitergeht, nutze Clamshell für Mac, eine Menüleisten-App, die ein MacBook mit Apple Silicon zugeklappt wach hält und den normalen Ruhezustand beim Schließen wiederherstellt, sobald du sie deaktivierst.

Kurze Antwort

Welches Codex nutzt du?

„Codex“ steht für mehrere Produkte, die an unterschiedlichen Orten laufen. Nur die, die auf deinem Mac laufen, interessiert der Deckel.

Ist dein Repository schon für Codex Cloud eingerichtet, ist es am einfachsten, die Aufgabe für die Nacht dorthin zu schicken: Dann muss auf deinem Laptop nichts wach bleiben. Lies weiter, wenn der Job deine lokalen Dateien, Tools, Zugangsdaten oder deine Hardware braucht.

Warum ein lokaler Codex-Lauf beim Zuklappen stoppt

1. Du schließt den DeckelmacOS leitet den Ruhezustand beim Schließen ein, getrennt vom Ruhezustand bei Inaktivität.
2. Nichts hält ihn aufEin beschäftigter Agent nicht, und caffeinate auch nicht.
3. Codex kommt nicht mehr voranKindprozesse, Test-Runner und Verbindungen stoppen ebenfalls.

Das Schließen eines MacBook-Deckels löst den Ruhezustand beim Schließen aus, der vom Ruhezustand bei Inaktivität getrennt ist. Ein Agent, der gerade Code schreibt oder Tests ausführt, blockiert ihn nicht, und caffeinate auch nicht: Es hält nur den Ruhezustand bei Inaktivität fern. Schläft der Mac, kommen Codex, seine Kindprozesse, Test-Runner und Netzwerkverbindungen nicht mehr voran. Ob die Sitzung beim Aufwachen sauber weiterläuft, hängt davon ab, was sie gerade tat; die Stunden dazwischen sind so oder so verloren.

Die Desktop-App von OpenAI hat für Remote-Hosts eine Einstellung namens Keep this Mac awake, die laut OpenAI den Ruhezustand verhindert, wenn der Computer am Strom hängt und Fernzugriff aktiviert ist. OpenAI empfiehlt selbst, dass ein Mac-Laptop als Host bei geöffnetem Deckel und mit Netzteil verfügbar bleibt und dass du bei geschlossenem Deckel zusätzlich ein externes Display anschließt. Damit bleibt ein Fall offen: Deckel zu, kein Monitor.

Codex lokal bei geschlossenem Deckel ausführen

• Apples Modus mit geschlossenem Display. Schließ ein externes Display, eine Tastatur, eine Maus und das Netzteil an. Laut Apples Anleitung muss ein zugeklappter Laptop dafür am Strom hängen und eine externe Tastatur und Maus nutzen. Zuverlässig, wenn du die Hardware hast und am Schreibtisch bleibst.
• sudo pmset -a disablesleep 1. Hält den Mac bei geschlossenem Deckel wach, ist aber ein globaler Schalter auf Administratorebene ohne Timer, der auch im Akkubetrieb gilt. Siehe was pmset disablesleep bewirkt und wie du es rückgängig machst.
• Clamshell. Eine Menüleisten-App, die den Ruhezustand beim Schließen nur übersteuert, solange sie aktiv ist. Kein sudo, keine Administratorrechte, keine Kernel-Erweiterung, kein privilegierter Helper. Sie nutzt statt pmset die IOKit-Steuerung für den Clamshell-Ruhezustand, die keine Sonderrechte braucht, und die Einstellung übersteht nie einen Neustart.

Clamshell für Mac hält ein MacBook mit Apple Silicon bei geschlossenem Deckel wach, ganz ohne Monitor. 7 Tage kostenlos, danach einmalig 9,99 $ für einen Mac.

Kostenlos testen

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

Einen Lauf der Codex CLI so verpacken, dass er Clamshell aktiviert und deaktiviert

Clamshell nimmt die URLs clamshell://arm, clamshell://disarm und clamshell://toggle an. Dieser Wrapper fordert vor einem nicht interaktiven Codex-Lauf die Aktivierung an und beim Beenden der Shell die Deaktivierung. So kehrt der normale Ruhezustand beim Schließen zurück, sobald der Job fertig ist.

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

# codex exec is read-only by default; allow edits in the workspace
codex exec --sandbox workspace-write "run the test suite and fix the failures" \
  2>> codex-progress.log | tee codex-result.md

Lies die Einschränkungen, bevor du dich darauf verlässt:

• open übermittelt nur eine Anfrage. Ein erfolgreicher Exit-Code beweist nicht, dass Clamshell aktiv ist. Clamshell kann ablehnen, zum Beispiel bei hoher thermischer Belastung, oder pausieren, solange ein externes Display verbunden ist. Prüfe den Zustand in der Menüleiste, bevor du den Deckel schließt.
• Der EXIT-Trap ist kein Versprechen. Er läuft nicht, wenn die Shell zwangsweise beendet wird oder abstürzt. Deaktiviere im Zweifel über das Menü.
• Clamshell weiß nichts von Codex. Es gibt keine Codex-Integration, und Clamshell erkennt nicht, wann ein Agent fertig ist. Das Skript beendet die Sitzung.
• Berechtigungen gelten weiterhin. Laut OpenAI läuft codex exec in einer schreibgeschützten Sandbox, sofern du keine weitere wählst. Gib dem Job nur so viel Zugriff wie nötig; ein wacher Mac bestätigt nichts.
• Setapp-Version. Die Setapp-Version nutzt stattdessen das Schema clamshell-setapp://.

Clamshell fügt der Kurzbefehle-App außerdem die Aktionen Aktivieren, Deaktivieren, Umschalten und Status hinzu, die du in einem eigenen Kurzbefehl kombinieren kannst.

Beweisen, dass Codex bei geschlossenem Deckel weiterarbeitet

Bevor du einem langen Lauf vertraust, nimm dir zwei Minuten für einen harmlosen Test.

1. Bitte Codex in einer interaktiven Sitzung bei geöffnetem Deckel, diesen Befehl auszuführen, und bestätige ihn:

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

2. Prüfe, dass Clamshell aktiv ist, und schließ den Deckel für die zwei Minuten.
3. Öffne ihn und führe cat lid-check.txt aus. Bestanden: zwölf Zeitstempel im Abstand von etwa zehn Sekunden, ohne Lücke, während der Deckel zu war.

Nicht bestanden: Eine lange Lücke heißt, dass der Lauf unterbrochen wurde, aber nicht, warum. Prüfe den Zustand von Clamshell, das Terminal und ob Codex auf eine Bestätigung gewartet hat, behebe das Problem bei geöffnetem Deckel und wiederhole den Test.

Nutzt du Remote aus der ChatGPT-App auf dem Smartphone, mach denselben Test vom Smartphone aus: Frag Codex nach zwei Minuten mit geschlossenem Deckel nach dem Dateiinhalt und einem frischen Zeitstempel. Eine Verbindungsanzeige allein heißt noch nicht, dass der Test bestanden ist.

Einen lokalen Codex-Lauf vom Smartphone aus steuern

Mit der Remote-Funktion von OpenAI steuert die ChatGPT-App auf iOS oder Android Codex-Chats auf einem verbundenen Mac- oder Windows-Computer, auf dem die ChatGPT-Desktop-App läuft. Eingerichtet wird das in der Desktop-App, nicht in der Codex CLI oder der IDE-Erweiterung. Vom Smartphone aus kannst du Chats starten oder fortsetzen, Fragen beantworten, Befehle bestätigen sowie Diffs und Testergebnisse prüfen. Der Host muss wach, online und angemeldet bleiben.

Clamshells Rolle ist eng umrissen: Bei geschlossenem Deckel bewahrt es den Host-Mac vor dem Ruhezustand beim Schließen, damit Remote etwas hat, mit dem es sich verbinden kann. Es macht einen schlafenden Mac nicht erreichbar, repariert keine abgebrochene Verbindung und beantwortet keine Bestätigungsanfragen für dich.

Was Clamshell kann und was nicht

Die Aktivierung mit gedrückter Wahltaste beim Zuklappen braucht den Deckelwinkelsensor eines MacBook Air M2 (2022) oder neuer oder eines MacBook Pro mit 14 oder 16 Zoll (2021) oder neuer; andere Laptops mit Apple Silicon werden über die Menüleiste aktiviert. Wahltaste + Deckel schließen und die Aktivierung über das Menü in der Menüleiste gelten nur für den nächsten Schließvorgang; eine Aktivierung per Rechtsklick oder über Kurzbefehle bleibt bestehen, bis du deaktivierst.

Häufige Fragen

Weitere Anleitungen

• Claude Code 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-Coding-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)
• Warum Codex „Keep this Mac awake“ beim Zuklappen nicht hilft (auf Englisch)

Quellen geprüft am 29. September 2026: das README von openai/codex, die OpenAI-Dokumentation zu Codex Cloud, Remote-Verbindungen und dem nicht interaktiven Modus sowie Apples Hinweise zu einem externen Display bei zugeklapptem Laptop. Das Verhalten von Clamshell ist anhand des App-Quellcodes und der FAQ beschrieben. Für diese Seite wurden keine neuen Hardwaretests durchgeführt. Clamshell ist eine unabhängige App und steht in keiner Verbindung zu OpenAI und wird von OpenAI weder unterstützt noch empfohlen. Codex ist eine Marke ihres Inhabers. Diese Seite ist die deutsche Übersetzung der englischen Anleitung.