Vai al contenuto principale
Claude Code combina un modello che ragiona sul vostro codice con strumenti integrati per operazioni su file, ricerca, esecuzione e accesso web. Gli strumenti integrati coprono la maggior parte dei compiti di codifica. Questa guida copre il livello di estensione: funzionalità che aggiungete per personalizzare ciò che Claude conosce, collegarlo a servizi esterni e automatizzare i flussi di lavoro.
Per informazioni su come funziona il ciclo agentico principale, consultate How Claude Code works.
Siete nuovi a Claude Code? Iniziate con CLAUDE.md per le convenzioni del progetto. Aggiungete altre estensioni secondo le vostre necessità.

Panoramica

Le estensioni si collegano a diverse parti del ciclo agentico:
  • CLAUDE.md aggiunge contesto persistente che Claude vede in ogni sessione
  • Skills aggiungono conoscenze riutilizzabili e flussi di lavoro invocabili
  • MCP collega Claude a servizi e strumenti esterni
  • Subagents eseguono i loro propri cicli in contesto isolato, restituendo riassunti
  • Agent teams coordinano più sessioni indipendenti con compiti condivisi e messaggistica peer-to-peer
  • Hooks vengono eseguiti completamente al di fuori del ciclo come script deterministici
  • Plugins e marketplaces confezionano e distribuiscono queste funzionalità
Skills sono l’estensione più flessibile. Una skill è un file markdown contenente conoscenze, flussi di lavoro o istruzioni. Potete invocare skills con un comando come /deploy, oppure Claude può caricarle automaticamente quando rilevante. Le skills possono essere eseguite nella vostra conversazione attuale o in un contesto isolato tramite subagents.

Abbinate le funzionalità al vostro obiettivo

Le funzionalità vanno dal contesto sempre attivo che Claude vede in ogni sessione, alle capacità su richiesta che voi o Claude potete invocare, all’automazione in background che viene eseguita su eventi specifici. La tabella seguente mostra ciò che è disponibile e quando ogni funzionalità ha senso.
FunzionalitàCosa faQuando utilizzarlaEsempio
CLAUDE.mdContesto persistente caricato in ogni conversazioneConvenzioni del progetto, regole “fai sempre X""Usa pnpm, non npm. Esegui i test prima di fare il commit.”
SkillIstruzioni, conoscenze e flussi di lavoro che Claude può utilizzareContenuto riutilizzabile, documenti di riferimento, compiti ripetibili/deploy esegue la vostra checklist di distribuzione; skill di documentazione API con pattern di endpoint
SubagentContesto di esecuzione isolato che restituisce risultati riassuntiIsolamento del contesto, compiti paralleli, worker specializzatiCompito di ricerca che legge molti file ma restituisce solo i risultati chiave
Agent teamsCoordinare più sessioni Claude Code indipendentiRicerca parallela, sviluppo di nuove funzionalità, debug con ipotesi concorrentiGenerare revisori per controllare sicurezza, prestazioni e test simultaneamente
MCPCollegamento a servizi esterniDati o azioni esterneInterrogare il vostro database, inviare a Slack, controllare un browser
HookScript deterministico che viene eseguito su eventiAutomazione prevedibile, nessun LLM coinvoltoEseguire ESLint dopo ogni modifica di file
Plugins sono il livello di confezionamento. Un plugin raggruppa skills, hooks, subagents e server MCP in una singola unità installabile. Le skills dei plugin hanno uno spazio dei nomi (come /my-plugin:review) in modo che più plugin possano coesistere. Utilizzate i plugin quando desiderate riutilizzare la stessa configurazione su più repository o distribuire ad altri tramite un marketplace.

Confrontate funzionalità simili

Alcune funzionalità possono sembrare simili. Ecco come distinguerle.
Skills e subagents risolvono problemi diversi:
  • Skills sono contenuti riutilizzabili che potete caricare in qualsiasi contesto
  • Subagents sono worker isolati che vengono eseguiti separatamente dalla vostra conversazione principale
AspettoSkillSubagent
Cosa èIstruzioni, conoscenze o flussi di lavoro riutilizzabiliWorker isolato con il suo proprio contesto
Vantaggio principaleCondividere contenuti tra contestiIsolamento del contesto. Il lavoro avviene separatamente, solo il riassunto ritorna
Migliore perMateriale di riferimento, flussi di lavoro invocabiliCompiti che leggono molti file, lavoro parallelo, worker specializzati
Le skills possono essere di riferimento o di azione. Le skills di riferimento forniscono conoscenze che Claude utilizza durante la vostra sessione (come la vostra guida di stile API). Le skills di azione dicono a Claude di fare qualcosa di specifico (come /deploy che esegue il vostro flusso di lavoro di distribuzione).Utilizzate un subagent quando avete bisogno di isolamento del contesto o quando la vostra finestra di contesto si sta riempiendo. Il subagent potrebbe leggere dozzine di file o eseguire ricerche estese, ma la vostra conversazione principale riceve solo un riassunto. Poiché il lavoro del subagent non consuma il vostro contesto principale, questo è utile anche quando non avete bisogno che il lavoro intermedio rimanga visibile. I subagents personalizzati possono avere le loro proprie istruzioni e possono precaricare skills.Possono combinarsi. Un subagent può precaricare skills specifiche (campo skills:). Una skill può essere eseguita in contesto isolato utilizzando context: fork. Consultate Skills per i dettagli.

Comprendete come le funzionalità si stratificano

