SpyBara
Go Premium

plugins/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 34 additions and 34 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Wed 14 22:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57

Panoramica dei plugin

Comprendi cos'è un plugin Claude Code, quando ne hai bisogno invece di una skill autonoma o di un server MCP, e quale pagina leggere per installarne uno o crearne uno.

Un plugin Claude Code è una directory di skills, agenti, hooks, server MCP o altri componenti che Claude Code installa e carica come un'unica unità. La maggior parte dei plugin proviene da un marketplace, che è un catalogo che elenca i plugin e da dove recuperare ciascuno. Puoi anche caricare un plugin da una cartella che qualcuno ti fornisce, oppure creare il tuo.

[!NOTE]

Questi casi sono trattati in altre pagine:

Per provare un plugin ora, esegui /plugin in una sessione di terminale Claude Code e installa uno dalla scheda Discover, che elenca i plugin dai tuoi marketplace. Da lì:

Comprendi cos'è un plugin

Un plugin è una directory di componenti, solitamente con un manifest. Il manifest, un file JSON in .claude-plugin/plugin.json, assegna al plugin il suo nome e può aggiungere una versione, una descrizione e altri metadati. I componenti sono ciò che il plugin aggiunge a Claude Code, come:

  • Skills: istruzioni SKILL.md che Claude carica quando rilevante, e che puoi anche eseguire come comando
  • Agenti: definizioni di subagenti a cui Claude può delegare
  • Hooks: comandi che Claude Code esegue in punti del suo ciclo di vita, come dopo ogni modifica
  • Un modulo degli hook: hook scritti come funzioni JavaScript, che possono anche disegnare riquadri e aggiungere comandi. Un plugin che ne ha uno è chiamato mod. Alcuni mod sono integrati in Claude Code.
  • Server MCP: server di strumenti a cui Claude Code si connette mentre il plugin è abilitato

Questo diagramma mostra un plugin denominato my-plugin che contiene uno di ciascuno di questi componenti, e cosa ottieni da ogni file una volta che il plugin si carica.

Diagram in two columns joined by five straight arrows. Left, the directory of a plugin named my-plugin, holding a manifest at .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json, and other components. Right, what each file gives you in your session: the manifest sets the plugin name, my-plugin; the skill runs as /my-plugin:review; the agent file is a subagent Claude can delegate to; the hooks file holds hooks that run on lifecycle events; and .mcp.json adds an MCP server that gives Claude tools.

Per ogni tipo di componente che un plugin può contenere, con un esempio di ciascuno, consulta Componenti del plugin. Per vedere dove si trova ogni pezzo nella directory di un plugin, utilizza l'esploratore di plugin su quella pagina.

Decidi se hai bisogno di un plugin

Skills, subagenti, hooks e server MCP funzionano tutti da soli, senza un plugin. Una skill che salvi in ~/.claude/skills/, ad esempio, è disponibile in ogni progetto sul tuo computer. Per configurarne una da sola, consulta Skills, Subagenti, Hooks o MCP.

Utilizza un plugin quando vuoi che diverse skills, subagenti, hooks o server MCP siano confezionati come un'unica unità. Installa uno per ottenere una configurazione che qualcun altro ha costruito, con un comando e aggiornamenti dal suo marketplace. Creane uno per fornire la tua configurazione ai tuoi colleghi, installarlo in molti progetti o pubblicare versioni rilasciate.

Cosa un plugin abilitato aggiunge alle tue sessioni

Un plugin abilitato fa parte di ogni sessione, non solo delle sessioni in cui lo utilizzi. Questo ha alcune conseguenze che vale la pena conoscere prima di installarne uno:

  • Contesto e utilizzo: per ogni skill, agente e comando che Claude può invocare autonomamente, il nome e la descrizione sono nel contesto di Claude ad ogni turno in modo che Claude sappia che esiste. Questi token contano verso il tuo utilizzo e lasciano meno spazio nella finestra di contesto anche nelle sessioni in cui nulla dal plugin viene eseguito. Il testo completo di una skill o di un agente si carica solo quando viene utilizzato. Ciò che i server MCP del plugin aggiungono per turno segue la ricerca di strumenti MCP.
  • Processi: i server MCP che il plugin definisce vengono eseguiti insieme a ogni sessione in cui è abilitato, e i suoi hook si attivano ai loro eventi.
  • Autorizzazioni: ciò che il plugin esegue, lo esegue come te. Consulta Sicurezza e affidabilità dei plugin per sapere cosa rivedere per primo.

Puoi controllare l'impronta di un plugin ad ogni fase:

  • Prima di installare: apri il plugin dalla scheda Marketplaces in /plugin. I plugin nel marketplace ufficiale di Anthropic mostrano una stima di Context cost lì.
  • Dopo l'installazione: Misura il costo di un plugin mostra come leggere l'impronta di un plugin, e il gruppo Not used recently della scheda Installed elenca i plugin che potresti disattivare.
  • Per fermarlo senza disinstallarlo: disabilita il plugin con /plugin o, nella tua shell, claude plugin disable. Consulta Gestisci i plugin installati.

Ottieni plugin da un marketplace

Un marketplace è un repository o una directory con un file .claude-plugin/marketplace.json che elenca i plugin e da dove recuperare ciascuno. È un catalogo, non un negozio ospitato. Aggiungi un marketplace una volta, quindi installa i plugin da esso per nome, come commit-commands@claude-plugins-official.

