I marketplace dei plugin consentono ai proprietari dei piani Team ed Enterprise di distribuire plugin curati a tutti gli utenti della loro organizzazione. Crei un marketplace, aggiungi plugin ad esso e controlli esattamente quali plugin i tuoi colleghi possono vedere e utilizzare. I plugin che distribuisci vengono visualizzati nella chat (sul web e nella scheda Chat in Claude Desktop), in Claude Cowork e nelle sessioni Claude Code dove i membri accedono con lo stesso account Claude.
I proprietari e i proprietari principali dei piani Team ed Enterprise possono gestire i plugin dell'organizzazione in Impostazioni organizzazione > Plugin e competenze. Nei piani Enterprise, anche i membri con un ruolo personalizzato che include la gestione delle librerie dell'organizzazione possono farlo.
Requisiti: Cowork e Skills devono essere entrambi abilitati per la tua organizzazione prima di poter utilizzare i marketplace dei plugin.
Per una versione di riferimento di questi controlli, consulta Gestisci i plugin per la tua organizzazione nella documentazione di Claude Code.
Nota: Disattivare Skills per la tua organizzazione interrompe anche la sincronizzazione di competenze e plugin con Claude Code e rimuove quelli già sincronizzati. Disattivare Cowork non influisce sulla sincronizzazione con Claude Code. Per mantenere competenze e plugin in Claude ma interrompere solo la sincronizzazione, imposta syncClaudeAiSkills e syncClaudeAiPlugins su false nelle impostazioni gestite di Claude Code. Scopri di più su configurazione amministratore di Claude Code.
Nota: I marketplace sono il modo in cui i proprietari distribuiscono i plugin alla loro organizzazione. Gli utenti possono anche condividere un plugin che hanno creato con colleghi o gruppi specifici, oppure inviarlo per la pubblicazione nella libreria della tua organizzazione. La condivisione e la pubblicazione sono controllate dalle impostazioni in Impostazioni organizzazione > Plugin e competenze nella scheda "Policy", e gli invii di plugin vengono esaminati lì nella scheda "Requests". Scopri di più su utilizzo dei plugin in Claude e consentire agli utenti di pubblicare competenze e plugin nella tua organizzazione.
Vedi cosa c'è nella tua organizzazione
La scheda "Inventory" elenca ogni competenza e plugin che la tua organizzazione gestisce, inclusi quelli creati dagli utenti per se stessi. Le competenze e i plugin ora si trovano sulla stessa pagina, quindi non è necessario passare da un'impostazione all'altra.
Per ogni elemento, la tabella mostra la sua origine, versione, capacità, pubblico e quante persone l'hanno utilizzato negli ultimi 30 giorni.
Per trovare un elemento, cerca per nome o utilizza i filtri:
Origine: La tua organizzazione, Libreria organizzazione o un marketplace specifico
Pubblico: Chi può utilizzare l'elemento
Tipo: Competenze o plugin
Le competenze gestite dalla tua organizzazione vengono visualizzate in Libreria organizzazione. Gestisci i marketplace dei plugin nella scheda Marketplace.
Per agire su un elemento, fai clic sul pulsante del menu alla fine della sua riga. Puoi visualizzare i dettagli e i file, consultare la cronologia delle versioni e modificare l'accesso predefinito e di gruppo.
Per le competenze e i plugin creati dagli utenti, la scheda Inventory mostra i metadati e lo stato di condivisione. Non mostra i file stessi.
Utilizza i marketplace creati da Anthropic
Anthropic fornisce marketplace integrati di plugin per diverse funzioni, come legale e finanza. Un marketplace Knowledge Work viene aggiunto alla tua organizzazione per impostazione predefinita.
Per aggiungere un marketplace creato da Anthropic:
Vai a Impostazioni organizzazione > Plugin e competenze e fai clic sulla scheda "Marketplace".
Fai clic su "Aggiungi", quindi seleziona "Aggiungi marketplace".
Seleziona "Sfoglia fonti Anthropic".
Fai clic su "Aggiungi" su ognuno che desideri venga visualizzato per tutti gli utenti della tua organizzazione.
Per rimuovere il marketplace Knowledge Work se non è rilevante per i tuoi team:
Vai a Impostazioni organizzazione > Plugin e competenze e fai clic sulla scheda "Marketplace".
Trova Knowledge Work.
Fai clic sul pulsante del menu nell'angolo in alto a destra.
Seleziona "Rimuovi".
I marketplace creati da Anthropic mostrano nomi leggibili, come "Knowledge Work", invece dello slug del repository sottostante.
Crea il tuo marketplace
Oltre ai marketplace creati da Anthropic, puoi crearne uno tuo. Ci sono due modi per aggiungere plugin a un marketplace che crei:
Caricamento manuale: Carica singoli file ZIP di plugin tramite l'interfaccia utente amministratore. Ideale per iterazioni rapide, strumenti una tantum o team che non mantengono plugin in un repository Git.
Sincronizzazione del repository: Connetti un repository GitHub o GitLab privato e Claude sincronizza i plugin da esso. Ideale quando più sviluppatori collaborano ai plugin o desideri aggiornamenti controllati dalla versione.
Puoi utilizzare entrambi gli approcci in parallelo. Ad esempio, esegui un marketplace sincronizzato con GitHub per i tuoi plugin principali e un marketplace manuale separato per strumenti ad hoc.
Configura un marketplace manuale
Fai clic su "Aggiungi", quindi seleziona "Carica un plugin".
Se è la prima volta che configuri un marketplace, "Carica in un nuovo marketplace" è selezionato automaticamente. Potrai scegliere "Aggiungi a un marketplace esistente" quando carichi plugin in seguito.
Immetti un nome per il tuo marketplace.
Trascina i tuoi file oppure fai clic sul prompt di caricamento e seleziona il tuo file. Il file deve essere un .zip valido inferiore a 200 MB.
Ripeti per ogni plugin che desideri aggiungere.
Fai clic su "Carica" per aggiungere i tuoi plugin a un nuovo marketplace.
Se carichi un plugin con lo stesso nome di uno esistente, sovrascrive automaticamente la versione precedente. Non è necessario eliminare prima quello vecchio.
Configura un marketplace sincronizzato con GitHub
La sincronizzazione GitHub ti consente di gestire i plugin come codice in un repository. Quando esegui il push delle modifiche, puoi attivare una sincronizzazione per aggiornare il tuo marketplace, manualmente o automaticamente.
Prepara il tuo repository
Puoi connettere un repository ospitato su github.com o sull'host GitHub Enterprise della tua organizzazione. Su github.com, il tuo repository deve essere privato o interno—i repository pubblici non sono consentiti per i marketplace dell'organizzazione. Per sincronizzare da GitLab, consulta Configura un marketplace sincronizzato con GitLab.
I marketplace sincronizzati con GitHub supportano un set più ristretto di tipi di source in marketplace.json rispetto a Claude Code. I percorsi relativi alle cartelle dei plugin all'interno del repository del marketplace (ad esempio, "source": "./plugins/my-plugin") sono completamente supportati e sono l'opzione più semplice. I tipi di origine github, url e git-subdir sono supportati. I tipi di origine npm, archive e command non sono supportati.
Un'origine di plugin può essere privata in tre casi:
Una fonte github.com che condivide il proprietario del repository del tuo marketplace, che la sincronizzazione dell'organizzazione recupera tramite l'app Claude GitHub.
Una fonte su GitHub Enterprise host della tua organizzazione con l'app Claude GitHub Enterprise installata su quel repository.
Una fonte url o git-subdir sullo stesso host GitLab del tuo repository marketplace. Su gitlab.com, la fonte deve trovarsi anche nello stesso gruppo di primo livello o namespace utente del repository marketplace.
Tutte le altre fonti vengono recuperate senza credenziali, quindi deve essere un repository pubblico su github.com, gitlab.com o bitbucket.org. Le fonti su qualsiasi altro host vengono rifiutate.
Se il codice del tuo plugin si trova in un repository privato che non soddisfa i criteri sopra, copia quelle cartelle di plugin nel repository marketplace e cambia la fonte di ogni plugin in un percorso relativo (un git subtree o un passaggio CI che vendita i file funziona bene).
Per i dettagli sulla struttura e la formattazione dei plugin, consulta il riferimento del manifest del plugin.
Risorse aggiuntive:
Connetti il repository
Assicurati che sia Cowork che Skills siano abilitati per la tua organizzazione.
Vai a Impostazioni organizzazione > Plugin e skill e fai clic sulla scheda "Marketplace".
Fai clic su "Aggiungi plugin", quindi seleziona "Sincronizza da GitHub".
Inserisci il repository nel formato
owner/repo(ad esempio,acme-corp/claude-plugins).
Il tuo token GitHub personale viene verificato per confermare che hai accesso, quindi Cowork utilizza il token di installazione dell'app GitHub per le operazioni di sincronizzazione.
Non riesci a vedere il tuo repository? Assicurati che l'app Claude GitHub sia installata in quel repository.
Come funziona la sincronizzazione
Una sincronizzazione iniziale viene eseguita automaticamente quando connetti un repository. Nel flusso di creazione di GitHub, puoi anche disattivare "Sincronizza automaticamente", che è attivo per impostazione predefinita. Con questa opzione attiva, una sincronizzazione viene eseguita quando una pull request viene unita al ramo che il marketplace segue, o quando qualcuno esegue il push direttamente a quel ramo.
La persona che attiva o disattiva la sincronizzazione automatica deve avere accesso a livello di amministratore a quel repository su GitHub. Questo viene verificato tramite la loro connessione GitHub personale, che è separata dall'installazione dell'app Claude GitHub. Senza accesso amministratore, la pagina mostra "Impossibile accedere al repository. Assicurati che il repository esista e che l'app Claude GitHub sia installata", anche quando l'app è installata correttamente e gli aggiornamenti manuali funzionano.
Il permesso Webhook (Lettura e Scrittura) dell'app Claude GitHub deve essere approvato anche nell'installazione. Nelle installazioni create prima dell'introduzione di questo permesso, GitHub mostra un prompt "Claude sta richiedendo autorizzazioni aggiornate" che un amministratore del repository o dell'organizzazione deve approvare.
Una volta abilitata, la sincronizzazione automatica per un repository GitHub viene eseguita quando una pull request che include un bump di versione del plugin viene unita al ramo predefinito del repository. I push diretti al ramo predefinito non attivano una sincronizzazione. Puoi sempre attivare una sincronizzazione manualmente facendo clic su "Risincronizza" nel marketplace.
Durante una sincronizzazione, Cowork confronta il commit più recente nel tuo repository con il commit sincronizzato per ultimo. Se non è cambiato nulla, la sincronizzazione viene saltata. Se ci sono modifiche, Cowork legge il manifest, convalida ogni plugin e sostituisce tutti i plugin nel marketplace con lo stato attuale del repository. Le sincronizzazioni possono richiedere fino a 30 minuti a seconda del numero di plugin.
Importante: Se una sincronizzazione non riesce, i membri mantengono l'ultima versione sincronizzata di ogni plugin. Controlla il messaggio di errore, correggi il repository e risincronizza.
Configura un marketplace sincronizzato con GitLab
Puoi sincronizzare un marketplace dell'organizzazione da un repository su gitlab.com o su un'istanza GitLab auto-gestita. Per i tipi di fonte plugin supportati e quali fonti possono essere private, consulta Prepara il tuo repository sopra.
Il supporto di GitLab è in beta e si applica solo alla sincronizzazione del marketplace dei plugin. Claude Code sul web non supporta ancora i repository GitLab.
Prima di iniziare
Ruolo. Hai bisogno del ruolo Proprietario o Proprietario principale per aggiungere una configurazione GitLab.
Visibilità del progetto. Su gitlab.com, il progetto marketplace deve essere privato o interno. Su un'istanza auto-gestita, qualsiasi visibilità funziona.
Token di accesso. Crea un token di accesso GitLab per Claude per leggere il progetto marketplace e qualsiasi progetto di fonte plugin sullo stesso host. Funzionano token di accesso personali, di gruppo e di progetto. L'utente del token ha bisogno almeno del ruolo Reporter su quei progetti.
Token legacy (con ambito): almeno l'ambito
read_api.Token di accesso personale con granularità fine: i permessi Progetto: Lettura, Ramo: Lettura e Repository: Lettura.
Facoltativo, per la configurazione automatica del webhook (passaggio 3): il ruolo Manutentore nel progetto marketplace più l'ambito
api(legacy) o il permesso Webhook: Crea e Elimina (con granularità fine). Senza questi, aggiungi il webhook manualmente una volta (passaggio 4).
Solo istanze auto-gestite.
Il nome host dell'istanza deve risolvere a un indirizzo IP pubblico e l'istanza deve accettare connessioni HTTPS da gli indirizzi IP in uscita di Anthropic.
Se un'autorità di certificazione privata ha emesso il suo certificato TLS, tieni pronto il certificato CA (PEM).
Le consegne dei webhook per la sincronizzazione automatica provengono dalla tua istanza a api.anthropic.com, quindi l'istanza deve essere in grado di effettuare richieste HTTPS in uscita a quell'host.
Passaggio 1: Aggiungi una configurazione GitLab
Per aggiungere una configurazione GitLab:
In Infrastruttura auto-ospitata, trova GitLab e fai clic su "Aggiungi configurazione".
Inserisci un nome visualizzato, il nome host (gitlab.com o il nome host della tua istanza come gitlab.example.com), il token di accesso e, per un'istanza auto-gestita con una CA privata, il certificato CA.
Fai clic su "Aggiungi configurazione". Claude esegue immediatamente un test di connessione e mostra i risultati in una finestra di dialogo Test di connessione GitLab.
(Facoltativo) Per verificare che il token possa leggere il tuo progetto marketplace, inserisci il suo percorso (ad esempio,
platform/claude-plugins) in Percorso progetto e fai clic su "Test accesso sincronizzazione".
Puoi rieseguire il test in qualsiasi momento dal menu della configurazione con Test connessione. Il nome host non può essere modificato in seguito. Se cambia, elimina la configurazione e aggiungine una nuova.
Passaggio 2: Aggiungi il marketplace
Per aggiungere il marketplace:
Vai a Impostazioni organizzazione > Plugin e competenze e fai clic sulla scheda "Marketplace".
Fai clic su "Aggiungi", quindi seleziona "Sincronizza da GitLab".
In URL repository GitLab, inserisci l'URL HTTPS del progetto, ad esempio
https://gitlab.example.com/platform/claude-plugins. I progetti nei sottogruppi annidati funzionano.Mantieni Sincronizzazione automatica attiva se desideri che i push attivino una sincronizzazione (vedi Passaggio 3).
Scegli l'Accesso predefinito per i plugin contenuti nel marketplace.
Fai clic su "Crea".
Claude legge il ramo predefinito del progetto e convalida il file del marketplace prima di creare il marketplace, che prende il nome dal percorso del progetto.
Passaggio 3: Sincronizzazione automatica
Con Sincronizzazione automatica attiva, ogni push al ramo predefinito del progetto attiva una sincronizzazione tramite un webhook nel progetto GitLab. Se il tuo token può gestire i webhook (vedi Prima di iniziare), Claude crea il webhook per te e non c'è nient'altro da fare.
Puoi attivare o disattivare Sincronizzazione automatica in seguito dal menu del marketplace. L'attivazione configura il webhook nello stesso modo.
Passaggio 4: Se Claude non riesce a creare il webhook
Se il token non può gestire i webhook, Claude mostra un messaggio Completa la configurazione del webhook in GitLab sullo schermo con un URL webhook e un token. Il token viene visualizzato una sola volta, quindi completa questo passaggio prima di chiudere il messaggio.
Nel tuo progetto GitLab, apri Impostazioni > Webhook e aggiungi un nuovo webhook con l'URL dal messaggio.
Incolla il token nel campo.
Se il messaggio mostra un Token segreto, incollalo nel campo Token segreto di GitLab.
Se il messaggio mostra un Token di firma (gitlab.com e versioni self-managed 19.1 o successive), seleziona "Genera token di firma" in GitLab e sostituisci il valore generato con quello da Claude.
Abilita Eventi push e salva.
(Facoltativo) Usa Test > Eventi push sul nuovo webhook in GitLab e conferma che segnala HTTP 200.
Se perdi il token, apri Configura webhook dal menu del marketplace, fai clic su "Rimuovi webhook", quindi su "Abilita webhook" per ottenerne uno nuovo. Il vecchio token smetterà di funzionare.
Scegli tra caricamento manuale e sincronizzazione del repository
Scenario | Approccio consigliato |
I plugin sono mantenuti nel controllo versione con CI/CD | Sincronizzazione GitHub o GitLab |
Più sviluppatori collaborano ai plugin | Sincronizzazione GitHub o GitLab |
Desideri la propagazione automatica degli aggiornamenti | Sincronizzazione GitHub o GitLab |
Prototipazione rapida o strumenti una tantum | Caricamento manuale |
Plugin creati da team non tecnici | Caricamento manuale |
Ambienti senza accesso a GitHub o GitLab | Caricamento manuale |
Test di un plugin prima di aggiungerlo a un repository sincronizzato | Caricamento manuale |
Controlla la distribuzione dei plugin
Una volta che il tuo marketplace ha plugin, controlli come vengono distribuiti utilizzando le preferenze di installazione. Per ogni plugin, puoi impostare una di quattro opzioni:
Preferenza | Cosa fa | Cosa vedono i membri |
Installato per impostazione predefinita | Pre-installa il plugin per tutti i membri dell'organizzazione | Il plugin appare nel loro elenco senza alcuna azione. I membri possono disattivarlo se lo desiderano. |
Disponibile per l'installazione | Elencato nella scheda Scopri | Gli utenti lo vedono nella scheda Scopri e possono aggiungerlo da soli. |
Non disponibile | Nascosto completamente | Gli utenti non possono vedere o aggiungere il plugin. Utile per la gestione temporanea o l'obsolescenza dei plugin. |
Obbligatorio | Pre-installa il plugin per tutti i membri dell'organizzazione senza la possibilità di rimuoverlo | Il plugin appare nel loro elenco senza alcuna azione, contrassegnato "Questo plugin è richiesto dalla tua organizzazione." Gli utenti non possono disattivarlo o rimuoverlo. Rimane attivo anche nelle sessioni di Claude Code che sincronizzano i plugin dell'account del membro. |
Importante: I plugin impostati su "Installato per impostazione predefinita" o "Obbligatorio" si installano anche in Claude Code per gli utenti che accedono con il loro account Claude. In Claude Code, gli hook del plugin, i sub-agent e i server MCP vengono eseguiti sul computer dell'utente e un plugin "Obbligatorio" non può essere disabilitato lì. Rivedi gli hook di un plugin prima di impostarlo su "Obbligatorio." Scopri di più sui plugin sincronizzati nella documentazione di Claude Code.
Imposta preferenze
In Impostazioni organizzazione > Plugin e competenze, fai clic sulla scheda "Inventario".
Trova il plugin e fai clic sul pulsante del menu alla fine della sua riga.
Fai clic su "Accesso predefinito", quindi seleziona un'opzione in Installa.
Le modifiche hanno effetto nella sessione successiva di ogni membro o nell'aggiornamento del plugin.
Cosa sperimentano i membri
I membri sfogliano i plugin disponibili nella scheda Scopri in Personalizza > Plugin. I plugin che imposti su "Installato per impostazione predefinita" o "Obbligatorio" appaiono automaticamente nel loro elenco. I plugin che imposti su "Disponibile per l'installazione" vengono visualizzati in Scopri affinché i membri li aggiungano da soli.
I membri non possono modificare i plugin gestiti dall'organizzazione, il che impedisce modifiche conflittuali agli strumenti condivisi.
Personalizza l'accesso ai plugin per gruppo
Gli amministratori Enterprise possono ignorare la preferenza di installazione a livello di organizzazione di un plugin per gruppi specifici. Ad esempio, puoi installare automaticamente un plugin per il gruppo Engineering, renderlo disponibile per Legal per l'installazione autonoma e nasconderlo a tutti gli altri.
L'accesso ai plugin a livello di gruppo è disponibile nei piani Enterprise. Lo imposti nella stessa pagina Impostazioni organizzazione > Plugin e competenze, che richiede un ruolo Owner o personalizzato che includa la gestione delle librerie dell'organizzazione.
Come funzionano gli override dei gruppi
Ogni plugin nel tuo marketplace ha una preferenza di installazione a livello di organizzazione (Installato per impostazione predefinita, Disponibile per l'installazione, Obbligatorio o Non disponibile). Per impostazione predefinita, ogni gruppo eredita l'impostazione a livello di organizzazione.
Quando imposti un override a livello di gruppo per un plugin, sostituisce l'impostazione a livello di organizzazione per i membri di quel gruppo. L'ordine di risoluzione è: impostazione del gruppo, quindi impostazione a livello di organizzazione, quindi impostazione predefinita del marketplace.
Imposta l'accesso ai plugin per un gruppo
In Impostazioni organizzazione > Plugin e competenze, fai clic sulla scheda "Inventario".
Trova il plugin che desideri personalizzare e fai clic sul pulsante del menu alla fine della sua riga.
Fai clic su "Accesso al gruppo...".
Fai clic su "Aggiungi gruppi" accanto a Targeting dell'installazione.
Seleziona il gruppo e scegli una delle preferenze di installazione elencate sopra.
Sia i gruppi creati manualmente che i gruppi forniti da SCIM dal tuo provider di identità appaiono nel selettore di gruppo e funzionano allo stesso modo.
Cosa succede quando un membro appartiene a più gruppi
Se un membro appartiene a due o più gruppi con impostazioni diverse per lo stesso plugin, si applica l'impostazione più permissiva. L'ordine da più a meno permissivo è: Obbligatorio > Installato per impostazione predefinita > Disponibile per l'installazione > Non disponibile.
Ad esempio, se il Gruppo A imposta un plugin su "Non disponibile" e il Gruppo B lo imposta su "Installato per impostazione predefinita", un membro in entrambi i gruppi ottiene il plugin installato per impostazione predefinita.
Nota: Questo differisce da come si risolvono i limiti di spesa dei gruppi. I limiti di spesa applicano il valore del gruppo più alto o più basso a seconda dell'impostazione Limite di spesa multi-gruppo. L'accesso ai plugin applica il valore più permissivo, perché i gruppi qui sono destinati a abilitare l'accesso per i team che hanno bisogno di uno strumento, non a fungere da limite di sicurezza. Se hai bisogno di bloccare completamente un plugin, imposta la sua preferenza a livello di organizzazione su "Non disponibile" e concedi l'accesso solo ai gruppi che dovrebbero averlo.
Cosa succede quando un gruppo viene eliminato
Se un gruppo viene rimosso (ad esempio, eliminato dal tuo provider di identità), l'override rimane nell'interfaccia utente di amministrazione ma è contrassegnato come orfano. Non ha alcun effetto sui membri (poiché nessuno appartiene a un gruppo eliminato) e non conta verso il badge di accesso personalizzato. Puoi cancellare gli override orfani dalle impostazioni "Accesso al gruppo..." del plugin.
Le impostazioni del gruppo persistono tra le risincronizzazioni del marketplace?
Sì. Gli override a livello di gruppo persistono quando risincronizzi un marketplace connesso a GitHub o GitLab. Vengono rimossi solo se il plugin stesso viene eliminato dal marketplace.
Limita quali marketplace gli utenti possono aggiungere
Un Owner o Primary Owner può limitare quali marketplace di plugin le persone nella tua organizzazione possono aggiungere, utilizzando una lista di autorizzazione, una lista di blocco o entrambe. Imposti questi elenchi nelle impostazioni gestite di Claude Code, ma si applicano anche in Claude e Claude Cowork.
Per impostare una lista di autorizzazione o una lista di blocco:
Trova Impostazioni gestite.
Fai clic su "Gestisci".
Aggiungi strictKnownMarketplaces (una lista di autorizzazione), blockedMarketplaces (una lista di blocco) o entrambi al JSON.
Fai clic su "Aggiungi impostazioni" o "Aggiorna impostazioni".
Inserisci il nome della tua organizzazione GitHub esattamente come GitHub lo mostra, perché la corrispondenza della lista di autorizzazione è sensibile alle maiuscole. Se una fonte è in entrambi gli elenchi, viene bloccata.
Una volta impostati gli elenchi, Claude li controlla ogni volta che qualcuno nella tua organizzazione aggiunge un marketplace da un repository Git in Claude, Claude Desktop o Cowork. Questo copre i marketplace che gli utenti aggiungono per se stessi in Personalizza e i marketplace aggiunti per l'intera organizzazione in Impostazioni organizzazione > Plugin e competenze. Claude rifiuta qualsiasi repository che gli elenchi non consentono, ad eccezione dei marketplace costruiti da Anthropic.
Tieni presente:
Imposta gli elenchi in Impostazioni organizzazione. Un file managed-settings.json o una politica MDM distribuita ai computer si applica solo a Claude Code su quei computer.
I marketplace esistenti non vengono controllati di nuovo. I marketplace aggiunti prima di impostare gli elenchi rimangono fino a quando qualcuno non li rimuove.
I plugin caricati non vengono controllati. Per impedire agli utenti di caricare file di plugin, disattiva Competenze create dall'utente in Impostazioni organizzazione > Plugin e competenze nella scheda "Politica".
Per ogni tipo di fonte che gli elenchi accettano, vedi Limita cosa gli utenti possono installare nella documentazione di Claude Code.
Aggiorna e rimuovi plugin
Marketplace manuali
Per aggiornare un plugin, carica un nuovo file ZIP con lo stesso nome del plugin. La nuova versione sostituisce automaticamente quella esistente. I nomi dei plugin sono l'identificatore univoco, quindi legal sostituirà sempre legal.
Per rimuovere un plugin, eliminalo dal tuo marketplace in Impostazioni organizzazione > Plugin e skill nella scheda "Inventario".
Marketplace sincronizzati con GitHub
Invia le tue modifiche al repository connesso, quindi vai a Impostazioni organizzazione > Plugin e skill e fai clic sulla scheda "Marketplace", trova il tuo marketplace e fai clic su "Aggiorna" per attivare una sincronizzazione. Ogni sincronizzazione sostituisce tutti i plugin con lo stato attuale del repository. Se un proprietario ha abilitato "Sincronizza automaticamente" per il marketplace, una sincronizzazione viene eseguita anche quando una pull request con un aggiornamento della versione del plugin viene unita al ramo predefinito del repository.
Per i marketplace sincronizzati con GitLab, vedi Configurare un marketplace sincronizzato con GitLab.
Per rimuovere un plugin, eliminalo dal repository e attiva una sincronizzazione.
Limiti
Limite | Valore | Note |
Dimensione massima ZIP del plugin (caricamento) | 200 MB | Applicato sia lato client che lato server |
Numero massimo di plugin per marketplace (manuale) | 1000 | Per marketplace |
Numero massimo di plugin per marketplace (sincronizzazione GitHub o GitLab) | 1000 | Per marketplace |
Lunghezza massima del nome del plugin | 64 caratteri | Deve utilizzare parole minuscole separate da trattini |
Timeout di sincronizzazione | 30 minuti | Per operazione di sincronizzazione |
Visibilità del repository sincronizzato | Solo privato o interno su github.com e gitlab.com | Ospitato su github.com, GitHub Enterprise Server, gitlab.com o un'istanza GitLab auto-gestita. Gli host GitLab (incluso gitlab.com) richiedono una configurazione GitLab in Impostazioni organizzazione > Claude Code. |
Regole di denominazione
I nomi dei plugin devono utilizzare parole minuscole separate da trattini (ad esempio, deployment-tools, non Deployment Tools). I seguenti nomi di marketplace sono riservati e non possono essere utilizzati:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
Anche i nomi che si fingono marketplace ufficiali di Anthropic sono bloccati.
Nota: Gli autori di plugin possono impostare un displayName in modo che un plugin mostri un nome leggibile nel catalogo invece del suo slug. Se un autore non ne imposta uno, il plugin mostra il suo slug (ad esempio, deployment-tools).
Risoluzione dei problemi
Caricamento rifiutato
Cause comuni: il file supera 200 MB, non è un file ZIP valido o il marketplace ha raggiunto il limite di 1000 plugin. Controlla le dimensioni e il formato del file e rimuovi i plugin inutilizzati se sei al limite di capacità. Se la scansione di skill e plugin è attiva, un plugin può anche essere rifiutato perché è stato segnalato per contenuto dannoso. Rivedi il motivo, risolvi il problema e carica di nuovo il plugin.
Plugin non visualizzato per i membri
Controlla la preferenza di installazione del plugin nelle impostazioni del tuo marketplace. Se è impostata su Non disponibile, i membri non lo vedranno. Inoltre, conferma che Cowork e Skills siano entrambi abilitati per la tua organizzazione.
Plugin aggiornato non riflesso per i membri
Le modifiche hanno effetto nella sessione successiva di ogni membro o nell'aggiornamento del plugin. In Claude Code, gli utenti ricevono la modifica la prossima volta che avviano Claude Code. Se l'aggiornamento non viene ancora visualizzato, conferma che il caricamento sia riuscito controllando la versione del plugin nel tuo marketplace.
La sincronizzazione GitHub non riesce con un errore di contenuto
Uno o più plugin nel tuo repository probabilmente sono formattati in modo non corretto. Correggi il problema di formattazione, invia l'aggiornamento a GitHub e attiva di nuovo la sincronizzazione. Per i requisiti della struttura del plugin, vedi il riferimento del manifest del plugin.
La sincronizzazione non riesce con "External plugin source type is not supported. Supported types: git-subdir, github, url" o i plugin vengono saltati con "Repository not found on gitlab.com. Check the URL and make sure the repository is public."
Una o più voci di plugin nel tuo marketplace.json utilizzano una source che punta al di fuori del repository connesso (una source github, url o git-subdir), e la sincronizzazione dell'organizzazione non può recuperarla. Una source privata funziona solo in tre casi: un repository github.com condivide il proprietario del tuo repository marketplace, un repository sull'host GitHub Enterprise della tua organizzazione con la tua GitHub Enterprise App installata su di esso, oppure una source url o git-subdir sullo stesso host GitLab del tuo repository marketplace (su gitlab.com, anche sotto lo stesso namespace di gruppo di primo livello o utente).
Per qualsiasi altra fonte privata, sposta le cartelle dei plugin nel repository del marketplace e cambia il source di ogni voce in un percorso relativo (ad esempio, "./plugins/my-plugin"), quindi esegui il push e risincronizza. In alternativa, carica i plugin interessati singolarmente tramite Impostazioni organizzazione > Plugin e competenze Fai clic su "Aggiungi", "Carica un plugin", quindi seleziona "Aggiungi a un marketplace esistente". I plugin caricati tramite il menu Personalizza di un membro vengono installati solo per quel membro e non vengono distribuiti all'organizzazione, anche se i membri possono condividere i plugin con colleghi o gruppi specifici se la condivisione è attivata.
Impossibile visualizzare un repository GitHub durante la connessione
Assicurati che l'app GitHub di Claude sia installata in quel repository. Il tuo token GitHub personale viene controllato per primo per confermare l'accesso, ma la sincronizzazione stessa utilizza il token di installazione dell'app GitHub.
"Impossibile accedere al repository" quando si attiva "Sincronizza automaticamente"
Se gli aggiornamenti manuali funzionano ma l'attivazione di "Sincronizza automaticamente" mostra "Impossibile accedere al repository. Assicurati che il repository esista e che l'app GitHub di Claude sia installata", ci sono due probabili cause:
Non hai accesso amministratore al repository. L'attivazione della sincronizzazione automatica crea un webhook, che richiede l'accesso a livello amministratore al repository tramite la tua connessione GitHub personale. Chiedi a un amministratore del repository di abilitare l'interruttore oppure fai aggiornare il tuo accesso GitHub.
L'autorizzazione Webhooks dell'app GitHub di Claude non è stata approvata. Nelle installazioni precedenti, GitHub mostra un prompt "Claude sta richiedendo autorizzazioni aggiornate". Un amministratore del repository o dell'organizzazione deve approvare l'autorizzazione Webhooks (Lettura e Scrittura) nell'installazione.
"Nessuna istanza GitLab è configurata per la tua organizzazione. Aggiungine una nelle impostazioni di Claude Code, quindi torna qui" quando si aggiunge un marketplace
Se visualizzi questo messaggio quando aggiungi un marketplace in GitLab, assicurati di aver aggiunto prima la configurazione GitLab. Vedi Passaggio 1: Aggiungi una configurazione GitLab in Configura un marketplace sincronizzato con GitLab.
"Questo URL non si trova su un'istanza GitLab configurata"
Assicurati che il nome host dell'URL corrisponda esattamente a un nome host GitLab configurato.
L'aggiunta di un progetto gitlab.com non riesce con "Impossibile creare il marketplace. Riprova."
Verifica che la visibilità del progetto sia privata o interna. I progetti gitlab.com pubblici non possono essere utilizzati come marketplace dell'organizzazione.
Il test di connessione non riesce a Reach host (ad esempio "Impossibile risolvere il nome host", "La connessione è stata rifiutata" o "GitLab non ha risposto in tempo"), oppure l'aggiunta di un marketplace su un'istanza auto-gestita non riesce con un errore generico
Conferma che l'istanza sia raggiungibile da Internet pubblico su HTTPS e che gli indirizzi IP in uscita di Anthropic siano consentiti attraverso il tuo firewall. "Impossibile stabilire una connessione sicura" di solito significa che il certificato CA è mancante o errato.
Errori che iniziano con "Autenticazione a … non riuscita" o "Accesso negato"
Il token è scaduto, revocato o manca di un ambito o ruolo elencato nella sezione Prima di iniziare in Configura un marketplace sincronizzato con GitLab. Crea un nuovo token e incollalo nella configurazione (Modifica > Token di accesso).