O que é e porque importa
Uma rotina é um prompt guardado que o Claude Code executa sozinho: a uma hora fixa ou a intervalos regulares. Escreves uma vez e depois arranca sem teres de abrir nada.
O problema que me resolve é simples. De manhã abro o computador e não sei o que aconteceu durante a noite: quantas pessoas se inscreveram, se houve erros, se o site foi abaixo. Ir procurar tudo à mão leva tempo, e muitas vezes acabo por não o fazer. Com duas rotinas, a resposta já está à minha espera.
Uma rotina pode correr em três sítios diferentes. A escolha depende de duas coisas: com que frequência tem de arrancar e se o teu computador pode ficar ligado.
- Na cloud: arranca mesmo com o computador desligado, mas no máximo uma vez por hora.
- Na app de desktop do Claude, como rotina Local: corre no teu computador, até de poucos em poucos minutos, mas só com a app aberta e o computador acordado.
- Com /loop, dentro de uma sessão do Claude Code: é a forma mais rápida, mas só vive enquanto essa sessão estiver aberta.
1. O resumo das 7h30
Esta ponho-a na cloud, assim arranca às 7h30 mesmo que o computador esteja desligado ou fechado na mochila.
- No Claude Code escreve /schedule (tens de ter sessão iniciada com a tua conta claude.ai), ou vai a claude.ai/code/routines e clica em New routine. Com /schedule é o Claude que te faz as perguntas e guarda a rotina por ti.
- Escolhe o projeto. Tem de estar no GitHub: sempre que arranca, a rotina descarrega uma cópia limpa e não vê os ficheiros do teu computador.
- Como horário escolhe todos os dias às 7h30. Indicas no teu fuso horário e a conversão é feita automaticamente.
- Liga a base de dados e os logs de erros como conectores. São as ligações a serviços externos que tens na tua conta claude.ai.
- Cola o prompt abaixo e troca [nome] pelo nome da tua app.
Todas as manhãs verifica a minha app [nome] e escreve-me o que aconteceu desde ontem à noite: - quantas pessoas se inscreveram (só o número, nada de dados pessoais); - os erros nos logs: quantos, quais, a que horas, se algum se repete; - um resumo de três linhas: como correu a noite e o que vejo primeiro. Não alteres nada: lê e escreve o resumo.
No prompt só peço o número de inscrições, nada de nomes nem emails. Para perceber como correu a noite chega-me isso, e o resumo fica guardado: é melhor que lá dentro não acabem dados pessoais de ninguém.
Onde encontras o resumo
Sempre que arranca, a rotina cria uma sessão nova, ao lado das outras. Abres e encontras o que fez e o resumo. Se alguma vez alterasse o código, o trabalho iria para um branch que começa por claude/, não para o teu branch principal, a não ser que o prompt peça outra coisa.
Atenção ao estado verde na lista de execuções: quer dizer que a sessão arrancou e terminou sem problemas técnicos, não que a tarefa correu bem. Nas primeiras vezes, abre a sessão e lê.
2. A verificação a cada 5 minutos
As rotinas na cloud arrancam no máximo uma vez por hora. Para uma verificação a cada 5 minutos precisas de algo que corra no teu computador, e aqui tens dois caminhos. O prompt é o mesmo para os dois:
Abre [endereço do site] e verifica se responde e se a página carrega. Escreve-me só se mudar alguma coisa em relação à verificação anterior: "o site não responde" quando for abaixo, "voltou" quando voltar. Se estiver tudo como antes, não escrevas nada.
A cada 5 minutos são cerca de 288 verificações por dia: mantém-no curto. O prompt acima faz uma só coisa e só escreve quando alguma coisa muda.
Com /loop, numa sessão aberta
Na sessão do Claude Code escreve /loop 5m e logo a seguir o texto. A cada 5 minutos o Claude volta a executá-lo na mesma conversa, por isso lembra-se de como estava o site na verificação anterior.
Os limites: só funciona enquanto a sessão estiver aberta e o computador ligado. Se fechares o terminal, para. E ao fim de 7 dias o loop para sozinho: dá uma última volta e apaga-se. Se ainda precisares dele, voltas a lançá-lo.
Com a app de desktop do Claude, como rotina Local
- Na app de desktop, no separador Code, abre Routines, clica em New routine e escolhe Local.
- Dá-lhe um nome, escolhe a pasta do projeto e cola o mesmo prompt.
- Entre os horários predefinidos (Manual, Hourly, Daily, Weekdays, Weekly) não existe «a cada 5 minutos». Escolhe Hourly e guarda; depois, numa sessão da app, pede ao Claude que a lance a cada 5 minutos.
- Deixa a app aberta e o computador acordado. Se o computador entrar em suspensão, as verificações desse período são saltadas.
Uma diferença importante: na app de desktop cada verificação é uma sessão nova e não sabe nada da anterior. Por isso não te pode dizer «voltou». No fim do prompt acrescenta esta linha, assim sabe o que mudou:
Guarda o resultado em estado-site.txt e volta a lê-lo na verificação seguinte
Para o computador não adormecer quando está parado, nas definições da app há a opção Keep computer awake. Fechar a tampa do portátil, no entanto, põe-no em suspensão na mesma.
3. Antes de a deixar andar sozinha
Testo-a à mão
Na primeira vez lanço-a eu com Run now, o botão que existe tanto em claude.ai/code/routines como na app de desktop, e vejo o que faz antes de a deixar andar sozinha. Na app de desktop conta também o modo de permissões: em Manual, uma rotina local fica presa a cada pedido de permissão até responderes. Na primeira execução aprovo-os ali mesmo escolhendo «always allow»: a partir daí essas ferramentas correm sem perguntar.
Tiro os conectores de que não precisa
Quando crias uma rotina na cloud, todos os conectores da tua conta vêm incluídos por defeito. E durante a execução o Claude pode usar todas as ferramentas deles, incluindo as que escrevem, sem te perguntar nada. Uma rotina que controla não deve poder mudar nada: deixo só a base de dados e os logs e, se o serviço o permitir, ligo-os só em modo de leitura. O «Não alteres nada» do prompt ajuda, mas o limite verdadeiro é aquilo em que a rotina pode mexer.
Não me preocupo com o atraso
Uma rotina pode arrancar alguns minutos depois da hora marcada: é normal. Na cloud acontece sobretudo se escolheres uma hora certa, como as 7h00. Na app de desktop cada rotina arranca sempre com o mesmo pequeno atraso de alguns minutos. Com /loop 5m, pelo contrário, a verificação chega mais ou menos a cada 5 minutos.
Os erros mais comuns
- Pôr na cloud a verificação a cada 5 minutos: lá o mínimo é uma hora, por isso usa /loop ou uma rotina Local.
- Deixar todos os conectores incluídos: tira os de que não precisa, porque durante a rotina o Claude usa-os sem perguntar.
- Pedir nomes e emails dos inscritos: pede só o número, para perceber como correu a noite não precisas de dados pessoais.
- Esquecer que na app de desktop cada verificação começa do zero: acrescenta a linha que guarda o resultado em estado-site.txt.
- Confiar no estado verde: abre a sessão e lê o que fez realmente.
- Contar com um /loop passada uma semana: expira ao fim de 7 dias, por isso aponta quando o voltar a lançar ou passa para uma rotina Local.
Checklist
- Projeto no GitHub
- Resumo das 7h30 como rotina na cloud
- Só base de dados e logs nos conectores
- Só o número de inscrições, nada de dados pessoais
- Verificação a cada 5 minutos com /loop 5m ou com uma rotina Local
- Linha do estado-site.txt acrescentada, se usares a app de desktop
- Primeira volta lançada à mão e lida
Perguntas frequentes
O resumo das 7h30 arranca mesmo com o computador desligado?
Sim, se for uma rotina na cloud: corre nos servidores da Anthropic, não no teu computador. A rotina Local e o /loop, pelo contrário, precisam do computador ligado.
Escrevo /schedule e não acontece nada. Porquê?
O /schedule só aparece se tiveres iniciado sessão no Claude Code com a tua conta claude.ai, não com uma chave de API. Mesmo assim podes criar a rotina no site, em claude.ai/code/routines, a não ser que a tua organização tenha desativado as rotinas.
A rotina na cloud pode alterar o meu código?
Sim: corre sozinha, sem te pedir permissões. Se mudar alguma coisa, põe-na num branch que começa por claude/. É por isso que no prompt lhe digo para não alterar nada e lhe tiro os conectores de que não precisa.