Marketplace dei plugin

I marketplace dei plugin sono cataloghi di plugin disponibili che rendono facile scoprire, installare e gestire le estensioni di Claude Code. Questa guida ti mostra come utilizzare i marketplace esistenti e crearne di tuoi per la distribuzione del team.

Panoramica

Un marketplace è un file JSON che elenca i plugin disponibili e descrive dove trovarli. I marketplace forniscono:

Scoperta centralizzata: Sfoglia plugin da più fonti in un unico posto
Gestione delle versioni: Traccia e aggiorna automaticamente le versioni dei plugin
Distribuzione del team: Condividi plugin richiesti in tutta la tua organizzazione
Fonti flessibili: Supporto per repository git, repository GitHub, percorsi locali e gestori di pacchetti

Prerequisiti

Claude Code installato e in esecuzione
Familiarità di base con il formato file JSON
Per creare marketplace: Repository Git o ambiente di sviluppo locale

Aggiungere e utilizzare marketplace

Aggiungi marketplace utilizzando i comandi /plugin marketplace per accedere ai plugin da diverse fonti:

Aggiungere marketplace GitHub

Aggiungi un repository GitHub contenente .claude-plugin/marketplace.json

/plugin marketplace add owner/repo

Aggiungere repository Git

Aggiungi qualsiasi repository git

/plugin marketplace add https://gitlab.com/company/plugins.git

Aggiungere marketplace locali per lo sviluppo

Aggiungi directory locale contenente .claude-plugin/marketplace.json

/plugin marketplace add ./my-marketplace

Aggiungi percorso diretto al file marketplace.json

/plugin marketplace add ./path/to/marketplace.json

Aggiungi marketplace.json remoto tramite URL

/plugin marketplace add https://url.of/marketplace.json

Installare plugin dai marketplace

Una volta aggiunti i marketplace, installa i plugin direttamente:

Installa da qualsiasi marketplace conosciuto

/plugin install plugin-name@marketplace-name

Sfoglia i plugin disponibili in modo interattivo

/plugin

Verificare l’installazione del marketplace

Dopo aver aggiunto un marketplace:

Elenca marketplace: Esegui /plugin marketplace list per confermare che sia stato aggiunto
Sfoglia plugin: Usa /plugin per vedere i plugin disponibili dal tuo marketplace
Testa l’installazione: Prova a installare un plugin per verificare che il marketplace funzioni correttamente

Configurare marketplace del team

Imposta l’installazione automatica del marketplace per i progetti del team specificando i marketplace richiesti in .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    },
    "project-specific": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}

Quando i membri del team si fidano della cartella del repository, Claude Code installa automaticamente questi marketplace e qualsiasi plugin specificato nel campo enabledPlugins.

Creare il tuo marketplace

Costruisci e distribuisci collezioni di plugin personalizzate per il tuo team o comunità.

Prerequisiti per la creazione del marketplace

Repository Git (GitHub, GitLab o altro hosting git)
Comprensione del formato file JSON
Uno o più plugin da distribuire

Creare il file marketplace

Crea .claude-plugin/marketplace.json nella radice del tuo repository:

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Formattazione automatica del codice al salvataggio",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Strumenti di automazione del deployment"
    }
  ]
}

Schema del marketplace

Campi obbligatori

Campo	Tipo	Descrizione
`name`	string	Identificatore del marketplace (kebab-case, senza spazi)
`owner`	object	Informazioni del manutentore del marketplace
`plugins`	array	Lista dei plugin disponibili

Metadati opzionali

Campo	Tipo	Descrizione
`metadata.description`	string	Breve descrizione del marketplace
`metadata.version`	string	Versione del marketplace
`metadata.pluginRoot`	string	Percorso base per le fonti relative dei plugin

Voci dei plugin

Le voci dei plugin sono basate sullo schema del manifesto del plugin (con tutti i campi resi opzionali) più campi specifici del marketplace (source, category, tags, strict), con name che è obbligatorio.

Campi obbligatori:

Campo	Tipo	Descrizione
`name`	string	Identificatore del plugin (kebab-case, senza spazi)
`source`	string\|object	Da dove recuperare il plugin

Campi opzionali del plugin

Campi di metadati standard:

Campo	Tipo	Descrizione
`description`	string	Breve descrizione del plugin
`version`	string	Versione del plugin
`author`	object	Informazioni dell’autore del plugin
`homepage`	string	Homepage del plugin o URL della documentazione
`repository`	string	URL del repository del codice sorgente
`license`	string	Identificatore di licenza SPDX (es. MIT, Apache-2.0)
`keywords`	array	Tag per la scoperta e categorizzazione del plugin
`category`	string	Categoria del plugin per l’organizzazione
`tags`	array	Tag per la ricercabilità
`strict`	boolean	Richiedi plugin.json nella cartella del plugin (predefinito: true) ¹

