Subagent

Un subagent è un assistente specializzato che gestisce un tipo specifico di compito nella PROPRIA context-window, con un prompt di sistema personalizzato, accesso specifico agli strumenti e permessi indipendenti. Usalo quando un compito secondario inonderebbe la tua conversazione principale con risultati di ricerca, log o contenuti di file che non referenzierai più; il subagent gestisce quel lavoro nel proprio contesto e restituisce solo il riassunto. Claude utilizza il campo description di ciascun subagent per decidere quando delegare.

I subagent sono definiti nei file .agent.md. Le posizioni verificate per questi file sono .claude/agents/ (per il progetto corrente, inclusi nel controllo di versione) e ~/.claude/agents/ (per tutti i tuoi progetti). Claude Code scansiona entrambe le directory ricorsivamente. L'identità di un subagent deriva esclusivamente dal suo campo frontmatter name, che deve essere univoco, minuscolo e separato da trattini; il nome del file o il percorso della sottocartella non contribuiscono alla sua identità.

I campi frontmatter richiesti includono name e description. La description dice a Claude quando delegare compiti a questo subagent. Opzionalmente, puoi specificare tools per concedere l'accesso a strumenti specifici (omettere questo campo concede l'accesso a tutti gli strumenti disponibili). Il campo model può specificare quale modello Claude utilizzare (es. sonnet, opus, haiku, fable, o un ID modello completo) o ereditare quello predefinito. Un campo skills può essere utilizzato per precaricare skill specifiche nel contesto del subagent.

I subagent plugin non supportano hooks, mcpServers, o permissionMode per motivi di sicurezza. Claude Code monitora entrambe le directory degli agenti, quindi le modifiche alle definizioni dei subagent vengono applicate entro pochi secondi senza richiedere un riavvio. Il comando /agents non apre più una procedura guidata di creazione; chiede all'utente di chiedere a Claude o di modificare direttamente i file .agent.md.

Skill come Sub-Agents possono generare CLI AI esterni come subagent con ambito limitato, mentre Create Custom Agent crea questi file .agent.md. Per flussi di lavoro complessi, Multi-Agent Coordinator può suddividere i compiti tra i subagent, e Agent Orchestration Advisor aiuta a progettare questi sistemi multi-agente, potenzialmente sfruttando i pattern di progressive-disclosure.