Terminal-Leitfaden

caffeinate-Befehl: den Mac per Terminal wach halten

macOS bringt ein kleines Kommandozeilen-Tool namens caffeinate mit, das deinen Mac davon abhält, in den Ruhezustand zu gehen, während etwas Wichtiges läuft — ein Build, ein Download oder eine lange KI-Coding-Session. Es ist eingebaut, du musst also nichts installieren: Öffne das Terminal, und es ist schon da unter /usr/bin/caffeinate. Dieser Leitfaden zeigt, was jede Flag macht, kopierbare Beispiele, die du direkt ins Terminal einfügen kannst, und die Grenzen, die du kennen solltest, bevor du dich darauf verlässt.

Perked kaufen für 1 €So funktioniert’s

Was caffeinate ist

Der Befehl caffeinate erstellt eine temporäre Sleep-Assertion — eine Aufforderung an macOS, eine bestimmte Art von Ruhezustand aufzuschieben. Ohne Flags verhindert er den Leerlauf-Ruhezustand und hält diese Assertion, bis du ihn stoppst. Gibst du ihm ein Programm zum Ausführen mit, hält er die Assertion nur, solange dieses Programm läuft, und gibt sie danach automatisch frei. Das macht ihn ideal, um einen einzelnen Befehl zu umschließen, dessen Laufzeit du vorher nicht kennst.

Er braucht keine Administratorrechte, schreibt nichts auf die Festplatte und legt keinen Anmeldeobjekt an. Sobald der Befehl endet, ist die Assertion weg und dein Mac kehrt zu seinem normalen Energieverhalten zurück.

Flag-Referenz

Du kombinierst diese einbuchstabigen Flags, um genau zu beschreiben, welche Art von Ruhezustand blockiert werden soll. Sie lassen sich bündeln, -di ist also dasselbe wie -d -i.

Flag	Was sie bewirkt
`-d`	Verhindert, dass das Display in den Ruhezustand geht (der Bildschirm bleibt an).
`-i`	Verhindert den Leerlauf-Ruhezustand des Systems. Das ist die Voreinstellung, wenn du gar keine Flags angibst.
`-m`	Verhindert den Leerlauf-Ruhezustand der Festplatte.
`-s`	Verhindert den Ruhezustand des Systems vollständig. Diese Assertion ist nur im Netzbetrieb gültig — im Akkubetrieb wird sie ignoriert.
`-u`	Erklärt, dass der Nutzer aktiv ist. Ist das Display aus, wird es wieder eingeschaltet. Ohne -t gilt standardmäßig ein Timeout von 5 Sekunden.
`-t <seconds>`	Legt ein Timeout in Sekunden fest, nach dem die Assertion fallengelassen wird. Das Timeout wird ignoriert, wenn du ein Programm aufrufst.
`-w <pid>`	Wartet, bis der Prozess mit der angegebenen PID endet, und gibt dann die Assertion frei. Wird ignoriert, wenn du zusätzlich ein Programm aufrufst.

Kopierbare Beispiele

Füge eines davon ins Terminal ein. Jedes ist ein vollständiger Befehl.

caffeinate -i bun run build

Führt einen Build aus und hält den Mac genau so lange wach, wie er dauert — die Assertion wird in dem Moment freigegeben, in dem der Build fertig ist.

caffeinate

Ohne Flags und ohne Programm verhindert es den Leerlauf-Ruhezustand, bis du zum Stoppen Control-C drückst.

caffeinate -di -t 3600

Hält Display und System wach und lässt die Assertion dann nach 3600 Sekunden (einer Stunde) automatisch fallen.

caffeinate -w 12345

Hält die Assertion, bis der Prozess mit der PID 12345 endet — praktisch, um einen anderswo gestarteten Job zu überwachen.

caffeinate -s make

Verhindert den vollständigen System-Ruhezustand, während ein langer Job läuft. Denk dran: -s wirkt nur im Netzbetrieb.

Fallstricke und Grenzen

caffeinate ist ein grobes Werkzeug. Ein paar Dinge überraschen viele:

Kein Akku-Bewusstsein. Abgesehen von -s (das nur im Netzbetrieb funktioniert) hält caffeinate deinen Mac bereitwillig auch im Akkubetrieb wach und entleert ihn dabei komplett. Es kennt keinen sicheren Akkustand.
Vergessene Sitzungen. Ein nacktes caffeinate ohne Programm und ohne Timeout läuft, bis du es beendest. Es ist leicht, eins zu starten, wegzugehen und den Mac tagelang wach zu lassen.
Das Terminal muss offen bleiben. Die Assertion lebt mit dem caffeinate-Prozess. Schließ diesen Terminal-Tab oder das Fenster, und die Assertion stirbt mit ihm. Auch das Abmelden beendet sie.
Keine automatische Erkennung. caffeinate kann nicht erkennen, ob dein Agent noch arbeitet oder schon vor zehn Minuten fertig war. Du startest und stoppst es jedes Mal von Hand.
-s nur im Netzbetrieb. Die vollständige System-Ruhezustand-Assertion wird im Akkubetrieb stillschweigend ignoriert, sodass ein darauf angewiesenes Skript ohne Netzteil trotzdem in den Ruhezustand gehen kann.

Wann eine Menüleisten-App `caffeinate` schlägt

caffeinate ist perfekt für einmalige Befehle, deren Ende du siehst. Aber wenn du regelmäßig KI-Coding-Agenten laufen lässt, werden das manuelle Starten/Stoppen und die fehlende Akku-Intelligenz schnell lästig. Genau diese Lücke füllt Perked. Es ist eine native macOS-Menüleisten-App, die die Buchhaltung für dich übernimmt:

Erkennt Agenten automatisch. Es erkennt 29 Coding-Agenten von Haus aus — Claude Code, Cursor und mehr — und hält den Mac nur wach, solange tatsächlich einer läuft.
Energiebewusste Regeln. Bleib nur im Netzbetrieb wach oder oberhalb eines Akkustands, den du festlegst, damit du nie versehentlich den Akku leerst.
Zeitgesteuerte Sitzungen & Lock & Leave. (Bildschirm sperren, wach bleiben) Bleib für eine festgelegte Dauer wach oder sperre den Bildschirm, während die Sitzung weiterläuft.
Geht danach wieder in den Ruhezustand. Keine vergessenen Sitzungen, kein Terminal-Tab zum Babysitten — es gibt den Mac in dem Moment frei, in dem die Arbeit erledigt ist.

Schluss mit dem Terminal-Babysitten

Einmalkauf, für immer deins — 1 € heute, und dein Preis ist für immer gesichert.

Perked kaufen für 1 €

Zur kompletten Preisstaffel →

Häufige Fragen

Ist caffeinate in macOS eingebaut?

Ja. caffeinate liegt bei jedem modernen macOS unter /usr/bin/caffeinate — du musst nichts installieren. Öffne das Terminal und führ es aus.

Hält caffeinate meinen Mac im Akkubetrieb wach?

Die Assertions -i und -d funktionieren im Akkubetrieb, aber caffeinate hat kein Akku-Bewusstsein und entleert ihn. Die System-Ruhezustand-Assertion -s wird ignoriert, außer du bist im Netzbetrieb.

Wie stoppe ich caffeinate?

Drück Control-C im Terminal, in dem es läuft, oder lass es von selbst enden, wenn das Programm fertig ist, die PID endet oder das -t-Timeout abläuft. Auch das Schließen des Terminal-Tabs beendet es.

Kann caffeinate erkennen, wann mein KI-Agent startet und stoppt?

Nein. caffeinate ist komplett manuell — du entscheidest, wann du es startest und stoppst. Eine Menüleisten-App wie Perked achtet auf Coding-Agenten und hält den Mac nur wach, solange sie tatsächlich laufen.

Du fährst lange Agent-Sessions? Sieh dir an, wie du deinen Mac für Claude Code, Cursor & KI-Agenten wach hältst.

← Zurück zu Perked