Campi di configurazione dei componenti:

Campo	Tipo	Descrizione
`commands`	string\|array	Percorsi personalizzati ai file o directory dei comandi
`agents`	string\|array	Percorsi personalizzati ai file degli agenti
`hooks`	string\|object	Configurazione degli hook personalizzati o percorso al file degli hook
`mcpServers`	string\|object	Configurazioni del server MCP o percorso alla configurazione MCP

^{1 - Quando strict: true (predefinito), il plugin deve includere un file manifesto plugin.json, e i campi del marketplace integrano quei valori. Quando strict: false, il plugin.json è opzionale. Se manca, la voce del marketplace serve come manifesto completo del plugin.}

Fonti dei plugin

Percorsi relativi

Per plugin nello stesso repository:

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

Repository GitHub

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

Repository Git

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

Voci avanzate dei plugin

Le voci dei plugin possono sovrascrivere le posizioni predefinite dei componenti e fornire metadati aggiuntivi. Nota che ${CLAUDE_PLUGIN_ROOT} è una variabile d’ambiente che si risolve nella directory di installazione del plugin (per i dettagli vedi Variabili d’ambiente):

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Strumenti di automazione del flusso di lavoro aziendale",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "[email protected]"
  },
  "homepage": "https://docs.company.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": [
    "./agents/security-reviewer.md",
    "./agents/compliance-checker.md"
  ],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{"type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"}]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}

Relazione dello schema: Le voci dei plugin utilizzano lo schema del manifesto del plugin con tutti i campi resi opzionali, più campi specifici del marketplace (source, strict, category, tags). Questo significa che qualsiasi campo valido in un file plugin.json può essere utilizzato anche in una voce del marketplace. Quando strict: false, la voce del marketplace serve come manifesto completo del plugin se non esiste plugin.json. Quando strict: true (predefinito), i campi del marketplace integrano il file manifesto del plugin stesso.

Ospitare e distribuire marketplace

Scegli la migliore strategia di hosting per le tue esigenze di distribuzione dei plugin.

Ospitare su GitHub (raccomandato)

GitHub fornisce il metodo di distribuzione più facile:

Crea un repository: Imposta un nuovo repository per il tuo marketplace
Aggiungi file marketplace: Crea .claude-plugin/marketplace.json con le tue definizioni di plugin
Condividi con i team: I membri del team aggiungono con /plugin marketplace add owner/repo

Vantaggi: Controllo versione integrato, tracciamento dei problemi e funzionalità di collaborazione del team.

Ospitare su altri servizi git

Qualsiasi servizio di hosting git funziona per la distribuzione del marketplace, utilizzando un URL a un repository git arbitrario. Ad esempio, utilizzando GitLab:

/plugin marketplace add https://gitlab.com/company/plugins.git

Utilizzare marketplace locali per lo sviluppo

Testa il tuo marketplace localmente prima della distribuzione:

Aggiungi marketplace locale per il test

/plugin marketplace add ./my-local-marketplace

Testa l'installazione del plugin

/plugin install test-plugin@my-local-marketplace

Gestire le operazioni del marketplace

Elencare marketplace conosciuti

Elenca tutti i marketplace configurati

/plugin marketplace list

Mostra tutti i marketplace configurati con le loro fonti e stato.

Aggiornare i metadati del marketplace

Aggiorna i metadati del marketplace

/plugin marketplace update marketplace-name

Aggiorna gli elenchi dei plugin e i metadati dalla fonte del marketplace.

Rimuovere un marketplace

Rimuovi un marketplace

/plugin marketplace remove marketplace-name

Rimuove il marketplace dalla tua configurazione.

Rimuovere un marketplace disinstallerà qualsiasi plugin che hai installato da esso.

Risoluzione dei problemi dei marketplace

Problemi comuni del marketplace

Marketplace non si carica

Sintomi: Non riesci ad aggiungere il marketplace o vedere i plugin da esso Soluzioni:

Verifica che l’URL del marketplace sia accessibile
Controlla che .claude-plugin/marketplace.json esista nel percorso specificato
Assicurati che la sintassi JSON sia valida utilizzando claude plugin validate
Per repository privati, conferma di avere i permessi di accesso

Fallimenti nell’installazione dei plugin

Sintomi: Il marketplace appare ma l’installazione del plugin fallisce Soluzioni:

