Claude Code si ferma quando il Mac va in stop

Cosa succede davvero durante lo stop

Quando un Mac va in stop, la CPU smette di eseguire i tuoi processi. L’agente non viene ucciso. Viene congelato. Quando la macchina si risveglia, il processo riprende. Ma a quel punto la connessione API che usava è scaduta. La chiamata allo strumento che stava facendo è fallita. Su un portatile, il coperchio chiuso porta allo stop in pochi secondi, a meno che qualcosa lo impedisca. Il blocco schermo non causa lo stop. Nemmeno il salvaschermo. Solo il timer di stop e il coperchio lo fanno.

Soluzione 1: caffeinate per un singolo task

macOS include uno strumento che tiene sveglia la macchina mentre gira un comando. Avvia l’agente tramite questo strumento e il Mac resta acceso finché l’agente non termina.

caffeinate -i claude

Il flag impedisce al sistema di andare in stop per inattività. Aggiungi un secondo flag per tenere acceso anche lo schermo. Serve solo per gli strumenti che pilotano lo schermo.

caffeinate -di claude

Questo non resiste alla chiusura del coperchio. L’interruttore del coperchio prevale su ogni richiesta di restare attivi. Inoltre non fa nulla dopo che l’agente termina e avvii il task successivo senza caffeinate.

Soluzione 2: disattiva lo stop per tutta la macchina

Su un Mac desktop, o su un portatile collegato alla corrente, imposta il timer di stop su mai e lascialo così. Sono le impostazioni che usiamo su ogni Mac per agenti.

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

Lo schermo può comunque spegnersi. Così risparmi energia, e per un processo nel terminale non cambia nulla. L’ultima riga attiva il risveglio via rete. Aiuta se qualcosa mette comunque in stop la macchina.

Soluzione 3: il coperchio chiuso

Un MacBook con il coperchio chiuso va in stop, a meno che sia collegato alla corrente e a uno schermo, una tastiera o un mouse esterni. È la regola clamshell di Apple. Senza schermo, un’altra impostazione costringe la macchina a restare sveglia a coperchio chiuso.

sudo pmset -a disablesleep 1

Per annullarla usa lo stesso comando con uno zero. Due avvertenze. In uno zaino o sul letto il portatile si scalda, quindi lascialo su una superficie rigida. E se si stacca il cavo, scarica la batteria in poche ore e poi si spegne senza uno shutdown pulito.

Soluzione 4: il terminale, non la macchina

A volte il Mac è rimasto sveglio e la sessione è sparita lo stesso. In quel caso si è chiusa la finestra del terminale o è caduta la connessione SSH. Entrambe le cose inviano un segnale di hangup a tutto ciò che gira dentro. La risposta è un multiplexer di terminale. Esegui l’agente in una sessione tmux. Sopravvive alla finestra chiusa, alla caduta di SSH e ai singhiozzi del Wi-Fi.

brew install tmux
tmux new -s agent
claude

Per staccarti premi Ctrl-b e poi d. Più tardi ti riattacchi con un solo comando, da qualsiasi terminale o dal telefono via SSH.

tmux attach -t agent

C’è una guida completa a questo setup: tenere viva una sessione di Claude Code con tmux.

Soluzione 5: ripartire dopo un riavvio

Gli aggiornamenti di sicurezza riavviano la macchina. Anche i cali di corrente. Dopo un riavvio non gira nulla finché qualcuno non fa il login. Su una macchina che deve funzionare da sola, attiva il login automatico per l’utente dell’agente nelle Impostazioni di Sistema. Poi aggiungi un LaunchAgent che ricrea la sessione tmux al login. La checklist per un Mac sempre acceso ha l’elenco completo, compreso il gruppo di continuità.

Quando il portatile è la macchina sbagliata

Tutto quello che c’è sopra funziona. Però trasforma il tuo portatile in un server che non puoi portare da nessuna parte. Quando l’agente inizia a fare lavoro vero di notte, quasi tutti lo spostano su una macchina che ha un solo compito: restare accesa. Le scelte sono quattro. Un Mac mini di scorta a casa. Una macchina Linux, se non ti serve Xcode. Un Mac in un cloud. Oppure un Mac mini in hosting che qualcun altro tiene sveglio. Il confronto dei posti dove far girare un agente 24/7 mette i costi uno accanto all’altro.