Source: https://aiprimetech.io/it/claude-code/subagents/ [Home](/it/) › [Claude Code](/it/claude-code/) › Subagenti [Panoramica](/it/claude-code/)[Installazione](/it/claude-code/install/)[riferimento della CLI](/it/claude-code/cli/)[Prezzi e limiti](/it/claude-code/pricing/)[Agent SDK](/it/claude-code/sdk/)[Skill e plugin](/it/claude-code/skills/)[GitHub](/it/claude-code/github/)[Web, desktop e IDE](/it/claude-code/web-and-desktop/)[Modelli](/it/claude-code/models/)[Errori](/it/claude-code/errors/)[È open source?](/it/claude-code/open-source/)[Tutorial](/it/claude-code/tutorial/)[Per studenti](/it/claude-code/for-students/)[Automazione QA](/it/claude-code/qa-automation/)[Confronto con Cursor](/it/claude-code/vs-cursor/)[Confronto con Codex e OpenCode](/it/claude-code/vs-codex/)[Subagenti](/it/claude-code/subagents/)[Hook](/it/claude-code/hooks/)[MCP](/it/claude-code/mcp/)[Ecosistema](/it/claude-code/ecosystem/)[VS Code](/it/claude-code/vscode/)[OpenRouter](/it/claude-code/openrouter/)[Limiti di frequenza](/it/claude-code/rate-limits/)[Guida in cinese](/claude-code/zh/) Ultimo aggiornamento: 11 ottobre 2026 # Subagenti di Claude Code: come funzionano, come definirli e team di agenti Un subagente è un esecutore separato di Claude Code con un proprio prompt di sistema, proprie autorizzazioni per gli strumenti e — l'aspetto importante — una propria finestra di contesto. La sessione principale gli delega un'attività, riceve un riepilogo e mantiene pulito il proprio contesto. Usati bene, i subagenti fanno la differenza tra una sessione che si degrada dopo un'ora e una che continua a funzionare tutto il giorno. ## TLDR - Definiscine uno come file Markdown in .claude/agents/ (progetto) oppure ~/.claude/agents/ (utente): front matter per name, description, tools, model; il corpo è il prompt di sistema. - Claude delega automaticamente quando la descrizione corrisponde all'attività, oppure esplicitamente quando indichi il nome dell'agente. - Ogni subagente ha il proprio contesto e i suoi token vengono fatturati separatamente; i risultati vengono restituiti in forma riassunta. - /agents li crea e li gestisce; i team di agenti estendono questa idea al coordinamento delle sessioni. ## Definire un subagente ``` # .claude/agents/code-reviewer.md --- name: code-reviewer description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change. tools: Read, Grep, Glob, Bash(git diff *) model: sonnet --- You are a senior reviewer. Read the staged diff, list concrete defects with file:line, flag untested paths, and stop. Do not edit files. ``` name è il modo in cui lo richiami; description è il modo in cui Claude decide di richiamarlo autonomamente, quindi scrivila come una regola di instradamento ("usa dopo qualsiasi modifica non banale") anziché come un titolo professionale. tools limita ciò che può fare: un revisore che non può modificare è un revisore più sicuro. model fissa un livello: haiku per l'esplorazione e la classificazione, sonnet per la maggior parte del lavoro, opus per il passaggio difficile, oppure inherit per seguire la sessione principale. ## Agenti di progetto e agenti utente I file in .claude/agents/ appartengono al repository e lo accompagnano: includili in un commit e ogni membro del team avrà lo stesso revisore, autore di test e agente di migrazione. I file in ~/.claude/agents/ sono tuoi in ogni progetto. In caso di conflitto di nomi, gli agenti di progetto hanno la precedenza. /agents all'interno di una sessione elenca, crea e modifica entrambi i tipi senza dover intervenire manualmente sui file. ## Quando Claude delega In due modi. Implicito: l'agente principale legge la descrizione di ogni subagente e delega quando un'attività corrisponde; non è necessario dire "esegui il subagente code-reviewer su questo" se la descrizione indica già quando usarlo. Esplicito: indica il suo nome nel prompt. In entrambi i casi il subagente opera nel proprio contesto, vede solo ciò che gli viene fornito e ciò che legge, e restituisce un risultato che la sessione principale riassume nella propria cronologia. I subagenti non avviano altri subagenti; la gerarchia ha un solo livello. ## Perché mantengono bassi i costi delle sessioni Ogni turno in Claude Code invia nuovamente l'intera conversazione. Un sottoagente che legge quaranta file lo fa nella propria finestra di contesto; l'agente principale riceve un paragrafo. Senza sottoagenti, quei quaranta file rimarrebbero nel contesto principale per il resto della sessione e verrebbero reinviati a ogni turno. Quindi, per codebase di grandi dimensioni, lo schema è: esplorare con un sottoagente Haiku, revisionare con un sottoagente Sonnet e riservare il contesto dell'agente principale alle decisioni. I token di ogni sottoagente vengono fatturati separatamente: non è gratuito, ma il suo contesto resta circoscritto. ## Parallelismo e limiti di utilizzo Più sottoagenti possono essere eseguiti contemporaneamente, e ciascuno costituisce una richiesta in streaming parallela. È il modo più rapido per raggiungere il limite di richieste simultanee su qualsiasi endpoint, quindi, con un nuovo account del gateway, inizia con due o tre sottoagenti in parallelo e richiedi una maggiore concorrenza quando il carico di lavoro è concreto. La guida agli errori descrive il 429 che altrimenti riceverai. ## Team di agenti Le versioni più recenti di Claude Code introducono i team di agenti: invece di un unico agente principale che delega a sottoagenti di breve durata, più sessioni si coordinano come membri del team con un nome, una lista di attività condivisa e messaggi tra loro, così un coordinatore può assegnare il lavoro, chiedere aggiornamenti e fermare un membro del team. È una funzionalità sperimentale, attivabile tramite un'impostazione, che cambia da una versione all'altra: consulta claude --help e il registro delle modifiche per conoscere il flag attuale, anziché affidarti a un articolo di blog. Il modello concettuale è lo stesso dei sottoagenti, con l'aggiunta di persistenza e comunicazione; anche il modello di costo è lo stesso, moltiplicato per i membri del team. ## Sul gateway I sottoagenti e i team usano lo stesso endpoint e la stessa chiave della sessione principale, quindi ANTHROPIC_BASE_URL=https://aiprimetech.io si applica a tutti. Con un piano illimitato a tariffa fissa, il parallelismo diventa una questione di uso corretto anziché di fatturazione, ed è per questo che chi usa intensamente più agenti tende a scegliere questi piani. | Piano | Durata | Prezzo | Illimitato per 1 ora | 1 ora | $1 | Illimitato per 24 ore | 24 ore | $10 | Illimitato per 1 settimana | 1 settimana | $49 | Illimitato per 15 giorni | 15 giorni | $89 [Tutti i piani illimitati →](/it/plans/) ## Provalo prima gratuitamente I nuovi account ricevono $5 di credito API gratuito con il codice CLAUDECODE — abbastanza per una serata con Claude Code su Sonnet — poi crediti pari a 7.69231× il valore nominale. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crea un account con il codice CLAUDECODE](/register?promo=CLAUDECODE) ## Domande frequenti Che cos'è un sottoagente in Claude Code? Un agente separato con un proprio prompt di sistema, autorizzazioni per gli strumenti, scelta del modello e finestra di contesto, definito come file Markdown in .claude/agents/, a cui la sessione principale delega attività.Dove si trova la documentazione dei sottoagenti di Claude Code? Il riferimento ufficiale si trova nella documentazione di Claude Code di Anthropic, nella sezione Sottoagenti; questa pagina è la versione pratica: il formato dei file, quando avviene la delega e quanto costa.I sottoagenti comportano costi aggiuntivi? I loro token vengono fatturati come quelli di qualsiasi richiesta. Fanno risparmiare nelle sessioni lunghe mantenendo le letture estese fuori dal contesto dell'agente principale, ma costano di più se ne esegui molti in parallelo su Opus.Che cosa sono i team di agenti? Un'estensione sperimentale in cui più sessioni di Claude Code si coordinano come membri del team con un nome, tramite messaggi e una lista di attività condivisa, anziché avere un unico agente principale e assistenti di breve durata. ## Esegui Claude Code sul gateway Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice CLAUDECODE.[Ottieni una chiave API](/register?promo=CLAUDECODE) [Scopri i piani illimitati](/it/plans/) AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway. ## Altre guide su Claude Code [Claude Code: la guida completa](/it/claude-code/)[Come installare Claude Code](/it/claude-code/install/)[Documentazione della CLI di Claude Code: comandi e flag](/it/claude-code/cli/)[Prezzi e limiti di Claude Code, spiegati](/it/claude-code/pricing/)[L'SDK di Claude Code, ora Claude Agent SDK](/it/claude-code/sdk/)[Skill e plugin di Claude Code](/it/claude-code/skills/)[Claude Code in GitHub: App, Action e @claude](/it/claude-code/github/)[Claude Code ha un'interfaccia web? Le versioni web, desktop e per IDE spiegate](/it/claude-code/web-and-desktop/)[Quale modello usa Claude Code e come cambiarlo](/it/claude-code/models/)[Errori di Claude Code e come risolverli](/it/claude-code/errors/)[Claude Code è open source?](/it/claude-code/open-source/)[Tutorial di Claude Code: la tua prima sessione reale](/it/claude-code/tutorial/)[Claude per studenti: Claude Code, l'API e ciò che offre davvero il settore education](/it/claude-code/for-students/)[Come usare Claude Code per l'automazione QA](/it/claude-code/qa-automation/)[Claude Code e Cursor a confronto: quale scegliere, quando — e come usarli entrambi](/it/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: confronto tra gli agenti da terminale](/it/claude-code/vs-codex/)[Hook di Claude Code: controllo deterministico su ciò che fa l'agente](/it/claude-code/hooks/)[MCP in Claude Code: connessione ai server, ambiti, MCP remoto ed esempi concreti](/it/claude-code/mcp/)[L'ecosistema Claude Code: router, framework, plugin e gli elenchi che li raccolgono](/it/claude-code/ecosystem/)[Claude Code in VS Code: l'estensione, l'uso dal terminale e gli errori](/it/claude-code/vscode/)[Come usare OpenRouter in Claude Code (e quando evitarlo)](/it/claude-code/openrouter/)[Errore di limite di frequenza di Claude: cosa significa "Errore API: limite di frequenza raggiunto" e come risolverlo](/it/claude-code/rate-limits/)[Come usare Claude Code: dall'installazione all'uso quotidiano](/claude-code/zh/)