Aula 16Automação: tarefas agendadas e lembretes

🖥️ Versão Desktop. Nesta versão do curso, você usa o Claude Code no app Claude Desktop, na aba Code. Quase tudo é feito por janelas e botões. Quando uma aula pedir para digitar um comando, ela mostra exatamente o que digitar. Nesta aula, você não digita nenhum comando: a tarefa agendada se cria com botões ou pedindo em português. A parte opcional do fim mostra os recursos de quem programa, e alguns deles, como o claude -p, rodam num terminal, com o Claude Code do terminal.

Objetivos

Ao final desta aula você vai saber:

• Criar uma tarefa agendada local, que o app roda sozinho toda segunda-feira, na pasta da sua página
• Acompanhar a primeira execução com Run now e aprovar só o que faz sentido
• Os limites da tarefa local: o app aberto, o computador acordado e o horário perdido
• Pedir um lembrete em português, que vira uma tarefa de uma vez só
• Depois da Aula 19, criar uma tarefa agendada na nuvem, que roda mesmo com o seu computador desligado, e ler o resultado de cada execução

ℹ️ O que esta aula pede: a pasta da sua página, como nas aulas anteriores, e o app na versão 1.1.5368 ou mais nova, que é onde as tarefas locais começam. A parte da nuvem fica para depois da Aula 19, porque precisa da página no GitHub, e só existe nos planos Pro, Max, Team e Enterprise.

Na Aula 15, você viu o que roda sempre, num momento certo. Nesta aula, o Claude trabalha num horário marcado, mesmo com você longe: toda segunda-feira, amanhã às 15h ou, depois da Aula 19, com o computador desligado. A ferramenta é a tarefa agendada (scheduled task): um pedido salvo que roda sozinho num horário. No app, ela pode ser:

• local: roda no seu computador, na sua pasta, com o app aberto;
• na nuvem: roda num computador da Anthropic, mesmo com o seu desligado, a partir do repositório do GitHub.

A tarefa local: o resumo da semana

A tarefa local não precisa do GitHub: ela lê e escreve na sua pasta, como uma conversa que você abriu. A desta aula se chama resumo-da-semana. Toda segunda, às 9h, ela lê as versões guardadas da semana e escreve, em português simples, o arquivo resumo-da-semana.md na pasta.

Pelos botões

1. Na aba Code, clique em Scheduled (tarefas agendadas), na barra lateral. Se não aparecer, procure no menu More da barra lateral.
2. Clique em New task (tarefa nova). Se abrir um menu com Create with Claude e Set up manually, escolha Set up manually (configurar à mão). Abre a janela New scheduled task.
3. Em Name, escreva resumo-da-semana. O nome não pode repetir o de outra tarefa.
4. Na caixa logo abaixo do nome, escreva o pedido:

Leia as versões guardadas dos últimos 7 dias e escreva, em português simples, um resumo do que mudou na página, no arquivo resumo-da-semana.md, nesta pasta. Se o arquivo já existir, escreva por cima. Se nenhuma versão foi guardada na semana, diga isso no resumo. Não mude nenhum outro arquivo.

5. Pule o cartão Trigger (gatilho) por enquanto e abra Advanced settings (configurações avançadas), logo abaixo dele. Na aba General, ligue Only on this computer (só neste computador).
6. Na linha Local folder (pasta local), escolha a pasta da sua página. Sem a pasta, o Create não acende.
7. Volte ao cartão Trigger e escolha Weekly (toda semana): segunda-feira, 9h.
8. Na barra da caixa do pedido, escolha Manual no seletor de modo. O modelo pode ficar como está; se quiser gastar menos, o Sonnet dá conta de um resumo (Aula 08).
9. Clique em Create (criar). Se for a primeira vez nessa pasta, o app pede que você confie nela. Abre a página da tarefa.

💡 A janela abriu com Only on this computer no alto? É outro desenho da mesma janela. Ligue Only on this computer antes de preencher qualquer coisa, e aparece um formulário próprio da tarefa local: Name, Description (uma frase sobre a tarefa, obrigatória), a caixa do pedido, com o modo e o modelo, Working folder (a pasta) e Trigger. Preencha e clique em Create.

