Come eseguire più agenti Claude Code in parallelo

Un agente è utile. Tre agenti che lavorano su compiti separati mentre tu rivedi il diff del primo: è lì che gli agenti da terminale ripagano davvero. Ma è anche lì che le cose si rompono in fretta: due agenti che modificano lo stesso file, un dev server che litiga per una porta, o un limite di utilizzo raggiunto a metà pomeriggio.

Questa guida descrive una configurazione che evita questi problemi. Se preferisci che sia un agente a dividere il lavoro e a rivederlo al posto tuo, leggi Gestire un team di agenti AI per programmare. Funziona con Claude Code, Codex, Gemini CLI e qualsiasi altra CLI di agenti.

In breve

1. Dai a ogni agente il suo compito e, per il lavoro che modifica il codice, la sua copia di lavoro (un git worktree).
2. Tieni tutti gli agenti di un progetto visibili in un'unica griglia, così ti accorgi quando uno ha bisogno di te.
3. Usa un secondo agente come revisore, non come secondo autore, sullo stesso codice.
4. Tieni d'occhio i limiti di utilizzo, perché agenti in parallelo li consumano in parallelo.

Passo 1: dividi il lavoro in compiti indipendenti

Gli agenti in parallelo funzionano quando i loro compiti non toccano gli stessi file. Buone suddivisioni:

• Una funzionalità in un'area e un bug fix in un'altra
• Implementare una modifica e scrivere test per il codice esistente
• Un agente scrive codice, un altro la documentazione o un piano di migrazione
• Ricerca o lettura del codice, che non cambia nulla

Cattive suddivisioni: due agenti sullo stesso componente, oppure un agente che fa refactoring del codice che un altro sta estendendo. Se non riesci a descrivere i file di ogni compito senza sovrapposizioni, eseguili uno dopo l'altro.

Passo 2: dai a ogni agente un worktree tutto suo

Due agenti nella stessa cartella condividono un'unica working tree. Quando entrambi modificano, ottieni modifiche applicate a metà, conflitti a sorpresa e diff di cui non sai attribuire la paternità. La soluzione è un git worktree per compito: un secondo checkout dello stesso repository in una cartella tutta sua, su un branch tutto suo.

git worktree add ../atlas-auth -b feat/auth
git worktree add ../atlas-search -b feat/search

Ogni agente lavora poi nella sua cartella, e tu fai il merge dei branch quando hanno finito. Claude Code può farlo anche in un solo passaggio con claude --worktree feature-auth. La nostra guida ai git worktree per Claude Code e Codex entra nei dettagli, comprese dipendenze, file .env e pulizia.

Gli agenti in sola lettura (revisione, ricerca, domande sulla documentazione) possono condividere la cartella principale.

Passo 3: metti tutti gli agenti su un solo schermo

Con gli agenti in parallelo il problema di solito non è il codice, è l'attenzione. Un agente chiede un permesso in un pannello in background e resta lì ad aspettare per venti minuti.

In Vibe Console, ogni progetto può avere fino a 10 terminali, in pannelli o in una griglia da 1×2 a 3×3. Un layout che funziona bene con tre agenti:

Ogni terminale può eseguire un agente diverso: scegline uno accanto al pulsante Avvia e premi ⌘K. Per avviare un agente dentro un worktree, prima fai cd nella sua cartella; puoi trascinare un worktree dal riquadro Controllo del codice sorgente su un terminale per incollarne il percorso. Rinomina i terminali (Rinomina…) con il nome del loro compito, così la griglia si legge come una lista di cose da fare.

Ogni pannello mostra un pallino che indica se il suo agente sta lavorando o è inattivo. Quando un agente finisce, o si ferma ad aspettare un tuo input, l'app riproduce un suono e apre la tacca su quella sessione, così puoi distogliere lo sguardo. Vedi notifiche di Claude Code su Mac per i dettagli e un'alternativa gratuita con gli hook.

Passo 4: usa un secondo agente come revisore

Modelli diversi colgono errori diversi. Uno schema economico ed efficace:

1. Claude Code implementa una modifica nel suo worktree.
2. Quando ha finito, avvia Codex (o un'altra sessione di Claude Code) nella stessa cartella con un prompt di revisione salvato, per esempio: «Rivedi il diff non ancora committato cercando bug, test mancanti e problemi di sicurezza. Non modificare i file; elenca i problemi con file e riga.»
3. Incolla i risultati al primo agente.

Salva una volta il prompt di revisione nei Prompt salvati (⌘⇧S) e incollalo con un clic in qualsiasi terminale.

Passo 5: tieni d'occhio i limiti di utilizzo

I piani di Claude Code e Codex misurano l'utilizzo a finestre, tra cui una finestra mobile di 5 ore e un limite settimanale. Tre agenti la consumano circa tre volte più in fretta, e raggiungere un limite a metà compito lascia il lavoro a metà.

Vibe Console mostra gli anelli di quota di Claude Code e Codex nella tacca e nella barra degli strumenti del terminale, con l'orario di azzeramento, e ti avvisa all'80% e al 100%. La nostra guida ai limiti di utilizzo di Claude Code spiega le finestre e come organizzarti di conseguenza.

Passo 6: merge e pulizia

Quando un compito è finito:

1. Rivedi il diff del branch (Controllo del codice sorgente, ⌘⇧G).
2. Esegui i test in quel worktree.
3. Fai il merge del branch, poi rimuovi il worktree (Rimuovi worktree in Controllo del codice sorgente, oppure git worktree remove ../atlas-auth).

Quanti agenti sono troppi?

Per la maggior parte delle persone, due o tre agenti che scrivono codice più un revisore sono il massimo utile. Oltre, il collo di bottiglia diventa la revisione, non gli agenti. Aggiungi altri agenti in parallelo solo per compiti indipendenti, ben definiti e coperti da buoni test.

Domande frequenti

Posso usare Claude Code e Codex sullo stesso progetto contemporaneamente?

Sì. Dai a ciascuno il suo worktree se entrambi modificano il codice, oppure tienine uno nel ruolo di revisore in sola lettura.

Le sessioni parallele di Claude Code condividono il contesto?

No. Ogni sessione ha la sua conversazione. Condividi le decisioni tramite file che gli agenti leggono, come CLAUDE.md, AGENTS.md o le note di progetto.

Eseguire agenti in parallelo costa di più?

Consuma più in fretta i limiti del tuo piano, perché ogni agente usa la quota in modo indipendente. Il lavoro totale è simile; semplicemente avviene in meno tempo.

Vuoi provarlo? Scarica Vibe Console gratis per 14 giorni.