Subagent — delega come un developer senior
Assegna task mirati a istanze Claude dedicate
⏱ Stima ~6 min
01 · Leggi
I developer senior non fanno tutto da soli — delegano. Quando un junior chiede a un senior di investigare un bug, il senior non abbandona il lavoro in corso. Manda qualcuno a indagare e riferire.
Subagent ti permette di fare la stessa cosa con Claude Code. Invece di un'unica conversazione enorme che prova a gestire tutto — leggere file, eseguire test, investigare l'architettura — puoi delegare task mirati a subagent dedicati, ognuno con il proprio context window.
Il vantaggio chiave: i subagent tengono pulita la conversazione principale. Un subagent può leggere 50 file per capire il tuo sistema di validazione, ma ti riporta solo un breve riassunto nel tuo context window.
💡 Immagina cosìPensa al subagent come a un assistente di ricerca che mandi in biblioteca. Non ci vai tu con una scrivania piena di libri — va lui, legge tutto e torna con un foglio di riassunto. La tua scrivania rimane libera per il lavoro importante.
Punti chiave
- I subagent girano in un context window separato dalla tua conversazione principale
- Investigano, analizzano ed eseguono task in modo indipendente
- Riportano solo un riassunto nel tuo context — non tutti i file che hanno letto
- La tua conversazione principale rimane concentrata sull'implementazione
02 · Leggi
Claude Code ha diversi tipi di subagent integrati, ognuno progettato per task specifici: - Explore — Ricerca in sola lettura. Cerca file, legge codice, risponde a domande sul codebase. Non può modificare. - Plan — Progettazione dell'architettura. Esplora il codebase e propone piani di implementazione. In sola lettura finché non approvi. - Bash — Esperto di comandi. Esegue comandi nel terminale. Usalo per test, build e controlli di sistema.
Claude genera automaticamente i subagent quando riconosce task che meritano isolamento — come investigare un codebase ampio o eseguire una suite di test. Puoi anche richiederli esplicitamente.
Punti chiave
- Explore: ricerca in sola lettura e analisi del codebase
- Plan: progettazione dell'architettura e pianificazione dell'implementazione
- Bash: comandi nel terminale e operazioni di sistema
- Claude genera automaticamente i subagent quando opportuno
03 · Esempio di codice
Puoi chiedere direttamente a Claude di usare un subagent. Ecco un prompt che attiva la delega a un subagent.
Prompt che attiva un subagent
"Use a subagent to investigate how auth works in this codebase"
"Explore the database schema and summarize what tables we have"
"Run the test suite and report which tests fail"
"Analyze the API routes and list all endpoints"
Quando chiedi a Claude di "investigare", "esplorare", "analizzare" o "eseguire test", spesso delega automaticamente a un subagent. Il subagent fa il lavoro pesante nel proprio context e torna nella tua conversazione con un riassunto conciso.
04 · Leggi
Puoi creare i tuoi subagent personalizzati scrivendo un file SKILL.md con frontmatter YAML. Questo definisce un agent specializzato con le proprie istruzioni, restrizioni sugli strumenti e scelta del modello.
Gli agent personalizzati sono potenti perché puoi limitarne le capacità. Un code reviewer ha bisogno solo di leggere file — non dovrebbe modificarli né eseguire comandi. Un test runner ha bisogno di Bash ma non di Edit. Le restrizioni sugli strumenti rendono gli agent più sicuri e focalizzati.
Punti chiave
- Gli agent personalizzati si definiscono in un file SKILL.md con frontmatter YAML
- Il campo tools: limita ciò che l'agent può fare
- Un reviewer ha bisogno di Read/Grep/Glob — non di Edit o Bash
- Le restrizioni rendono gli agent più sicuri e focalizzati
05 · Esempio di codice
Ecco come creare un subagent personalizzato per la code review. Il frontmatter YAML ne configura il comportamento.
.claude/skills/code-reviewer/SKILL.md
---
name: code-reviewer
description: Expert code review specialist. Use after code changes.
tools: Read, Grep, Glob
model: sonnet
---
Review code for:
1. Bug risks and logic errors
2. Security vulnerabilities (injection, auth bypass)
3. Performance issues (N+1 queries, unnecessary loops)
4. Style inconsistencies with the existing codebase
Provide specific line references and severity ratings.
Questo agent può solo leggere codice — non può modificare file né eseguire comandi. La restrizione tools: Read, Grep, Glob garantisce che resti concentrato sulla revisione. model: sonnet indica di usare Sonnet (rapido e conveniente) invece del modello della tua conversazione principale.
06 · Quiz
Stai implementando una nuova funzionalità e devi capire come funziona il sistema di validazione esistente, che richiede di leggere più di 20 file. Qual è l'approccio più efficiente in termini di context?
- Leggere tutti e 20 i file da solo nella conversazione principale
- Chiedere a Claude di spiegare la validazione senza leggere i file
- Aprire una nuova sessione Claude per l'investigazione
- Usare un subagent per investigare e riportare un riassunto
07 · Abbina
Abbina ogni tipo di subagent al suo utilizzo ottimale.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
Altre lezioni di questo capitolo
⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.
※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.