Ou pedindo

Também dá para criar a tarefa pedindo, numa conversa. Clique em + New, escolha Local e a pasta da sua página na linha abaixo da caixa de mensagem e confira o Manual no seletor de modo, na mesma linha. Peça:

Crie uma tarefa agendada só neste computador, nesta pasta, chamada resumo-da-semana, no modo Manual, toda segunda às 9h, que leia as versões guardadas dos últimos 7 dias e escreva, em português simples, um resumo do que mudou na página no arquivo resumo-da-semana.md. Se o arquivo já existir, escreva por cima, e não mude nenhum outro arquivo.

Depois, abra Scheduled e clique na tarefa para conferir. Para mudar alguma coisa, como o pedido, a pasta, o horário ou o modo, clique no lápis (Edit).

A primeira execução, com você olhando

Quando a tarefa roda, muitas vezes ninguém está olhando. E, no Manual, ela para no primeiro pedido de licença e espera você. A desta aula lê as versões sem pedir nada, porque olhar o histórico não muda nada, mas pede licença para criar o arquivo.

Por isso, logo depois de criar:

1. Na página da tarefa, clique em Run now (rodar agora).
2. Uma conversa nova aparece na barra lateral, numa seção também chamada Scheduled. Abra.
3. Quando aparecer o pedido de licença para criar o resumo-da-semana.md, leia e escolha always allow (sempre permitir). Aprove assim só o que faz sentido para essa tarefa.
4. Confira: o resumo-da-semana.md aparece na pasta. Clique no caminho do arquivo na conversa e leia.

O "always allow" vale para essa tarefa: nas próximas execuções, ela aprova sozinha a mesma ferramenta, a de escrever arquivos. Por isso o pedido diz qual arquivo escrever. Para ver ou desfazer essa aprovação, use o painel Always allowed (sempre permitido), na página da tarefa.

💡 O resumo é um arquivo da pasta, como o decisoes.md: aparece entre as mudanças ainda não guardadas e entra na próxima versão que você guardar. Se preferir deixá-lo de fora das versões, peça para pôr o nome dele no .gitignore (Aula 06).

Os limites da tarefa local

• Só roda com o app aberto e o computador acordado. Se o computador dormir na hora marcada, a execução é pulada. Para ele não dormir sozinho, ligue Keep computer awake (manter o computador acordado) em Settings → This computer → System. Fechar a tampa do notebook ainda o faz dormir.
• Perdeu o horário? Ela roda uma vez quando der. Ao abrir o app ou acordar o computador, o app confere se alguma tarefa perdeu horário nos últimos 7 dias e roda uma única vez a mais recente, com uma notificação. Uma tarefa das 9h pode rodar às 23h: por isso o pedido fala em "últimos 7 dias", e não em "hoje".
• Ela começa alguns minutos depois da hora marcada, sempre com o mesmo atraso, para não rodar junto com as tarefas de todo mundo.
• No Manual, para no pedido de licença. A conversa fica na barra lateral, esperando a sua resposta.

Na página da tarefa ficam o Run now, o estado Active (ativa) ou Paused (pausada), o lápis Edit, o histórico das execuções, inclusive as puladas (passe o mouse por cima para ver o motivo), o painel Always allowed e Delete (apagar). Também dá para pedir numa conversa: "mostre as minhas tarefas agendadas" ou "pause a tarefa resumo-da-semana". Para apagar, só o botão Delete.

Lembretes

Numa conversa, peça:

Me lembre amanhã às 15h de conferir a página no celular.

O app cria uma tarefa agendada de uma vez só, que se desliga depois de rodar. Na hora, ela abre uma conversa nova na seção Scheduled da barra lateral, com o lembrete, e o app mostra uma notificação quando ela termina, se você não estiver olhando essa conversa. Como toda tarefa local, só roda com o app aberto e o computador acordado.

Para um intervalo que o cartão Trigger não oferece, peça do mesmo jeito: "crie uma tarefa que me lembre de responder as encomendas do WhatsApp a cada 2 horas".

