Agentes que continuam trabalhando sem você
Como agendar o Claude para rodar automaticamente
O Claude e o Claude Code da Anthropic são as ferramentas citadas neste guia. Ele é independente, sem afiliação com a Anthropic nem endosso dela.
Publicações sobre agentes de IA que continuam trabalhando depois que você fecha o notebook, disparados por um agendamento, uma chamada de API ou um evento do GitHub, estiveram em todo lugar nesta semana. Essa capacidade não é teórica. O Claude e o Claude Code da Anthropic já oferecem isso hoje, por mais de um mecanismo, dependendo de onde você quer que o trabalho realmente aconteça. Este guia trata especificamente do Claude Code, a ferramenta para desenvolvedores, não do recurso separado de tarefas agendadas dentro do aplicativo de chat para consumidores do Claude. Ele explica o que de fato significa uma sessão do Claude Code se iniciar por conta própria, as cinco formas que as pessoas estão usando para configurar isso nesta semana, e as verificações que valem a pena fazer antes de deixar qualquer uma delas rodar sem a sua supervisão.
Uma sessão do Claude Code rodando automaticamente se inicia sozinha a partir de um prompt que você salvou antes, trabalha nele e informa o resultado, sem que ninguém abra um terminal naquele momento. O Claude Code permite isso de cinco formas: /loop para verificações rápidas dentro de uma sessão ainda aberta na sua máquina, /schedule para uma tarefa durável na nuvem que roda na própria infraestrutura da Anthropic, uma sessão na nuvem em claude.ai/code que continua rodando depois que você fecha o notebook, um workflow do GitHub Actions que executa o Claude Code em um evento do repositório ou em um agendamento cron, e um agendador comum do sistema operacional, como cron, launchd ou o Agendador de Tarefas, chamando claude -p pela linha de comando.
Publicado em
Aula grátis · sem precisar de contaConheça o ClaudePor Que o Claude?6 minComeçar a aula grátisPrincipais pontos
- Rodar automaticamente significa que uma sessão do Claude Code se inicia sozinha a partir de um prompt salvo com antecedência, trabalha nele e informa o resultado, sem que ninguém abra um terminal naquele momento.
- O /loop roda dentro de uma sessão que você deixa aberta na sua própria máquina; o /schedule cria uma tarefa durável na nuvem, antes chamada de Rotina, que roda na infraestrutura própria da Anthropic.
- Uma sessão na nuvem em claude.ai/code, um workflow do GitHub Actions e o agendador do seu próprio computador chamando claude -p são outras três formas de rodar o Claude Code sem ninguém no teclado.
- As ferramentas de cron por trás do /loop só disparam enquanto o Claude Code está aberto e ocioso na sua máquina; qualquer coisa que precise sobreviver a um notebook fechado pertence ao /schedule, ao GitHub Actions ou ao agendador do seu próprio sistema.
- Todo método aqui precisa das mesmas verificações antes de confiar nele sem supervisão: permissões bem delimitadas, um limite de gastos, um histórico de execuções visível e uma etapa de aprovação humana para qualquer coisa que envie, pague ou exclua.
Resumo: cinco formas de rodar o Claude Code sem supervisão
| Método | Onde roda | Precisa da sua máquina ligada? | Melhor para |
|---|---|---|---|
| /loop | Dentro de uma sessão aberta, na sua máquina | Sim, a sessão precisa ficar aberta | Acompanhar algo hoje, como um deploy ou um pull request |
| /schedule | Infraestrutura na nuvem da Anthropic | Não | Uma tarefa recorrente que precisa sobreviver a um notebook fechado |
| Sessão na nuvem (claude.ai/code) | Infraestrutura na nuvem da Anthropic | Não | Uma tarefa única e substancial que você delega e confere depois |
| GitHub Actions | Executores hospedados pelo GitHub | Não | Reagir a um evento do repositório, não a um relógio |
| Agendador do sistema + claude -p | Sua própria máquina ou servidor | Sim | Zero dependência de qualquer conta na nuvem para o agendamento em si |
Copie e cole
Prompts para usar hoje mesmo
Um loop local rápido para algo que você está acompanhando agora
/loop 10m check whether the deploy to staging has finished, read the last 50 lines of its log, and tell me in one line whether it succeeded, failed, or is still running. Don't touch anything, just report back each time.
O /loop só dispara enquanto essa sessão permanecer aberta na sua máquina, o que é perfeito para acompanhar algo por uma tarde.
Uma tarefa durável na nuvem criada com /schedule
/schedule every weekday at 8am, open the repository's pull requests, read any new review comments or failed CI checks since yesterday, and post a one-paragraph summary to our team channel. If nothing changed, say so in one line instead of repeating yesterday's summary.
Diferente do /loop, isso continua rodando na infraestrutura própria da Anthropic mesmo depois que você fecha o notebook.
Perguntando o que uma execução sem supervisão pode fazer, antes de agendar qualquer coisa
Before I turn this into a scheduled task, tell me plainly what you can do without me watching: can you push commits, open pull requests, spend any API budget, or message anyone on my behalf? List anything that needs my approval first, so I know exactly what I'm turning on before I save this schedule.
Uma boa resposta aqui é específica. Uma resposta vaga é motivo para restringir a tarefa, não para deixar de perguntar.
Um prompt para um workflow do GitHub Actions, restrito a um evento
Read the pull request that was just opened, compare it against the project's CLAUDE.md conventions, and leave one inline comment per real issue you find. If you find nothing worth flagging, post a single comment that says the change looks clean. Never approve or merge the pull request yourself.
Esse é o texto para o campo prompt do workflow, não algo que você digita em uma janela de chat.
Interativo x sem supervisão
O que "rodar por conta própria" realmente significa
Toda conversa que você já teve com um assistente de IA provavelmente começou do mesmo jeito: você abriu uma janela, digitou algo e esperou. Fecha essa janela, e a conversa deixa de existir até você voltar. Nada acontece enquanto você está ausente, porque nada está agendado para acontecer na sua ausência.
Rodar automaticamente inverte isso. Uma sessão do Claude Code se inicia por conta própria, em um horário ou em reação a um evento que você configurou com antecedência, trabalha em um prompt que você já escreveu, e para quando termina ou quando precisa de você. Quem inicia a sessão é a verdadeira linha divisória, não quão capaz o modelo subjacente é no instante em que você está observando.
Essa mudança, quem inicia a sessão, também explica por que o restante deste guia é específico sobre o Claude Code em vez do Claude de modo geral. O Claude da Anthropic, o aplicativo de chat para consumidores, tem seu próprio recurso separado de tarefas agendadas, para coisas como um resumo diário da caixa de entrada. O Claude Code, a ferramenta agêntica voltada para desenvolvedores, tem mecanismos diferentes, feitos para rodar dentro de um repositório, um terminal ou um pipeline de CI, e é isso que o restante deste guia aborda.
Nenhum dos cinco mecanismos abaixo exige que você escreva software novo. Cada um é apenas uma forma de dizer ao Claude Code quando começar e o que fazer depois disso, usando ferramentas que já existem hoje.
Onde o trabalho realmente roda
Cinco formas de colocar o Claude Code em um agendamento
Escolha a que combina com onde o trabalho precisa acontecer, não a que parece mais impressionante.
/loop, para verificações rápidas em uma sessão aberta
Um comando embutido no Claude Code que repete um prompt em intervalos, ou deixa o próprio Claude escolher o intervalo, enquanto a sessão permanecer aberta na sua própria máquina.
/schedule, para uma tarefa durável na nuvem
Também um comando embutido no Claude Code. Ele salva um prompt, repositórios e conectores como uma tarefa agendada que roda na infraestrutura própria da Anthropic, por um agendamento, uma chamada de API ou um evento do GitHub, esteja a sua máquina ligada ou não.
Uma sessão na nuvem em claude.ai/code
Inicie uma sessão do Claude Code no navegador, no app do Claude para celular, ou com claude --cloud a partir do seu terminal. Ela continua rodando depois que você fecha o notebook, e você pode conferir de qualquer dispositivo.
Um workflow do GitHub Actions
A GitHub Action do Claude Code roda dentro dos workflows do seu repositório, respondendo a uma menção a @claude ou executando automaticamente um prompt salvo em qualquer evento que você configurar, incluindo um agendamento cron.
O agendador do seu próprio computador, chamando claude -p
Cron e launchd no macOS e Linux, Agendador de Tarefas no Windows, chamando claude -p, a opção não interativa do Claude Code, a partir de uma linha ou script que você mesmo escreve. Nenhuma conta na nuvem ligada ao agendamento.
Embutido na CLI
/loop e /schedule: os próprios comandos de agendamento do Claude Code
O /loop é a forma mais rápida de testar isso. Digite /loop 5m check the deploy and tell me if it finished, e o Claude Code converte esse intervalo em uma expressão cron, agenda a tarefa dentro da sessão atual, e repete seu prompt a cada cinco minutos até você pará-lo ou sete dias passarem, o que vier primeiro. Se você omitir o intervalo, o Claude escolhe um dinamicamente, esperando mais tempo quando o que está observando fica quieto.
O problema está justamente em como ele funciona: o /loop é limitado à sessão. As tarefas que ele cria só disparam enquanto aquela sessão específica do Claude Code ainda estiver rodando e ociosa na sua máquina. Feche o terminal, e elas param. Isso torna o /loop ótimo para acompanhar um deploy ou um pull request por uma tarde, e inadequado para qualquer coisa que precise sobreviver a você fechar o notebook.
O /schedule é o outro comando embutido, e resolve exatamente essa lacuna. Descreva uma tarefa recorrente em linguagem natural, como /schedule daily PR review at 9am, ou uma única como /schedule in 2 weeks, open a cleanup PR that removes the feature flag, e o Claude Code a salva como uma tarefa agendada na nuvem, o que a Anthropic chamava de Rotina antes de renomear. A partir daí, ela roda na infraestrutura própria da Anthropic, disparada por um agendamento, uma chamada de API ou um evento do repositório no GitHub, sem nenhuma dependência de a sua máquina estar ligada.
Intervalos cron personalizados para uma tarefa /schedule são limitados a uma vez por hora; qualquer coisa mais frequente é rejeitada, um limite deliberado e não um erro, já que esse é um trabalho pensado para rodar sem supervisão em vez de ser consultado o tempo todo. O /loop não tem esse limite: suas ferramentas de cron suportam granularidade de um minuto, porque uma sessão que você está observando ativamente pode tolerar um loop bem mais apertado do que uma que roda totalmente por conta própria.
Mais três formas de rodar sem supervisão
Sessões na nuvem, GitHub Actions e o agendador do seu próprio computador
Uma sessão na nuvem é a categoria mais ampla sob a qual uma tarefa /schedule realmente roda. Você pode iniciar uma diretamente, sem nenhum agendamento associado, a partir de claude.ai/code no navegador, da aba Code no app do Claude para celular, ou com claude --cloud "your task" a partir do seu próprio terminal. De qualquer forma que você a inicie, a sessão roda em infraestrutura gerenciada pela Anthropic em vez do seu notebook, continua rodando depois que você o fecha, e você pode conferir ou direcionar a sessão de qualquer dispositivo conectado à mesma conta.
O GitHub Actions tira o gatilho do Claude Code por completo e o coloca no seu repositório. A GitHub Action do Claude Code, anthropics/claude-code-action, roda dentro de um arquivo de workflow que você adiciona a .github/workflows/. Dê a ela um campo prompt e ela executará esse prompt automaticamente em qualquer evento do GitHub que você configurar o workflow para escutar: um pull request sendo aberto, uma issue sendo rotulada, ou um simples gatilho de agendamento cron como qualquer outro workflow agendado. Mencione @claude em um comentário em vez disso, sem um campo prompt definido, e ela passa a responder diretamente a essa menção em vez de rodar por conta própria.
A opção mais simples dispensa por completo a infraestrutura de agendamento da própria Anthropic. claude -p, em que o p significa print (imprimir), executa o Claude Code de forma não interativa: ele recebe um prompt, executa uma vez, imprime o resultado e termina com um código de status que seu script pode checar. Aponte o cron no macOS ou Linux, o launchd no macOS, ou o Agendador de Tarefas no Windows para uma linha que chame claude -p "your prompt" --allowedTools "...", e é o próprio sistema operacional que decide quando o Claude roda, sem nenhuma conta na nuvem ou nível de assinatura envolvido no agendamento.
Combine claude -p com um modo de permissão e uma opção que desative pedidos de permissão quando não houver ninguém no teclado para responder. Sem essa combinação, uma execução sem supervisão pode simplesmente travar, esperando uma aprovação que ninguém está ali para dar.
Antes de salvar o agendamento
O que checar antes de deixar qualquer coisa rodar sem supervisão
Essas verificações valem para todo método acima. Elas são sobre o que o agendamento tem permissão para tocar, não sobre qual você escolheu.
Delimite bem as permissões
Decida quais ferramentas, repositórios e conectores uma execução agendada realmente precisa, e conceda apenas esses. Uma tarefa que só precisa ler um arquivo de log não tem motivo para ter acesso de escrita a todo o seu código.
Defina um limite de gastos
Uma execução sem supervisão pode chamar a API muito mais vezes do que você jamais digitaria à mão. Limite isso, seja com um limite de turnos em uma única chamada, seja com um alerta de orçamento na conta que executa o agendamento.
Mantenha um histórico de execuções visível
Todo método aqui mantém algum registro do que rodou e quando: uma transcrição da sessão, um log de execução do workflow, ou uma linha que seu próprio script escreve em um arquivo. Leia isso, especialmente na primeira semana.
Adicione uma etapa de aprovação humana para qualquer risco
Nada sem supervisão deveria concluir um pagamento, enviar uma mensagem a uma pessoa real, dar push para uma branch protegida ou excluir algo, sem que uma pessoa aprove antes essa ação específica.
Dê a ele um sinal de vida
Configure uma forma de notar se um agendamento para de disparar silenciosamente: uma olhada semanal no histórico de execuções da tarefa, ou um lembrete separado que verifica se o último relatório realmente chegou na hora.
A ferramenta certa para o trabalho
Qual método você deve realmente usar
Comece por onde o trabalho precisa acontecer, não por qual método parece mais capaz. Se você está acompanhando ativamente um deploy ou um pull request nesta tarde e já tem uma sessão do Claude Code aberta, o /loop não custa nada extra para testar e para no momento em que você fecha o terminal.
Se a tarefa precisa sobreviver a você fechar o notebook e rodar de novo amanhã mesmo assim, use /schedule, uma sessão na nuvem ou GitHub Actions. O /schedule é o mais rápido dos três para configurar de dentro de uma conversa que você já está tendo. Uma sessão na nuvem em claude.ai/code combina com uma tarefa única e substancial que você quer delegar e conferir depois, em vez de algo recorrente. O GitHub Actions é a escolha certa quando o próprio gatilho é um evento do repositório, um pull request, uma issue, um release, em vez de um relógio.
Use o agendador do seu próprio sistema operacional e o claude -p quando você quiser zero dependência de qualquer conta na nuvem para o agendamento em si, quando a tarefa já convive com outros jobs de cron que você mantém, ou quando a política da sua organização mantém a automação em infraestrutura que ela controla diretamente em vez da nuvem de um fornecedor.
Juntando tudo
Como isso se parece quando está rodando
Imagine uma tarefa /schedule configurada para toda manhã de dia útil. Ela desperta por conta própria porque um gatilho, não uma pessoa, iniciou a sessão. Ela clona o repositório do zero, lê os pull requests abertos desde ontem, e confere o status de CI e os comentários de revisão de cada um contra as próprias convenções do CLAUDE.md do projeto.
Ela não faz merge de nada, e não dá push para a branch padrão. Ela abre um resumo em rascunho, ou um pequeno pull request próprio se o prompt autorizou especificamente isso, e para ali, assim como os métodos vizinhos deste guia: uma execução do GitHub Actions posta no pull request que a disparou e em nenhum outro lugar; um job de cron chamando claude -p imprime seu resultado em um arquivo de log e termina com um código de status; uma sessão /loop conta o que encontrou e espera o próximo intervalo.
Em todos os casos, o agendamento faz um só trabalho: iniciar a sessão para que uma pessoa não precise se lembrar disso. Tudo depois disso, o que a sessão tem permissão para tocar e o que precisa perguntar antes, continua sendo uma decisão que você tomou ao escrever o prompt e escolher as permissões, não algo que o agendamento decide por conta própria.
Pratique escrever o briefing antes de automatizar algo maior
Escrever um prompt que uma sessão do Claude Code pode executar sem supervisão, e saber exatamente quais permissões deixar de fora, é a mesma habilidade, seja o gatilho /loop, /schedule, um evento do GitHub ou uma linha no cron. A aula gratuita da Nightschool AI sobre hooks e automação mostra como montar uma execução automatizada com uma etapa de aprovação, usando o Claude Code como exemplo.
Perguntas frequentes
O que realmente significa o Claude rodar automaticamente?
Significa que uma sessão do Claude Code se inicia sozinha a partir de um prompt que você salvou antes, trabalha nele por conta própria e informa o resultado, sem que ninguém abra um terminal ou uma janela de chat naquele momento. O agendamento decide quando ela começa; o prompt e as permissões que você definiu continuam decidindo tudo o que ela tem permissão para fazer.
Qual é a diferença entre /loop e /schedule no Claude Code?
O /loop repete um prompt dentro de uma sessão que ainda está aberta na sua própria máquina, e para no momento em que você fecha essa sessão. O /schedule, em vez disso, salva um prompt como uma tarefa agendada na nuvem que roda na infraestrutura própria da Anthropic, por um agendamento, uma chamada de API ou um evento do GitHub, esteja a sua máquina ligada ou não.
Preciso manter o Claude Code aberto no meu notebook para uma tarefa agendada disparar?
Só para o /loop, que é limitado à sessão e para de disparar no momento em que ela fecha. Uma tarefa criada com /schedule, uma sessão na nuvem em claude.ai/code e um workflow do GitHub Actions rodam todos em infraestrutura diferente do seu notebook, então nenhum deles precisa que sua máquina esteja ligada.
Um workflow do GitHub Actions pode executar o Claude Code em um agendamento, não só em um pull request?
Sim. Dê à GitHub Action do Claude Code um campo prompt e configure o gatilho do workflow como um agendamento cron, do mesmo jeito que você agendaria qualquer outro workflow do GitHub Actions, e ela executará esse prompt automaticamente nos horários que você definir, sem precisar de um pull request ou issue para disparar.
O que é claude -p, e por que chamá-lo pelo cron ou pelo Agendador de Tarefas em vez de usar /schedule?
claude -p executa o Claude Code de forma não interativa pela linha de comando, imprimindo seu resultado e terminando com um código de status em vez de abrir uma janela de chat. Chamá-lo pelo agendador do seu próprio sistema operacional mantém o agendamento em si fora de qualquer conta na nuvem, o que importa se a sua política exige que a automação fique em infraestrutura que você controla.
Uma sessão na nuvem em claude.ai/code é a mesma coisa que uma tarefa agendada?
Uma tarefa criada com /schedule roda como uma sessão na nuvem, mas você também pode iniciar uma sessão na nuvem diretamente, com claude --cloud ou em claude.ai/code, para um trabalho único sem nenhum agendamento associado. Uma tarefa agendada é uma sessão na nuvem com um gatilho salvo com antecedência; nem toda sessão na nuvem tem um.
O que eu nunca deveria deixar uma execução sem supervisão do Claude Code fazer por conta própria?
Concluir um pagamento, enviar uma mensagem a uma pessoa real, dar push para uma branch protegida, ou excluir algo, sem que uma pessoa aprove antes essa ação específica. Isso cobre quase tudo que é difícil de desfazer. Ler, redigir rascunhos, resumir e sinalizar são coisas razoáveis de automatizar por completo desde o início.
Este guia tem afiliação com a Anthropic ou é endossado por ela?
Não. Este é um guia educacional independente. Ele cita o Claude e o Claude Code da Anthropic de forma descritiva, para explicar ferramentas reais com precisão, sem nenhuma afiliação, endosso ou parceria com a Anthropic.
Preciso de um plano pago para usar /schedule ou iniciar uma sessão na nuvem?
Tarefas agendadas na nuvem e sessões na nuvem estão disponíveis nos planos Pro, Max, Ultra e Team, e para usuários Enterprise com o acesso adequado, em vez de em todo plano gratuito. O /loop e o claude -p chamado pelo seu próprio agendador não têm essa restrição de plano para o agendamento em si.
Transforme isso na sua primeira execução sem supervisão do Claude Code
Escolha uma tarefa bem delimitada, escreva o que ela nunca deve fazer por conta própria, escolha o método que combina com onde o trabalho precisa acontecer, e observe as primeiras execuções antes de confiar mais nela.