Ora sei il CEO: Come gestire un team di sviluppo IA in Claude Code
Immagina questo. Apri il terminale, digiti poche frasi, e improvvisamente lo schermo si divide in piu riquadri - ognuno con uno sviluppatore IA autonomo che lavora su una parte diversa del tuo progetto. Comunicano tra loro. Prendono in carico i compiti. Mettono in discussione le idee degli altri. E tu ti siedi comodamente e guardi tutto svolgersi come un gioco di strategia in tempo reale.
Questi sono gli Agent Teams in Claude Code. E sono appena diventati realta.
Cosa sono gli Agent Teams?
Gli Agent Teams ti permettono di coordinare piu istanze di Claude Code che lavorano insieme. Una sessione funge da team leader - coordina il lavoro, assegna compiti e sintetizza i risultati. Gli altri sono compagni di squadra - sessioni indipendenti, ognuna in esecuzione nella propria finestra di contesto, che comunicano direttamente tra loro.
Ecco cosa li distingue dai sotto-agenti: i sotto-agenti operano all'interno di una singola sessione e possono solo riportare all'agente principale. Non possono parlare tra loro. Gli Agent Teams sono istanze Claude Code completamente indipendenti che si scambiano messaggi direttamente. Usa i sotto-agenti quando hai bisogno di lavoratori rapidi e concentrati che riportano. Usa gli Agent Teams quando i compagni di squadra devono condividere scoperte, sfidarsi a vicenda e coordinarsi autonomamente.
Mantieni il controllo per tutto il tempo. Claude non crea mai un team senza la tua approvazione - o lo richiedi tu, o Claude ne suggerisce uno e attende la tua conferma prima di procedere.
Attivalo in 30 secondi
Gli Agent Teams sono sperimentali e disattivati di default. Attivali con uno di questi due metodi:
Opzione 1: Variabile d'ambiente
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Opzione 2: File di configurazione
Aggiungilo al tuo settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
Fatto. Ora sei un team manager.
Lancia il tuo primo team
Niente file di configurazione. Niente YAML. Descrivi semplicemente il compito e la struttura del team desiderata in linguaggio naturale. Claude crea il team, avvia i compagni di squadra e coordina il lavoro in base al tuo prompt.
Questo esempio funziona bene perche i tre ruoli sono indipendenti e possono esplorare il problema senza aspettarsi a vicenda:
Sto progettando uno strumento CLI che aiuta gli sviluppatori a tracciare
i commenti TODO nella loro codebase. Crea un team di agenti per esplorare
la questione da angolazioni diverse: un compagno per la UX, uno per
l'architettura tecnica, uno che fa l'avvocato del diavolo.
Premi Invio e guarda. Claude crea un team con una lista di compiti condivisa, avvia un compagno per ogni angolazione, li lascia esplorare, sintetizza le loro scoperte e fa pulizia quando il lavoro e finito.
Il terminale del leader elenca tutti i compagni e cosa stanno facendo. Sembra un pannello di progetto che si aggiorna da solo in tempo reale.
Due modi per seguire l'azione
Puoi scegliere come il tuo team appare sullo schermo:
La modalita in-process e quella predefinita. Tutti i compagni operano nel tuo terminale principale. Usa Shift+Su/Giu per selezionare un compagno e digita per inviargli un messaggio direttamente. Funziona in qualsiasi terminale - nessun setup aggiuntivo necessario.
La modalita split-pane e lo spettacolo. Ogni compagno ha il proprio riquadro visibile. Guardi letteralmente piu sviluppatori IA programmare fianco a fianco in tempo reale. Richiede tmux o iTerm2 e non funziona nel terminale integrato di VS Code, Windows Terminal o Ghostty.
Se vuoi quella sensazione da gioco di strategia in tempo reale - la modalita split-pane fa per te. Guardare tre agenti investigare simultaneamente la tua codebase da angolazioni diverse in riquadri separati e davvero emozionante.
Controlla il tuo team come un professionista
Una volta che il team e in funzione, parli con il leader in linguaggio naturale. Lui gestisce coordinazione, assegnazione compiti e delegazione in base alle tue istruzioni.
Ma ecco la mossa vincente - il Delegate Mode. Premi Shift+Tab per scorrere i modi di permesso. Quando un team di agenti e attivo, il ciclo include il Delegate Mode, che limita il leader ai soli strumenti di coordinazione. Niente codice, solo avvio, messaggi e gestione compiti. Questo risolve il problema comune del leader che cerca di implementare i compiti da solo invece di delegarli.
Puoi anche bypassare completamente il leader. Usa Shift+Su/Giu per selezionare qualsiasi compagno e inviargli un messaggio direttamente. Non sei vincolato a una catena di comando - puoi intervenire dove vuoi, esattamente come un vero team manager che va alla scrivania di qualcuno.
La lista di compiti condivisa
Dietro le quinte, il team funziona con una lista di compiti condivisa. I compiti hanno tre stati: in attesa, in corso e completato. I compiti possono avere dipendenze - quando un compagno completa un compito da cui dipendono altri, i compiti bloccati vengono automaticamente sbloccati.
I compagni reclamano i compiti autonomamente. Quando uno finisce il suo lavoro, prende il prossimo compito non assegnato e non bloccato dalla lista. Nessun micromanagement necessario.
Tutta la configurazione del team e i compiti sono memorizzati localmente in ~/.claude/teams/{team-name}/config.json.
Dove gli Agent Teams dominano
Gli Agent Teams sono piu efficaci per compiti dove l'esplorazione parallela aggiunge valore reale. Ecco i casi d'uso piu forti direttamente dal manuale:
Ricerca e revisione
Piu compagni investigano simultaneamente aspetti diversi di un problema, poi condividono e contestano reciprocamente le scoperte. Un singolo revisore tende a gravitare verso un tipo di problema alla volta. Dividi i criteri in domini indipendenti e tutto riceve attenzione approfondita contemporaneamente:
Crea un team di agenti per revisionare la PR #142. Avvia tre revisori:
- Uno focalizzato sulle implicazioni di sicurezza
- Uno che verifica l'impatto sulle prestazioni
- Uno che valida la copertura dei test
Fai revisionare ciascuno e riportare le scoperte.
Tre agenti, tre angolazioni, tutti attivi contemporaneamente. Sembra di comandare una squadra d'assalto.
Nuovi moduli o funzionalita
I compagni possiedono ciascuno una parte separata senza ostacolarsi. Quando i confini sono chiari, e qui che gli Agent Teams danno il meglio:
Crea un team di agenti per costruire la nuova funzionalita dashboard.
Un compagno sullo strato API, uno sui componenti frontend,
uno sulla suite di test.
Quando il compagno API finisce le definizioni dei tipi, invia un messaggio direttamente al compagno frontend. Il compagno test chiede al compagno API di avviare un server di sviluppo. Si coordinano da soli senza che tu muova un dito.
Debug con ipotesi concorrenti
Invece di testare teorie una alla volta, avvia compagni che inseguono ciascuno un'ipotesi diversa in parallelo. Convergono piu velocemente sulla risposta - e possono contestare le scoperte degli altri lungo il percorso.
Pensalo come un dibattito tra esperti dove tu sei il giudice.
Coordinamento tra livelli
Modifiche che attraversano frontend, backend e test - ciascuna gestita da un compagno diverso. Questo e il classico scenario "troppe parti mobili per un solo cervello", e gli Agent Teams lo gestiscono magnificamente.
Quando NON usare gli Agent Teams
Non ogni compito ha bisogno di un team. Gli Agent Teams aggiungono overhead di coordinamento e usano significativamente piu token di una singola sessione. Funzionano meglio quando i compagni possono operare indipendentemente.
Salta i team e usa una singola sessione o sotto-agenti per:
- Compiti sequenziali dove ogni passo dipende dal precedente
- Modifiche allo stesso file dove piu agenti creerebbero conflitti
- Lavoro con molte dipendenze che impedisce l'esecuzione parallela
- Compiti di routine che un singolo agente gestisce perfettamente
Non metteresti insieme un team di cinque persone per rinominare una variabile. La stessa logica si applica qui.
Costi in token: Il prezzo del potere
Questa e la sezione piu importante. Gli Agent Teams usano significativamente piu token di una singola sessione. Ogni compagno ha la propria finestra di contesto, e l'uso di token scala con il numero di compagni attivi.
Per ricerca, revisione e sviluppo di nuove funzionalita, i token extra ne valgono solitamente la pena. Per compiti di routine, una singola sessione e molto piu conveniente.
Pensalo come assumere freelancer - li chiami per i grandi lavori, non per le attivita quotidiane.
Il tuo CLAUDE.md funziona ancora
Buona notizia - CLAUDE.md funziona normalmente con gli Agent Teams. I compagni leggono i file CLAUDE.md dalla loro directory di lavoro, quindi qualsiasi guida specifica del progetto si applica automaticamente a tutto il team. Nessuna configurazione extra necessaria.
Limitazioni note
Gli Agent Teams sono sperimentali e la documentazione e trasparente al riguardo. Le limitazioni attualmente note includono problemi con la ripresa della sessione, il coordinamento dei compiti e il comportamento di chiusura. Puoi far funzionare solo un team per sessione, i team annidati non sono supportati e la modalita split-pane e limitata a tmux e iTerm2.
Il leader a volte cerca di implementare i compiti da solo invece di delegarli. Due soluzioni: digli esplicitamente "aspetta che i tuoi compagni completino i loro compiti prima di procedere" nel prompt, o usa il Delegate Mode (Shift+Tab) per limitarlo ai soli strumenti di coordinamento.
Siamo agli inizi - ma l'esperienza fondamentale gia sembra qualcosa di fondamentalmente nuovo.
Approcci correlati
Gli Agent Teams si affiancano ad altre strategie di lavoro parallelo in Claude Code:
I sotto-agenti sono la tua opzione di delega leggera. Lanciano agenti ausiliari per ricerca o verifica all'interno della tua sessione - meglio per compiti che non necessitano coordinamento tra agenti.
Le sessioni parallele manuali usando git worktrees ti permettono di eseguire piu sessioni Claude Code per conto tuo senza coordinamento automatico del team.
La progressione e chiara: sotto-agenti per compiti individuali rapidi, Agent Teams quando i collaboratori devono effettivamente lavorare insieme.
Per iniziare: La tua prima missione
Ecco la progressione consigliata:
Settimana uno: Attiva gli Agent Teams e inizia con una revisione del codice. Tre revisori, tre angolazioni - sicurezza, prestazioni, copertura test. Basso rischio, alto rendimento. Osserva come si coordinano e prendi il ritmo del flusso.
Settimana due: Prova un'esplorazione di ricerca. Dai al team una domanda di design aperta con tre prospettive diverse. Guarda come si sfidano a vicenda sulle idee.
Settimana tre: Tenta un'implementazione di funzionalita con confini chiari. Un compagno per livello, ciascuno con il proprio territorio.
A quel punto avrai un istinto per quando i team aggiungono valore e quando una sessione singola e la scelta migliore.
La conclusione
Gli Agent Teams trasformano Claude Code da un singolo sviluppatore a una squadra coordinata che gestisci in tempo reale. Descrivi cosa vuoi, assegni ruoli, guardi piu agenti IA avviarsi in riquadri separati, prendere compiti, scambiarsi messaggi e consegnare risultati in parallelo.
E sperimentale. Consuma token. Ha spigoli. Ed e la cosa piu emozionante che sia successa nella programmazione assistita dall'IA quest'anno.
Attivalo. Lancia un team. Guarda il tuo terminale prendere vita.
Non stai piu solo scrivendo codice. Stai dirigendo lo spettacolo.
