Plugin Claude Code: cosa sono e quanto costano
Scopri dove vive un plugin Claude Code, come installarlo e quanto costa davvero: nulla per il meccanismo, ma token per ciò che aggiunge al contesto.
Che cos’è un plugin di Claude Code
Un plugin di Claude Code è una directory contenente componenti che Claude Code carica e gestisce come un’unica unità. I componenti principali sono skill, agenti, hook, server MCP, server LSP e monitor in background. Un plugin può includere anche comandi, stili di output, temi, workflow e una directory bin/ contenente eseguibili. L’installazione di un plugin aggiunge tutte le sue parti contemporaneamente, con un unico nome. La disattivazione le rimuove nello stesso modo.
Un plugin, nella maggior parte dei casi, non fornisce all’agente funzionalità che non possedeva già. Skill, agenti, hook e server MCP possono essere creati manualmente in una directory .claude/. Le eccezioni sono i server linguistici per l’intelligenza sul codice e moduli, che Claude Code carica soltanto da un plugin. Per tutto il resto, il plugin è il livello di packaging: consente di gestire la versione di questi componenti, distribuirli a quindici persone e aggiornarli in seguito senza chiedere a tutti di copiare i file. Questa è l’idea fondamentale. Gran parte della confusione sui plugin nasce dall’aspettativa che offrano un nuovo tipo di funzionalità.
Il manifest opzionale in .claude-plugin/plugin.json assegna un nome al plugin. Questo nome diventa un namespace. Una skill contenuta in un plugin chiamato commit-commands viene invocata come /commit-commands:commit. In questo modo, due plugin possono includere entrambi una skill chiamata commit senza che una nasconda l’altra. Gli agenti dei plugin seguono lo stesso criterio nell’elenco delle menzioni con @, ad esempio plugin-name:agent-name.
Plugin, skill, server MCP o file di regole
Questi quattro termini vengono usati come se fossero alternative. Non lo sono, ed è utile chiarire una volta per tutte la distinzione.
- Una skill è un'unità di istruzioni che Claude carica quando l'attività lo richiede. Vedere che cos'è realmente un'Agent Skill.
- Un server MCP è un processo separato che espone strumenti all'agent tramite un protocollo, spesso come servizio di rete gestito direttamente.
- Un file di regole come
CLAUDE.mdcontiene il contesto del progetto, viene letto all'avvio della sessione e si applica a tutte le attività. - Un plugin è una directory di skill, agent, hook, server MCP o altri componenti che Claude Code installa e carica come un'unica unità. Il manifest opzionale ne definisce il nome e può aggiungere una versione, una descrizione e altri metadati. La distribuzione non fa parte del plugin: un marketplace è un catalogo separato che elenca i plugin e indica dove recuperare ciascuno di essi.
La domanda a cui risponde un plugin, quindi, non è «che cosa può fare l'agent». È «come distribuisco questo componente al team e come lo aggiorno il mese prossimo». Se devi scegliere tra i primi tre elementi, il confronto tra skill, server MCP e file di regole descrive in dettaglio i criteri di scelta. Se ti interessa soprattutto la parte MCP, eseguire i propri server MCP su un VPS descrive gli aspetti relativi all'hosting.
Dove risiedono i plugin e cosa contiene un plugin
La maggior parte dei plugin del marketplace viene copiata in una cache locale in ~/.claude/plugins/cache, con una directory separata per ogni versione installata. I plugin con percorso relativo in un marketplace aggiunto da un percorso locale vengono caricati direttamente dalla posizione originale. I plugin di tipo command-source in modalità link vengono caricati tramite collegamenti alla directory sorgente. Quando aggiorni o disinstalli un plugin copiato, la directory della versione precedente viene contrassegnata come orfana e viene eliminata circa due settimane dopo. In questo modo, una sessione che ha già caricato la versione precedente continua a funzionare invece di interrompersi durante l'attività. La pulizia viene eseguita solo finché è registrata almeno un'installazione di plugin. Dopo la disinstallazione dell'ultimo plugin, le directory orfane restano presenti finché non installi un altro plugin.
Poiché il percorso di un plugin copiato cambia a ogni aggiornamento, un plugin non deve mai codificare direttamente la propria posizione. Gli hook e le configurazioni MCP all'interno di un plugin usano ${CLAUDE_PLUGIN_ROOT}, che restituisce la directory di installazione corrente. Lo stato che deve sopravvivere a un aggiornamento va inserito in ${CLAUDE_PLUGIN_DATA}, che restituisce una directory stabile sotto ~/.claude/plugins/data/.
Per un plugin copiato, nella cache viene copiata soltanto la directory del plugin. Fanno eccezione le destinazioni dei collegamenti simbolici presenti altrove nello stesso marketplace, che vengono copiate nella posizione prevista. Uno script che legge un percorso esterno alla root del plugin, ad esempio ../shared-utils, funziona durante lo sviluppo con un percorso locale, ma si interrompe quando il plugin viene copiato nella cache, perché quei file non sono mai stati copiati. Un percorso di componente dichiarato in questo modo in plugin.json fallisce prima: Claude Code rifiuta qualsiasi percorso di componente che esca dalla root del plugin, anche durante lo sviluppo, restituendo un errore path escapes plugin directory.
La struttura è la seguente.
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── code-review/
│ └── SKILL.md
├── agents/
├── hooks/
│ └── hooks.json
├── .mcp.json
└── bin/Solo plugin.json viene inserito in .claude-plugin/. Tutto il resto si trova nella root del plugin. Inserire skills/ o hooks/ dentro .claude-plugin/ è il motivo più comune per cui un plugin viene installato correttamente e poi non esegue alcuna operazione: Claude Code cerca queste directory nella root, non ne trova nessuna e carica un plugin privo di componenti.
Il manifest è invece molto semplice.
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
}Come installare un plugin di Claude Code
L'installazione prevede due passaggi, ma il primo non installa nulla. Si aggiunge un marketplace, cioè un catalogo di plugin, quindi si installano i singoli plugin disponibili. Il marketplace ufficiale di Anthropic, claude-plugins-official, viene registrato automaticamente al primo avvio interattivo di Claude Code, a meno che una policy gestita o CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL non lo impedisca. Gli altri marketplace devono essere aggiunti manualmente.
/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-officialIl nome del marketplace proviene dal file del catalogo all'interno del repository, non dal percorso del repository. Prima di digitare un comando di installazione, quindi, leggere il nome del marketplace nella scheda Marketplaces di /plugin. Il marketplace claude-code-plugins precedente in anthropics/claude-code è deprecato; per le nuove installazioni usare claude-plugins-official. I plugin esistenti provenienti dal marketplace precedente vengono aggiornati dal repository ufficiale. Non è quindi necessario reinstallare commit-commands solo per cambiare marketplace.
Al termine dell'installazione, leggere la riga di riepilogo. Plugin is now active. indica che i componenti sono stati caricati nella sessione corrente. Run /reload-plugins to apply. indica che non sono stati attivati durante l'installazione; il pannello si chiude e Claude Code esegue automaticamente il reload. Se il reload avvisa che dovrebbe rileggere la conversazione, il plugin resta in attesa. In questo caso, eseguirlo nuovamente come /reload-plugins --force. Verificare quindi che il plugin sia effettivamente disponibile: /plugin lo mostra nella scheda Installed, digitando / si ottiene l'elenco delle skill come /plugin-name:skill-name, mentre tutto ciò che non è stato caricato viene mostrato nella scheda Errors insieme al motivo.
L'installazione richiede un ambito, che determina chi può usare il plugin. L'ambito utente riguarda solo l'utente corrente, in ogni progetto. L'ambito progetto scrive il plugin nel file .claude/settings.json del repository, sotto enabledPlugins, e lo abilita per chiunque cloni il repository. Il plugin non viene però scaricato automaticamente per queste persone: ogni collaboratore deve installarlo una volta sulla propria macchina, ad esempio con claude plugin install name@marketplace --scope project, a meno che la voce del marketplace non sia un percorso relativo o che una directory seed lo contenga già. L'ambito locale riguarda solo l'utente corrente e il repository corrente.
Per uno script, un Dockerfile o qualsiasi sessione in cui non sia disponibile un pannello interattivo, usare invece la variante shell. Questa installa il plugin nell'ambito utente, a meno che non venga passato --scope. Su una macchina in cui nessuno ha ancora aperto una sessione interattiva, il marketplace ufficiale non è registrato. È quindi necessario aggiungerlo prima.
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin listclaude plugin install viene eseguito al di fuori di una sessione. Una sessione già aperta non vedrà quindi il nuovo plugin finché non si esegue /reload-plugins o non si avvia una nuova sessione.
La gestione dei plugin installati segue lo stesso schema in entrambi i casi. /plugin list mostra ciò che è installato e accetta --enabled o --disabled. /plugin disable name@marketplace disattiva un plugin senza rimuoverlo, /plugin enable lo riattiva e /plugin uninstall lo rimuove. Le varianti slash command aprono il pannello dei plugin per applicare la modifica. Per questo, negli script, è preferibile usare gli equivalenti shell claude plugin ....
Per distribuire un marketplace a un intero team, inserirlo nel file .claude/settings.json del progetto oppure eseguire una volta claude plugin marketplace add your-org/claude-plugins --scope project e sottoporre a commit il file generato. Claude Code registra il marketplace per ogni membro quando il membro considera attendibile la directory del repository.
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}Durante lo sviluppo di un plugin proprio, si può ignorare completamente il marketplace. claude --plugin-dir ./my-plugin carica una directory per la sessione corrente, /reload-plugins rileva le modifiche senza riavviare la sessione e claude plugin validate ./my-plugin verifica il manifest, il frontmatter delle skill e degli agent, oltre a hooks/hooks.json, prima che il plugin venga usato da altri. Il marketplace non è necessario neppure per condividere un plugin: è possibile inviare la directory oppure un .zip della directory, da caricare con --plugin-dir. In questo caso, però, non verranno ricevuti aggiornamenti finché non si invierà una nuova copia.
Quanto costa un plugin di Claude Code?
Il meccanismo è gratuito. A novembre 2026 non sono previsti costi per aggiungere un marketplace, installare un plugin o mantenerlo abilitato. I marketplace ufficiali e quelli della community sono repository Git pubblici, mentre un plugin è una directory di file di testo.
Il costo di un plugin è espresso in token, che sono ciò che misura effettivamente l'utilizzo dell'abbonamento o la fattura API. Il modo in cui questi token incidono dipende dal metodo con cui paghi lo strumento, mentre quanto costa Claude Code con ciascun piano descrive i livelli di abbonamento e i prezzi API per token. Il costo si presenta in tre modi diversi, che hanno comportamenti differenti.
Costo del contesto permanente. Ogni plugin abilitato inserisce nel contesto i nomi e le descrizioni delle skill, degli agent e dei comandi che Claude può invocare autonomamente. Questa parte viene riletta a ogni turno della sessione, indipendentemente dal fatto che venga eseguito qualcosa. Non tutti i componenti consumano token: un hook viene eseguito dall'harness e non aggiunge nulla al contesto del modello. Prima dell'installazione, la vista di dettaglio /plugin mostra una sezione Will install che elenca i comandi, le skill, gli agent, gli hook e i server MCP e LSP che stai per aggiungere. Per un plugin del marketplace ufficiale di Anthropic, mostra anche una sezione Context cost con le stime Every turn e When invoked, purché tu apra il plugin usando il nome del marketplace o dalla scheda Marketplaces, invece che dall'elenco Discover. Leggi entrambe le sezioni. Un plugin proveniente da un marketplace proprietario o di terze parti non dispone della sezione Context cost, ma non devi effettuare la stima manualmente: claude plugin details name nella shell stampa una quantità di token Always-on e una suddivisione per componente per qualsiasi plugin caricato, incluso quello passato con --plugin-dir. Puoi quindi clonare un repository ed eseguire claude --plugin-dir ./that-plugin plugin details that-plugin prima di installare qualsiasi elemento. Questo valore non include i server MCP. Un plugin che include un server MCP è generalmente il più pesante, perché le definizioni degli strumenti sono voluminose. Nei modelli che supportano la ricerca degli strumenti MCP, però, queste definizioni vengono caricate solo quando è necessario uno strumento. Esegui /context in una sessione con il plugin abilitato e leggi la riga MCP tools per vedere quanto aggiungono.
Costo di invocazione. L'esecuzione della skill di un plugin aggiunge le relative istruzioni alla conversazione, quindi il corpo della skill viene addebitato solo quando la skill viene utilizzata. Il corpo è comunque la parte meno costosa. Ciò che la skill ordina all'agent di fare può avere un costo molto maggiore: il metodo Depth Tree della skill unlazy utilizza quasi tutti i suoi token per i passaggi aggiuntivi che impone prima di consentire all'agent di dichiarare conclusa un'attività, non per il file installato. Un agent è diverso. Un subagent esegue una conversazione autonoma con il proprio prompt di sistema e la propria cache, iniziando senza cache hit. Per questo, un plugin il cui workflow genera agent ha un costo molto maggiore di quanto suggerisca la stima del contesto.
Costo della cache. Abilitare o disabilitare un plugin durante una sessione può obbligare la richiesta successiva a rielaborare l'intera conversazione. Skill, comandi, agent, hook, monitor e temi non producono mai questo effetto: il contenuto aggiunto viene accodato dopo la cronologia esistente, quindi la richiesta successiva paga il nuovo contenuto e continua a leggere dalla cache tutto ciò che lo precede. Fanno eccezione un plugin che fornisce un server MCP e un plugin di code intelligence, il cui language server fornisce a Claude lo strumento LSP. Per MCP, il comportamento dipende dalla ricerca degli strumenti: se gli strumenti vengono caricati in modo differito, la cache viene mantenuta; se invece vengono caricati nel prefisso del prompt, la richiesta successiva rilegge l'intera conversazione come input non memorizzato nella cache. Per questo /reload-plugins avvisa e rifiuta la modifica quando un cambiamento agli strumenti MCP o allo strumento LSP invaliderebbe la cache, finché non passi --force.
Puoi monitorare questi valori invece di stimarli. Ogni risposta API riporta cache_read_input_tokens e cache_creation_input_tokens, mentre una statusline personalizzata che mostra l'utilizzo dei token in tempo reale li rende visibili. In una sessione sana, i token letti sono molti più di quelli creati. Se la creazione rimane elevata a ogni turno, significa che qualcosa nel prefisso cambia a ogni turno. Per una panoramica più ampia di ciò che riempie la finestra, consulta come gestire la finestra di contesto di Claude Code e che cosa indicano effettivamente quei conteggi dei token.
Una semplice attività di manutenzione può ripagarsi da sola. La scheda Installed raggruppa sotto l'intestazione Not used recently i plugin installati dai marketplace che non hai utilizzato per almeno 14 giorni e 10 sessioni. Nella vista di dettaglio mostra anche una riga Last used. L'intestazione esclude i plugin gestiti e quelli delle directory seed, oltre ai plugin con un tema, uno stile di output, un monitor o un workflow. Un server LSP viene considerato utilizzato quando fornisce diagnostica o risponde a una richiesta di navigazione del codice. Quando è configurato strictKnownMarketplaces, non vengono visualizzati né l'intestazione né la riga Last used:. Questi plugin continuano comunque a consumare tempo di avvio e spazio nel contesto a ogni sessione. Disabilitali o disinstallali. L'abitudine più economica consiste nell'essere selettivi prima dell'installazione: quali skill di Matt Pocock vale la pena installare analizza una raccolta di 27 skill e distingue quelle necessarie a un singolo sviluppatore da quelle che offrono vantaggi soprattutto in un team.
Un plugin viene eseguito con i tuoi permessi
La documentazione ufficiale di Anthropic è esplicita: un plugin installato può eseguire codice arbitrario sul tuo computer con i privilegi del tuo utente. Non si tratta di un rischio ipotetico. Gli hook di un plugin eseguono comandi shell in corrispondenza degli eventi della sessione, anche prima e dopo le chiamate agli strumenti. La directory bin/ del plugin viene aggiunta a PATH dello strumento Bash mentre il plugin è abilitato. I server MCP stdio del plugin sono processi che il plugin avvia, mentre una mod esegue JavaScript direttamente all'interno di Claude Code. Hook, monitor, processi server e processi delle mod vengono eseguiti al di fuori della sandbox di Claude Code; le relative regole sui permessi continuano comunque ad applicarsi alle chiamate agli strumenti effettuate da Claude.
Su un laptop, questo rischio è limitato a ciò che l'utente desktop può raggiungere. Su un server, di norma non è così. L'account che esegue l'agente dispone spesso di chiavi SSH, token di deploy, una sessione della CLI cloud e accesso al socket Docker. Di conseguenza, «codice arbitrario eseguito come il tuo utente» può significare il controllo della macchina. Se Claude Code viene eseguito su un VPS, leggi come eseguire Claude Code in sicurezza su un VPS prima di installare qualsiasi componente. Prima di installare un plugin che comunica con un servizio esterno, leggi anche come impedire a un agente di accedere alle credenziali. Altri harness incontrano lo stesso limite sullo stesso server a noleggio. Per questo i plugin di DeepSeek Harness che vale la pena installare servono soprattutto a impostare limiti di spesa, regole sui permessi degli strumenti e scansione delle injection, invece di aggiungere nuove funzionalità.
Esistono alcune misure di protezione, ed è utile sapere quali siano. Un plugin con ambito di progetto proviene dal repository e non da te, quindi viene caricato solo dopo che hai considerato attendibile il workspace. I relativi server MCP richiedono comunque un'approvazione separata per ciascun server, mentre i monitor in background non vengono caricati. Agli agenti forniti con i plugin non è consentito dichiarare hook, server MCP o una modalità di autorizzazione. Quando i plugin del marketplace vengono copiati nella cache, i symlink che puntano all'esterno del marketplace vengono ignorati. Un plugin copiato non può quindi includere file arbitrari dell'host tramite questi link.
Nessuna di queste misure sostituisce la lettura del codice che installi. Controlla l'elenco Will install, preferisci plugin di cui puoi aprire e leggere il codice sorgente, conserva i plugin del team in un repository marketplace sotto il tuo controllo ed esegui claude plugin validate su tutto ciò che scrivi personalmente. Anche ciò che hai verificato può cambiare in seguito: l'aggiornamento automatico è abilitato per impostazione predefinita nei marketplace ufficiali di Anthropic, tranne knowledge-work-plugins e first-party-plugins, mentre è disabilitato per quelli di terze parti aggiunti tramite sorgente. Quando è abilitato, Claude Code aggiorna i file del plugin in background.
FAQ
I plugin di Claude Code hanno un costo aggiuntivo?
No. Non sono previsti costi per il sistema dei plugin, per l'aggiunta di un marketplace o per l'installazione di un plugin. Il costo dipende dall'uso dei token ed è addebitato al piano o alla spesa API, come qualsiasi altro contesto. Un plugin aggiunge contesto persistente a ogni turno e ne aggiunge altro quando viene richiamata una delle sue skill o dei suoi agent. Può inoltre forzare un turno costoso non memorizzato nella cache se fornisce un server MCP con strumenti caricati nel prefisso del prompt. Per un plugin presente nel marketplace ufficiale di Anthropic, la vista dei dettagli /plugin mostra una stima Context cost prima dell'installazione; per qualsiasi altro plugin, claude plugin details name stampa il costo in token sempre attivo dopo l'installazione o il caricamento con --plugin-dir.
Qual è la differenza tra un plugin e una skill?
Una skill è una singola unità di istruzioni. Un plugin è un pacchetto che può contenere skill, agent, hook, server MCP, server LSP e monitor, con un nome, in genere una versione e, solitamente, un marketplace da cui installarlo. Può anche essere condiviso come directory o come .zip che gli utenti caricano con --plugin-dir. Scrivi una skill autonoma in .claude/ quando serve a te e a questo progetto. Una skill con un unico scopo, come Ponytail, che indirizza l'agent verso la modifica minima funzionante, è il caso più chiaro: un file con una sola regola, almeno fino a quando il team non ne ha bisogno. Trasformala in un plugin quando deve essere usata da altre persone e aggiornata nel tempo. Le skill dei plugin sono organizzate in namespace, quindi una skill interna a un plugin viene richiamata come /plugin-name:skill-name anziché come /skill-name.
Il mio plugin è stato installato, ma le sue skill non vengono visualizzate. Qual è il problema?
Controlla prima il riepilogo dell'installazione. Se contiene Run /reload-plugins to apply., Claude Code esegue il reload quando il pannello viene chiuso. Se il reload avvisa che rileggerà la conversazione, eseguilo nuovamente come /reload-plugins --force. Se il plugin è stato caricato ma non mostra nulla, apri /plugin e consulta la scheda Errors. L'errore strutturale più comune consiste nell'inserire skills/, agents/ o hooks/ dentro .claude-plugin/, dove Claude Code non li cerca. Ricorda che le skill dei plugin sono organizzate in namespace: quando digiti /, devi cercare /plugin-name:skill-name. Se il plugin appartiene a un'altra persona e viene caricato senza errori, apri il riquadro dei dettagli nella scheda Installed. Un plugin che in quella scheda non elenca skill non ne offre alcuna. Se la scheda Errors indica che il plugin non è nella cache, manca la directory di installazione. Reinstallalo dalla shell con claude plugin install name@marketplace ed esegui /reload-plugins.
Posso installare plugin senza il pannello interattivo?
Sì. Usa il comando shell claude plugin install name@marketplace, che installa il plugin nell'ambito dell'utente, salvo che vengano passati --scope project o --scope local. Funziona negli script, nelle image e negli ambienti non interattivi in cui il pannello /plugin non è disponibile. Poiché viene eseguito al di fuori di una sessione, una sessione già aperta richiede /reload-plugins prima che il plugin diventi operativo. In una sessione senza terminale interattivo, le modifiche ai server MCP del plugin diventano effettive nella sessione successiva.
È sicuro installare un plugin da un marketplace trovato su GitHub?
Consideralo come l'esecuzione dello script di installazione di quel repository con il tuo account, perché il comportamento è sostanzialmente questo. Un plugin può eseguire comandi shell tramite hook, aggiungere eseguibili al PATH dello strumento Bash e avviare server MCP, il tutto con i privilegi del tuo utente. Anthropic non controlla né verifica i contenuti dei plugin di terze parti. Installa da fonti che puoi leggere, esamina l'elenco Will install prima della conferma e adotta criteri più restrittivi su un server rispetto a un laptop, perché l'account del server contiene solitamente chiavi e token che possono essere sottratti.