Pitch: por que o Claude Code e o Codex param quando você fecha o MacBook (e o que o macOS oferece)
Fala, pessoal. Já aviso logo: isto é um Pitch. Esta conta é do Keep Mac Awake, um app de barra de menus para macOS que mantém o MacBook acordado com a tampa fechada, e quem escreve é a equipe que desenvolve o app. Mesmo assim, a maior parte do texto é sobre o próprio macOS: por que o agente que você deixou rodando é interrompido quando a tampa fecha, o que o sistema já oferece e em que condições cada opção funciona. O app aparece na lista de opções e na última seção.
O problema
Você pede ao Claude Code ou ao Codex uma tarefa longa, fecha o MacBook e vai fazer outra coisa. Quando abre de novo, o agente parou no meio da tarefa. O Claude Code avisa com Your computer went to sleep mid-response ou Connection lost while your computer was asleep (referência de erros da Anthropic).
Não é bug do agente. Ele é um processo no seu Mac, e um Mac em repouso não executa nada: nem o agente, nem o build, nem o download que você deixou rodando.
Repouso por inatividade e repouso pela tampa são coisas diferentes
O macOS entra em repouso por dois caminhos:
- Por inatividade: depois de um tempo sem uso, conforme os ajustes de Bateria ou de Energia.
- Forçado: o Technical Q&A QA1340 da Apple diz que fechar a tampa de um notebook e escolher Repouso no menu Apple causam o repouso forçado (QA1340).
A maioria das ferramentas que "mantêm o Mac acordado" cria uma power assertion do tipo PreventUserIdleSystemSleep, que só bloqueia o primeiro caminho. A documentação da Apple para essa assertion avisa que o sistema "may still sleep for lid close" (documentação da Apple). Isso vale também para as opções dos próprios agentes. Sobre o "Keep computer awake" do app desktop do Claude, a Anthropic escreve: "Closing the laptop lid still puts it to sleep" (documentação do Claude Code). Já o features.prevent_idle_sleep do Codex CLI usa essa mesma assertion (openai/codex#11711).
caffeinate: o que cada opção faz com a tampa fechada
| Comando | Assertion | Com a tampa fechada |
|---|---|---|
caffeinate ou caffeinate -i | PreventUserIdleSystemSleep | O Mac entra em repouso |
caffeinate -s | PreventSystemSleep | Na tomada, continua rodando em dark wake (tela desligada) enquanto o caffeinate estiver ativo; na bateria, entra em repouso |
A man page do caffeinate diz que a assertion do -s "is valid only when system is running on AC power" (caffeinate.8), e a Apple documenta que essa assertion "allows the system to reside in Dark Wake for an arbitrary length of time" (documentação da Apple). Ou seja, com o carregador conectado, caffeinate -s mantém o MacBook acordado com a tampa fechada. Mas tem dois limites: só vale enquanto o processo do caffeinate estiver rodando, e o Mac entra em repouso assim que sai da tomada.
Para saber o que aconteceu durante a noite, dá para olhar o log de energia:
pmset -g log | grep "Clamshell Sleep"
Entering DarkWake state due to 'Clamshell Sleep' quer dizer que o repouso foi bloqueado e o Mac continuou rodando com a tela desligada (PMConnection.m). Entering Sleep state due to 'Clamshell Sleep' quer dizer que ele dormiu. Cuidado com DarkWake from Deep Idle: é um despertar de manutenção a partir de um repouso de verdade, não prova de que o Mac ficou acordado.
SleepDisabled: o ajuste que vale para tudo
Existe um ajuste global, SleepDisabled, que impede o repouso por qualquer motivo, inclusive pela tampa, tanto na tomada quanto na bateria. Ele não aparece na man pmset, mas está no código-fonte do pmset:
sudo pmset disablesleep 1
# confira: deve mostrar SleepDisabled 1
pmset -g | grep SleepDisabled
# para voltar ao repouso normal
sudo pmset disablesleep 0
O detalhe é que isso é uma chave, não uma sessão. Não tem temporizador e continua ativo depois de reiniciar (PMSettings.m). Basta esquecer uma vez para o MacBook passar a noite acordado dentro da mochila.
Modo de tela fechada (clamshell)
Com monitor externo, teclado, mouse e energia conectados, a Apple dá suporte oficial ao uso com a tampa fechada (Suporte da Apple). Só que o kernel coloca o Mac em repouso quando o monitor externo é desconectado com a tampa fechada (IOPMrootDomain.cpp). Um cabo solto já derruba o modo, e sem monitor ele nem existe.
Resumindo as opções (novembro de 2026)
- Keep Mac Awake (nosso app): uma sessão com tempo definido, sem monitor, na tomada ou na bateria (nível mínimo de 20% por padrão), e o repouso normal volta no fim.
caffeinate -s: só na tomada e só enquanto o caffeinate roda, em dark wake.sudo pmset disablesleep 1: na tomada e na bateria, sem temporizador; você precisa lembrar de desfazer.- Modo de tela fechada: com monitor, teclado, mouse e energia.
caffeinate -i e a opção de Bateria que impede o repouso automático não mantêm o Mac acordado com a tampa fechada.
De qualquer forma, um Mac fechado continua esquentando, então deixe o Mac numa superfície dura e ventilada, nunca dentro da mochila ou embaixo de um travesseiro.
O Pitch: Keep Mac Awake
O SleepDisabled é o ajuste que funciona com a tampa fechada sem monitor. O problema dele é o esquecimento. O Keep Mac Awake ativa esse ajuste só durante uma sessão que você (ou o seu agente) inicia, e depois restaura o ajuste anterior. Algumas decisões que tomamos:
- Sessão com prazo. Sem limite, 1 hora, 8 horas ou quantas horas você quiser, até 168 (durante o teste grátis, as sessões vão até 8 horas). Uma sessão nunca começa sozinha, e uma sessão com tempo definido termina na hora marcada e o repouso normal volta.
- Um watchdog separado. Se o serviço em segundo plano do app ou o serviço do sistema parar ou travar, um serviço supervisor independente restaura o repouso normal. Fechar o app também restaura.
- Na tomada ou na bateria. Quando uma sessão começa em um MacBook na bateria, Run on battery se ativa sozinho, com nível mínimo de 20%, a menos que você já o tenha definido; com a opção desativada, uma sessão sem tomada espera a energia voltar. Na bateria, a sessão termina no nível escolhido e também termina se o Mac chegar ao estado térmico
seriousdo macOS. Na tomada, o calor fica por conta do macOS. - Nenhuma power assertion. Durante uma sessão,
pmset -g assertionsnão mostra nenhuma linha do Keep Mac Awake, epmset -gmostraSleepDisabled 1. Quem muda esse ajuste é um pequeno serviço do sistema; por isso o instalador pede a senha de administrador uma vez. - Silêncio à noite (opcional). Uma chave desligada por padrão, "Mute sound when lid closes": com ela ligada, fechar a tampa durante uma sessão silencia o Mac, e o som volta quando você abre a tampa. Assim o aviso de um agente que termina de madrugada não acorda ninguém.
- Feito para agentes.
keepmacawake start --hours 8 --json,keepmacawake status --jsonekeepmacawake stop --jsondevolvem um objeto JSON por chamada, com códigos de saída documentados (o 4, por exemplo, indica que precisa de uma ação do usuário: ligar na tomada ou fazer uma compra).
O que ele não faz: não mantém o Wi-Fi nem outras conexões de rede ativas e não acorda um Mac que já entrou em repouso. Funciona em qualquer Mac com Apple Silicon e macOS 26 ou posterior. Tem teste grátis: keepmacawake.com.
Se quiser ir mais fundo, escrevemos um guia em português com uma tabela comparando os métodos: como deixar o MacBook ligado com a tampa fechada.
Fica a pergunta para quem roda agente à noite no MacBook: vocês deixam na tomada com caffeinate -s, usam monitor externo ou mandam tudo para um servidor? Críticas ao app e ao texto são bem-vindas.