Anleitung · Agent-Läufe über Nacht

KI-Agenten über Nacht auf dem Mac laufen lassen

Du startest ein langes Claude-Code-Refactoring oder einen Codex-Batch, schaust auf die Uhr und gehst — vielleicht ins Bett, vielleicht in ein Meeting. Der Plan ist simpel: Der Agent arbeitet sich durch, während du weg bist, und morgens liest du die Ergebnisse. Und dann kommst du zu einem schlafenden Mac zurück und einem Lauf, der vor Stunden hängengeblieben ist. Diese Anleitung erklärt, warum der Ruhezustand von macOS nächtliche Agent-Läufe abwürgt, welche Energie- und Session-Einstellungen einen Lauf am Leben halten und wie Perked das Ganze automatisiert — nur wach, solange deine Agenten arbeiten, und den Mac wieder in den Ruhezustand lässt, sobald sie fertig sind.

Warum der Ruhezustand von macOS einen nächtlichen Lauf abwürgt

macOS kennt zwei verschiedene Arten von Ruhezustand, und nur eine davon ist harmlos. Der Display-Ruhezustand schaltet einfach nur den Bildschirm aus — dein Agent läuft hinter einem schwarzen Display weiter, und genau das willst du über Nacht. Der System-Ruhezustand (Leerlauf) ist das Problem: Nach einer Weile ohne Tastatur-, Trackpad- oder Mausaktivität legt macOS die ganze Maschine schlafen. Die CPU parkt, Hintergrundprozesse frieren ein, Netzwerkverbindungen brechen ab. Ein Coding-Agent zählt als keine dieser Aktivitäten, sodass ein unbeaufsichtigter Mac aus Sicht des Systems untätig wirkt — selbst wenn ein Agent gerade die CPU auslastet — und mitten im Lauf schlafen gelegt wird.

Verbreitet ist die Annahme, ein Mac am Netz bleibe von selbst wach. Tut er nicht. Der Leerlauf-Ruhezustand hat einen Timer, der auch im Netzbetrieb auslöst — die Standardzeit ist nur länger als im Akkubetrieb. Das Notebook, das du geladen auf dem Schreibtisch liegen lässt, klinkt sich also ein, zwei Stunden nach Beginn des Auftrags trotzdem aus, und die Session des Agenten stirbt mit ihm. Einen nächtlichen Lauf durchzubekommen heißt, gezielt den Leerlauf-Ruhezustand zu überwinden — ohne den Mac danach für immer wach zu lassen.

Die Energieeinstellungen, auf die es ankommt

macOS legt sein Ruhezustand-Verhalten über das eingebaute Tool `pmset` offen. Es lohnt sich zu wissen, was die relevanten Schlüssel tun — und wo das Steuern von Hand an seine Grenzen stößt:

• pmset -g gibt deine aktuellen Energieeinstellungen aus. Achte auf `sleep` (Minuten Leerlauf, bevor das System in den Ruhezustand geht — `0` bedeutet nie) gegenüber `displaysleep` (Minuten, bevor allein der Bildschirm ausgeht). Den Display-Ruhezustand abzuschalten hindert das System kein bisschen am Schlafen; das sind getrennte Timer.
• sudo pmset -c disablesleep 1 ist das grobe Werkzeug: Es verhindert im Netzbetrieb den Leerlauf-Ruhezustand komplett. Es braucht ein Admin-Passwort, es ist global und leicht zu vergessen, dass du es aktiviert hast, und es hält die Maschine wach, egal ob gerade gearbeitet wird — so kann es klammheimlich einen Akku leeren oder ein geschlossenes Notebook überhitzen, bis du daran denkst, es wieder auf `0` zu setzen.
• Netzbetrieb vs. Akku. pmset führt getrennte Profile: `-c` setzt das Netzbetrieb-Profil, `-b` das Akku-Profil und `-a` beide zugleich. Im Akkubetrieb geht macOS viel aggressiver in den Ruhezustand, für einen nächtlichen Lauf willst du den Mac also in der Regel am Netz — aber selbst im Netzbetrieb greift der Leerlauf-Timer weiter, solange du ihn nicht änderst.

Der Haken an alledem: Es ist ein manueller, globaler Alles-oder-nichts-Schalter, den du vor dem Lauf umlegen und danach wieder zurückstellen musst — und wenn du es vergisst, geht der Mac nie wieder von selbst in den Ruhezustand.

Die Session am Leben halten: tmux und abgekoppelte Läufe

