Come eseguire più agenti di coding IA in parallelo con i git worktree

Uno dei cambiamenti più grandi nello sviluppo assistito dall'IA nel corso del 2026 è che non punti più un singolo agente su un singolo task. Strumenti come Claude Code e Cursor ora incoraggiano a eseguire diversi agenti in parallelo — uno che corregge un bug, un altro che scrive test, un terzo che abbozza una funzionalità. L'insidia: se modificano tutti la stessa working directory, si sovrascrivono le modifiche a vicenda e corrompono la build.

La soluzione pulita è una vecchia funzionalità di Git che si rivela la primitiva perfetta per questo: i worktree.

Cos'è davvero un worktree

Normalmente un repository Git ha una sola working directory — la cartella in cui modifichi i file. git worktree permette a un repository di avere più working directory contemporaneamente, ciascuna con il checkout di un branch diverso, tutte che condividono la stessa storia .git sottostante. Ogni worktree è una vera cartella su disco con i propri file, così un agente che lavora in una non può toccare i file in un'altra.

Pensalo come dare a ogni agente la propria scrivania nello stesso ufficio, invece di tre persone che litigano per una sola tastiera.

Il workflow di base

Dall'interno del tuo repository, crea un worktree per ogni task sul suo branch:

# Create a new branch + folder for an auth bug fix
git worktree add ../myapp-auth-fix -b fix/auth-bug

# Another for a feature, in parallel
git worktree add ../myapp-search -b feat/search

# See everything you have checked out
git worktree list

Ora hai due cartelle gemelle accanto al tuo repository principale: myapp-auth-fix e myapp-search. Apri una sessione di agente separata in ciascuna — cd ../myapp-auth-fix e avvia lì Claude Code, poi fai lo stesso in ../myapp-search in un'altra scheda del terminale. Ogni agente ha un checkout completo e indipendente. Girano nello stesso momento, committano sui propri branch e non collidono mai.

Quando un task è finito, fai il merge del suo branch e rimuovi il worktree per tenere tutto in ordine:

git checkout main
git merge fix/auth-bug
git worktree remove ../myapp-auth-fix

Un esempio concreto

Diciamo che stai costruendo una piccola web app e hai tre lavori indipendenti: correggere un redirect di login instabile, aggiungere la paginazione a una lista e aggiornare una dipendenza lenta. Invece di farli uno alla volta:

git worktree add ../app-login   -b fix/login-redirect
git worktree add ../app-paging  -b feat/pagination
git worktree add ../app-deps    -b chore/upgrade-deps

Avvia un agente in ogni cartella con un prompt mirato. Mentre l'agente del login traccia la logica del redirect, l'agente della paginazione sta già scrivendo i componenti, e l'agente delle dipendenze sta eseguendo l'aggiornamento e la suite di test. Venti minuti dopo rivedi tre branch separati e puliti e fai il merge di quelli che passano.

Consigli che lo tengono gestibile

• Mantieni i task indipendenti. I worktree prevengono i conflitti tra file, ma se due agenti modificano gli stessi file su branch diversi, alla fine incapperai comunque in conflitti di merge. Suddividi il lavoro lungo cuciture naturali.
• Dai a ogni worktree lo stesso contesto. Un file CLAUDE.md (o file di regole equivalente) committato nel tuo repository viaggia automaticamente in ogni worktree, così ogni agente eredita le tue convenzioni.
• Attenzione alle cartelle delle dipendenze. node_modules, gli ambienti virtuali e le cache di build non sono condivisi tra worktree. Potresti dover eseguire npm install una volta per worktree, o usare un gestore di pacchetti con uno store globale (pnpm, uv) per evitare di riscaricare tutto.
• Non parallelizzare troppo. In pratica, da tre a cinque agenti concorrenti è il punto ideale. Oltre, il tempo che spendi a rivedere e coordinare supera la velocità che guadagni.

Le integrazioni native dei worktree sono arrivate nei principali strumenti dalla fine del 2025, e ora esistono launcher dedicati che ti avviano le sessioni. Ma non te ne serve nessuno per iniziare — git worktree add è integrato in Git, funziona già oggi ed è il modo singolarmente più affidabile per far costruire diversi agenti IA per te in una volta sola senza che si intralcino a vicenda.