---
title: "Agentes de código de madrugada: sandbox, git, teto de custo"
description: "Configuração prática para agentes de código sem supervisão: sandbox, checkpoints no git, arquivo de tarefa, limite de passos, revisão de manhã e plano fixo."
url: https://broadrouter.com/pt/blog/overnight-coding-agent-runs/
lang: pt-BR
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/blog/overnight-coding-agent-runs/) (atualizado em 2026-11-16).

# Como rodar agentes de código à noite sem supervisão, com segurança

Pela equipe da BroadNet Inference · 5 min de leitura · Publicado em 2026-11-14 · Atualizado em 2026-11-16

Rode o agente em um contêiner ou VM com só o repositório montado, no próprio branch git, com um commit a cada passo concluído. Dê a ele um arquivo de tarefa escrito, um limite de passos e um horário de parada, e revise o branch de manhã. Uma sessão de plano fixo, como o Full Moon da BroadNet a $60, trava a conta no pior caso.

## Pontos principais

-   Sandbox primeiro: um contêiner ou VM com só o repositório montado e nenhuma credencial de produção.
-   Um branch ou git worktree por agente, com um commit depois de cada passo, deixa toda mudança revisável e reversível.
-   Um arquivo de tarefa com uma definição clara de "pronto" funciona melhor que um prompt de uma linha.
-   Limite de passos, horário de parada e detecção de repetição param execuções travadas antes de amanhecer.
-   Uma sessão de plano não tem medidor de tokens, então uma noite de trabalho do agente custa o preço do plano, qualquer que seja a contagem de tokens.

**Nesta página**

1.  1\. Como colocar em sandbox um agente sem supervisão?
2.  2\. Por que dar a cada agente o próprio branch?
3.  3\. O que vai no arquivo de tarefa?
4.  4\. Que proteções param um agente travado?
5.  5\. De madrugada, sai mais barato uma sessão de plano ou cobrança por token?
6.  6\. Como revisar a execução de manhã?
7.  Como testar com segurança na primeira noite?

Agentes de código são bons em trabalho longo, bem definido e tedioso: adicionar testes a cinquenta módulos, migrar todas as chamadas para uma nova API, corrigir mil avisos de lint. Esse tipo de trabalho não precisa de você assistindo. Precisa de um lugar seguro para rodar, de uma tarefa clara, de proteções contra travamentos e de um jeito de revisar o resultado tomando um café.

Este é um checklist para montar isso.

## 1\. Como colocar em sandbox um agente sem supervisão?

Um agente sem supervisão roda comandos de shell que ninguém aprova. Parta do princípio de que, em algum momento, ele vai rodar algo que você não rodaria: apagar o diretório errado, instalar um pacote, fazer push para um remoto. Contenha o agente.

