Gestisci i plugin Claude Cowork per la tua organizzazione

I marketplace dei plugin consentono ai proprietari dei piani Team ed Enterprise di distribuire plugin curati a tutti gli utenti della loro organizzazione tramite Claude Cowork. Crei un marketplace, aggiungi plugin ad esso e controlli esattamente quali plugin i tuoi colleghi possono vedere e utilizzare.

Requisiti: Cowork e Skills devono essere entrambi abilitati per la tua organizzazione prima di poter utilizzare i marketplace dei plugin.

Esistono due modi per aggiungere plugin a un marketplace:

Puoi utilizzare entrambi gli approcci in parallelo, ad esempio un marketplace sincronizzato con GitHub per i tuoi plugin principali e un marketplace manuale separato per strumenti ad hoc.

Se carichi un plugin con lo stesso nome di uno esistente, sovrascrive automaticamente la versione precedente, senza necessità di eliminare prima quella vecchia.

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.

Il tuo repository deve essere privato o interno—i repository pubblici non sono consentiti per i marketplace dell'organizzazione. I repository ospitati su istanze personalizzate di GitHub Enterprise Server non sono supportati. Il tuo repository deve essere ospitato su github.com.

I marketplace sincronizzati con GitHub supportano un set più ristretto di tipi di source in marketplace.json rispetto a quanto fa Claude Code CLI. I percorsi relativi alle cartelle dei plugin all'interno del repository connesso (ad esempio, "source": "./plugins/my-plugin") sono completamente supportati. I tipi di source github, url e git-subdir sono supportati solo quando il repository di destinazione è pubblico. I tipi di source npm e pip non sono supportati. Se il codice del tuo plugin si trova in repository privati separati, copia quelle cartelle di plugin nel repository del marketplace (un git submodule, git subtree o un passaggio CI funziona bene) e fai loro riferimento con percorsi relativi.

Per i dettagli sulla struttura e la formattazione dei plugin, consulta la documentazione di riferimento dei plugin.

Risorse aggiuntive:

Il tuo token GitHub personale viene verificato per confermare che hai accesso, quindi Cowork utilizza il token di installazione della sua app GitHub per le operazioni di sincronizzazione.

Non riesci a vedere il tuo repository? Assicurati che l'app GitHub di Claude sia installata in quel repository.

Una sincronizzazione iniziale viene eseguita automaticamente quando connetti un repository. Successivamente, i proprietari dell'organizzazione possono optare per continuare gli aggiornamenti automatici per marketplace andando a Impostazioni organizzazione > Plugin (sotto Librerie), facendo clic sul pulsante del menu nell'angolo in alto a destra del marketplace, quindi attivando "Sincronizza automaticamente":

Il marketplace GitHub verrà quindi sincronizzato automaticamente ogni volta che un PR viene unito a quel repository. Puoi anche attivare le sincronizzazioni manualmente facendo clic su "Aggiorna" 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.

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:

I membri sfogliano i plugin disponibili tramite la finestra modale Sfoglia plugin in Cowork. I plugin installati automaticamente appaiono nel loro elenco installato automaticamente. I plugin disponibili vengono visualizzati nel catalogo per l'installazione self-service.

I membri non possono modificare i plugin gestiti dall'organizzazione, il che impedisce modifiche conflittuali agli strumenti condivisi.

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.

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 tale 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 di gruppo, quindi impostazione a livello di organizzazione, quindi impostazione predefinita del marketplace.

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.

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.

Se un gruppo viene rimosso, ad esempio se eliminato dal tuo provider di identità, l'override rimane nell'interfaccia 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 di accesso personalizzato del plugin.

Sì. Gli override a livello di gruppo persistono quando risincronizzi un marketplace connesso a GitHub. Vengono rimossi solo se il plugin stesso viene eliminato dal marketplace.

Per aggiornare un plugin, carica un nuovo file ZIP con lo stesso nome di plugin. La nuova versione sostituisce automaticamente quella esistente. I nomi dei plugin sono l'identificatore univoco — legal sostituirà sempre legal.

Per rimuovere un plugin, eliminalo dal tuo marketplace in Impostazioni organizzazione > Plugin.

Esegui il push delle modifiche al repository connesso, quindi vai a Impostazioni organizzazione > Plugin, 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. Nota che se un proprietario ha abilitato "Sincronizza automaticamente" per il marketplace sincronizzato con GitHub, questo accadrà automaticamente dopo il push delle modifiche al repository.

Per rimuovere un plugin, eliminalo dal repository e attiva una sincronizzazione.

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:

Sono bloccati anche i nomi che si fingono marketplace ufficiali di Anthropic.

Cause comuni: il file supera 50 MB, non è un file ZIP valido o il marketplace ha raggiunto il limite di 100 plugin. Controlla le dimensioni e il formato del file e rimuovi i plugin inutilizzati se sei al limite.

Controlla la preferenza di installazione del plugin nelle impostazioni del tuo marketplace. Se è impostata su Non disponibile, i membri non la vedranno. Inoltre, conferma che Cowork e Skills siano entrambi abilitati per la tua organizzazione.

Le modifiche hanno effetto nella sessione successiva di ogni membro o nell'aggiornamento del plugin. Se l'aggiornamento non viene ancora visualizzato, conferma che il caricamento sia riuscito controllando la versione del plugin nel tuo marketplace.

Uno o più plugin nel tuo repository probabilmente hanno una formattazione non corretta. Correggi il problema di formattazione, invia l'aggiornamento a GitHub e attiva di nuovo la sincronizzazione. Per i requisiti della struttura del plugin, consulta la documentazione di riferimento del plugin.

Uno 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 il repository di destinazione è privato. La sincronizzazione dell'organizzazione attualmente può recuperare origini esterne solo da repository pubblici. Sposta le cartelle dei plugin nel repository del marketplace e modifica la source di ogni voce in un percorso relativo (ad esempio, "./plugins/my-plugin"), quindi invia e risincronizza. In alternativa, carica i plugin interessati singolarmente tramite Personalizza > Aggiungi plugin > Crea plugin > Carica plugin.

Una sincronizzazione GitHub non riuscita può rimuovere temporaneamente i plugin dal tuo marketplace. Correggi il problema sottostante, risincronizza con successo, quindi verifica che le preferenze di installazione siano impostate correttamente, poiché potrebbero essere state ripristinate.

Assicurati che l'app GitHub Cowork 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.