Verifica che gli URL delle fonti dei plugin siano accessibili
Controlla che le directory dei plugin contengano i file richiesti
Per fonti GitHub, assicurati che i repository siano pubblici o che tu abbia accesso
Testa le fonti dei plugin manualmente clonando/scaricando

Validazione e test

Testa il tuo marketplace prima di condividerlo:

Valida la sintassi JSON del marketplace

claude plugin validate .

Aggiungi marketplace per il test

/plugin marketplace add ./path/to/marketplace

Installa plugin di test

/plugin install test-plugin@marketplace-name

Per flussi di lavoro completi di test dei plugin, vedi Testa i tuoi plugin localmente. Per risoluzione tecnica dei problemi, vedi Riferimento plugin.

Prossimi passi

Per gli utenti del marketplace

Scopri marketplace della comunità: Cerca su GitHub collezioni di plugin di Claude Code
Contribuisci con feedback: Segnala problemi e suggerisci miglioramenti ai manutentori del marketplace
Condividi marketplace utili: Aiuta il tuo team a scoprire collezioni di plugin preziose

Per i creatori di marketplace

Costruisci collezioni di plugin: Crea marketplace tematici intorno a casi d’uso specifici
Stabilisci versioning: Implementa politiche chiare di versioning e aggiornamento
Coinvolgimento della comunità: Raccogli feedback e mantieni comunità di marketplace attive
Documentazione: Fornisci file README chiari che spiegano i contenuti del tuo marketplace

Per le organizzazioni

Marketplace privati: Imposta marketplace interni per strumenti proprietari
Politiche di governance: Stabilisci linee guida per l’approvazione dei plugin e la revisione della sicurezza
Risorse di formazione: Aiuta i team a scoprire e adottare plugin utili in modo efficace

Vedi anche

Plugin - Installazione e utilizzo dei plugin
Riferimento plugin - Specifiche tecniche complete e schemi
Sviluppo plugin - Creazione dei tuoi plugin
Impostazioni - Opzioni di configurazione dei plugin

Iniziare

Sviluppa con Claude Code

Claude Code SDK

Distribuzione

Amministrazione

Configurazione

Riferimento

Risorse

​Panoramica

​Prerequisiti

​Aggiungere e utilizzare marketplace

​Aggiungere marketplace GitHub

​Aggiungere repository Git

​Aggiungere marketplace locali per lo sviluppo

​Installare plugin dai marketplace

​Verificare l’installazione del marketplace

​Configurare marketplace del team

​Creare il tuo marketplace

​Prerequisiti per la creazione del marketplace

​Creare il file marketplace

​Schema del marketplace

​Campi obbligatori

​Metadati opzionali

​Voci dei plugin

​Campi opzionali del plugin

​Fonti dei plugin

​Percorsi relativi

​Repository GitHub

​Repository Git

​Voci avanzate dei plugin

​Ospitare e distribuire marketplace

​Ospitare su GitHub (raccomandato)

​Ospitare su altri servizi git

​Utilizzare marketplace locali per lo sviluppo

​Gestire le operazioni del marketplace

​Elencare marketplace conosciuti

​Aggiornare i metadati del marketplace

​Rimuovere un marketplace

​Risoluzione dei problemi dei marketplace

​Problemi comuni del marketplace

​Marketplace non si carica

​Fallimenti nell’installazione dei plugin

​Validazione e test

​Prossimi passi

​Per gli utenti del marketplace

​Per i creatori di marketplace

​Per le organizzazioni

​Vedi anche

Panoramica

Prerequisiti

Aggiungere e utilizzare marketplace

Aggiungere marketplace GitHub

Aggiungere repository Git

Aggiungere marketplace locali per lo sviluppo

Installare plugin dai marketplace

Verificare l’installazione del marketplace

Configurare marketplace del team

Creare il tuo marketplace

Prerequisiti per la creazione del marketplace

Creare il file marketplace

Schema del marketplace

Campi obbligatori

Metadati opzionali

Voci dei plugin

Campi opzionali del plugin

Fonti dei plugin

Percorsi relativi

Repository GitHub

Repository Git

Voci avanzate dei plugin

Ospitare e distribuire marketplace

Ospitare su GitHub (raccomandato)

Ospitare su altri servizi git

Utilizzare marketplace locali per lo sviluppo

Gestire le operazioni del marketplace

Elencare marketplace conosciuti

Aggiornare i metadati del marketplace

Rimuovere un marketplace

Risoluzione dei problemi dei marketplace

Problemi comuni del marketplace

Marketplace non si carica

Fallimenti nell’installazione dei plugin

Validazione e test

Prossimi passi

Per gli utenti del marketplace

Per i creatori di marketplace

Per le organizzazioni

Vedi anche