-   **Um contêiner ou VM**, não a conta de usuário principal do seu notebook. A [documentação de segurança](https://docs.docker.com/engine/security/) do Docker cobre os controles; no mínimo, rode como usuário não root e remova as capabilities de que não precisa.
-   **Monte só o repositório.** Nada de diretório home, chaves SSH, credenciais de nuvem ou um `~/.config` cheio de tokens.
-   **Nenhum segredo de produção.** Use bancos de teste e chaves de API fictícias. Se o agente precisar de um serviço real, dê a ele uma chave com escopo limitado e revogável.
-   **Limite a rede.** O agente precisa da API do modelo e talvez de um registro de pacotes. Raramente precisa de mais alguma coisa.
-   **Sem permissão de push.** Deixe-o fazer commits localmente. Você faz o push depois de revisar.

A chave de API do modelo é a única credencial que o agente precisa ter. Use uma chave criada para esse fim e, se o provedor permitir, restrinja-a ao IP de saída da sandbox. As chaves da BroadNet aceitam [allow-lists de IP](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/) com até 32 entradas, então uma chave vazada não serve para nada fora dali.

## 2\. Por que dar a cada agente o próprio branch?

Trabalhe em um branch dedicado, nunca no `main`. Se você roda mais de um agente, dê a cada um seu próprio diretório de trabalho com [git worktree](https://git-scm.com/docs/git-worktree):

```bash
git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes
```

Cada worktree é um checkout separado do mesmo repositório, então os agentes não sobrescrevem os arquivos uns dos outros, e cada branch mostra exatamente o que um agente fez.

Depois, **faça um commit a cada passo concluído.** O Aider faz isso por padrão. Para outros agentes, coloque isso nas instruções ou envolva o loop para que um commit aconteça sempre que os testes passarem. Um histórico de commits pequenos transforma “o agente quebrou alguma coisa às 3 da manhã” em “o commit 14 quebrou; fique com do 1 ao 13”.

## 3\. O que vai no arquivo de tarefa?

Um prompt de uma linha que funciona de forma interativa falha de madrugada, porque não há ninguém para responder à primeira pergunta do agente. Escreva um arquivo de tarefa:

```markdown
# Task: add unit tests to src/billing/

## Goal
Every public function in src/billing/ has at least one unit test.

## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit

## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.

## Notes
Append decisions and skipped items to NOTES.md as you go.
```

A seção “done when” é a parte importante. Ela dá ao agente um jeito de saber que terminou e dá a você um jeito de conferir. O arquivo de notas também serve de memória se a execução reiniciar ou se o contexto for compactado; veja [gestão de contexto para agentes de longa duração](https://broadrouter.com/pt/blog/long-running-agent-context-management/).

## 4\. Que proteções param um agente travado?

Sem supervisão significa que ninguém percebe um agente travado até de manhã. Quatro proteções:

1.  **Limite de passos.** Um número máximo fixo de chamadas ao modelo por tarefa.
2.  **Horário de parada.** Pare em um horário definido, por exemplo 07:00, qualquer que seja o estado.
3.  **Detecção de repetição.** Pare quando a mesma chamada de ferramenta devolver o mesmo resultado três vezes, ou quando nenhum arquivo mudar por um número definido de passos.
4.  **Timeouts por ferramenta.** Uma suíte de testes travada não deve travar a noite.

Quando uma proteção dispara, o agente deve escrever o motivo no arquivo de notas e sair de forma limpa. Por que limites de passos e de novas tentativas importam para o custo é explicado em [limite os passos por tarefa](https://broadrouter.com/pt/blog/cut-coding-agent-llm-costs/), no guia de custos de agentes de código.

O Aider é fácil de rodar assim: a [documentação de scripting](https://aider.chat/docs/scripting.html) mostra a opção `--message` para executar uma instrução e sair, e `--yes-always` para aceitar as confirmações automaticamente. Coloque isso em um loop de shell sobre uma lista de tarefas, com `timeout` em volta de cada execução, e você tem uma fila noturna simples.

## 5\. De madrugada, sai mais barato uma sessão de plano ou cobrança por token?

Execuções noturnas mudam a pergunta sobre custo. Ninguém está olhando o medidor, e um agente travado pode ficar em loop por horas.

**Em uma chave cobrada por token**, o custo depende de quanto o agente envia. Agentes reenviam o contexto a cada passo, então uma execução de oito horas pesa. O cache de prompt ajuda muito (a entrada em cache no [DeepSeek V4.1 Flash](https://broadrouter.com/pt/models/deepseek-v4.1-flash/) custa $0.0055 por 1M de tokens, contra $0.175 para entrada nova), mas tokens de saída e de raciocínio são cobrados integralmente. Você precisa de um orçamento de tokens por execução e de um limite de gasto na conta.

**Em uma sessão de plano**, não há medidor de tokens. Uma sessão Full Moon custa $60 por mês para DeepSeek V4.1 Flash ilimitado, e esse é o teto, por mais que o agente rode ou fique em loop. Para trabalho noturno, essa é a principal vantagem: a conta no pior caso é conhecida antes de você ir dormir.

|  | Chave por token | Sessão de plano |
| --- | --- | --- |
| Custo no pior caso de uma noite travada | Cresce com os tokens | Fixo no preço do plano |
| Agentes em paralelo | Até 4 requisições simultâneas por chave de pagamento por uso | Uma requisição por vez por sessão |
| Modelos | Todos os modelos de chat | Só DeepSeek V4.1 Flash |
| Proteções ainda necessárias | Sim, para custo e tempo | Sim, para tempo |

Duas observações práticas sobre sessões. Uma sessão roda uma requisição por vez, então dois agentes dividindo uma sessão se revezam; tarefas em uma sessão rodam em sequência, o que de madrugada muitas vezes não é problema. Se você quer agentes rodando lado a lado, compre uma sessão por agente. [Agentes em paralelo em uma API de preço fixo](https://broadrouter.com/pt/blog/run-parallel-coding-agents-flat-rate/) faz as contas.

Na velocidade típica de cerca de 100 tokens por segundo, uma sessão pode produzir cerca de 259 milhões de tokens de saída em um mês de uso contínuo. Se isso sai melhor que o preço por token para você depende do volume; o exemplo da BroadNet de um agente de código em tempo integral dá cerca de $65.40 por mês no pagamento por uso. Faça suas contas na [calculadora de preço fixo vs. por token](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/). Execuções longas sem supervisão também exigem disciplina de contexto e novas tentativas que sobrevivam a uma queda: veja [timeouts, novas tentativas e checkpoints](https://broadrouter.com/pt/blog/long-running-agents-timeouts-retries/).

## 6\. Como revisar a execução de manhã?

O valor de uma execução noturna só aparece na hora da revisão. Faça-a ser rápida:

1.  **Leia primeiro o NOTES.md.** O que o agente terminou, pulou e onde travou?
2.  **Confira o motivo da parada.** Concluído, limite de passos, horário de parada ou repetição?
3.  **Rode os testes você mesmo.** Não confie no relato do agente de que os testes passaram.
4.  **Leia o diff por commit.** Commits pequenos facilitam achar e descartar mudanças ruins.
5.  **Faça squash ou rebase do que você mantiver** e abra um pull request normal.

Na maioria das manhãs você vai manter quase todo o trabalho e corrigir alguns commits à mão. Nas manhãs ruins, você apaga um branch. De qualquer forma, nada tocou o `main` sem você.

## Como testar com segurança na primeira noite?

Comece com uma tarefa bem especificada, um agente e uma sessão. Uma hora do Meteor ($1) basta para conferir se a sandbox, o branch e as proteções funcionam antes de deixar algo rodando a noite toda. Para o agente em si, o [guia do Aider](https://broadrouter.com/pt/guides/aider-unlimited-deepseek/) traz as configurações exatas de conexão, [o melhor modelo aberto para agentes de código](https://broadrouter.com/pt/blog/best-open-model-for-coding-agents/) ajuda a escolher o modelo e [como funcionam as sessões de plano](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) explica chaves e sessões.

Ferramentas gratuitas sobre o tema (em inglês)

-   [Agent run cost estimator](https://broadrouter.com/tools/agent-run-cost-estimator/) Context growth per step, total tokens and cost of one agent run, with a DeepSeek session comparison.
-   [LLM batch job planner](https://broadrouter.com/tools/llm-batch-job-planner/) Run time, binding limit, cost per model and the flat sessions needed to finish a big job by a deadline.
-   [Flat-rate vs per-token LLM cost calculator](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) Break-even between an unlimited plan and paying per token, per agent.
-   [LLM rate limit and concurrency calculator](https://broadrouter.com/tools/llm-rate-limit-calculator/) Which limit binds first: RPM, TPM or concurrency, with Little's law.

[Ferramentas gratuitas (em inglês)](https://broadrouter.com/tools/)

## Termos neste artigo

[Token](https://broadrouter.com/pt/glossary/token/)

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Timeout de requisição (request timeout)](https://broadrouter.com/pt/glossary/request-timeout/)

Timeout de requisição é o tempo máximo que um cliente HTTP espera por um servidor antes de abandonar a requisição. Os clientes costumam dividi-lo em timeout de conexão, para abrir a conexão, e timeout de leitura, para esperar os dados. Chamadas a LLMs precisam de timeouts de leitura generosos, porque respostas longas levam tempo.

[Tokens de entrada e de saída](https://broadrouter.com/pt/glossary/input-and-output-tokens/)

Tokens de entrada são os tokens que um modelo de linguagem lê em uma requisição, incluindo o system prompt, o histórico da conversa, as definições de ferramentas e as imagens. Tokens de saída são os que ele gera na resposta, incluindo o raciocínio. As APIs de LLM costumam cobrá-los separadamente, e a saída costuma custar mais.

[Tokens de entrada em cache (cached input)](https://broadrouter.com/pt/glossary/cached-input-tokens/)

Tokens de entrada em cache são tokens do prompt que um provedor de LLM processou há pouco e pode reaproveitar de um cache em vez de calcular de novo, normalmente um prefixo repetido, como um system prompt ou um documento. Os provedores os cobram com uma tarifa menor que a dos tokens de entrada novos.

[Agente de programação com IA (AI coding agent)](https://broadrouter.com/pt/glossary/coding-agent/)

Um agente de programação com IA é uma ferramenta de software em que um modelo de linguagem trabalha numa codebase em ciclo: lê arquivos, edita, roda comandos como os testes, lê a saída e decide o próximo passo até a tarefa terminar ou um limite ser atingido.

[Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/)

Uma chave de API é uma string secreta que identifica e autoriza um cliente que chama uma API. As APIs de LLM normalmente a esperam em um cabeçalho Authorization: Bearer, e qualquer pessoa que tenha a chave pode fazer requisições cobradas da conta dona dela.

## Perguntas frequentes

### É seguro deixar um agente rodar comandos de shell sem supervisão?

Só dentro de uma sandbox que você não se importa de jogar fora. Monte o repositório, deixe segredos e credenciais de produção de fora e limite o acesso à rede ao que a tarefa precisa.

### Quantas tarefas noturnas uma sessão de plano aguenta?

Uma sessão roda uma requisição por vez, então as tarefas em uma sessão rodam uma depois da outra. Enfileire-as em sequência em uma sessão ou compre uma sessão para cada agente que você quer rodando em paralelo.

### E se o agente quebrar o build durante a noite?

Nada chega ao seu branch principal sem revisão. Com um commit por passo, você vê exatamente onde deu errado e mantém os commits bons de antes desse ponto.

### Que tarefas combinam com execuções noturnas?

Trabalho bem especificado e testável, como migrar chamadas para uma nova API, adicionar testes a módulos sem testes, corrigir lint em toda a base de código ou atualizar dependências. Trabalho de design em aberto é melhor fazer com uma pessoa no loop.

## Continue lendo

-   [10 formas de reduzir o custo de LLM de agentes de código, com economia](https://broadrouter.com/pt/blog/cut-coding-agent-llm-costs/)
-   [Como rodar agentes de código em paralelo numa API de LLM de preço fixo](https://broadrouter.com/pt/blog/run-parallel-coding-agents-flat-rate/)
-   [Gestão de contexto para agentes de longa duração com janela de 1M](https://broadrouter.com/pt/blog/long-running-agent-context-management/)
-   [API de LLM com preço fixo ou por token: a conta do ponto de equilíbrio](https://broadrouter.com/pt/blog/flat-rate-vs-pay-per-token-llm-api/)
-   [Prompt injection em agentes de código: defesas que funcionam](https://broadrouter.com/pt/blog/prompt-injection-coding-agents/)
-   [Custo de uma execução de agente de código: passos, contexto e cache](https://broadrouter.com/pt/blog/ai-coding-agent-run-cost/)
-   [Claude Code com modelos abertos: proxies, endpoints nativos e limites](https://broadrouter.com/pt/blog/claude-code-with-openai-compatible-models/)
-   [Guia: Rode o Aider no DeepSeek V4.1 Flash ilimitado](https://broadrouter.com/pt/guides/aider-unlimited-deepseek/)
-   [Guia: Como funcionam os planos de API de LLM ilimitada para agentes](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/)
-   [Guia: Restrinja chaves de API aos seus servidores com lista de IPs](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-overnight-coding-agent-runs&utm_content=page-cta) ·

**Fontes**

-   [Documentação do Docker, segurança do Docker Engine](https://docs.docker.com/engine/security/)
-   [Documentação do Git, git-worktree](https://git-scm.com/docs/git-worktree)
-   [Documentação do Aider, scripting do aider](https://aider.chat/docs/scripting.html)
-   [Planos ilimitados da BroadNet Inference (em inglês)](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-overnight-coding-agent-runs&utm_content=sources)
