Sotto-agenti di Claude Code: quando servono e come si creano

Che cosa riceve un sotto-agente?

Molto meno di quanto si pensi. Non vede la tua conversazione né i file già letti: per questo la richiesta che riceve deve contenere tutto ciò che gli serve.

Riceve	Non riceve
Le istruzioni del suo file, se è un agente tuo	La conversazione fino a quel punto
La richiesta che gli passa Claude	I file già letti nella sessione
I CLAUDE.md e lo stato di git, tranne Explore e Plan	Le skill già usate

Ci sono agenti già inclusi: Explore e Plan servono a cercare e pianificare senza modificare, e partono apposta senza CLAUDE.md né stato di git per essere più veloci; general-purpose è per i compiti che richiedono sia di cercare sia di modificare.

Il riassunto che riporta è tutto ciò che torna nella conversazione. Un errore dell’agente arriva con lo stesso tono sicuro di un risultato giusto: su ciò che conta, va ricontrollato.

Ricontrollato l’8 novembre 2026 su Claude Code 2.1.319.

Quando conviene usarne uno?

Quando ciò che costa è il testo intermedio, non il ragionamento. Il caso tipico è una ricerca in molti file: a te serve la risposta, non cinquanta pagine lette.

Schema	Come funziona	Esempio
Isolare	Fa un lavoro rumoroso e riporta l’essenziale	Lanciare tutte le prove e riferire solo quelle fallite
In parallelo	Più agenti su parti indipendenti, poi si uniscono i risultati	Controllare in parallelo tre esportazioni diverse
In catena	Il risultato del primo diventa il compito del secondo	Trovare i titoli sbagliati, poi correggerli

Il parallelo vale solo se i pezzi non dipendono l’uno dall’altro: altrimenti è una catena, e metterli insieme li fa lavorare due volte. Sono buoni candidati i lotti di un catalogo, come spiega la guida su come accorciare e arricchire i titoli con l’AI, purché le varianti dello stesso gruppo restino nello stesso lotto.

Non conviene per un lavoro di due minuti e dieci righe: l’agente deve ricostruire il contesto, e il suo riassunto rientra comunque nella conversazione. La guida su modelli, contesto e costi spiega perché ogni agente consuma per conto suo.

Come si crea un agente tuo?

Con un file di testo, in .claude/agents/ per il progetto o in ~/.claude/agents/ per tutti i progetti. Puoi anche chiedere a Claude di crearlo. Un esempio inventato:

---
name: revisore-feed
description: Controlla un feed del catalogo e segnala gli errori. Usalo dopo ogni modifica al feed.
tools: Read, Grep, Glob
model: sonnet
---

Controlli il feed che ti viene indicato. Non modifichi nulla.
Riporta: ID del prodotto, campo, problema. Se non trovi errori, dillo in una riga.

Campo	A che cosa serve
name	Il nome dell’agente
description	Quando usarlo: è ciò che Claude legge per decidere
tools	Gli strumenti ammessi. Un revisore senza Edit non può modificare, qualunque cosa decida
model	Il modello: un compito ripetitivo può girare su uno più economico

Scrivere gli strumenti ammessi è il controllo più utile: è una regola che lo strumento applica, non una raccomandazione. Una richiesta esplicita, come «usa revisore-feed sul file di oggi», evita di dipendere dalla scelta automatica.

Se il compito ripete sempre gli stessi passi nella conversazione principale, forse basta una skill: non serve un contesto separato per seguire una procedura.

Che cosa sono il fork e il workflow?

Sono due varianti per i casi che un agente normale non copre bene: il primo porta con sé la conversazione, il secondo regge molti agenti.

	Agente normale	Fork	Workflow
Parte con	Solo la richiesta	Tutta la conversazione	Uno script scritto da Claude
Chi decide il passo dopo	Claude, turno per turno	Claude, turno per turno	Lo script
Dimensione	Pochi compiti	Un lavoro a lato	Da decine a centinaia di agenti
Come si avvia	Lo sceglie Claude o lo chiedi	/subtask richiesta	Lo chiedi, per esempio con /deep-research

Il fork serve quando rispiegare tutto costerebbe più del lavoro: eredita istruzioni, strumenti e modello, lavora in secondo piano e il risultato torna nella conversazione.

Il workflow sposta il piano in uno script: i risultati intermedi non riempiono la conversazione, e il lavoro si può riprendere. Di norma lavorano fino a 16 agenti insieme. Consuma molto: va chiesto consapevolmente, non per abitudine. Come si lanciano i lavori lunghi è nella guida al lavoro in automatico.

Quali errori evitare?

Sono tre, e costano in modi diversi: tempo, soldi o fiducia in un risultato sbagliato.

• Una richiesta troppo corta. Una riga sola scritta con il contesto in testa non basta a chi quel contesto non lo vede. Serve dire obiettivo, che cosa è già stato escluso e dove guardare.
• Fidarsi del riassunto. L’agente può dire «verificato» senza aver verificato tutto. Le affermazioni che finiscono in un conto o in un file da caricare si ricontrollano sulla fonte.
• Dargli l’ipotesi da confermare. Chi riceve una tesi tende a confermarla. Per una revisione, dai il materiale e non la tua conclusione.

Sui dati di un negozio vale doppio. Un agente che analizza un file di vendite può sbagliare un totale con grande sicurezza, e il riassunto non lo mostrerà. Chiedi le prove prima di decidere, come spiega la guida su come chiedere bene a Claude Code; e su che cosa Claude può fare davvero per un e-commerce leggi la pagina su Claude per e-commerce.

Domande frequenti

Fonti

• Claude Code: Subagents
• Claude Code: Workflows
• Claude Code: Best practices