Wachbleiben ist nur die halbe Miete. Startest du einen Agenten in einem Terminal über SSH oder in einem Fenster, das du später schließt, kann der Lauf sterben, wenn diese Verbindung oder Session verschwindet — selbst auf einem Mac, der nie geschlafen hat. Die Lösung ist eine dauerhafte Session. Starte den Agenten in tmux (oder screen), koppel dich ab, und der Prozess läuft unter der Session weiter; du kannst dich später von überall wieder anhängen und genau dort weitermachen, wo du aufgehört hast. Den Befehl mit `nohup` oder als Hintergrundjob zu starten erfüllt für einmalige Skripte einen ähnlichen Zweck.

Aber Session-Persistenz und Ruhezustand sind zwei getrennte Dinge, und man wirft sie leicht in einen Topf. tmux hält deinen Prozess an einer lebendigen Session; es tut nichts, um macOS davon abzuhalten, die Maschine darunter in den Leerlauf-Ruhezustand zu schicken. Eine abgekoppelte tmux-Session auf einem schlafenden Mac ist trotzdem eingefroren — der Prozess bleibt erhalten, macht aber keine Fortschritte. Du brauchst beides: eine dauerhafte Session, damit der Lauf Verbindungsabbrüche übersteht, und ein Wachhalten, damit der Mac die Session durch die Nacht weiterlaufen lässt.

Wissen, wann er fertig ist: Benachrichtigungen

Ein nächtlicher Lauf ist nützlicher, wenn er dir sagen kann, dass er fertig ist — oder dass er gestoppt hat und dich braucht. Ein paar leichtgewichtige Wege, ein Signal zu bekommen, ohne das Terminal zu bewachen:

• osascript -e 'display notification "Run finished" with title "Agent"' löst am Ende deines Befehls eine native macOS-Benachrichtigung aus, sodass ein Banner wartet, wenn du zurückkommst. Häng es mit `&&` hinter den Agenten, damit es nur bei Erfolg meldet.
• say "the run is done" spricht einen Hinweis laut aus — praktisch, wenn du im selben Raum, aber weg vom Bildschirm bist. Ein schlichter Terminal-Piepton (`printf '\a'`) tut es auch, wenn dein Terminal so eingestellt ist, dass er ihn anzeigt.
• Ein Push aufs Handy. Ein einzeiliger curl an einen Dienst wie ntfy oder Pushover, an den Befehl angehängt, schickt eine Benachrichtigung aufs Handy — nützlich, wenn du wirklich aus dem Haus bist. Etliche Agenten bieten auch eigene Hooks, die einen Befehl ausführen können, wenn eine Aufgabe abgeschlossen ist.

Lock & Leave: weggehen, ohne einzuschlafen

Einen Mac über Nacht wach und entsperrt auf dem Schreibtisch zu lassen, ist nicht ideal. macOS lässt dich den Bildschirm mit ⌃⌘Q sperren, aber der sicherheitsbewusste Schritt ist, in einem Rutsch zu sperren und den Lauf weiterlaufen zu lassen. Genau das macht Perkeds „Lock & Leave“ (Bildschirm sperren, wach bleiben): Drück ⌥⌘A, um den Bildschirm zu sperren, während die Session wach bleibt und die Agenten weiterarbeiten. Das Display wird dunkel und die Maschine ist gesichert, aber der Lauf darunter pausiert nie — du kannst gefahrlos weggehen und zu fertiger Arbeit zurückkommen.

Wo Perked ins Spiel kommt

Perked ist eine macOS-Menüleisten-App, die all das automatisiert, damit du dir nichts davon merken musst. Sie erkennt 22 Coding-Agenten von Haus aus — Claude Code, Codex, Cursor, Gemini CLI, Aider und mehr — plus jede eigene App, die du hinzufügst, und hält den Mac nur wach, solange einer von ihnen tatsächlich läuft. Starte den Lauf und geh; Perked übernimmt das Wachbleiben für dich, ohne `pmset` und ohne ein Flag, das du zurücksetzen musst.

Weil es an das gekoppelt ist, was die Agenten tun, löst es auch die andere Hälfte des Problems: Wenn der letzte Agent fertig ist, lässt Perked den Mac von selbst wieder in den Ruhezustand — so wird aus einem nächtlichen Lauf kein Mac, der den ganzen Tag wach bleibt. Es ist energiebewusst — setz Netzbetrieb oder einen von dir gewählten Akkustand voraus —, es funktioniert bei geschlossenem Deckel, und es spielt mit „Lock & Leave“ zusammen, damit du den Bildschirm sichern kannst, ohne den Lauf zu stoppen.

Es ist ein Einmalkauf ab 1 € — aktuell 1 €, und was du zahlst, ist für immer gesichert.

FAQ zu nächtlichen Agent-Läufen

← Zurück zu Perked