Claude Code Subagents e Agent Teams: una guida pratica

Sottoagenti, Agent Teams, orchestrazione: cosa significa realmente, quando ne avete bisogno, e come rimanere in controllo quando germoglia.

Hai visto le parole "sottoagenti", "Agent Teams", "orchestrazione", e ti chiedi se ti manca qualcosa. Breve risposta: per la maggior parte dei vostri compiti, no. Ma sul grande lavoro, sì, e vale la pena capire.

Sblocchiamolo senza il gergo.

Che cosa è realmente un subagent

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

Quando l'agente principale colpisce un subtask ben definito, lo delega a un subagent. Quel subagent funziona nella sua finestra di contesto, fa il suo lavoro, e restituisce solo il risultato. L'agente principale non ottiene la sua storia completa inquinando il suo contesto, ottiene la conclusione.

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

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

---
name: test-writer
description: Use when tests need to be written or fixed
---
You write tests. You aim for edge-case coverage,
not the happy path. You never touch production code.

Agent Teams, il prossimo passo

Agent Teams è l'orchestratore multi-agente costruito in Claude Code. Ancora sperimentale, disabilitato per impostazione predefinita, ma un punto di ingresso solido.

L'idea: un agente capo divide un grande compito, delega ogni pezzo ad un agente specializzato (con il proprio modello, suggerimenti, strumenti), gli specialisti lavorano in parallelo su un file system condiviso, e i risultati risalgono al piombo.

Se "delegate a uno specialista" suona come subagenti, è normale. Agent Teams è che l'idea ha spinto fino a gestire diversi agenti veramente in parallelo, non solo uno dopo l'altro.

Oltre a quello incorporato, ci sono orchestratori di terze parti come Multiclaude e Gas Town. Sono opinioni, che è ciò che li rende buoni punti di partenza quando si inizia: decidono per voi fino a quando non avete costruito le vostre abitudini.

Quando ne hai bisogno (e quando non lo fai)

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

In questo momento, il multi-agente è ancora un modo costoso e sperimentale per attaccare grandi progetti.

Ne hai bisogno quando:

Il progetto si divide in pezzi autenticamente indipendenti che toccano file diversi.
Una singola finestra di contesto non può contenere tutta la cosa.
Si desidera parallelizzare un ampio refactor o una migrazione in tutto il repo.

Non è necessario per una correzione di bug, una funzione focalizzata, o qualsiasi cosa che si adatta in una testa.

La trappola sta girando un "team" di dieci anni per qualcosa che un agente farebbe in cinque minuti. Paghi in token e complessità per un parallelismo che il compito non ha mai chiesto.

Il vero problema: visibilità

Ecco cosa non si parla abbastanza. Nel momento in cui si eseguono diversi subagenti o un team agente, si perde il filo.

Un capo delegato a cinque specialisti. Quale sta lavorando? Che e' finito? Che aspetta una decisione? In un terminale si vede una parete di testo scorrente, e non si può dire chi sta facendo cosa.

Questo è dove un cruscotto visivo cambia tutto. AgentsRoom mostra ogni agente e ogni subagent come propria piastrella, con il suo stato scritto fuori. Se guardi la delegazione, vedi chi sta aspettando la tua risposta, vedi chi si è schiantato. La parete del testo diventa una mappa leggibile.

Senza questo punto di vista, l'orchestrazione multi-agente rimane una demo impressionante che è ingestibile giorno per giorno. Con esso, diventa uno strumento che realmente usi.

Dove cominciare

Non saltare dritto in una squadra di otto anni.

Inizia con uno o due subagenti per compiti precisi e ripetitivi: uno che scrive test, uno che cerca il codebase. Presto sentirete il guadagno sul contesto del vostro agente principale.

Una volta che quel meccanico si sente naturale, accendere Agent Teams per lavoro che si divide in modo pulito. Tieni d'occhio chi sta facendo cosa, approva i piani prima dell'esecuzione, e ferma la recensione del momento diventa il tuo collo di bottiglia.

Multi-agent premia le persone che strutturano prima di lanciare. Non quelli che lanciano più agenti.