Subagenti Claude Code e Team di Agenti: Una Guida Pratica

Hai visto le parole "subagents," "Agent Teams," "orchestration," e ti chiedi se ti stai perdendo qualcosa. Risposta breve: per la maggior parte dei tuoi compiti, no. Ma per lavori grandi, sì, ed è utile capire.

Scomponiamolo senza gergo.

Cosa è realmente un subagent

Un subagent è un assistente specializzato con il proprio contesto, il proprio prompt e le proprie autorizzazioni agli strumenti.

Quando l'agente principale incontra un sottocompito ben definito, lo delega a un subagent. Quel subagent lavora nella propria finestra di contesto, svolge il suo lavoro e restituisce solo il risultato. L'agente principale non riceve la sua intera cronologia che inquina il suo contesto, riceve la conclusione.

Questo è il punto: mantenere pulito il contesto dell'agente principale. Invece di un agente che affoga in 50.000 token di ricerca file, hai un subagent che fa la ricerca e riporta tre righe utili.

Dichiari i tuoi subagents nella cartella .claude/agents/ del tuo progetto. Ognuno ha un nome, una descrizione che indica quando usarlo e un prompt di sistema.

---
name: test-writer
description: Usa quando i test devono essere scritti o corretti
---
Scrivi test. Miri alla copertura dei casi limite,
non al percorso felice. Non tocchi mai il codice di produzione.

Agent Teams, il passo successivo

Agent Teams è l'orchestratore multi-agente integrato in Claude Code. Ancora sperimentale, disabilitato di default, ma un solido punto di partenza.

L'idea: un agente leader divide un grande compito, delega ogni parte a un agente specialista (con il proprio modello, prompt, strumenti), gli specialisti lavorano in parallelo su un file system condiviso, e i risultati fluiscono indietro al leader.

Se "delegare a uno specialista" suona come subagents, è normale. Agent Teams è quell'idea spinta fino a far funzionare diversi agenti veramente in parallelo, non solo uno dopo l'altro.

Oltre a quello integrato, ci sono orchestratori di terze parti come Multiclaude e Gas Town. Sono opinati, ed è ciò che li rende buoni punti di partenza quando inizi: decidono per te finché non hai costruito le tue abitudini.

Quando ne hai bisogno (e quando no)

Chiariamo: l'orchestrazione multi-agente è inutile per il 95% dei compiti assistiti da agenti. Per la maggior parte del tuo lavoro quotidiano, un singolo agente è più veloce e semplice.

Al momento, il multi-agente è ancora un modo costoso e sperimentale per affrontare grandi progetti.

Ne hai bisogno quando:

• Il progetto si divide in pezzi veramente indipendenti che toccano file diversi.
• Una singola finestra di contesto non può contenere tutto.
• Vuoi parallelizzare un ampio refactoring o una migrazione a livello di repository.

Non ne hai bisogno per una correzione di bug, una funzionalità mirata o qualsiasi cosa che si adatti a una sola testa.

La trappola è avviare un "team" di dieci agenti per qualcosa che un agente farebbe in cinque minuti. Paghi in token e complessità per un parallelismo che il compito non ha mai richiesto.

Il vero problema: la visibilità

Ecco cosa non viene discusso abbastanza. Nel momento in cui esegui diversi subagents o un Agent Team, perdi il filo.

Un leader delega a cinque specialisti. Quale sta lavorando? Quale ha finito? Quale sta aspettando una decisione? In un terminale vedi un muro di testo scorrevole e non puoi dire chi sta facendo cosa.

Qui è dove una dashboard visiva cambia tutto. AgentsRoom mostra ogni agente e ogni subagent come una propria tessera, con il suo stato scritto chiaramente. Guardi la delega accadere, vedi chi sta aspettando una tua risposta, vedi chi è andato in crash. Il muro di testo diventa una mappa leggibile.

Senza quella vista, l'orchestrazione multi-agente rimane una demo impressionante ma ingovernabile giorno per giorno. Con essa, diventa uno strumento che usi davvero.

Da dove iniziare

Non saltare direttamente a un team di otto agenti.

Inizia con uno o due subagents per compiti precisi e ripetitivi: uno che scrive test, uno che cerca nel codice. Sentirai rapidamente il guadagno sul contesto del tuo agente principale.

Una volta che quella meccanica sembra naturale, attiva Agent Teams per lavori che si dividono chiaramente. Tieni d'occhio chi sta facendo cosa, approva i piani prima dell'esecuzione e fermati nel momento in cui la revisione diventa il tuo collo di bottiglia.

Il multi-agente premia le persone che strutturano prima di lanciare. Non quelle che lanciano il maggior numero di agenti.