[!NOTE]

Un marketplace di plugin non è Claude Marketplace. Claude Marketplace è il sito web su claude.com/marketplace dove puoi sfogliare plugin, connettori, prodotti partner e partner di servizi. Non è un marketplace che aggiungi con /plugin marketplace add.

Claude Code aggiunge il marketplace ufficiale di Anthropic la prima volta che avvii una sessione di terminale interattiva, a meno che una politica gestita non lo blocchi. Claude Code non aggiunge i marketplace community e demo di Anthropic da solo. Per distinguere i tre marketplace di Anthropic, leggi Marketplace di Anthropic. Per vedere cosa elenca quello ufficiale, apri la scheda Discover di /plugin in una sessione o sfoglia Claude Marketplace.

Questo diagramma mostra il percorso da un marketplace alla tua sessione. Un marketplace elenca un plugin, installi quel plugin e Claude Code carica i suoi componenti.

Diagram of the marketplace path in three boxes, left to right. A marketplace, a catalog of plugins, lists a plugin. The plugin is one directory installed as a unit, holding skills, agents, hooks, MCP servers, and other components. You install the plugin into Claude Code, which loads its components.

Installa e gestisci i plugin contiene i passaggi di installazione per ogni luogo in cui esegui Claude Code. Mentre stai sviluppando un plugin, non hai bisogno di un marketplace: caricalo direttamente dalla sua cartella con --plugin-dir, come mostra Sviluppa senza un marketplace.

Rendi disponibile un plugin installato nella tua sessione

Prima che un plugin che hai installato ti dia una skill che puoi eseguire, deve essere presente ad ognuno di questi livelli:

  • Impostazioni: le tue impostazioni elencano i marketplace che hai aggiunto e i plugin che sono abilitati.
  • Disco: ~/.claude/plugins/ contiene ciò che Claude Code ha recuperato e installato.
  • Sessione: i plugin si caricano all'avvio, o quando ricarichi i plugin.

Leggi Riferimento al caricamento dei plugin per le regole ad ogni livello, incluso quale file di impostazioni ha la precedenza e dove si trovano i file su disco.

Distingui i marketplace di Anthropic da quelli di terze parti

Il nome di un marketplace lo colloca in uno di tre livelli. Claude Code accetta i nomi ufficiali e community solo per i marketplace provenienti da repository github.com/anthropics/:

  • Ufficiale: marketplace con uno dei nomi ufficiali del marketplace di Anthropic, incluso claude-plugins-official e il marketplace demo claude-code-plugins.
  • Community: marketplace con uno dei nomi community di Anthropic, come claude-community. Identifica i marketplace di Anthropic per nome li elenca.
  • Terze parti: ogni altro marketplace. Un marketplace che il tuo collega o la tua organizzazione pubblica è di terze parti.

Indipendentemente dal livello, un plugin che installi può eseguire codice con i tuoi privilegi utente. Leggi Sicurezza e affidabilità dei plugin per sapere come rivedere un plugin prima di installarlo.

Attraverso impostazioni gestite, un'organizzazione può consentire o bloccare marketplace, forzare l'installazione di plugin e disattivare il caricamento solo per sessione. Leggi Gestisci i plugin per la tua organizzazione per questi controlli.

Comprendi gli ambiti di installazione

Quando installi un plugin, scegli un ambito, e l'ambito decide chi il plugin è abilitato per:

  • Ambito utente: abilitato per te in ogni progetto su questo computer
  • Ambito progetto: abilitato per tutti coloro che lavorano in questo repository, attraverso il .claude/settings.json committato. Ogni collaboratore deve comunque installarlo sulla propria macchina
  • Ambito locale: abilitato per te solo in questo repository

Un plugin che installi a livello di ambito utente nel terminale, nelle sessioni locali dell'app desktop o nell'estensione VS Code è disponibile negli altri due su quel computer, perché tutti e tre leggono gli stessi file di impostazioni. Consulta Scegli un ambito di installazione per sapere come sceglierne uno.

Una sessione cloud, inclusa una nel browser su claude.ai/code, non carica i plugin nelle tue impostazioni locali. Per i passaggi di installazione nel terminale, VS Code e l'app desktop, e per ciò che una sessione cloud carica, consulta Installa un plugin.

[!NOTE]

Lo stesso formato di plugin si installa anche su claude.ai e in Cowork, dove viene caricato un diverso set di componenti. Per quelle superfici, consulta Plugin su claude.ai e in Cowork su claude.com e la sua tabella di supporto dei componenti.

Passaggi successivi

La maggior parte delle persone inizia installando un plugin dal marketplace ufficiale di Anthropic, che Claude Code aggiunge la prima volta che avvii una sessione di terminale interattiva. Esegui /plugin in una sessione di terminale per sfogliarlo, o segui Installa e gestisci i plugin, che copre anche l'app desktop e VS Code. Per vedere cosa c'è in quel marketplace prima di aprire Claude Code, sfoglia Claude Marketplace sul web.

Per creare il tuo, Crea un plugin inizia con una directory vuota e termina con un plugin funzionante.

Una volta che hai installato o costruito un plugin, queste pagine coprono cosa viene dopo: