Caffeinate Mac : Claude Code travaille capot fermé

Caffeinate Mac, l’outil intégré à macOS, bloque la mise en veille durant son exécution, mais cesse de fonctionner dès que vous rabattez l’écran en mode batterie. Claude Code devait achever cette nuit une longue tâche pour votre client, mais elle s’interrompt en plein milieu et, le matin venu, vous tombez sur un projet resté à moitié terminé. Un réglage système garde le Mac éveillé capot fermé, et un outil gratuit l’applique pour une durée choisie.

0:40

Pourquoi le Mac s’endort quand vous fermez le capot

macOS distingue trois veilles : celle de l’écran, celle du disque et celle du système. Seule la dernière arrête Claude Code, parce qu’elle suspend tous les processus, terminal compris.

Fermer le capot déclenche la veille du système, quoi que fasse une application. Sur batterie, macOS l’impose pour une raison de sécurité : un portable fermé dans un sac ne doit pas chauffer. Branché sur secteur avec un écran externe, le Mac peut rester éveillé (le mode « clamshell »), mais ce n’est pas le cas d’un MacBook seul posé sur un bureau la nuit.

Claude Code et Codex tournent dans votre session. Le Mac dort, l’agent s’arrête, et il ne reprend pas tout seul au réveil s’il attendait une réponse réseau.

Ce que fait caffeinate, et où il s’arrête

caffeinate est livré avec macOS. Il pose une « assertion » qui retient la veille tant que la commande tourne :

caffeinate -i claude          # pas de veille d'inactivité tant que Claude Code tourne
caffeinate -i -t 28800        # 8 heures, puis la veille normale reprend
caffeinate -d                 # garde aussi l'écran allumé

Les options utiles :

caffeinate protège donc contre l’inactivité. Le capot, lui, gagne toujours, et pour un agent qui doit tourner la nuit, c’est justement le cas qui compte.

Le réglage qui tient capot fermé : pmset

Le levier qui retient vraiment la veille, capot fermé, est un réglage système :

sudo pmset -a disablesleep 1   # plus de veille, même capot fermé
sudo pmset -a disablesleep 0   # retour à la normale

Il demande le mot de passe administrateur, et il reste actif jusqu’à ce que vous le remettiez à 0. C’est là que le bricolage devient risqué : oublier le retour à 0, c’est un Mac qui ne dort plus jamais, y compris dans un sac. Il faut aussi éteindre l’écran, couper le son et les notifications à la main, puis tout rétablir le matin.

Insomnia : une durée, puis le capot

Insomnia est une petite app gratuite et open source (licence MIT) qui fait tout cela avec une fin programmée. Son œil se loge dans la barre des menus, sans icône dans le Dock.

1. Vous cliquez sur l’œil, vous entrez une durée (jours, heures, minutes), vous validez.
2. Vous lancez la tâche dans Claude Code.
3. Vous fermez le capot.

Pendant la session, Insomnia éteint l’écran et le rétroéclairage du clavier, coupe le son, met Slack, WhatsApp et Discord en pause, et passe le Mac en économie d’énergie. Si le Wi-Fi tombe, il peut basculer sur le partage de connexion de votre iPhone. À la fin de la durée, il défait tout, et il tient un journal de chaque changement pour pouvoir l’annuler après un plantage.

L’installation tient en un message d’une ligne, collé dans Claude Code, qui suit le guide officiel du dépôt. Une étape demande votre mot de passe : Claude Code vous donne alors la commande à lancer vous-même dans le Terminal.

Les précautions avant une nuit capot fermé

Insomnia se dit lui-même expérimental, et j’attendrais d’avoir fait un essai d’une heure, Mac sous les yeux, avant de lui confier une nuit. Avant la première :

• Il faut macOS 26 ou plus récent, sur une puce Apple Silicon. Un Mac Intel n’est pas pris en charge.
• L’installation autorise quatre commandes pmset sans mot de passe, pour votre compte. Lisez la page d’installation du dépôt avant d’installer.
• Sur batterie, par défaut, l’économie d’énergie s’active sous 40 % et la session s’arrête sous 10 %. Pour une nuit entière, branchez le chargeur.
• Posez le Mac sur une surface stable et ventilée, jamais dans un sac fermé. Les règles de chaleur d’Insomnia coupent la session en cas de surchauffe critique, mais un minuteur n’est pas une garantie.
• Capot fermé, le micro intégré se coupe. Un appel vocal pendant la session passe par des AirPods ou un micro externe.

Le matin, si vous voulez savoir sans ouvrir le Mac que la tâche est finie, un hook de fin de tâche peut vous envoyer une notification : voyez les hooks de Claude Code. Et si la session s’arrête plus tôt que prévu, c’est peut-être la limite d’usage de Claude, pas la veille.