Immagini Claude Code come un consulente con una piccola squadra. Lei parla soltanto con il consulente. Lui passa le attività parziali agli specialisti e alla fine Le comunica il risultato.
Questo è esattamente ciò che sono i sub-agents. Niente hype, ma uno strumento pratico per dividere il lavoro. Questo articolo mostra quando convengono — e quando no.
Che cos’è un sub-agent
La sessione principale è l’orchestratore. È l’istanza con cui Lei parla. Avvia sub-agents autonomi e assegna loro dei compiti.
Ogni sub-agent lavora in un proprio contesto nuovo. Restituisce soltanto un risultato compatto. I sub-agents parlano con la sessione principale, mai tra loro.
Perché convengono
Quattro motivi rendono utili i sub-agents.
- Contesto pulito. Ricerche, log lunghi e report voluminosi restano fuori dalla chat principale.
- Lavoro in parallelo. Molti compiti indipendenti girano contemporaneamente invece che uno dopo l’altro.
- Modelli economici. Il lavoro di manovalanza lo svolge un modello piccolo, la direzione uno potente.
- Revisioni oneste. Un agente nuovo non è condizionato a darLe ragione.
Integrati o costruiti da Lei
Claude Code porta con sé sub-agents generici. Accanto a questi, Lei costruisce agenti propri e specializzati. Un sub-agent non è altro che un file Markdown.
In alto c’è il frontmatter YAML: nome, descrizione, modello e strumenti consentiti. La descrizione è la leva più importante. Decide se l’agente è adatto al compito.
Un errore frequente nella pratica è una virgoletta dimenticata. Allora la struttura si rompe e l’agente non parte mai.
Progetto o globale
Gli agenti legati al progetto stanno nel repository e viaggiano con esso. Gli agenti globali stanno nella Sua cartella utente e appartengono soltanto a Lei.
Regola pratica: se deve usarlo il team, va nel progetto. Spostarlo è banale, perché è soltanto un file.
Quando serve un sub-agent — e quando no
Non ogni compito ha bisogno di un sub-agent. Troppi portano spesso a risultati peggiori. Aiuta una domanda semplice.
Questo riverserà subito nella mia chat una montagna di informazioni che non rileggerò mai più? Se sì, deleghi. Se no, resta nella sessione principale.
Usi i sub-agents quando vanno letti molti file, quando i job girano in parallelo o quando desidera una revisione imparziale.
Vi rinunci per modifiche piccole, per passaggi che dipendono l’uno dall’altro o quando l’agente dovrebbe porre una domanda di chiarimento.
Flussi di lavoro dinamici e «ultra code»
Da Opus 4.8 esistono i flussi di lavoro dinamici. La sessione principale avvia allora automaticamente molti sub-agents in parallelo. È potente, ma consuma in fretta il Suo limite di sessione.
Per questo la parola di attivazione è passata da «workflow» a «ultra code». Così nessun flusso di lavoro grande parte per sbaglio. Usi lo strumento in modo consapevole.
Prendere sul serio i permessi
Se un agente può leggere o modificare dati, deve presumere che prima o poi lo farà. Per questo abiliti solo gli strumenti di cui ha davvero bisogno.
Per gli agenti di ricerca e di verifica questo significa di solito: sola lettura. Nei file di agenti altrui verifichi prima eventuali prompt injection.
Il mio impegno nei Suoi confronti
I sub-agents non sono fine a sé stessi. Sono uno strumento per dividere il lavoro. Il guadagno è meno rumore nella chat, costi più bassi e uno sguardo imparziale sul Suo lavoro.
Il mio impegno nei Suoi confronti: consiglio i sub-agents solo dove aiutano in modo misurabile. L’automazione è più dell’hype sull’IA.
Nota: questo articolo riassume le idee centrali di un video YouTube in lingua inglese sui sub-agents di Claude Code e le inquadra dal punto di vista della consulenza. Fonte: youtube.com/watch?v=e18sdZLwP7o.