Gestisci i plugin 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. 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 sia nella chat (sul web e nella scheda Chat di Claude Desktop) che in Claude Cowork.

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

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:

Per rimuovere il marketplace Knowledge Work se non è rilevante per i tuoi team:

I marketplace creati da Anthropic mostrano nomi leggibili, come "Knowledge Work," invece dello slug del repository sottostante.

Oltre ai marketplace creati da Anthropic, puoi crearne uno tuo. Esistono due modi per aggiungere plugin a un marketplace che crei:

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.

Se carichi un plugin con lo stesso nome di uno esistente, sovrascrive automaticamente la versione precedente. Non è necessario 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.

Prepara il tuo repository

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:

Connetti il repository

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.

Come funziona la sincronizzazione

Una sincronizzazione iniziale viene eseguita automaticamente quando colleghi un repository. Successivamente, i proprietari dell'organizzazione possono scegliere di attivare gli aggiornamenti automatici continui per ogni marketplace andando su Impostazioni organizzazione > Plugin (sotto Librerie), facendo clic sul pulsante 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 attraverso la finestra modale Sfoglia plugin. 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 aziendali possono ignorare la preferenza di installazione a livello organizzativo 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 organizzativo (Installato per impostazione predefinita, Disponibile per l'installazione, Obbligatorio o Non disponibile). Per impostazione predefinita, ogni gruppo eredita tale impostazione a livello organizzativo.

Quando imposti un override a livello di gruppo per un plugin, sostituisce l'impostazione a livello organizzativo per i membri di quel gruppo. L'ordine di risoluzione è: impostazione di gruppo, quindi impostazione a livello organizzativo, quindi impostazione predefinita del marketplace.

Sia i gruppi creati manualmente che i gruppi forniti da SCIM dal tuo provider di identità vengono visualizzati 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 tue 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. Tieni presente 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:

I nomi che impersonano i marketplace ufficiali di Anthropic sono bloccati.

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

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.

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 sono probabilmente formattati in modo non corretto. Correggi il problema di formattazione, esegui il push dell'aggiornamento su GitHub e attiva di nuovo la sincronizzazione. Per i requisiti della struttura dei plugin, consulta la documentazione di riferimento dei plugin.

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 il repository di destinazione è privato. La sincronizzazione dell'organizzazione può attualmente 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 esegui il push 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 e verifica che le preferenze di installazione siano impostate correttamente, poiché potrebbero essere state ripristinate.

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.