Subagent e agent teams
Come Claude Code divide il lavoro fra più agenti senza perdere il filo.
- Subagent
- Un assistente specializzato con la sua memoria di lavoro, le sue istruzioni e i suoi strumenti. Fa il compito a parte e restituisce solo il riassunto.
- Agent team
- Più sessioni Claude Code coordinate da un capo squadra: si dividono i compiti da una lista comune e si scrivono fra loro.
Due modi di dividere il lavoro
Subagent
Lavorano a parte e riportano il risultato a chi li ha chiamati.
Agent team
Sessioni complete che si scrivono fra loro e si prendono i compiti da una lista.
Come si crea un subagent
Un file di testo nella cartella degli agenti. In cima chi è e quando chiamarlo, sotto il suo modo di lavorare.
--- name: revisore description: Rivede il codice prima del merge. Usalo in modo proattivo. tools: Read, Grep, Glob model: sonnet --- Sei un revisore. Leggi le modifiche e segnala bug, rischi e test mancanti.
Vive in .claude/agents/ del progetto o in ~/.claude/agents/ per tutti i progetti. Claude Code ne ha già alcuni pronti, come Explore per cercare nel codice in sola lettura e Plan per preparare un piano.
Quale scegliere
| Subagent | Agent team | |
|---|---|---|
| Memoria di lavoro | Sua, il risultato torna a chi chiama | Sua, del tutto indipendente |
| Comunicazione | Riporta a chi l'ha chiamato | I compagni si scrivono fra loro |
| Coordinamento | Decide la sessione principale | Lista di compiti condivisa |
| Costo | Più basso | Più alto: ogni compagno è una sessione intera |
| Ideale per | Compiti mirati dove conta solo il risultato | Ricerca, revisione, ipotesi che si sfidano |
Gli agent team sono sperimentali e spenti di default. E dividere conviene solo quando i pezzi sono davvero indipendenti: sul lavoro in catena, un agente solo fa uguale o meglio e costa molto meno.
ognuno col suo compito, nessuno sullo stesso file
Domande frequenti
A cosa servono i subagent in Claude Code?
A tenere pulita la conversazione principale. Una ricerca nel codice o la lettura di cento file finiscono nella memoria del subagent; a te torna solo la conclusione.
Come creo un agente AI con Claude Code?
Scrivi un file in .claude/agents/ con nome, descrizione, strumenti e istruzioni. Claude lo chiama da solo quando la richiesta combacia con la descrizione, oppure glielo chiedi tu per nome.
Cosa sono gli agent teams di Claude Code?
Una funzione sperimentale: una sessione fa da capo squadra, crea altre sessioni complete e le coordina con una lista di compiti e messaggi diretti fra loro. Si attiva con una variabile nelle impostazioni.
Più agenti lavorano meglio di uno?
Solo se il lavoro si divide in pezzi indipendenti. Ogni agente in più consuma token e coordinamento: per compiti in sequenza o sullo stesso file, un agente solo è più affidabile.
Vuoi una squadra di agenti AI che lavora per la tua azienda?
Costruisco agenti AI che sanno chi fa cosa, e lo dicono.