Come eseguire più agenti IA sullo stesso repository (senza conflitti Git)
Far girare più agenti su un progetto richiede tre cose: una macchina che li ospita, una cartella che condividono, e una regola che decide chi scrive dove. Senza la terza, il secondo agente cancella il lavoro del primo senza che nulla lo segnali.
Passo dopo passo
- Crea il progetto. Un canvas avvia la propria macchina e un repository privato. È lì che vive la cartella condivisa, ed è la stessa per tutti gli agenti che aprirai in seguito.
- Collega i tuoi account. Collega l'abbonamento o la chiave API che paghi già presso Anthropic, OpenAI o un altro fornitore. Nessun token viene rivenduto, il consumo resta sul tuo account.
- Apri una finestra per agente. Claude Code, Codex, Kimi e OpenCode si aprono ciascuno nella propria finestra, con un vero terminale. Due finestre nel piano Solo, cinque nel Pro.
- Dividi per file, non per compito. Dai a ogni agente un angolo del progetto invece di un compito che attraversa tutto. Due agenti su due zone avanzano in parallelo, due agenti sullo stesso file si aspettano a vicenda.
- Lascia decidere la bacheca. Un agente riserva i percorsi che toccherà prima di scrivere, e il server li nega agli altri finché non li rilascia. Vedi chi tiene cosa, e chi aspetta.
Cosa avere a portata di mano
Un repository, anche vuoto, e un account presso un fornitore di modelli. Il resto lo fornisce il progetto: la macchina, la cartella e la bacheca che distribuisce i file.
Un file di istruzioni nella radice del repository cambia il risultato più di qualsiasi impostazione. Gli agenti lo leggono all'avvio, e risparmia a ognuno i primi cinque errori.
La suddivisione che funziona
L'unità giusta non è la funzionalità, è il file. Un agente sull'API, uno sull'interfaccia, uno sui test: si incrociano poco e quasi non si aspettano mai. Tre agenti sulla "pagina di pagamento" si contenderanno gli stessi tre file per un'ora intera.
Cosa guardi nel frattempo
I terminali scorrono nelle loro finestre, e la bacheca mostra chi tiene quale percorso. Un agente bloccato è visibile prima che faccia danni, il che è la vera differenza rispetto a una coda invisibile. Il meccanismo nel dettaglio.
Risposte dirette
Quanti agenti insieme sono utili?
Tanti quanti sono i cantieri indipendenti che il progetto ha in quel momento, il che fa due o tre per lo più e cinque su un grosso refactoring. Oltre quella soglia, gli agenti passano il tempo ad aspettare file invece di scrivere.
Serve un git worktree per agente?
È il metodo consigliato dalla maggior parte delle guide, e funziona: ogni agente riceve la propria copia di lavoro con il proprio indice, quindi nessuna collisione. Il costo è una fusione per copia, e un conflitto che si scopre alla fine. Su una cartella condivisa con prenotazione, non c'è nulla da unire perché non sono mai esistite due versioni vive.
Serve un branch per agente?
No, ed è proprio il punto. Un branch per agente sposta il conflitto verso la fusione, nel momento in cui nessuno ricorda più il ragionamento. Una cartella condivisa con una prenotazione risolve il conflitto nell'istante in cui si verifica.
Cosa succede se due agenti vogliono lo stesso file?
Il secondo aspetta. Lo vede a schermo, tu pure, e puoi dargli subito qualcos'altro da fare invece di scoprire il problema un'ora dopo.