Uruchamiasz długą sesję w Claude Code, odchodzisz od komputera i po godzinie odkrywasz, że Mac przeszedł w stan uśpienia i proces został zatrzymany? To częsty problem podczas generowania kodu, analizowania projektu czy wykonywania długich komend w terminalu.
Na szczęście macOS oferuje proste rozwiązanie. Jest nim caffeinate – niewielkie narzędzie dostępne w systemie, które pozwala tymczasowo zablokować usypianie komputera bez zmiany ustawień zasilania.
W tym artykule pokażę, jak działa caffeinate, które opcje warto znać oraz jak wykorzystać je podczas pracy z Claude Code.
Czym jest caffeinate?
caffeinate to narzędzie wbudowane w macOS, które tworzy tymczasowe blokady uśpienia systemu (Power Management Assertions). Zamiast na stałe zmieniać ustawienia zasilania, informuje system, że aktualnie wykonywane zadanie nie powinno zostać przerwane przez automatyczne usypianie komputera.
Po zakończeniu działania caffeinate wszystkie blokady są automatycznie usuwane, a macOS wraca do standardowych ustawień oszczędzania energii.
Dzięki temu nie trzeba pamiętać o ponownym włączaniu lub wyłączaniu opcji w Ustawieniach systemowych.
Dlaczego warto używać caffeinate z Claude Code?
Claude Code często wykonuje zadania trwające kilkanaście minut, a czasem nawet kilka godzin. Dotyczy to między innymi:
- refaktoryzacji dużych projektów,
- generowania kodu,
- analizowania repozytorium,
- uruchamiania testów,
- kompilacji aplikacji,
- pracy z agentami AI wykonującymi wiele kroków.
Tryb automode robi robotę :).
Jeżeli komputer przejdzie w stan uśpienia, proces może zostać zatrzymany lub utracić połączenie z usługami sieciowymi.
Najprostszym rozwiązaniem jest uruchomienie Claude Code przez caffeinate.
caffeinate -i claude
Od tej chwili Mac nie będzie przechodził w stan uśpienia z powodu bezczynności. Gdy zakończysz pracę w Claude Code, caffeinate również zakończy działanie i system wróci do normalnego trybu pracy.
To znacznie wygodniejsze niż ręczne zmienianie ustawień zasilania przed każdą dłuższą sesją.
Dzięki temu można zlecić dłuższą robotę i wyjść do kuchni na kawę czy do sklepu na szybkie zakupy. Robota będzie się robiła „sama”.
Najważniejsze flagi caffeinate
Większość użytkowników korzysta z zaledwie kilku opcji.
-i — zapobiega uśpieniu komputera
To najczęściej używana flaga.
caffeinate -i claude
Komputer pozostanie aktywny, nawet jeśli przez dłuższy czas nie będziesz używać klawiatury ani myszy.
Ekran może jednak zostać wygaszony zgodnie z ustawieniami systemu.
-d — nie wygaszaj ekranu
Jeżeli chcesz obserwować, co dzieje się w terminalu, dodaj flagę -d.
caffeinate -di claude
Mac pozostanie aktywny, a ekran nie zostanie wygaszony.
To dobre rozwiązanie podczas:
- monitorowania logów,
- obserwowania postępu pracy agenta,
- prezentacji,
- debugowania aplikacji.
-t — określ czas działania
Nie zawsze chcesz uruchamiać konkretny program przez caffeinate.
Możesz po prostu określić czas działania.
caffeinate -i -t 7200
Komputer pozostanie aktywny przez dwie godziny, a następnie caffeinate zakończy działanie automatycznie.
Praktyczne przykłady
Claude Code
Najbardziej praktyczny przykład.
caffeinate -i claude
Nie musisz martwić się, że Mac przejdzie w stan uśpienia podczas długiej sesji z agentem AI.
Budowanie projektu
caffeinate -i npm run build
Komputer pozostanie aktywny aż do zakończenia kompilacji.
Uruchamianie testów
caffeinate -i npm test
Przydatne przy długich zestawach testów integracyjnych. Trochę na siłę, ale pokazuję, że można inne komendy uruchamiać.
Startowanie serwera php
caffeinate -i rsync -av ~/Projects /Volumes/Backup
Backup nie zostanie przerwany przez automatyczne uśpienie komputera.
Jak sprawdzić, czy caffeinate działa?
macOS udostępnia narzędzie pokazujące aktywne blokady uśpienia.
pmset -g assertions
Jeżeli caffeinate działa poprawnie, zobaczysz wpis podobny do:
pmset -g assertions 2026-07-06 18:48:23 +0200 Assertion status system-wide: BackgroundTask 0 ApplePushServiceTask 0 UserIsActive 1 PreventUserIdleDisplaySleep 1 SoftwareUpdateTask 0 PreventSystemSleep 0 ExternalMedia 0 PreventUserIdleSystemSleep 1 NetworkClientActive 0 Listed by owning process: pid 10150(caffeinate): [0x0004db950001a0cd] 00:03:17 PreventUserIdleSystemSleep named: "caffeinate command-line tool" Details: caffeinate asserting for 300 secs Localized=THE CAFFEINATE TOOL IS PREVENTING SLEEP. Timeout will fire in 102 secs Action=TimeoutActionRelease pid 2992(caffeinate): [0x0004d3ed00019f3e] 00:35:57 PreventUserIdleSystemSleep named: "caffeinate command-line tool" Details: caffeinate asserting forever Localized=THE CAFFEINATE TOOL IS PREVENTING SLEEP. pid 2992(caffeinate): [0x0004d3ed00059f3f] 00:35:57 PreventUserIdleDisplaySleep named: "caffeinate command-line tool" Details: caffeinate asserting forever Localized=THE CAFFEINATE TOOL IS PREVENTING SLEEP. pid 1211(sharingd): [0x0004dc240001a0e0] 00:00:54 PreventUserIdleSystemSleep named: "Handoff" pid 83(powerd): [0x0004cf1600019e16] 00:56:36 PreventUserIdleSystemSleep named: "Powerd - Prevent sleep while display is on" pid 141(WindowServer): [0x0004d92d00099fff] 00:00:00 UserIsActive named: "com.apple.iohideventsystem.queue.tickle serviceID:100000fb9 service:AppleHIDKeyboardEventDriverV2 product:Apple Internal Keyboard / Trackpad eventType:3" Timeout will fire in 120 secs Action=TimeoutActionRelease No kernel assertions.
To oznacza, że system nie uśpi komputera z powodu bezczynności.
O czym warto pamiętać?
caffeinate nie zmienia ustawień systemowych. Działa wyłącznie przez czas działania procesu.
Po zakończeniu Claude Code lub innego programu wszystko wraca do normalnego stanu.
Warto również pamiętać, że caffeinate nie zapobiega uśpieniu po zamknięciu pokrywy MacBooka. Jeżeli zamkniesz laptop, system nadal przejdzie w stan uśpienia zgodnie z normalnym zachowaniem macOS.
Podsumowanie
Jeżeli regularnie korzystasz z Claude Code, caffeinate powinien znaleźć się wśród podstawowych narzędzi terminalowych.
Jedna komenda wystarczy, aby uniknąć przypadkowego uśpienia komputera podczas wielogodzinnej pracy agenta AI:
caffeinate -i claude
To rozwiązanie jest proste, bezpieczne i nie wymaga modyfikowania ustawień zasilania w macOS. Po zakończeniu pracy wszystko wraca do domyślnej konfiguracji systemu.
Jeżeli często uruchamiasz długie procesy z poziomu terminala, warto stosować caffeinate nie tylko z Claude Code, ale również podczas kompilacji projektów, wykonywania testów czy tworzenia kopii zapasowych. Dzięki temu masz pewność, że macOS nie przerwie pracy w najmniej odpowiednim momencie.