Na nuvem, depois da Aula 19

ℹ️ Para esta parte: a página no GitHub (Aula 19) e um plano Pro, Max, Team ou Enterprise. Ainda não chegou na Aula 19? Leia agora e volte depois.

A tarefa agendada na nuvem roda num computador da Anthropic, mesmo com o seu desligado. Ela trabalha numa cópia do seu repositório do GitHub, então só enxerga as versões que você já enviou para o GitHub. O intervalo mínimo é de uma hora, e ela também pode rodar uma vez só.

⚠️ Ela trabalha sozinha, sem pedir licença. Na nuvem, não há modo para escolher: ela não para em pedido nenhum. Por isso, o próprio pedido diz o que ela pode e o que não pode fazer. E cada execução usa o seu plano, como uma conversa.

Para levar o resumo da semana para a nuvem:

1. Em Scheduled, clique em New task e em Set up manually.
2. Dê o nome resumo-da-semana-nuvem e escreva o pedido:

Leia as versões guardadas dos últimos 7 dias e escreva, em português simples, um resumo do que mudou na página. Não mude nenhum arquivo: o resumo é a sua resposta final.

3. Abra Advanced settings. Na aba General, deixe Only on this computer desligado e, em Repository (repositório), escolha o confeitaria. O ambiente que aparece embaixo pode ficar no Default.
4. No cartão Trigger, escolha Schedule (horário) e a frequência semanal, na segunda, às 9h.
5. Na aba Connectors (conectores) de Advanced settings, tire todos. Por padrão, a tarefa recebe todos os seus conectores e pode usar tudo deles sem pedir licença, até mudar a sua agenda ou mandar um e-mail. Um resumo das versões não precisa de nenhum.
6. Clique em Create e, na página da tarefa, em Run now.

O "não mude nenhum arquivo" também tem motivo: o que ela mudasse iria para uma linha paralela nova, com o nome começando por claude/, que você teria de juntar. O resumo é só para ler.

Onde aparece o resultado

Cada execução vira uma conversa nova. A lista das execuções fica na página da tarefa, em claude.ai/code/routines, no navegador. O endereço ainda tem o nome antigo das tarefas agendadas, em inglês. Clique numa execução para abrir a conversa: o resumo é a última resposta do Claude. A tarefa aparece também na página Scheduled do app, junto das locais.

⚠️ Verde não quer dizer certo. O sinal verde numa execução só diz que ela começou e terminou sem pane. Não diz que o resumo saiu bom: abra e leia.

Qual relógio usar

Para ir além (opcional): scripts, GitHub e mais

🔧 Para ir além (para quem já programa; pode pular): esta parte mostra a tarefa local por dentro, mais detalhes das tarefas na nuvem, o Claude Code sem conversa, dentro de scripts (claude -p), o @claude no GitHub e no GitLab, o agendamento pelo GitHub Actions, o /goal, os links do app, os channels e o Agent SDK. Se você nunca programou, pule direto para o Na prática: tudo o que ele pede já foi explicado acima.

A tarefa local por dentro

• Os gatilhos prontos são Hourly, Daily, Weekdays e Weekly. O Edit oferece também o Manual, sem horário: a tarefa só roda com Run now, o jeito de guardar um pedido que você dispara quando quiser. Para outro intervalo, como a cada 15 minutos ou todo dia 1º, peça em linguagem natural: "agende uma tarefa que rode todos os testes a cada 6 horas".
• Mudanças não commitadas entram na conta. Por padrão, a tarefa roda sobre a pasta do jeito que ela estiver. Num repositório Git, marque Worktree no Edit, e cada execução ganha a sua worktree isolada.
• As regras allow do ~/.claude/settings.json também valem nas tarefas agendadas. A lista que a documentação usa para criar um commit sem liberar mais nada do Git fica assim no arquivo:

{
  "permissions": {
    "allow": [
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(git status *)",
      "Bash(git commit *)"
    ]
  }
}

