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 |
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_keyDomande 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 Scopri i piani illimitatiAI 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.