---
title: "Agenti di coding di notte: sandbox, git, tetto ai costi"
description: "Configurazione pratica per agenti di coding senza supervisione: sandbox, checkpoint git, file di task, limiti di passi, revisione al mattino e sessioni flat."
url: https://broadrouter.com/it/blog/overnight-coding-agent-runs/
lang: it
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/blog/overnight-coding-agent-runs/) (aggiornato il 2026-11-16).

# Come far lavorare gli agenti di coding di notte, in sicurezza

A cura del team di BroadNet Inference · 5 min di lettura · Pubblicato 2026-11-14 · Aggiornato 2026-11-16

Esegui l’agente in un container o in una VM con montato solo il repository, su un branch git dedicato, con un commit dopo ogni passo completato. Dagli un file di task scritto, un limite di passi e una scadenza oraria, poi rivedi il branch al mattino. Una sessione a piano flat, come Full Moon di BroadNet a $60, fissa la bolletta nel caso peggiore.

## Punti chiave

-   Prima la sandbox: un container o una VM con montato solo il repo e nessuna credenziale di produzione.
-   Un branch o un git worktree per agente, con un commit dopo ogni passo, rende ogni modifica revisionabile e reversibile.
-   Un file di task con una definizione chiara di "finito" funziona meglio di un prompt di una riga.
-   Limiti di passi, una scadenza e un controllo delle ripetizioni fermano le esecuzioni bloccate prima del mattino.
-   Una sessione a piano non ha contatore di token, quindi una notte di lavoro di un agente costa il prezzo del piano qualunque sia il numero di token.

**In questa pagina**

1.  1\. Come si mette in sandbox un agente senza supervisione?
2.  2\. Perché dare a ogni agente il suo branch?
3.  3\. Che cosa va nel file di task?
4.  4\. Quali protezioni fermano un agente bloccato?
5.  5\. Di notte conviene una sessione a piano o la fatturazione per token?
6.  6\. Come si rivede l’esecuzione al mattino?
7.  Come si prova in sicurezza la prima notte?

Gli agenti di coding sono bravi nei lavori lunghi, ben definiti e noiosi: aggiungere test a cinquanta moduli, migrare ogni chiamata a una nuova API, correggere mille warning del linter. Questo tipo di lavoro non ha bisogno che tu stia a guardare. Ha bisogno di un posto sicuro in cui girare, di un task chiaro, di protezioni contro i blocchi e di un modo per rivedere il risultato davanti a un caffè.

Questa è una checklist per configurare tutto questo.

## 1\. Come si mette in sandbox un agente senza supervisione?

Un agente senza supervisione esegue comandi shell che nessuno approva. Dai per scontato che prima o poi eseguirà qualcosa che tu non avresti eseguito: cancellare la directory sbagliata, installare un pacchetto, fare push su un remote. Contienilo.