⚠️ O espaço antes do * importa: Bash(git diff *) libera git diff com argumentos; Bash(git diff*) também libera git diff-index.

• Ferramentas MCP marcadas com requiresUserInteraction pedem licença a cada chamada e não oferecem o "always allow": uma tarefa que usa uma delas para toda vez. O modo Auto também evita as paradas, com uma checagem que revisa as ações antes de elas rodarem, mas o mais seguro continua sendo liberar só o necessário.
• O pedido mora em ~/.claude/scheduled-tasks/<nome>/SKILL.md, com o name e a description no frontmatter YAML e o pedido no corpo. O horário, a pasta, o modelo e o estado não ficam nesse arquivo: mude pelo Edit ou pedindo. Uma tarefa também pode mudar o próprio horário ou pedido durante uma execução, com a ferramenta MCP update_scheduled_task. No Delete, a caixa Also delete files on disk apaga também essa pasta.
• O /loop, que a versão do terminal ensina, repete um pedido dentro de uma conversa aberta. A documentação do app não fala dele; no app, o caminho documentado são as tarefas agendadas, a partir de 1 minuto.

As tarefas na nuvem por dentro

• Gatilhos: além do horário, uma chamada de API (com um token próprio) e eventos do GitHub, como um PR novo, com filtros. Dá para combinar vários no cartão Trigger, com o +.
• Web, app e terminal gravam na mesma conta: a tarefa criada num aparece nos outros na hora. No terminal, o /schedule cria e consulta tarefas pela conversa (o atalho /routines é o mesmo comando).
• Cada execução clona os repositórios a partir da branch padrão e faz push em branches com o prefixo claude/, a não ser que o pedido diga outra coisa. Para controlar onde ela pode enviar, use as regras de proteção de branch do GitHub. Fora de um Projeto (Aula 17), as skills commitadas no repositório carregam.
• O ambiente na nuvem decide a rede e as variáveis: o Default tem rede Trusted, com a lista padrão de domínios. Chaves de API vão como segredos de rede, não como variáveis.
• Limites: é uma prévia de pesquisa, com até 100 execuções por hora por conta e 30 Run now por hora por tarefa. Sem o GitHub conectado, ela pula execuções por até 72 horas e depois se desliga. Uma execução pode publicar um artifact novo (Aula 25) sem perguntar, privado até você compartilhar.

O Claude Code sem conversa: claude -p

O app é sempre interativo. Para rodar o Claude Code dentro de scripts, existe o claude -p, do Claude Code do terminal: recebe o pedido, imprime a resposta e sai. Ele lê do pipe e devolve JSON:

git log --oneline -20 | claude -p "resuma esses commits"
claude -p "Resuma este projeto" --output-format json | jq -r '.result'

Sem ninguém para aprovar, ele começa no Manual (desde a v2.1.302) e nega tudo o que pediria permissão. Libere só o necessário com --allowedTools (que libera, mas não restringe), use --permission-mode dontAsk no CI e limite com --max-turns e --max-budget-usd. Em scripts, --bare dá o mesmo resultado em qualquer máquina, sem carregar hooks, skills, servidores MCP nem o CLAUDE.md, mas precisa de uma ANTHROPIC_API_KEY. Essas opções e o modo dontAsk não existem no app: aqui, o controle fica no modo de cada tarefa e nas aprovações que você deu. A versão do terminal desta aula traz a tabela completa das opções.

O Claude no GitHub

Com a GitHub Action do Claude Code, você menciona @claude num comentário de issue ou de pull request, e o Claude trabalha no repositório: analisa, implementa e abre PRs. No terminal, o comando /install-github-app faz a instalação; no app, faça a configuração manual, que chega ao mesmo resultado. Você precisa ser admin do repositório no github.com.

