Claude Code Agent Teams: quando conviene lavorare in parallelo
Come funzionano gli agent teams di Claude Code, in cosa differiscono da Projects e quali attività si prestano davvero al lavoro parallelo.
Anthropic ha davvero introdotto una modalità per coordinare più sessioni di Claude Code, ma non si chiama Projects. La distinzione è importante: Projects organizza conversazioni, istruzioni e materiali di riferimento nell’interfaccia di Claude.ai; gli agent teams, invece, servono a far collaborare istanze di Claude Code su un’attività di sviluppo. Non sono un rilancio dello stesso prodotto né un sistema che trasforma automaticamente un gruppo di agenti in un team di programmatori senza supervisione.
La modalità agent teams assegna a una sessione il ruolo di coordinatore. Questa sessione può suddividere il lavoro e assegnare attività; i compagni operano nei propri contesti e possono scambiarsi messaggi direttamente, mentre una lista di attività condivisa aiuta a tenere traccia del lavoro. Il modello è pensato per problemi in cui l’esplorazione parallela porta un vantaggio concreto, non per qualsiasi richiesta da dare a un assistente.
Che cosa cambia rispetto a una singola sessione
In una sessione tradizionale, Claude Code lavora con un contesto principale: può analizzare il repository, modificare file ed eseguire comandi secondo i permessi concessi. Con gli agent teams, più istanze possono affrontare parti indipendenti dello stesso problema. Un esempio sensato è un’indagine su un bug difficile: un agente ricostruisce il percorso dei dati, un altro controlla i test e un terzo cerca regressioni introdotte da una modifica recente. Il coordinatore raccoglie i risultati e aiuta a decidere quali piste approfondire.
La parallelizzazione non equivale però a delega senza controllo. Le sessioni non condividono per magia una comprensione perfetta del progetto: devono coordinare le attività, evitare sovrapposizioni e rendere compatibili le modifiche. Se due agenti intervengono sugli stessi file, il risultato può richiedere integrazione e revisione. Anche un’analisi parallela può produrre conclusioni discordanti o errate; i test, la lettura delle differenze e il giudizio di chi mantiene il codice restano necessari.
Quando il lavoro in parallelo è utile
Gli agent teams sono più adatti a compiti divisibili: confrontare più ipotesi per un difetto, esplorare moduli distinti prima di una modifica, oppure assegnare a sessioni separate una funzionalità che attraversa interfaccia, servizi e documentazione. La condizione pratica è che ogni parte abbia confini abbastanza chiari e che i risultati si possano verificare separatamente. Se la soluzione richiede una lunga catena di decisioni dipendenti, o se tutti devono modificare lo stesso componente, il coordinamento può costare più del tempo risparmiato.
Anthropic ha raccontato un esperimento nel quale 16 agenti hanno lavorato a un compilatore C scritto in Rust. Nel resoconto, il gruppo ha prodotto un compilatore di circa 100.000 righe capace di compilare Linux 6.9 su x86, ARM e RISC-V, dopo quasi 2.000 sessioni Claude Code e circa 20.000 dollari di costi API. È un caso di ricerca su un’attività costruita apposta per mettere alla prova il lavoro parallelo, non una promessa di tempi o risultati per un normale progetto aziendale. Il dato utile è anche il costo di coordinamento e iterazione: aumentare il numero di agenti non rende automaticamente un’attività più economica.
Attivazione e limiti da considerare
La documentazione ufficiale descrive gli agent teams come una funzione sperimentale, disattivata per impostazione predefinita. Per provarla occorre abilitarla tramite la variabile CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 nella configurazione o nell’ambiente previsto da Claude Code. Anthropic segnala limiti nella ripresa delle sessioni, nel coordinamento delle attività e nella chiusura del team: è quindi opportuno provarla prima su un repository non critico e su un incarico circoscritto.
Prima di avviare più sessioni, conviene formulare obiettivi verificabili, assegnare aree di lavoro non sovrapposte e specificare come restituire i risultati. Per una revisione, ad esempio, si possono chiedere a sessioni diverse controlli mirati su sicurezza, compatibilità e test, senza autorizzare modifiche automatiche in produzione. Al termine, una persona dovrebbe esaminare le proposte, eseguire i controlli del progetto e decidere quali cambiamenti integrare.
Il compromesso è tra ampiezza e overhead. Più sessioni possono esplorare più piste contemporaneamente, ma consumano più risorse e richiedono una regia più attenta. Per una domanda semplice, una singola sessione è più lineare; per un’attività modulare con verifiche indipendenti, gli agent teams possono offrire un modo strutturato per distribuire l’esplorazione. Projects resta invece adatto a raccogliere contesto e conversazioni condivise in Claude.ai: sono strumenti con scopi diversi, non due nomi per la stessa funzione.