-   **Un container o una VM**, non l’utente principale del tuo laptop. La [documentazione sulla sicurezza](https://docs.docker.com/engine/security/) di Docker descrive i controlli; come minimo esegui come utente non root e togli le capability che non ti servono.
-   **Monta solo il repository.** Niente home directory, niente chiavi SSH, niente credenziali cloud, niente `~/.config` piena di token.
-   **Nessun segreto di produzione.** Usa database di test e chiavi API fittizie. Se l’agente ha bisogno di un servizio reale, dagli una chiave con permessi limitati e revocabile.
-   **Limita la rete.** All’agente servono l’API del modello e forse un registro di pacchetti. Raramente gli serve altro.
-   **Niente diritti di push.** Lascia che faccia commit in locale. Il push lo fai tu dopo la revisione.

La chiave API del modello è l’unica credenziale che l’agente deve avere. Usa una chiave creata apposta e, se il provider lo supporta, limitala all’IP di uscita della sandbox. Le chiavi BroadNet supportano [IP allow-list](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/) fino a 32 voci, quindi una chiave trafugata è inutilizzabile da qualsiasi altro posto.

## 2\. Perché dare a ogni agente il suo branch?

Lavora su un branch dedicato, mai su `main`. Se esegui più di un agente, dai a ciascuno la sua directory di lavoro con [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
```

Ogni worktree è un checkout separato dello stesso repository, quindi gli agenti non si sovrascrivono i file a vicenda, e ogni branch mostra esattamente che cosa ha fatto un agente.

Poi **fai un commit dopo ogni passo completato.** Aider lo fa di default. Per altri agenti, aggiungilo alle istruzioni oppure avvolgi il ciclo in modo che parta un commit ogni volta che i test passano. Una cronologia di piccoli commit trasforma “l’agente ha rotto qualcosa alle 3 di notte” in “l’ha rotto il commit 14; tieni dall’1 al 13”.

## 3\. Che cosa va nel file di task?

Un prompt di una riga che funziona in modo interattivo fallisce di notte, perché non c’è nessuno a rispondere alla prima domanda dell’agente. Scrivi un file di task:

```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.
```

La sezione “done when” è la parte importante. Dà all’agente un modo per sapere di aver finito, e dà a te un modo per verificarlo. Il file di note fa anche da memoria se l’esecuzione riparte o se il contesto viene compattato; vedi [gestione del contesto per agenti a lunga esecuzione](https://broadrouter.com/it/blog/long-running-agent-context-management/).

## 4\. Quali protezioni fermano un agente bloccato?

Senza supervisione significa che nessuno si accorge di un agente bloccato fino al mattino. Quattro protezioni:

1.  **Limite di passi.** Un numero massimo fisso di chiamate al modello per task.
2.  **Scadenza.** Fermati a un’ora precisa, per esempio le 07:00, qualunque sia lo stato.
3.  **Rilevamento delle ripetizioni.** Fermati quando la stessa chiamata a un tool restituisce lo stesso risultato tre volte, o quando nessun file cambia per un certo numero di passi.
4.  **Timeout per tool.** Una suite di test bloccata non deve bloccare la notte.

Quando scatta una protezione, l’agente dovrebbe scrivere il motivo nel file di note e uscire in modo pulito. Perché i limiti di passi e di retry contano per il costo è spiegato in [limita i passi per attività](https://broadrouter.com/it/blog/cut-coding-agent-llm-costs/) nella guida ai costi degli agenti di coding.

Aider si presta bene a questo uso: la sua [documentazione sullo scripting](https://aider.chat/docs/scripting.html) mostra l’opzione `--message` per eseguire un’istruzione e uscire, e `--yes-always` per accettare automaticamente le conferme. Avvolgilo in un ciclo shell su un elenco di task, con `timeout` attorno a ogni esecuzione, e hai una semplice coda notturna.

## 5\. Di notte conviene una sessione a piano o la fatturazione per token?

Le esecuzioni notturne cambiano la domanda sui costi. Nessuno guarda il contatore, e un agente bloccato può girare a vuoto per ore.

**Con una chiave a consumo per token**, il costo dipende da quanto invia l’agente. Gli agenti reinviano il contesto a ogni passo, quindi un’esecuzione di otto ore si fa sentire. Il prompt caching aiuta molto (l’input in cache su [DeepSeek V4.1 Flash](https://broadrouter.com/it/models/deepseek-v4.1-flash/) costa $0.0055 per 1M di token contro $0.175 per l’input nuovo), ma i token di output e di ragionamento si pagano per intero. Ti servono un budget di token per esecuzione e un limite di spesa sull’account.

**Con una sessione a piano**, non c’è contatore di token. Una sessione Full Moon costa $60 al mese per DeepSeek V4.1 Flash illimitato, e quello è il tetto, per quanto a lungo giri l’agente o per quanto giri a vuoto. Per il lavoro notturno è il vantaggio principale: la bolletta nel caso peggiore è nota prima di andare a dormire.

|  | Chiave per token | Sessione a piano |
| --- | --- | --- |
| Costo nel caso peggiore di una notte bloccata | Cresce con i token | Fisso al prezzo del piano |
| Agenti in parallelo | Fino a 4 richieste in corso per chiave a consumo | Una richiesta alla volta per sessione |
| Modelli | Tutti i modelli chat | Solo DeepSeek V4.1 Flash |
| Protezioni ancora necessarie | Sì, per costi e tempi | Sì, per i tempi |

Due note pratiche sulle sessioni. Una sessione esegue una richiesta alla volta, quindi due agenti che condividono una sessione fanno a turno; i task su una sessione girano in sequenza, il che di notte spesso va bene. Se vuoi agenti che girano fianco a fianco, compra una sessione per agente. [Agenti in parallelo su un’API flat](https://broadrouter.com/it/blog/run-parallel-coding-agents-flat-rate/) fa i conti.

Alla velocità tipica di circa 100 token al secondo, una sessione può produrre circa 259 milioni di token di output in un mese di uso continuo. Se questo batta il prezzo per token dipende dai tuoi volumi; l’esempio di BroadNet di un agente di coding a tempo pieno arriva a circa $65.40 al mese a consumo. Fai i tuoi conti con il [calcolatore flat vs per token](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/). Le lunghe esecuzioni senza supervisione richiedono anche disciplina sul contesto e retry che sopravvivano a un crash: vedi [timeout, retry e checkpoint](https://broadrouter.com/it/blog/long-running-agents-timeouts-retries/).

## 6\. Come si rivede l’esecuzione al mattino?

Il valore di un’esecuzione notturna si realizza solo al momento della revisione. Rendila veloce:

1.  **Leggi prima NOTES.md.** Che cosa ha finito l’agente, che cosa ha saltato e dove si è bloccato?
2.  **Controlla il motivo dell’arresto.** Finito, limite di passi, scadenza o ripetizione?
3.  **Esegui i test tu stesso.** Non fidarti del resoconto dell’agente sui test verdi.
4.  **Leggi il diff commit per commit.** I commit piccoli rendono facile individuare e scartare le modifiche sbagliate.
5.  **Fai squash o rebase di ciò che tieni**, poi apri una normale pull request.

Quasi tutte le mattine terrai gran parte del lavoro e sistemerai a mano qualche commit. Nelle mattine storte cancelli un branch. In ogni caso, nulla ha toccato `main` senza di te.

## Come si prova in sicurezza la prima notte?

Inizia con un task ben specificato, un agente e una sessione. Un’ora di Meteor ($1) basta per verificare che sandbox, branch e protezioni funzionino prima di lasciare qualcosa acceso tutta la notte. Per l’agente, la [guida ad Aider](https://broadrouter.com/it/guides/aider-unlimited-deepseek/) contiene le impostazioni di connessione esatte, [il miglior modello aperto per gli agenti di coding](https://broadrouter.com/it/blog/best-open-model-for-coding-agents/) ti aiuta a scegliere il modello e [come funzionano le sessioni a piano](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) spiega chiavi e sessioni.

Strumenti gratuiti sul tema (in inglese)

-   [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.

[Strumenti gratuiti (in inglese)](https://broadrouter.com/tools/)

## Termini in questo articolo

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

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Timeout della richiesta (request timeout)](https://broadrouter.com/it/glossary/request-timeout/)

Il timeout di una richiesta è il tempo massimo che un client HTTP aspetta un server prima di abbandonare la richiesta. I client di solito lo dividono in un timeout di connessione, per aprire la connessione, e un timeout di lettura, per l’attesa dei dati. Le chiamate LLM richiedono timeout di lettura generosi perché le risposte lunghe richiedono tempo.

[Token di input e di output](https://broadrouter.com/it/glossary/input-and-output-tokens/)

I token di input sono quelli che un modello linguistico legge in una richiesta: system prompt, cronologia, definizioni degli strumenti e immagini. I token di output sono quelli che genera in risposta, ragionamento compreso. Le API LLM di solito li prezzano separatamente, e l’output costa di più.

[Token di input in cache (cached input)](https://broadrouter.com/it/glossary/cached-input-tokens/)

I token di input in cache sono token del prompt che un provider LLM ha elaborato da poco e può riusare da una cache invece di ricalcolarli, di solito un prefisso ripetuto come un system prompt o un documento. I provider li fatturano a una tariffa più bassa dei token di input nuovi.

[Agente di coding AI (AI coding agent)](https://broadrouter.com/it/glossary/coding-agent/)

Un agente di coding AI è uno strumento software in cui un modello linguistico lavora su una codebase in un ciclo: legge file, li modifica, esegue comandi come i test, legge l’output e decide il passo successivo finché il compito è finito o si raggiunge un limite.

[Chiave API (API key)](https://broadrouter.com/it/glossary/api-key/)

Una chiave API è una stringa segreta che identifica e autorizza un client che chiama un’API. Le API LLM di solito la vogliono in un header Authorization: Bearer, e chiunque possieda la chiave può fare richieste fatturate all’account a cui appartiene.

## Domande frequenti

### È sicuro lasciare che un agente esegua comandi shell senza supervisione?

Solo dentro una sandbox che sei disposto a buttare via. Monta il repository, tieni fuori segreti e credenziali di produzione e limita l’accesso alla rete a ciò che serve al task.

### Quanti task notturni regge una sessione a piano?

Una sessione esegue una richiesta alla volta, quindi i task sulla stessa sessione girano uno dopo l’altro. Mettili in coda in sequenza su una sessione, oppure compra una sessione per ogni agente che vuoi far girare in parallelo.

### E se l’agente rompe la build durante la notte?

Niente arriva sul branch principale senza revisione. Con un commit per passo vedi esattamente dove è andato storto e tieni i commit buoni precedenti.

### Quali task sono adatti alle esecuzioni notturne?

Lavori ben specificati e verificabili con i test, come migrare le chiamate a una nuova API, aggiungere test a moduli che non ne hanno, correggere il lint in tutta la codebase o aggiornare le dipendenze. Il lavoro di design aperto è meglio farlo con una persona nel ciclo.

## Continua a leggere

-   [10 modi per ridurre i costi LLM degli agenti di coding, con i risparmi](https://broadrouter.com/it/blog/cut-coding-agent-llm-costs/)
-   [Come far girare agenti di coding in parallelo con un’API LLM flat](https://broadrouter.com/it/blog/run-parallel-coding-agents-flat-rate/)
-   [Contesto degli agenti a lungo termine con una finestra da 1M](https://broadrouter.com/it/blog/long-running-agent-context-management/)
-   [API LLM a tariffa flat o a consumo per token: i conti del pareggio](https://broadrouter.com/it/blog/flat-rate-vs-pay-per-token-llm-api/)
-   [Prompt injection negli agenti di coding: le difese che reggono](https://broadrouter.com/it/blog/prompt-injection-coding-agents/)
-   [Costo di un’esecuzione di un agente di coding: passi, contesto, cache](https://broadrouter.com/it/blog/ai-coding-agent-run-cost/)
-   [Claude Code con modelli open-weight: proxy, endpoint nativi e limiti](https://broadrouter.com/it/blog/claude-code-with-openai-compatible-models/)
-   [Guida: Usare Aider con DeepSeek V4.1 Flash illimitato](https://broadrouter.com/it/guides/aider-unlimited-deepseek/)
-   [Guida: Come funzionano i piani API LLM illimitati per gli agenti](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/)
-   [Guida: Limita le chiavi API ai tuoi server con le allowlist di IP](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/)

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

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

**Fonti**

-   [Documentazione Docker, sicurezza di Docker Engine](https://docs.docker.com/engine/security/)
-   [Documentazione di Git, git-worktree](https://git-scm.com/docs/git-worktree)
-   [Documentazione di Aider, scripting di aider](https://aider.chat/docs/scripting.html)
-   [Piani illimitati di BroadNet Inference (in inglese)](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-blog-overnight-coding-agent-runs&utm_content=sources)
