Vai al contenuto principale
Pubblicare un plugin Claude Code significa inserirlo in un marketplace, un catalogo JSON che elenca i plugin e dove recuperare ciascuno di essi, in modo che altre persone possano installarlo per nome e ricevere i tuoi aggiornamenti. Puoi gestire il tuo marketplace personale o inviare il tuo plugin alla directory di Anthropic. Per condividere un plugin senza pubblicarlo, invia alle persone la directory del plugin o un .zip di esso da caricare da soli. Questa pagina è per l’autore di un plugin funzionante che è pronto a condividerlo.
Questi casi sono trattati su altre pagine:
Inizia con Scegli come distribuire per confrontare le opzioni di distribuzione. Se conosci già il tuo percorso, vai a Prepara il tuo plugin per il rilascio, quindi segui la sezione del tuo percorso per sapere cosa dire ai tuoi utenti e come ricevono i tuoi aggiornamenti.

​
Scegli come distribuire

Scegli un’opzione di distribuzione in base a chi ha bisogno di installare il plugin: L’aggiornamento automatico è un’impostazione per marketplace sul lato dell’utente che recupera le nuove versioni in background.

​
Prepara il tuo plugin per il rilascio

Il nome, la versione, la convalida e un’installazione da un marketplace decidono se un rilascio funziona per le persone che lo installano. Controllali prima del primo rilascio e di nuovo prima di ogni rilascio successivo.
1

Scegli un nome permanente

Gli utenti installano, abilitano e configurano il tuo plugin per name@marketplace, quindi un plugin rinominato è un plugin diverso per ogni installazione esistente. Scegli un nome in kebab-case come deploy-helper, perché claude plugin validate avverte su altre forme, e trattalo come permanente. Imposta displayName in plugin.json per l’etichetta che gli utenti vedono.
2

Decidi come versione

Se imposti version in plugin.json e successivamente esegui il push di commit senza modificarla, claude plugin update stampa <name> is already at the latest version (1.0.0). e gli utenti mantengono la copia precedente. Incrementa version ad ogni rilascio, oppure omettila in un marketplace ospitato su git in modo che Claude Code utilizzi invece lo SHA del commit. Vedi Versioni e aggiornamenti.
3

Convalida

Nel tuo shell, esegui claude plugin validate --strict ./your-plugin. Un’esecuzione pulita stampa ✔ Validation passed.
  • In CI: mantieni --strict, che inoltre fa fallire l’esecuzione con codice di uscita 1 su avvisi come un campo manifest sconosciuto o una version mancante. Rimuovi --strict se hai scelto di omettere version nel passaggio precedente.
  • Percorsi: la convalida segnala i percorsi dei componenti che non iniziano con ./. All’interno dei comandi hook e delle configurazioni del server MCP, fai riferimento ai file come ${CLAUDE_PLUGIN_ROOT}/.... Vedi regole dei percorsi.
4

Installalo da un marketplace locale

Nel tuo shell, aggiungi un marketplace locale che elenca il plugin con claude plugin marketplace add ./path-to-marketplace, installa il plugin da esso e avvia una sessione per confermare che si carica.
5

Compila i metadati che gli utenti vedono

Imposta description, author, homepage e repository in plugin.json, e aggiungi un README.md alla radice del plugin. homepage deve essere analizzato come un URL. Il riferimento manifest elenca ogni campo.
6

Esegui la tua suite di eval

Se hai una suite di eval, esegui claude plugin eval nel tuo shell. Esegue i casi di test del plugin e valuta i risultati, il che cattura le regressioni quando modifichi il plugin. Vedi Testa i plugin con eval.

​
Condividi un plugin senza un marketplace

Se il plugin è in un repository git, le persone possono clonarlo e caricare il checkout, oppure avviare Claude Code dal loro shell con --plugin-url puntato a un .zip che allega a un rilascio. Per ottenere la tua prossima versione, eseguono il pull o scaricano di nuovo. Se non è in un repository, invia loro la directory o un .zip di esso. Lo caricano in uno di due modi:
  • Per una sessione: avviano Claude Code dal loro shell con claude --plugin-dir ./deploy-helper, dove il percorso è il clone, la cartella decompressa o il .zip stesso. Vedi Flag che caricano un plugin per una sessione.
  • Per ogni sessione: spostano la directory del plugin, con il suo .claude-plugin/plugin.json, sotto ~/.claude/skills/. Da quel momento Claude Code lo carica all’avvio, a meno che il loro amministratore non abbia bloccato i plugin nella directory delle skill.
