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 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
~/.configpiena 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 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:
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:
# 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.
4. Quali protezioni fermano un agente bloccato?
Senza supervisione significa che nessuno si accorge di un agente bloccato fino al mattino. Quattro protezioni:
- Limite di passi. Un numero massimo fisso di chiamate al modello per task.
- Scadenza. Fermati a un’ora precisa, per esempio le 07:00, qualunque sia lo stato.
- 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.
- 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à nella guida ai costi degli agenti di coding.
Aider si presta bene a questo uso: la sua documentazione sullo scripting 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 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 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. Le lunghe esecuzioni senza supervisione richiedono anche disciplina sul contesto e retry che sopravvivano a un crash: vedi timeout, retry e checkpoint.
6. Come si rivede l’esecuzione al mattino?
Il valore di un’esecuzione notturna si realizza solo al momento della revisione. Rendila veloce:
- Leggi prima NOTES.md. Che cosa ha finito l’agente, che cosa ha saltato e dove si è bloccato?
- Controlla il motivo dell’arresto. Finito, limite di passi, scadenza o ripetizione?
- Esegui i test tu stesso. Non fidarti del resoconto dell’agente sui test verdi.
- Leggi il diff commit per commit. I commit piccoli rendono facile individuare e scartare le modifiche sbagliate.
- 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 contiene le impostazioni di connessione esatte, il miglior modello aperto per gli agenti di coding ti aiuta a scegliere il modello e come funzionano le sessioni a piano spiega chiavi e sessioni.
