1

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

ComandoAssertionCom a tampa fechada
caffeinate ou caffeinate -iPreventUserIdleSystemSleepO Mac entra em repouso
caffeinate -sPreventSystemSleepNa 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)

  1. 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.
  2. caffeinate -s: só na tomada e só enquanto o caffeinate roda, em dark wake.
  3. sudo pmset disablesleep 1: na tomada e na bateria, sem temporizador; você precisa lembrar de desfazer.
  4. 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 serious do macOS. Na tomada, o calor fica por conta do macOS.
  • Nenhuma power assertion. Durante uma sessão, pmset -g assertions não mostra nenhuma linha do Keep Mac Awake, e pmset -g mostra SleepDisabled 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 --json e keepmacawake stop --json devolvem 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.

Carregando publicação patrocinada...