Aggiungere un .claude-plugin/marketplace.json allo stesso repository è ciò che consente alle persone di installare per nome e aggiornare con un comando; vedi Pubblica attraverso il tuo marketplace personale.

​
Spedisci un plugin con il tuo strumento personale

Se mantieni una CLI o SDK, pubblica il plugin in un marketplace e fai in modo che il tuo programma di installazione o il messaggio post-installazione esegua o stampi i due comandi di cui un utente ha bisogno: claude plugin marketplace add <source>, quindi claude plugin install <name>@<marketplace>. Per la scoperta in-sessione quando qualcuno utilizza il tuo strumento, vedi Consiglia il tuo plugin dalla tua CLI.

​
Pubblica attraverso il tuo marketplace personale

Il tuo marketplace personale è un file .claude-plugin/marketplace.json che elenca il tuo plugin, aggiunto a un repository git. Una volta che il file è nel repository, il plugin è pubblicato, senza modulo di invio. Puoi mantenere il file nel repository del plugin stesso o in uno separato.

​
Aggiungi il file marketplace al tuo repository

Per pubblicare dal repository del plugin stesso, salva il file marketplace accanto a plugin.json in .claude-plugin/, con una voce il cui source è "./", la radice del repository. Dai alla voce lo stesso name di plugin.json, secondo Mantieni il nome della voce e il nome del manifest uguali:
.claude-plugin/marketplace.json
Sostituisci your-marketplace con un nome che difficilmente altri autori sceglierebbero, perché un utente non può avere due marketplace con lo stesso nome. Nella tua shell, esegui claude plugin validate . nel repository prima di eseguire il push. Per sapere cosa controlla l’esecuzione, vedi Convalida una directory. Crea un marketplace copre il layout con diversi plugin in un repository.

​
Controlla chi può installare

Chiunque possa clonare il repository può installare da esso, quindi se il repository è privato, anche il marketplace è privato. Per host diversi da un repository git, vedi Ospita un marketplace. Per raggiungere tutti in un’azienda, incluse le persone che non usano git, vedi Distribuisci a un’intera azienda.

​
Comunica agli utenti come installare

Comunica ai tuoi utenti di aggiungere il marketplace e quindi installare il plugin dal loro shell, sostituendo la fonte e i nomi con i tuoi:
  • Aggiungi il marketplace una volta: claude plugin marketplace add your-org/your-marketplace, dove l’argomento è una scorciatoia GitHub owner/repo, un URL o un percorso
  • Installa il plugin: claude plugin install deploy-helper@your-marketplace
  • Oppure fai entrambi da dentro una sessione: /plugin install deploy-helper --marketplace your-org/your-marketplace. Richiede Claude Code v2.1.275 o successivo. Vedi Aggiungi un marketplace e installa in un comando
  • Oppure fai entrambi dalla shell in un solo comando: claude plugin install deploy-helper --marketplace your-org/your-marketplace. Richiede Claude Code v2.1.292 o successivo

​
Spedisci aggiornamenti agli utenti

Gli utenti ricevono un rilascio quando lo chiedono o quando l’aggiornamento automatico è attivato per il tuo marketplace:
  • Su richiesta: claude plugin update deploy-helper@your-marketplace nel shell dell’utente aggiorna il marketplace e installa la nuova copia quando la versione del tuo plugin è cambiata
  • Aggiornamento automatico: disattivato per impostazione predefinita per il tuo marketplace. Vedi Attiva l’aggiornamento automatico. Una volta attivato, fa lo stesso di claude plugin update con un ritardo dopo l’avvio della sessione
Installa plugin copre i comandi lato utente, e quando viene eseguito l’aggiornamento automatico copre i tempi.

​
Invia alla directory di Anthropic

