desktop-scheduled-tasks.md +13 −13
8 8
9As tarefas agendadas iniciam uma nova sessão automaticamente em um horário e frequência que você escolhe. Use-as para trabalho recorrente como análises de código diárias, verificações de atualizações de dependências ou briefings matinais que extraem informações do seu calendário e caixa de entrada.9As tarefas agendadas iniciam uma nova sessão automaticamente em um horário e frequência que você escolhe. Use-as para trabalho recorrente como análises de código diárias, verificações de atualizações de dependências ou briefings matinais que extraem informações do seu calendário e caixa de entrada.
10 10
1111A página **Routines** do aplicativo Desktop permite criar tanto tarefas agendadas locais quanto [routines](/pt/routines) remotas. Uma tarefa local é executada em sua máquina com acesso direto aos seus arquivos e ferramentas, mas só funciona enquanto o aplicativo está aberto e seu computador está acordado. Uma routine remota é executada na infraestrutura em nuvem gerenciada pela Anthropic, mesmo quando seu computador está desligado, e também pode ser acionada por chamadas de API ou eventos do GitHub. Esta página aborda tarefas agendadas locais; para routines remotas e suas opções de acionamento, consulte [Routines](/pt/routines).A página **Routines** do aplicativo Desktop permite criar tanto tarefas agendadas locais quanto [routines](/docs/pt/routines) remotas. Uma tarefa local é executada em sua máquina com acesso direto aos seus arquivos e ferramentas, mas só funciona enquanto o aplicativo está aberto e seu computador está acordado. Uma routine remota é executada na infraestrutura em nuvem gerenciada pela Anthropic, mesmo quando seu computador está desligado, e também pode ser acionada por chamadas de API ou eventos do GitHub. Esta página aborda tarefas agendadas locais; para routines remotas e suas opções de acionamento, consulte [Routines](/docs/pt/routines).
12 12
13<h2 id="compare-scheduling-options">13<h2 id="compare-scheduling-options">
14 Comparar opções de agendamento14 Comparar opções de agendamento
16 16
17Claude Code offers three ways to schedule recurring or one-off work:17Claude Code offers three ways to schedule recurring or one-off work:
18 18
1919| | [Cloud](/en/routines) | [Desktop](/en/desktop-scheduled-tasks) | [`/loop`](/en/scheduled-tasks) || | [Cloud](/docs/en/routines) | [Desktop](/docs/en/desktop-scheduled-tasks) | [`/loop`](/docs/en/scheduled-tasks) |
2020| :------------------------- | :----------------------------- | :------------------------------------- | :---------------------------------- || :------------------------- | :---------------------------------- | :------------------------------------- | :---------------------------------- |
2121| Runs on | Anthropic cloud | Your machine | Your machine || Runs on | Cloud, Anthropic-managed by default | Your machine | Your machine |
22| Requires machine on | No | Yes | Yes |22| Requires machine on | No | Yes | Yes |
23| Requires open session | No | No | Yes |23| Requires open session | No | No | Yes |
24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |
25| Access to local files | No (fresh clone) | Yes | Yes |25| Access to local files | No (fresh clone) | Yes | Yes |
2626| MCP servers | Connectors configured per task | [Config files](/en/mcp) and connectors | Inherits from session || MCP servers | Connectors configured per task | [Config files](/docs/en/mcp) and connectors | Inherits from session |
27| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |27| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |
29| Minimum interval | 1 hour | 1 minute | 1 minute |29| Minimum interval | 1 hour | 1 minute | 1 minute |
33</Tip>33</Tip>
34 34
35<Note>35<Note>
3636 Por padrão, as tarefas agendadas são executadas contra qualquer estado em que seu diretório de trabalho esteja, incluindo alterações não confirmadas. Ative o toggle de worktree ao criar a tarefa para dar a cada execução seu próprio worktree Git isolado, da mesma forma que [sessões paralelas](/pt/desktop#work-in-parallel-with-sessions) funcionam. Por padrão, as tarefas agendadas são executadas contra qualquer estado em que seu diretório de trabalho esteja, incluindo alterações não confirmadas. Ative o toggle de worktree ao criar a tarefa para dar a cada execução seu próprio worktree Git isolado, da mesma forma que [sessões paralelas](/docs/pt/desktop#work-in-parallel-with-sessions) funcionam.
37</Note>37</Note>
38 38
39<h2 id="create-a-scheduled-task">39<h2 id="create-a-scheduled-task">
75 75
76Quando uma tarefa é acionada, você recebe uma notificação da área de trabalho e uma nova sessão aparece em uma seção **Scheduled** na barra lateral. Abra-a para ver o que Claude fez, revisar alterações ou responder a prompts de permissão. A sessão funciona como qualquer outra: Claude pode editar arquivos, executar comandos, criar commits e abrir pull requests.76Quando uma tarefa é acionada, você recebe uma notificação da área de trabalho e uma nova sessão aparece em uma seção **Scheduled** na barra lateral. Abra-a para ver o que Claude fez, revisar alterações ou responder a prompts de permissão. A sessão funciona como qualquer outra: Claude pode editar arquivos, executar comandos, criar commits e abrir pull requests.
77 77
7878As tarefas só são executadas enquanto o aplicativo desktop está em execução e seu computador está acordado. Se seu computador dormir durante um horário agendado, a execução é ignorada. Para evitar suspensão por inatividade, ative **Keep computer awake** em Settings em **Desktop app → General**. Fechar a tampa do laptop ainda o coloca em suspensão. Para tarefas que precisam ser executadas mesmo quando seu computador está desligado, ou que devem ser acionadas por uma chamada de API ou evento do GitHub, crie uma [routine](/pt/routines) remota.As tarefas só são executadas enquanto o aplicativo desktop está em execução e seu computador está acordado. Se seu computador dormir durante um horário agendado, a execução é ignorada. Para evitar suspensão por inatividade, ative **Keep computer awake** em Settings em **Desktop app → General**. Fechar a tampa do laptop ainda o coloca em suspensão. Para tarefas que precisam ser executadas mesmo quando seu computador está desligado, ou que devem ser acionadas por uma chamada de API ou evento do GitHub, crie uma [routine](/docs/pt/routines) remota.
79 79
80<h2 id="missed-runs">80<h2 id="missed-runs">
81 Execuções perdidas81 Execuções perdidas
93 93
94Para evitar travamentos, clique em **Run now** após criar uma tarefa, observe prompts de permissão e selecione "always allow" para cada um. Execuções futuras dessa tarefa aprovam automaticamente as mesmas ferramentas sem solicitar. Você pode revisar e revogar essas aprovações na página de detalhes da tarefa.94Para evitar travamentos, clique em **Run now** após criar uma tarefa, observe prompts de permissão e selecione "always allow" para cada um. Execuções futuras dessa tarefa aprovam automaticamente as mesmas ferramentas sem solicitar. Você pode revisar e revogar essas aprovações na página de detalhes da tarefa.
95 95
9696As ferramentas do Connector [que sua organização definiu como `ask`](/pt/mcp#organization-controls-on-connector-tools) e as ferramentas MCP marcadas como [`requiresUserInteraction`](/pt/mcp#require-approval-for-a-specific-tool) solicitam confirmação a cada chamada e não oferecem uma opção de sempre permitir. Execuções que chamam essas ferramentas ficam travadas cada vez.As ferramentas do Connector [que sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) e as ferramentas MCP marcadas como [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) solicitam confirmação a cada chamada e não oferecem uma opção de sempre permitir. Execuções que chamam essas ferramentas ficam travadas cada vez.
97 97
98<h2 id="manage-scheduled-tasks">98<h2 id="manage-scheduled-tasks">
99 Gerenciar tarefas agendadas99 Gerenciar tarefas agendadas
112 112
113Uma tarefa agendada também pode modificar seu próprio agendamento ou prompt dentro de uma sessão em execução usando a ferramenta MCP `update_scheduled_task`. Isso permite que uma tarefa se reagende com base no que encontra, por exemplo, reagendando uma análise de código para ser executada mais cedo quando detecta que um branch de release foi criado.113Uma tarefa agendada também pode modificar seu próprio agendamento ou prompt dentro de uma sessão em execução usando a ferramenta MCP `update_scheduled_task`. Isso permite que uma tarefa se reagende com base no que encontra, por exemplo, reagendando uma análise de código para ser executada mais cedo quando detecta que um branch de release foi criado.
114 114
115115Para editar o prompt de uma tarefa no disco, abra `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (ou em [`CLAUDE_CONFIG_DIR`](/pt/env-vars) se definido). O arquivo usa frontmatter YAML para `name` e `description`, com o prompt como corpo. As alterações entram em vigor na próxima execução. Schedule, pasta, modelo e estado habilitado não estão neste arquivo: altere-os através do formulário Edit ou peça ao Claude.Para editar o prompt de uma tarefa no disco, abra `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (ou em [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars) se definido). O arquivo usa frontmatter YAML para `name` e `description`, com o prompt como corpo. As alterações entram em vigor na próxima execução. Schedule, pasta, modelo e estado habilitado não estão neste arquivo: altere-os através do formulário Edit ou peça ao Claude.
116 116
117<h2 id="related-resources">117<h2 id="related-resources">
118 Recursos relacionados118 Recursos relacionados
119</h2>119</h2>
120 120
121121* [Routines](/pt/routines): execute tarefas na infraestrutura gerenciada pela Anthropic em um agendamento, via chamada de API ou em resposta a eventos do GitHub, mesmo quando seu computador está desligado* [Routines](/docs/pt/routines): execute tarefas na infraestrutura gerenciada pela Anthropic em um agendamento, via chamada de API ou em resposta a eventos do GitHub, mesmo quando seu computador está desligado
122122* [Run prompts on a schedule](/pt/scheduled-tasks): agendamento com escopo de sessão com `/loop` na CLI* [Run prompts on a schedule](/docs/pt/scheduled-tasks): agendamento com escopo de sessão com `/loop` na CLI
123123* [Claude Code GitHub Actions](/pt/github-actions): execute Claude em um agendamento em CI em vez de em sua máquina* [Claude Code GitHub Actions](/docs/pt/github-actions): execute Claude em um agendamento em CI em vez de em sua máquina
124124* [Use Claude Code Desktop](/pt/desktop): o guia completo do aplicativo Desktop* [Use Claude Code Desktop](/docs/pt/desktop): o guia completo do aplicativo Desktop