1. Instale o app do Claude no GitHub: o Claude GitHub App, no seu repositório.
2. Guarde a chave como secret do repositório: crie o secret ANTHROPIC_API_KEY com uma chave de API da Claude Console (o GitHub explica como no guia de secrets do GitHub Actions). A assinatura também serve, com o secret CLAUDE_CODE_OAUTH_TOKEN, mas esse token é gerado com o claude setup-token, um comando do Claude Code do terminal.
3. Copie o workflow: o arquivo examples/claude.yml vai para a pasta .github/workflows/ do repositório. Peça ao Claude: "Numa branch nova, copie o workflow examples/claude.yml do repositório anthropics/claude-code-action para .github/workflows/claude.yml e abra um PR."

Faça o merge do PR com o workflow, e o @claude passa a funcionar:

@claude implemente esta funcionalidade com base na descrição da issue
@claude corrija o TypeError no componente do painel do usuário

O Claude responde num comentário e vai atualizando enquanto trabalha. Só quem tem permissão de escrita no repositório consegue chamá-lo, e o @claude precisa ser uma palavra inteira.

O arquivo de exemplo é parecido com este:

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Sem um prompt, a Action espera um @claude. Com um prompt: no bloco with:, ela roda sozinha no evento que você escolher, como um horário (on: schedule, com cron em UTC: 0 12 * * 1-5 é 9h de Brasília, de segunda a sexta). Nesse modo, o resultado vai para o log da execução, e o Claude não tem acesso ao shell nem à API do GitHub até você liberar as ferramentas em claude_args, por exemplo claude_args: "--max-turns 5 --allowedTools ...", ou numa regra permissions.allow do input settings. E o GitHub só roda workflows agendados a partir da branch padrão; em repositório público, ele desliga o agendamento depois de 60 dias sem atividade.

Antes de ligar, saiba que:

• Cada execução gasta minutos do GitHub Actions e tokens da API (ou o uso da assinatura, com o token OAuth). Limite com --max-turns em claude_args e com um tempo máximo no workflow.
• Chaves nunca vão para o código, só para os secrets. E apagar o secret não revoga a chave: revogue também na Console.
• Dê ao workflow só as permissões necessárias e revise as mudanças do Claude antes do merge.
• Commits feitos com o GITHUB_TOKEN padrão não disparam outros workflows. Se o seu workflow passa github_token: ${{ secrets.GITHUB_TOKEN }} à Action, tire essa linha: sem ela, a Action se autentica como o Claude GitHub App.

E no GitLab?

Também dá para chamar o @claude em issues e merge requests do GitLab: você adiciona um job ao .gitlab-ci.yml e guarda a chave como variável mascarada de CI/CD. Essa integração está em beta e é mantida pela própria GitLab.

/goal: trabalhe até ficar pronto

O /goal não é um relógio: ele mantém a sessão trabalhando até uma condição ser verdade. Depois de cada turno, um modelo pequeno confere a condição; se ela ainda não foi atingida, o Claude começa outro turno em vez de devolver a vez. No app, digite o /goal na caixa de mensagem:

/goal todos os testes em test/auth passam e o lint está limpo, ou pare depois de 20 turnos

• Ele termina quando a condição é atingida, quando é julgada impossível, num erro que precisa de você ou com /goal clear; o /clear também tira o objetivo. É um objetivo por sessão.
• Quem confere não roda nada: ele julga pelo que o Claude mostrou. Escreva uma condição que a saída prove, como "o npm test termina com código 0".
• Ele não muda o modo de permissão. No Manual, o Claude continua pedindo. Para deixá-lo sozinho, escolha Auto no seletor de modo.
• Por dentro, o /goal é um hook Stop (Aula 15) que a sessão cria para você, e por isso não existe com disableAllHooks.

Links claude://code/new

Um link claude://code/new abre a tela de nova sessão do app com o pedido já digitado, e pode apontar uma máquina remota por SSH (o app na versão 2.110.0 ou mais nova). Cabe num runbook de incidente ou num alerta do monitoramento:

claude://code/new?ssh_host=dev%40build.example.com&ssh_folder=/srv/payments&q=Investigue%20o%20erro%20500