La directory di Anthropic è il catalogo che le persone sfogliano su claude.ai e in Cowork per aggiungere plugin e connettori. Un’inserzione lì raggiunge le persone su claude.ai, in Cowork e in Claude Code. Invii dal portale degli sviluppatori su claude.ai/directory/manage, e Invia un plugin su claude.com illustra il portale passo dopo passo. Il marketplace ufficiale di Anthropic, claude-plugins-official, non accetta invii attraverso il portale della directory. Se lavori con un contatto partner di Anthropic, chiedi loro informazioni su un’inserzione nel marketplace ufficiale. Per inviare un plugin:
1

Conferma che puoi inviare

L’invio richiede un piano claude.ai a pagamento. Su Pro, Max e Ultra invii dal tuo account personale. Su Team e Enterprise, un Proprietario può inviare, e su Enterprise un Proprietario può anche concedere il permesso Directory ad altri membri attraverso un ruolo personalizzato in Impostazioni organizzazione > Ruoli. Vedi Conferma che puoi inviare alla directory.
2

Convalida il plugin localmente

Esegui claude plugin validate ./your-plugin --strict nella tua shell. Sostituisci ./your-plugin con il percorso della tua directory plugin. Il comando cattura gli errori del manifest localmente; plugin validate elenca quali file ogni esecuzione legge. Il portale applica regole di directory aggiuntive che la CLI non controlla, quindi un’esecuzione locale pulita non garantisce una convalida del portale pulita.La checklist di pre-invio del plugin su claude.com contiene i controlli da eseguire e correggere prima di inviare.
3

Controlla cosa si carica dove

Alcuni componenti del plugin sono solo Claude Code e non si caricano su claude.ai o in Cowork. La tabella di supporto dei componenti elenca ogni componente per app, così sai cosa riceveranno gli utenti al di fuori di Claude Code.
4

Invia nel portale degli sviluppatori

Apri il portale degli sviluppatori su claude.ai/directory/manage e segui Invia un plugin su claude.com.
Il resto del processo è documentato su claude.com:

​
Come un plugin elencato raggiunge gli utenti di Claude Code

Una persona che installa il tuo plugin dalla directory su claude.ai lo ha sul suo account, e Claude Code lo carica come <name>@synced. Plugin sincronizzati da claude.ai copre cosa vedono e come lo disattivano.

​
Spedisci aggiornamenti, ridenominazioni e rimozioni

​
Rilascia una nuova versione

Se pubblichi attraverso il tuo marketplace personale e il tuo plugin.json imposta version, incrementala e esegui il push. Gli utenti che eseguono claude plugin update o hanno l’aggiornamento automatico attivato ricevono la nuova versione, come descritto in Spedisci aggiornamenti agli utenti. Per un elenco di directory, vedi Aggiorna un plugin pubblicato.

​
Etichetta un rilascio

Etichetta il rilascio in git quando altri plugin dichiarano un intervallo di versione sul tuo, perché quegli intervalli si risolvono rispetto ai tag. Altrimenti non hai bisogno di un tag. Per etichettare, esegui claude plugin tag nel tuo shell dalla directory del plugin. Crea un tag {name}--v{version}. Aggiungi --push per inviare il tag a origin. Il riferimento plugin tag elenca i suoi flag.

​
Rinomina o rimuovi un plugin

Non modificare mai il name di un plugin pubblicato. Dopo una ridenominazione, gli utenti che lo hanno già installato perdono il plugin, perché la loro installazione è registrata sotto il vecchio nome. Una voce renames nel tuo file marketplace li migra invece. Cambia displayName quando vuoi un’etichetta diversa. Se una ridenominazione è inevitabile, utilizza la mappa renames del file marketplace in modo che le installazioni esistenti migrino invece di fallire con Plugin "<name>" not found in marketplace. Per rimuovere un plugin dal marketplace, o per i dettagli completi di renames, vedi Rinomina o rimuovi un plugin nella pagina di hosting. Il riferimento marketplace ha il campo.

​
Dichiara dipendenze

Se il tuo plugin ha bisogno di un altro plugin dello stesso marketplace per essere abilitato, elencalo nell’array dependencies di plugin.json. Ogni voce è un nome semplice o un oggetto con un intervallo di versione semver. Quando un utente installa il tuo plugin, Claude Code installa e abilita anche la dipendenza. Dipendenze dei plugin copre la sintassi dell’intervallo, le dipendenze tra marketplace e come gli utenti potano le dipendenze di cui non hanno più bisogno.

​
Passaggi successivi