Ir para conteúdo principal

Gerenciar plugins do Cowork para sua organização

Atualizado ontem

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

Proprietários e Proprietários Primários de planos Team e Enterprise podem gerenciar plugins da organização no Claude Desktop.

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:

  • Upload manual—Faça upload de arquivos ZIP de plugins individuais através da interface de administração. Melhor para iteração rápida, ferramentas pontuais ou equipes que não usam GitHub para desenvolvimento de plugins.

  • Sincronização com GitHub—Conecte um repositório privado do GitHub e o Cowork sincroniza automaticamente plugins dele. Melhor quando múltiplos desenvolvedores colaboram em plugins ou você quer atualizações com controle de versão.

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.


Configurar um marketplace manual

  1. Abra Claude Desktop e vá para Configurações da Organização > Plugins.

  2. Clique em "Adicionar plugins" e selecione "Fazer upload de um arquivo" como a fonte.

  3. Se esta é sua primeira vez configurando um marketplace, "Fazer upload para um novo marketplace" será selecionado automaticamente.

    1. Você poderá escolher "Adicionar a um marketplace existente" ao fazer upload de plugins no futuro.

  4. Digite um nome para seu marketplace.

  5. Arraste seus arquivos ou clique no prompt de upload e selecione seu arquivo.

    1. Nota: O arquivo deve ser um .zip válido com menos de 50 MB.

  6. Repita para cada plugin que você deseja adicionar.

  7. Clique em "Upload" para adicionar seus plugins a um novo marketplace.

Se você fizer upload de um plugin com o mesmo nome de um existente, ele sobrescreve a versão anterior automaticamente—não é necessário deletar a antiga primeiro.


Configurar um marketplace sincronizado com GitHub

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.

Preparar seu repositório

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.

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

Recursos adicionais:

Conectar o repositório

  1. Certifique-se de que Cowork e Skills estão ambos habilitados para sua organização.

  2. Vá para Configurações da Organização > Plugins.

  3. Clique em "Adicionar plugin" e selecione "GitHub" como a fonte.

  4. Digite o repositório no formato proprietário/repositório (por exemplo, acme-corp/claude-plugins).

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 GitHub App do Cowork está instalado nesse repositório.

Como a sincronização funciona

Uma sincronização inicial é executada automaticamente quando você conecta um repositório. Depois disso, você pode disparar sincronizações manualmente clicando em "Verificar atualizações" em seu marketplace em Configurações da Organização > Plugins.

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.

Importante: Se uma sincronização falhar, os plugins podem ser temporariamente removidos para seus membros da equipe. Se isso acontecer, verifique a mensagem de falha, corrija o problema em seu repositório, faça push da atualização e dispare a sincronização novamente. Depois que a sincronização for bem-sucedida, verifique se suas preferências de instalação ainda estão definidas corretamente — elas podem ter sido redefinidas durante a falha.


Controlar a distribuição de plugins

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

Preferência

O que faz

O que os membros veem

Auto-instalar

Instalado automaticamente para todos os membros da organização

O plugin aparece em sua lista de instalados sem nenhuma ação. Os membros podem desinstalar se escolherem.

Disponível

Listado no catálogo de plugins

Os membros o veem ao navegar plugins e podem instalá-lo por conta própria.

Não disponível

Oculto do catálogo completamente

Os membros não conseguem ver ou instalar o plugin. Útil para preparar ou descontinuar plugins.

Definir preferências

  1. Em Configurações da Organização > Plugins, navegue até seu marketplace.

  2. Selecione a preferência de instalação para cada plugin.

  3. As alterações entram em vigor na próxima sessão ou atualização de plugin de cada membro.

O que os membros experimentam

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

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


Atualizar e remover plugins

Marketplaces manuais

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

Para remover um plugin, delete-o de seu marketplace em Configurações da Organização > Plugins.

Marketplaces sincronizados com GitHub

Faça push de suas alterações para o repositório conectado, depois vá para Configurações da Organização > Plugins, encontre seu marketplace e clique em "Verificar atualizações" para disparar uma sincronização. Cada sincronização substitui todos os plugins pelo estado atual do repositório.

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


Limites

Limite

Valor

Notas

Tamanho máximo de ZIP de plugin (upload)

50 MB

Aplicado tanto no lado do cliente quanto no lado do servidor

Máximo de plugins por marketplace (manual)

100

Por marketplace

Máximo de plugins por marketplace (sincronização GitHub)

500

Por marketplace

Comprimento máximo do nome do plugin

64 caracteres

Deve usar palavras em minúsculas separadas por hífens

Tempo limite de sincronização

30 minutos

Por operação de sincronização

Visibilidade do repositório GitHub

Apenas privado ou interno

Deve estar hospedado em github.com. Repositórios públicos e instâncias do GitHub Enterprise Server não são suportados.


Regras de nomenclatura

Os nomes de 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:

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

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


Escolher entre upload manual e sincronização com GitHub

Cenário

Abordagem recomendada

Plugins são mantidos em controle de versão com CI/CD

Sincronização com GitHub

Múltiplos desenvolvedores colaboram em plugins

Sincronização com GitHub

Você quer propagação automática de atualizações

Sincronização com GitHub

Você precisa de mais de 100 plugins em um marketplace

Sincronização com GitHub

Prototipagem rápida ou ferramentas pontuais

Upload manual

Plugins construídos por equipes não-técnicas

Upload manual

Ambientes sem acesso ao GitHub

Upload manual

Testar um plugin antes de adicioná-lo a um repositório sincronizado

Upload manual


Solução de problemas

Upload rejeitado

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 formato do arquivo e remova plugins não utilizados se estiver na capacidade máxima.

Plugin não aparecendo para membros

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 o verão. Também confirme que Cowork e Skills estão ambos habilitados para sua organização.

Plugin atualizado não refletindo para membros

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

Sincronização com GitHub falha com erro de conteúdo

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

Plugins desapareceram após uma sincronização falhada

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

Não consegue ver um repositório GitHub ao conectar

Certifique-se de que o GitHub App do Cowork 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.

Isto respondeu à sua pergunta?