Marketplace dei plugin - Claude Code Docs

I marketplace dei plugin sono cataloghi di plugin disponibili che facilitano la scoperta, l’installazione e la gestione delle estensioni Claude Code. Questa guida mostra come utilizzare i marketplace esistenti e crearne uno proprio per la distribuzione all’interno del team.

Panoramica

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

Scoperta centralizzata: Sfoglia i plugin da più fonti in un unico posto
Gestione delle versioni: Traccia e aggiorna automaticamente le versioni dei plugin
Distribuzione del team: Condividi i plugin richiesti in tutta l’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 di file JSON
Per la creazione di marketplace: Repository Git o ambiente di sviluppo locale

Aggiungi e utilizza i marketplace

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

Aggiungi marketplace GitHub

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

/plugin marketplace add owner/repo

Aggiungi repository Git

Aggiungi qualsiasi repository git

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

Aggiungi 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

Installa 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

Verifica l’installazione del marketplace

Dopo aver aggiunto un marketplace:

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

Configura marketplace del team

Configura 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 considerano attendibile la cartella del repository, Claude Code installa automaticamente questi marketplace e tutti i plugin specificati nel campo enabledPlugins.

Crea il tuo marketplace

Crea e distribuisci raccolte 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 di file JSON
Uno o più plugin da distribuire

Crea il file del 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": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

Schema del marketplace

Campi obbligatori

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

Metadati facoltativi

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

Voci dei plugin

Le voci dei plugin si basano sullo schema del manifesto del plugin (con tutti i campi resi facoltativi) più i campi specifici del marketplace (source, category, tags, strict), con name obbligatorio.

Campi obbligatori:

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

Campi plugin facoltativi

Campi di metadati standard:

Campo	Tipo	Descrizione
`description`	string	Breve descrizione del plugin
`version`	string	Versione del plugin
`author`	object	Informazioni sull’autore del plugin
`homepage`	string	URL della homepage o della documentazione del plugin
`repository`	string	URL del repository del codice sorgente
`license`	string	Identificatore di licenza SPDX (ad es. MIT, Apache-2.0)
`keywords`	array	Tag per la scoperta e la categorizzazione dei 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 del componente:

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 questi valori. Quando strict: false, il plugin.json è facoltativo. Se manca, la voce del marketplace funge da manifesto completo del plugin.}

Fonti dei plugin

Percorsi relativi

Per i 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 di plugin avanzate

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

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise workflow automation tools",
  "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 facoltativi, più i campi specifici del marketplace (source, strict, category, tags). Ciò 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 funge da manifesto completo del plugin se non esiste alcun plugin.json. Quando strict: true (predefinito), i campi del marketplace integrano il file manifesto del plugin stesso.

Ospita e distribuisci i marketplace

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

Ospita su GitHub (consigliato)

GitHub fornisce il metodo di distribuzione più semplice:

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

Vantaggi: Funzionalità integrate di controllo della versione, tracciamento dei problemi e collaborazione del team.

Ospita su altri servizi git

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

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

Utilizza marketplace locali per lo sviluppo

Prova il tuo marketplace localmente prima della distribuzione:

Aggiungi marketplace locale per il test

/plugin marketplace add ./my-local-marketplace

Prova l'installazione del plugin

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

Gestisci le operazioni del marketplace

Elenca i marketplace conosciuti

Elenca tutti i marketplace configurati

/plugin marketplace list

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

Aggiorna i metadati del marketplace

/plugin marketplace update marketplace-name

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

Rimuovi un marketplace

/plugin marketplace remove marketplace-name

Rimuove il marketplace dalla tua configurazione.

La rimozione di un marketplace disinstallerà tutti i plugin che hai installato da esso.

Risoluzione dei problemi dei marketplace

Problemi comuni del marketplace

Il marketplace non si carica

Sintomi: Non riesci ad aggiungere il marketplace o a 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 i repository privati, conferma di avere i permessi di accesso

Errori di installazione del plugin

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

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

Convalida e test

Prova il tuo marketplace prima di condividerlo:

Convalida la sintassi JSON del marketplace

claude plugin validate .

Aggiungi marketplace per il test

/plugin marketplace add ./path/to/marketplace

Installa il plugin di test

/plugin install test-plugin@marketplace-name

Per i flussi di lavoro completi di test dei plugin, vedi Prova i tuoi plugin localmente. Per la risoluzione dei problemi tecnici, vedi Riferimento dei plugin.

Passaggi successivi

Per gli utenti del marketplace

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

Per i creatori del marketplace

Crea raccolte di plugin: Crea marketplace tematici attorno a casi d’uso specifici
Stabilisci il versionamento: Implementa politiche di versionamento e aggiornamento chiare
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: Configura 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 efficacemente i plugin utili

Vedi anche

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

Amministrazione

​Panoramica

​Prerequisiti

​Aggiungi e utilizza i marketplace

​Aggiungi marketplace GitHub

​Aggiungi repository Git

​Aggiungi marketplace locali per lo sviluppo

​Installa plugin dai marketplace

​Verifica l’installazione del marketplace

​Configura marketplace del team

​Crea il tuo marketplace

​Prerequisiti per la creazione del marketplace

​Crea il file del marketplace

​Schema del marketplace

​Campi obbligatori

​Metadati facoltativi

​Voci dei plugin

​Campi plugin facoltativi

​Fonti dei plugin

​Percorsi relativi

​Repository GitHub

​Repository Git

​Voci di plugin avanzate

​Ospita e distribuisci i marketplace

​Ospita su GitHub (consigliato)

​Ospita su altri servizi git

​Utilizza marketplace locali per lo sviluppo

​Gestisci le operazioni del marketplace

​Elenca i marketplace conosciuti

​Aggiorna i metadati del marketplace

​Rimuovi un marketplace

​Risoluzione dei problemi dei marketplace

​Problemi comuni del marketplace

​Il marketplace non si carica

​Errori di installazione del plugin

​Convalida e test

​Passaggi successivi

​Per gli utenti del marketplace

​Per i creatori del marketplace

​Per le organizzazioni

​Vedi anche

Panoramica

Prerequisiti

Aggiungi e utilizza i marketplace

Aggiungi marketplace GitHub

Aggiungi repository Git

Aggiungi marketplace locali per lo sviluppo

Installa plugin dai marketplace

Verifica l’installazione del marketplace

Configura marketplace del team

Crea il tuo marketplace

Prerequisiti per la creazione del marketplace

Crea il file del marketplace

Schema del marketplace

Campi obbligatori

Metadati facoltativi

Voci dei plugin

Campi plugin facoltativi

Fonti dei plugin

Percorsi relativi

Repository GitHub

Repository Git

Voci di plugin avanzate

Ospita e distribuisci i marketplace

Ospita su GitHub (consigliato)

Ospita su altri servizi git

Utilizza marketplace locali per lo sviluppo

Gestisci le operazioni del marketplace

Elenca i marketplace conosciuti

Aggiorna i metadati del marketplace

Rimuovi un marketplace

Risoluzione dei problemi dei marketplace

Problemi comuni del marketplace

Il marketplace non si carica

Errori di installazione del plugin

Convalida e test

Passaggi successivi

Per gli utenti del marketplace

Per i creatori del marketplace

Per le organizzazioni

Vedi anche