Gerenciar plugins do Claude Cowork para sua organização

Os marketplaces de plugins permitem que proprietários de planos Team e Enterprise distribuam plugins selecionados para todos na sua organização através do Claude Cowork. Você cria um marketplace, adiciona plugins a ele e controla exatamente quais plugins seus membros da equipe podem ver e usar.

Requisitos: Cowork e Skills devem estar ambos habilitados para sua organização antes de você poder usar marketplaces de plugins.

Existem duas maneiras de adicionar plugins a um marketplace:

Você pode usar ambas as abordagens em paralelo—por exemplo, um marketplace sincronizado com GitHub para seus plugins principais e um marketplace manual separado para ferramentas ad-hoc.

Se você fizer upload de um plugin com o mesmo nome de um existente, ele sobrescreve a versão anterior automaticamente—sem necessidade de deletar a antiga primeiro.

A sincronização com GitHub permite que você gerencie plugins como código em um repositório. Quando você faz push de alterações, você pode disparar uma sincronização para atualizar seu marketplace—manual ou automaticamente.

Seu repositório deve ser privado ou interno—repositórios públicos não são permitidos para marketplaces de organização. Repositórios hospedados em instâncias personalizadas do GitHub Enterprise Server não são suportados. Seu repositório deve estar hospedado em github.com.

Os marketplaces sincronizados com GitHub suportam um conjunto mais restrito de tipos de source em marketplace.json do que a CLI do Claude Code. Caminhos relativos para pastas de plugins dentro do repositório conectado (por exemplo, "source": "./plugins/my-plugin") são totalmente suportados. Os tipos de source github, url e git-subdir são suportados apenas quando o repositório de destino é público. Os tipos de source npm e pip não são suportados. Se seu código de plugin reside em repositórios privados separados, copie essas pastas de plugins para o repositório do marketplace (um git submodule, git subtree ou uma etapa de CI funciona bem) e referencie-as com caminhos relativos.

Para detalhes sobre estrutura e formatação de plugins, consulte a documentação de referência de plugins.

Recursos adicionais:

Seu token pessoal do GitHub é verificado para confirmar que você tem acesso, então o Cowork usa seu token de instalação do GitHub App para operações de sincronização.

Não consegue ver seu repositório? Certifique-se de que o Claude GitHub App está instalado nesse repositório.

Uma sincronização inicial é executada automaticamente quando você conecta um repositório. Depois disso, proprietários da organização podem optar por continuarem com atualizações automáticas por marketplace indo para Configurações da organização > Plugins (em Bibliotecas), clicando no botão de menu no canto superior direito do marketplace, então alternando "Sincronizar automaticamente" para ativado:

O marketplace do GitHub será então sincronizado automaticamente sempre que um PR for mesclado nesse repositório. Você também pode disparar sincronizações manualmente clicando em "Atualizar" no marketplace.

Durante uma sincronização, o Cowork compara o commit mais recente em seu repositório com o commit sincronizado pela última vez. Se nada mudou, a sincronização é ignorada. Se houver alterações, o Cowork lê o manifesto, valida cada plugin e substitui todos os plugins no marketplace pelo estado atual do repositório. As sincronizações podem levar até 30 minutos dependendo do número de plugins.

Depois que seu marketplace tiver plugins, você controla como eles são distribuídos usando preferências de instalação. Para cada plugin, você pode definir uma de quatro opções:

Os membros navegam pelos plugins disponíveis através do modal Procurar plugins no Cowork. Os plugins instalados automaticamente aparecem na lista de instalados automaticamente. Os plugins disponíveis aparecem no catálogo para instalação por autoatendimento.

Os membros não conseguem editar plugins gerenciados pela organização, o que evita alterações conflitantes em ferramentas compartilhadas.

Administradores Enterprise podem substituir a preferência de instalação de um plugin em toda a organização para grupos específicos. Por exemplo, você pode instalar automaticamente um plugin para o grupo de Engenharia, disponibilizá-lo para o grupo Jurídico instalar por conta própria e ocultá-lo de todos os outros.

Cada plugin em seu marketplace tem uma preferência de instalação em toda a organização (Instalado por padrão, Disponível para instalação, Obrigatório ou Não disponível). Por padrão, cada grupo herda essa configuração em toda a organização.

