Panduan

Claude Code berhenti saat Mac Anda tidur

Anda memberi Claude Code tugas panjang, menutup laptop, lalu kembali dan sesinya sudah mati. Agennya tidak bermasalah. macOS menidurkan mesinnya. Saat tidur, semua proses dibekukan, jaringan putus, dan koneksi SSH berakhir. Halaman ini membahas pengaturan yang mencegahnya, sesuai urutan untuk dicoba. Halaman ini juga membahas kapan solusi yang jujur adalah mesin lain.

Apa yang sebenarnya terjadi saat Mac tidur

Saat Mac tidur, CPU berhenti menjalankan proses Anda. Agennya tidak dimatikan. Agennya dibekukan. Saat mesin bangun, proses itu berlanjut. Namun koneksi API yang dipakainya sudah timeout. Tool call yang sedang berjalan sudah gagal. Di laptop, layar yang ditutup berarti tidur dalam hitungan detik, kecuali ada yang mencegahnya. Layar kunci tidak membuat Mac tidur. Screensaver juga tidak. Hanya timer tidur dan penutup laptop yang melakukannya.

Solusi 1: caffeinate untuk satu tugas

macOS punya tool bawaan yang menjaga mesin tetap bangun selama satu perintah berjalan. Jalankan agen lewat tool itu, dan Mac tetap menyala sampai agen selesai.

caffeinate -i claude

Flag ini mencegah sistem tidur karena idle. Tambahkan flag kedua agar layar juga tetap menyala. Ini hanya penting untuk tool yang mengendalikan layar.

caffeinate -di claude

Cara ini tidak bertahan saat laptop ditutup. Sakelar penutup mengalahkan semua pengaturan idle. Cara ini juga tidak berlaku lagi setelah agen selesai dan Anda memulai tugas berikutnya tanpanya.

Solusi 2: matikan mode tidur di mesin

Di Mac desktop, atau laptop yang tersambung ke listrik, atur timer tidur ke never dan biarkan begitu. Ini pengaturan yang kami pakai di setiap Mac untuk agen.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10
sudo pmset -a womp 1

Layar tetap boleh tidur. Itu menghemat listrik dan tidak mengubah apa pun untuk proses terminal. Baris terakhir mengaktifkan wake on network. Ini membantu jika ada sesuatu yang tetap menidurkan mesin.

Solusi 3: laptop yang ditutup

MacBook yang ditutup akan tidur, kecuali tersambung ke listrik dan ke layar, keyboard, atau mouse eksternal. Itu aturan clamshell dari Apple. Tanpa layar eksternal, ada satu pengaturan lagi yang memaksa mesin tetap bangun saat ditutup.

sudo pmset -a disablesleep 1

Batalkan nanti dengan perintah yang sama dan angka nol. Ada dua peringatan. Laptop akan panas di dalam tas atau di atas kasur, jadi letakkan di permukaan keras. Baterai juga akan habis dalam beberapa jam jika kabel listrik tercabut. Lalu laptop mati tanpa shutdown yang bersih.

Solusi 4: masalahnya di terminal, bukan di mesin

Kadang Mac tetap bangun, tetapi sesinya tetap hilang. Penyebabnya jendela terminal tertutup atau koneksi SSH putus. Keduanya mengirim sinyal hangup ke semua proses di dalamnya. Solusinya adalah terminal multiplexer. Jalankan agen di dalam sesi tmux. Sesi itu bertahan saat jendela tertutup, SSH putus, atau Wi-Fi tersendat.

brew install tmux
tmux new -s agent
claude

Lepaskan sesi dengan Ctrl-b lalu d. Sambungkan lagi nanti dari terminal mana pun, atau dari ponsel lewat SSH, dengan satu perintah.

tmux attach -t agent

Ada panduan lengkap untuk setup ini: menjaga sesi Claude Code tetap hidup dengan tmux.

Solusi 5: kembali berjalan setelah reboot

Pembaruan keamanan me-restart mesin. Listrik yang berkedip juga. Setelah restart, tidak ada yang berjalan sampai seseorang login. Untuk mesin yang dibiarkan tanpa pengawasan, aktifkan login otomatis untuk user agen di System Settings. Lalu tambahkan LaunchAgent yang membuat ulang sesi tmux saat login. Checklist Mac yang selalu menyala memuat daftar lengkapnya, termasuk baterai cadangan.

Kapan laptop bukan mesin yang tepat

Semua cara di atas berhasil. Tetapi laptop Anda jadi server yang tidak bisa dibawa ke mana-mana. Begitu agen mengerjakan pekerjaan sungguhan semalaman, kebanyakan orang memindahkannya ke mesin yang tugasnya hanya tetap menyala. Ada empat pilihan. Mac mini cadangan di rumah. Mesin Linux, jika Anda tidak butuh Xcode. Mac di cloud. Atau Mac mini hosted yang dijaga tetap bangun oleh pihak lain. Perbandingan tempat menjalankan agen 24/7 memuat biayanya secara berdampingan.

Pertanyaan yang sering diajukan

Apakah caffeinate menjaga Claude Code tetap berjalan saat laptop ditutup?

+

Tidak. Di MacBook, sakelar penutup mengalahkan caffeinate. Mesin harus tersambung ke listrik dengan layar eksternal terpasang, atau memakai pengaturan daya disablesleep.

Apakah layar kunci atau screensaver menghentikan agen?

+

Tidak. Mengunci layar dan menjalankan screensaver tidak membuat mesin tidur. Hanya timer tidur, baterai lemah, atau laptop yang ditutup yang melakukannya. Layar terkunci aman untuk agen terminal.

Apakah ini juga berlaku untuk Codex?

+

Ya. Codex CLI adalah proses terminal seperti Claude Code. Pengaturan tidur, caffeinate, dan tmux yang sama berlaku, begitu juga aturan penutup laptop.

Bisakah saya menjaga Mac tetap bangun dari ponsel?

+

Anda bisa memulai tugas dari ponsel dengan Remote Control milik Claude Code atau lewat SSH. Tetapi Anda tidak bisa mencegah Mac tidur dari jauh setelah Mac memutuskan untuk tidur. Atur pengaturan daya sekali saja di mesin itu sendiri.

Panduan terkait