Claude Code para quando o seu Mac entra em repouso
Você deu uma tarefa longa ao Claude Code, fechou a tampa e voltou para uma sessão morta. O agente não tem nenhum problema. O macOS colocou a máquina em repouso. O repouso suspende todos os processos, derruba a rede e encerra qualquer conexão SSH. Esta página mostra os ajustes que evitam isso, na ordem em que vale testar. Ela também mostra o ponto em que a solução honesta é usar outra máquina.
O que acontece de verdade no repouso
Quando um Mac entra em repouso, a CPU para de executar seus processos. O agente não é encerrado. Ele fica congelado. Quando a máquina acorda, o processo continua. Mas aí a conexão com a API que ele usava já expirou. A chamada de ferramenta que estava no meio já falhou. Em um notebook, tampa fechada significa repouso em poucos segundos, a menos que algo impeça. A tela de bloqueio não causa repouso. A proteção de tela também não. Só o temporizador de repouso e a tampa causam.
Solução 1: caffeinate para uma única tarefa
O macOS vem com uma ferramenta que mantém a máquina acordada enquanto um comando roda. Inicie o agente por ela e o Mac fica ligado até o agente terminar.
caffeinate -i claude
A opção impede que o sistema entre em repouso por inatividade. Adicione uma segunda opção para manter a tela ligada também. Isso só importa para ferramentas que controlam a tela.
caffeinate -di claude
Isso não resiste à tampa fechada de um notebook. O sensor da tampa passa por cima de qualquer bloqueio de inatividade. E não adianta nada depois que o agente termina e você inicia a próxima tarefa sem ele.
Solução 2: desligue o repouso da máquina
Em um Mac de mesa, ou em um notebook na tomada, coloque o temporizador de repouso em nunca e deixe assim. Estes são os ajustes que usamos em todo Mac para agentes.
sudo pmset -a sleep 0 sudo pmset -a disksleep 0 sudo pmset -a displaysleep 10 sudo pmset -a womp 1
A tela ainda pode apagar. Isso economiza energia e não muda nada para um processo de terminal. A última linha ativa o despertar pela rede, o que ajuda se algo colocar a máquina em repouso mesmo assim.
Solução 3: a tampa fechada
Um MacBook com a tampa fechada entra em repouso, a menos que esteja na tomada e ligado a uma tela, teclado ou mouse externo. Essa é a regra de modo fechado da Apple. Sem tela externa, mais um ajuste força a máquina a ficar acordada com a tampa fechada.
sudo pmset -a disablesleep 1
Desfaça depois com o mesmo comando e um zero. Dois avisos. O notebook vai esquentar dentro de uma mochila ou em cima da cama, então deixe em uma superfície dura. E ele vai gastar a bateria em poucas horas se o cabo sair, e depois desligar sem um encerramento limpo.
Solução 4: o terminal, não a máquina
Às vezes o Mac continuou acordado e a sessão sumiu mesmo assim. Isso é a janela do terminal fechando ou a conexão SSH caindo, o que envia um sinal de desligamento para tudo dentro dela. A resposta é um multiplexador de terminal. Rode o agente dentro de uma sessão tmux e ele sobrevive à janela, à queda do SSH e às falhas do Wi-Fi.
brew install tmux tmux new -s agent claude
Desconecte com Ctrl-b e depois d. Reconecte depois de qualquer terminal, ou do celular por SSH, com um comando.
tmux attach -t agent
Há um guia completo dessa configuração: como manter uma sessão do Claude Code viva com tmux.
Solução 5: volte depois de uma reinicialização
Atualizações de segurança reiniciam a máquina. Quedas de energia também. Depois de reiniciar, nada roda até alguém fazer login. Para uma máquina que deve ficar sem supervisão, ative o login automático do usuário do agente nos Ajustes do Sistema. Depois adicione um LaunchAgent que recria a sessão tmux no login. A checklist do Mac sempre ligado tem a lista completa, incluindo bateria de reserva.
Quando o notebook é a máquina errada
Tudo acima funciona. Mas também transforma o seu notebook em um servidor que você não pode levar a lugar nenhum. Quando o agente começa a fazer trabalho de verdade durante a noite, a maioria das pessoas passa ele para uma máquina cujo único trabalho é ficar ligada. Há quatro opções. Um Mac mini sobrando em casa. Uma máquina Linux, se você não precisa do Xcode. Um Mac na nuvem. Ou um Mac mini hospedado que outra pessoa mantém acordado. A comparação de lugares para rodar um agente 24/7 mostra os custos lado a lado.
Perguntas frequentes
O caffeinate mantém o Claude Code rodando com a tampa fechada?
+
Não. Em um MacBook, o sensor da tampa passa por cima do caffeinate. Você precisa da máquina na tomada com uma tela externa ligada, ou do ajuste de energia disablesleep.
A tela de bloqueio ou a proteção de tela param o agente?
+
Não. Bloquear a tela e ativar a proteção de tela não colocam a máquina em repouso. Só o temporizador de repouso, a bateria fraca ou a tampa fechada fazem isso. Uma tela bloqueada não atrapalha um agente de terminal.
Isso vale para o Codex também?
+
Sim. O Codex CLI é um processo de terminal como o Claude Code. Os mesmos ajustes de repouso, o caffeinate e o tmux valem para ele, e a mesma regra da tampa.
Posso manter o Mac acordado pelo celular?
+
Você pode iniciar uma tarefa pelo celular com o Remote Control do Claude Code ou por SSH. Mas não dá para impedir remotamente que um Mac entre em repouso depois que ele decide fazer isso. Configure os ajustes de energia uma vez na própria máquina.