Quando você define uma substituição no nível de grupo para um plugin, ela substitui a configuração em toda a organização para membros desse grupo. A ordem de resolução é: configuração de grupo, depois configuração em toda a organização, depois padrão do marketplace.

Grupos criados manualmente e grupos provisionados por SCIM do seu provedor de identidade aparecem no seletor de grupo e funcionam da mesma forma.

Se um membro pertence a dois ou mais grupos com configurações diferentes para o mesmo plugin, a configuração mais permissiva se aplica. A ordem de mais para menos permissiva é: Obrigatório > Instalado por padrão > Disponível para instalação > Não disponível.

Por exemplo, se o Grupo A define um plugin como "Não disponível" e o Grupo B o define como "Instalado por padrão", um membro em ambos os grupos obtém o plugin instalado por padrão.

Se um grupo for removido — por exemplo, se for excluído do seu provedor de identidade — a substituição permanece na interface do administrador, mas é marcada como órfã. Não tem efeito nos membros (já que ninguém pertence a um grupo excluído) e não conta para o crachá de acesso personalizado. Você pode limpar substituições órfãs nas configurações de acesso personalizado do plugin.

Sim. As substituições no nível de grupo persistem quando você ressincroniza um marketplace conectado ao GitHub. Elas são removidas apenas se o próprio plugin for excluído do marketplace.

Para atualizar um plugin, carregue um novo arquivo ZIP com o mesmo nome de plugin. A nova versão substitui a existente automaticamente. Os nomes de plugins são o identificador único — legal sempre substituirá legal.

Para remover um plugin, exclua-o do seu marketplace em Configurações da organização > Plugins.

Envie suas alterações para o repositório conectado, depois vá para Configurações da organização > Plugins, encontre seu marketplace e clique em "Atualizar" para disparar uma sincronização. Cada sincronização substitui todos os plugins pelo estado atual do repositório. Observe que se um proprietário tiver habilitado "Sincronizar automaticamente" para o marketplace sincronizado com GitHub, isso acontecerá automaticamente após enviar alterações para o repositório.

Para remover um plugin, exclua-o do repositório e dispare uma sincronização.

Os nomes dos plugins devem usar palavras em minúsculas separadas por hífens (por exemplo, deployment-tools, não Deployment Tools). Os seguintes nomes de marketplace são reservados e não podem ser usados:

Nomes que imitam marketplaces oficiais da Anthropic também são bloqueados.

Causas comuns: o arquivo excede 50 MB, não é um arquivo ZIP válido ou o marketplace atingiu o limite de 100 plugins. Verifique o tamanho e o formato do arquivo e remova plugins não utilizados se estiver no limite.

Verifique a preferência de instalação do plugin nas configurações do seu marketplace. Se estiver definida como Não disponível, os membros não a verão. Também confirme que Cowork e Skills estão ambos habilitados para sua organização.

As alterações entram em vigor na próxima sessão ou atualização do plugin de cada membro. Se a atualização ainda não aparecer, confirme que o upload foi bem-sucedido verificando a versão do plugin no seu marketplace.

Um ou mais plugins no seu repositório provavelmente estão formatados incorretamente. Corrija o problema de formatação, envie a atualização para o GitHub e dispare a sincronização novamente. Para requisitos de estrutura de plugin, consulte a documentação de referência de plugin.

Uma ou mais entradas de plugin no seu marketplace.json usam uma source que aponta para fora do repositório conectado (uma fonte github, url ou git-subdir, e o repositório de destino é privado. A sincronização da organização atualmente só pode buscar fontes externas de repositórios públicos. Mova as pastas de plugin para o repositório do marketplace e altere a source de cada entrada para um caminho relativo (por exemplo, "./plugins/my-plugin"), depois envie e ressincronize. Alternativamente, carregue os plugins afetados individualmente via Personalizar > Adicionar plugin > Criar plugin > Carregar plugin.

Uma sincronização do GitHub com falha pode remover temporariamente plugins do seu marketplace. Corrija o problema subjacente, ressincronize com sucesso e verifique se as preferências de instalação estão definidas corretamente — elas podem ter sido redefinidas.

Certifique-se de que o Cowork GitHub App está instalado nesse repositório. Seu token pessoal do GitHub é verificado primeiro para confirmar o acesso, mas a sincronização em si usa o token de instalação do GitHub App.