Deixe o Claude Code rodando e saia: um fluxo de trabalho

01Por que tarefas longas travam

O Claude Code espera por você em três situações:

1. Prompts de permissão. No modo padrão, ele pergunta antes da maioria dos comandos de shell e edições de arquivo.
2. Perguntas. Quando precisa que você escolha algo, ele pergunta com AskUserQuestion e espera.
3. O fim de um turno. Quando termina, ele espera sua próxima mensagem.

Qualquer uma delas pode deixar uma tarefa longa parada por uma hora enquanto você está fora. A rotina abaixo elimina as esperas desnecessárias e faz as restantes chegarem até você.

02Passo 1: escreva uma tarefa que possa terminar sem você

A melhor forma de evitar perguntas é respondê-las antes. Antes de sair, diga ao Claude:

• O que significa "pronto". "Todos os testes em tests/api passam" é melhor do que "conserte a API".
• Como verificar o trabalho. Informe o comando de teste ou de build.
• O que ele não pode fazer. "Não altere o schema do banco" ou "não faça push".
• O que fazer se travar. "Se não conseguir resolver em um número razoável de tentativas, pare e descreva o que tentou."

Para uma mudança maior, comece no plan mode, alinhe o plano e depois deixe rodar:

claude --permission-mode plan

03Passo 2: libere o rotineiro, mantenha o arriscado

Cada prompt de permissão é uma pausa. Decida antes quais comandos o Claude pode executar livremente. Adicione regras de allow para os comandos seguros e repetitivos em .claude/settings.json ou com /permissions:

{
  "permissions": {
    "allow": [
      "Bash(npm test *)",
      "Bash(npm run lint)",
      "Bash(git diff *)"
    ],
    "deny": [
      "Bash(git push *)"
    ]
  }
}

Regras de deny têm prioridade sobre as de allow, então um deny em git push vale mesmo que algo mais amplo esteja liberado. Você também pode trocar de modo. O acceptEdits aceita edições de arquivo e comandos comuns de sistema de arquivos no diretório de trabalho sem perguntar. Os prós e contras de cada modo, incluindo por que o bypassPermissions só deve ser usado em containers ou VMs, estão em Modos de permissão do Claude Code explicados.

Mantenha o prompt para tudo que você gostaria de revisar antes: exclusão de arquivos, chamadas de rede inesperadas, qualquer coisa que mexa em produção.

04Passo 3: mantenha a sessão viva

Se o computador entrar em suspensão, o Claude Code para junto. Cada sistema operacional tem um jeito de se manter acordado.

Mac. Rode o Claude Code com o caffeinate, que mantém o Mac acordado enquanto o comando roda:

caffeinate -i claude

Linux. Em distribuições com systemd, o systemd-inhibit bloqueia a suspensão durante a execução de um comando:

systemd-inhibit claude

Windows. Em Configurações, abra Sistema e depois as opções de energia, e configure o computador para não suspender quando estiver na tomada.

Em um servidor remoto, ou se você puder fechar o terminal, rode o Claude Code dentro do tmux ou do screen para que ele continue rodando quando você desconectar:

tmux new -s work
claude
# detach with Ctrl+B then D; reattach later with: tmux attach -t work

Claude Code no tmux ou screen explica notificações de sessões desanexadas, e Notificações via SSH trata de servidores remotos.

05Passo 4: faça as esperas chegarem até você

É aqui que a maioria das configurações deixa a desejar. Você precisa saber quando o Claude termina ou precisa de você e, de preferência, responder sem ter que voltar ao computador.

Você tem algumas opções:

• O Remote Control da Anthropic conecta o app do Claude à sua sessão local, nos planos compatíveis e com login no claude.ai. Como usar o Claude Code pelo celular explica esse recurso e as outras opções para celular.
• Um hook feito por você que envia um push pelo ntfy, Telegram, Slack ou Discord avisa que algo aconteceu. Responder fica por sua conta. Veja Envie notificações do Claude Code para Telegram, Slack ou Discord.
• Claude Code Notifier, que é o assunto do restante desta seção.

Com o Claude Code Notifier

O Claude Code Notifier é uma ferramenta independente da TouchTap Ltd, não feita pela Anthropic. A ferramenta de linha de comando gratuita, ccn, funciona pelos hooks do Claude Code no Mac, Windows e Linux, e os apps para iPhone e Android permitem que você responda. Se ainda não configurou, Conecte seu celular ao Claude Code leva cerca de um minuto.

Depois do pareamento, cada uma das três esperas chega ao seu celular:

• Concluído. Um push assim que um turno termina. Logo em seguida, você pode enviar a próxima instrução pelo celular, e o Claude continua a partir dela.
• Permissão. Permitir uma vez, permitir na sessão ou negar.
• Pergunta. Escolha uma das opções do Claude.

Antes de sair, faça uma verificação rápida:

ccn doctor   # hooks, credentials, server connection, presence detection
ccn test     # a test notification to your phone

Ajuste o tempo de espera

O ccn sabe se você está no computador. Se você digitou nos últimos 30 segundos, o terminal pergunta normalmente. Se você está longe, o terminal espera a resposta do celular até um limite e para de esperar assim que você toca no teclado. Para uma tarde inteira fora, aumente o limite:

ccn config set hold_ceiling_seconds 1800

Aceita de 30 a 3600 segundos, com padrão de 600. Uma configuração relacionada, stop_hold_seconds (0 a 600, padrão 120), controla a espera no fim de um turno por uma instrução de acompanhamento vinda do celular. ccn config show lista tudo, e a maioria das configurações também pode ser alterada por computador pelo app.

Não seja acordado

Se uma tarefa roda durante a noite, defina um horário de silêncio para o celular ficar quieto enquanto você dorme:

ccn config set quiet_hours 22:00-08:00

Mais detalhes em Horário de silêncio e Não Perturbe.

O app é gratuito para baixar e exige uma assinatura ou compra vitalícia para uso. Sem celular, o ccn ainda oferece notificações de desktop gratuitas, que ajudam quando você está em outro cômodo, mas não quando está fora. Veja os preços.

06Passo 5: revise quando voltar

Sair de perto só é seguro se você conferir o que aconteceu. Quando voltar:

• Leia o diff antes de fazer commit: git diff ou a visualização de revisão do seu editor.
• Rode os testes você mesmo.
• Revise os comandos que o Claude executou, principalmente os que você aprovou pelo celular.

Trabalhar em uma branch ou em um git worktree facilita descartar uma execução que deu errado. Se você roda várias sessões ao mesmo tempo, Como rodar várias sessões do Claude Code ajuda a identificar qual delas está chamando.

07Checklist para copiar

1. Tarefa escrita com um critério claro de conclusão e um comando de teste.
2. Regras de allow para comandos rotineiros, regras de deny para os arriscados.
3. Computador mantido acordado, ou a sessão no tmux.
4. Celular pareado, ccn doctor e ccn test passando.
5. Limite de espera e horário de silêncio definidos conforme o tempo que você vai ficar fora.
6. Revise o diff quando voltar.

08Perguntas frequentes