• q é o pedido, com os espaços escritos como %20; ssh_host, ssh_port e ssh_folder apontam a conexão, e o app pede a sua confirmação antes de usá-la.
• O link nunca envia nada sozinho: o pedido fica na caixa de mensagem até você ler e apertar Enter. Antes de enviar, confira o pedido e o ambiente selecionado. Um / ou um ! no começo do pedido não vira comando, e um @ não cita arquivo.
• No GitHub (README, issue, PR ou wiki), o link não fica clicável: o GitHub apaga o endereço e deixa só o texto. Ali, ponha o link num bloco de código, como o de cima, para a pessoa copiar e colar na barra de endereço do navegador.

Os links claude-cli://, que abrem o Claude Code do terminal, aparecem na versão do terminal desta aula.

Channels

Um channel é um servidor MCP que empurra eventos para uma sessão aberta: o resultado do CI, um alerta do monitoramento ou uma mensagem de chat. Ele entra com a opção --channels do Claude Code do terminal, numa prévia de pesquisa. No app, o caminho parecido é o Dispatch, que manda uma tarefa do celular para o seu computador (Aula 23).

ℹ️ Próximo passo: o Agent SDK. Quer construir o seu próprio agente, com as mesmas ferramentas, permissões e hooks do Claude Code, dentro de um app seu? O Agent SDK é o Claude Code como biblioteca, em Python e TypeScript. Veja a visão geral do Agent SDK na documentação oficial (em inglês).

Na prática

Use a pasta da sua página (a confeitaria, ou a da sua ideia).

1. Na aba Code, clique em Scheduled e em New task (e em Set up manually, se o menu aparecer). Crie a tarefa resumo-da-semana com o pedido da aula: Only on this computer ligado, a pasta da sua página, o gatilho Weekly, na segunda, às 9h, e Manual no seletor de modo. Clique em Create.
2. Na página da tarefa, clique em Run now. Abra a conversa nova, na seção Scheduled da barra lateral, e, no pedido de licença para criar o resumo-da-semana.md, escolha always allow.
3. Confira: o resumo-da-semana.md aparece na pasta. Clique no caminho do arquivo na conversa e leia o resumo.
4. Na página da tarefa, abra o painel Always allowed e veja a aprovação que você deu.
5. Abra Settings → This computer → System e decida se liga o Keep computer awake.
6. Clique em + New, escolha Local e a pasta da sua página na linha abaixo da caixa de mensagem, confira o Manual e peça: "me lembre daqui a 5 minutos de conferir a página no celular". Confira a tarefa nova em Scheduled e espere: alguns minutos depois, a conversa do lembrete aparece na barra lateral.
7. Depois da Aula 19: crie a tarefa resumo-da-semana-nuvem, com o repositório confeitaria e sem nenhum conector, clique em Run now e, em claude.ai/code/routines, abra a execução e leia o resumo.

Resumo

• A tarefa agendada local é um pedido salvo que o app roda sozinho, na sua pasta: Scheduled → New task → Set up manually, com Only on this computer, a pasta, o gatilho e o Manual. Ou peça numa conversa.
• No Manual, ela para no primeiro pedido de licença. Rode com Run now, escolha "always allow" só para o que faz sentido e desfaça no painel Always allowed. Pronto quando: o resumo-da-semana.md aparece na pasta.
• Ela só roda com o app aberto e o computador acordado (Keep computer awake). Perdeu o horário? Roda uma vez quando der, se foi nos últimos 7 dias.
• "Me lembre amanhã às 15h…" cria um lembrete: uma tarefa de uma vez só, que se desliga depois de rodar.
• Depois da Aula 19, a tarefa agendada na nuvem roda num computador da Anthropic, mesmo com o seu desligado, a partir do repositório do GitHub. Ela trabalha sozinha, sem pedir licença: tire os conectores e diga no pedido o que ela pode fazer. O resultado fica em claude.ai/code/routines, e verde não quer dizer certo.

Quer ir mais fundo? Veja a página de tarefas agendadas do app e a de tarefas agendadas na nuvem na documentação oficial (em inglês).

Até aqui, o Claude trabalhou num pedido de cada vez. Na próxima aula, várias conversas trabalham ao mesmo tempo para você, na nuvem, e uma delas coordena as outras: os Projetos.