Le funzionalità possono essere definite a più livelli: a livello di utente, per progetto, tramite plugins o tramite politiche gestite. Potete anche annidare file CLAUDE.md in sottodirectory o posizionare skills in pacchetti specifici di un monorepo. Quando la stessa funzionalità esiste a più livelli, ecco come si stratificano:
  • I file CLAUDE.md sono additivi: tutti i livelli contribuiscono contenuti al contesto di Claude simultaneamente. I file dalla vostra directory di lavoro e sopra si caricano all’avvio; le sottodirectory si caricano mentre lavorate in esse. Quando le istruzioni entrano in conflitto, Claude usa il giudizio per riconciliarle, con istruzioni più specifiche che tipicamente hanno la precedenza. Consultate come i file CLAUDE.md si caricano.
  • Skills e subagents si sovrascrivono per nome: quando lo stesso nome esiste a più livelli, una definizione vince in base alla priorità (gestito > utente > progetto per skills; gestito > flag CLI > progetto > utente > plugin per subagents). Le skills dei plugin sono con spazio dei nomi per evitare conflitti. Consultate scoperta delle skills e ambito del subagent.
  • I server MCP si sovrascrivono per nome: locale > progetto > utente. Consultate ambito MCP.
  • Hooks si uniscono: tutti gli hooks registrati si attivano per i loro eventi corrispondenti indipendentemente dalla fonte. Consultate hooks.

Combinate le funzionalità

Ogni estensione risolve un problema diverso: CLAUDE.md gestisce il contesto sempre attivo, le skills gestiscono conoscenze e flussi di lavoro su richiesta, MCP gestisce connessioni esterne, i subagents gestiscono l’isolamento e gli hooks gestiscono l’automazione. Le configurazioni reali le combinano in base al vostro flusso di lavoro. Ad esempio, potreste utilizzare CLAUDE.md per convenzioni del progetto, una skill per il vostro flusso di lavoro di distribuzione, MCP per connettervi al vostro database e un hook per eseguire il linting dopo ogni modifica. Ogni funzionalità gestisce ciò che fa meglio.
PatternCome funzionaEsempio
Skill + MCPMCP fornisce la connessione; una skill insegna a Claude come utilizzarla beneMCP si connette al vostro database, una skill documenta lo schema e i pattern di query
Skill + SubagentUna skill genera subagents per il lavoro paralleloLa skill /audit avvia subagents di sicurezza, prestazioni e stile che lavorano in contesto isolato
CLAUDE.md + SkillsCLAUDE.md contiene regole sempre attive; le skills contengono materiale di riferimento caricato su richiestaCLAUDE.md dice “segui le nostre convenzioni API,” una skill contiene la guida di stile API completa
Hook + MCPUn hook attiva azioni esterne tramite MCPL’hook post-modifica invia una notifica Slack quando Claude modifica file critici

Comprendete i costi del contesto

Ogni funzionalità che aggiungete consuma parte del contesto di Claude. Troppo può riempire la vostra finestra di contesto, ma può anche aggiungere rumore che rende Claude meno efficace; le skills potrebbero non attivarsi correttamente, o Claude potrebbe perdere traccia delle vostre convenzioni. Comprendere questi compromessi vi aiuta a costruire una configurazione efficace.

Costo del contesto per funzionalità

Ogni funzionalità ha una strategia di caricamento e un costo di contesto diversi:
FunzionalitàQuando si caricaCosa si caricaCosto del contesto
CLAUDE.mdInizio della sessioneContenuto completoOgni richiesta
SkillsInizio della sessione + quando utilizzateDescrizioni all’inizio, contenuto completo quando utilizzateBasso (descrizioni ogni richiesta)*
Server MCPInizio della sessioneTutte le definizioni degli strumenti e gli schemi JSONOgni richiesta
SubagentsQuando generatiContesto fresco con skills specificateIsolato dalla sessione principale
HooksAl triggerNiente (viene eseguito esternamente)Zero, a meno che l’hook non restituisca contesto aggiuntivo
*Per impostazione predefinita, le descrizioni delle skills si caricano all’inizio della sessione in modo che Claude possa decidere quando utilizzarle. Impostate disable-model-invocation: true nel frontmatter di una skill per nasconderla completamente a Claude fino a quando non la invocate manualmente. Questo riduce il costo del contesto a zero per le skills che invocate solo voi.

Comprendete come le funzionalità si caricano

Ogni funzionalità si carica in diversi punti della vostra sessione. Le schede seguenti spiegano quando ogni funzionalità si carica e cosa entra nel contesto. Caricamento del contesto: CLAUDE.md e MCP si caricano all'inizio della sessione e rimangono in ogni richiesta. Le skills caricano descrizioni all'inizio, contenuto completo all'invocazione. I subagents ottengono contesto isolato. Gli hooks vengono eseguiti esternamente.
Quando: Inizio della sessioneCosa si carica: Contenuto completo di tutti i file CLAUDE.md (livelli gestito, utente e progetto).Eredità: Claude legge i file CLAUDE.md dalla vostra directory di lavoro fino alla radice e scopre quelli annidati nelle sottodirectory mentre accede a quei file. Consultate Come i file CLAUDE.md si caricano per i dettagli.
Mantenete CLAUDE.md sotto ~500 righe. Spostate il materiale di riferimento in skills, che si caricano su richiesta.

Scopri di più

Ogni funzionalità ha la sua propria guida con istruzioni di configurazione, esempi e opzioni di configurazione.

CLAUDE.md

Memorizzate il contesto del progetto, le convenzioni e le istruzioni

Skills

Date a Claude competenze di dominio e flussi di lavoro riutilizzabili

Subagents

Delegate il lavoro a contesto isolato

Agent teams

Coordinate più sessioni che lavorano in parallelo

MCP

Collegate Claude a servizi esterni

Hooks

Automatizzate i flussi di lavoro con gli hooks

Plugins

Confezionate e condividete set di funzionalità

Marketplaces

Ospitate e distribuite raccolte di plugin