Ir para conteúdo principal

Gerenciar plugins 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. Você cria um marketplace, adiciona plugins a ele e controla exatamente quais plugins seus membros da equipe podem ver e usar. Os plugins que você distribui aparecem no chat (na web e na aba Chat do Claude Desktop), no Claude Cowork e nas sessões do Claude Code onde os membros fazem login com a mesma conta Claude.

Proprietários e Proprietários Primários de planos Team e Enterprise podem gerenciar plugins da organização em Configurações da organização > Plugins e skills. Em planos Enterprise, membros com uma função personalizada que inclui gerenciar as bibliotecas da organização também podem.

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

Para uma versão de referência desses controles, consulte Gerenciar plugins para sua organização na documentação do Claude Code.

Observação: Desativar Skills para sua organização também interrompe a sincronização de skills e plugins com o Claude Code e remove os que já foram sincronizados. Desativar Cowork não afeta a sincronização com o Claude Code. Para manter skills e plugins no Claude mas interromper apenas a sincronização, defina syncClaudeAiSkills e syncClaudeAiPlugins como false nas configurações gerenciadas do Claude Code. Saiba mais sobre configuração de administrador do Claude Code.

Observação: Marketplaces são como proprietários distribuem plugins para sua organização. Os usuários também podem compartilhar um plugin que criaram com colegas ou grupos específicos, ou enviá-lo para ser publicado na biblioteca da sua organização. O compartilhamento e a publicação são controlados pelas configurações em Configurações da organização > Plugins e skills na aba "Policy", e os envios de plugins são revisados lá na aba "Requests". Saiba mais sobre usar plugins no Claude e permitir que usuários publiquem skills e plugins em sua organização.


Veja o que há em sua organização

A aba "Inventory" lista todos os skills e plugins que sua organização governa, incluindo os que os usuários criaram para si mesmos. Skills e plugins agora vivem na mesma página, então você não precisa alternar entre configurações.

Para cada item, a tabela mostra sua origem, versão, capacidades, público e quantas pessoas o usaram nos últimos 30 dias.

Para encontrar um item, pesquise por nome ou use os filtros:

  • Origem: Sua organização, biblioteca da organização ou um marketplace específico

  • Público: Quem pode usar o item

  • Tipo: Skills ou plugins

Skills que sua organização gerencia aparecem em Biblioteca da organização. Você gerencia marketplaces de plugins na aba Marketplaces.

Para agir em um item, clique no botão de menu no final de sua linha. Você pode visualizar detalhes e arquivos, ver histórico de versões e alterar acesso padrão e de grupo.

Para skills e plugins que os usuários criaram, a aba Inventory mostra metadados e status de compartilhamento. Ela não mostra os arquivos em si.

Use marketplaces construídos pela Anthropic

A Anthropic fornece marketplaces integrados de plugins para diferentes funções, como jurídica e finanças. Um marketplace Knowledge Work é adicionado à sua organização por padrão.

Para adicionar um marketplace construído pela Anthropic:

  1. Vá para Configurações da organização > Plugins e skills e clique na aba "Marketplaces".

  2. Clique em "Add", depois selecione "Add marketplace".

  3. Selecione "Browse Anthropic sources".

  4. Clique em "Add" em cada um que você deseja que apareça para todos na sua organização.

Para remover o marketplace Knowledge Work se não for relevante para suas equipes:

  1. Vá para Configurações da organização > Plugins e skills e clique na aba "Marketplaces".

  2. Encontre Knowledge Work.

  3. Clique no botão de menu no canto superior direito.

  4. Selecione "Remove".

Marketplaces construídos pela Anthropic mostram nomes legíveis, como "Knowledge Work", em vez do slug do repositório subjacente.


Crie seu próprio marketplace

Além dos marketplaces construídos pela Anthropic, você pode criar o seu próprio. Existem duas maneiras de adicionar plugins a um marketplace que você cria:

  • 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 mantêm plugins em um repositório Git.

  • Sincronização de repositório: Conecte um repositório privado do GitHub ou GitLab e o Claude sincroniza plugins dele. Melhor quando múltiplos desenvolvedores colaboram em plugins ou você deseja atualizações controladas por versão.

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

Configure um marketplace manual

  1. Clique em "Add", depois selecione "Upload a plugin".

  2. Se esta é sua primeira vez configurando um marketplace, "Upload to a new marketplace" é selecionado automaticamente. Você poderá escolher "Add to an existing marketplace" ao fazer upload de plugins depois.

  3. Digite um nome para seu marketplace.

  4. Arraste seus arquivos ou clique no prompt de upload e selecione seu arquivo. O arquivo deve ser um .zip válido com menos de 200 MB.

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

  6. 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. Você não precisa deletar o antigo primeiro.

Configure um marketplace sincronizado com GitHub

A sincronização do 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, manualmente ou automaticamente.

Prepare seu repositório

Você pode conectar um repositório hospedado em github.com ou no host GitHub Enterprise da sua organização. Em github.com, seu repositório deve ser privado ou interno—repositórios públicos não são permitidos para marketplaces da organização. Para sincronizar do GitLab, consulte Configure um marketplace sincronizado com GitLab.

Marketplaces sincronizados com GitHub suportam um conjunto mais estreito de tipos de source em marketplace.json do que o Claude Code faz. Caminhos relativos para pastas de plugins dentro do repositório do marketplace (por exemplo, "source": "./plugins/my-plugin") são totalmente suportados e são a opção mais simples. Os tipos de source github, url e git-subdir também são suportados. Os tipos de source npm, archive e command não são suportados.

Uma fonte de plugin pode ser privada em três casos:

  • Uma fonte github.com que compartilha o proprietário do repositório do seu marketplace, que a sincronização da organização busca através do Claude GitHub App.

  • Uma fonte no GitHub Enterprise da sua organização com o Claude GitHub Enterprise App instalado nesse repositório.

  • Uma fonte url ou git-subdir no mesmo host GitLab que seu repositório de marketplace. No gitlab.com, a fonte também deve estar sob o mesmo grupo de nível superior ou namespace de usuário que o repositório de marketplace.

Todas as outras fontes são buscadas sem credenciais, portanto deve ser um repositório público no github.com, gitlab.com ou bitbucket.org. Fontes em qualquer outro host são rejeitadas.

Se o código do seu plugin está em um repositório privado que não atende aos critérios acima, copie essas pastas de plugin para o repositório de marketplace e altere a fonte de cada plugin para um caminho relativo (uma git subtree ou uma etapa de CI que vende os arquivos funciona bem).

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

Recursos adicionais:

Conectar o repositório

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

  2. Vá para Configurações da organização > Plugins e skills e clique na aba "Marketplaces".

  3. Clique em "Adicionar plugins" e selecione "Sincronizar do GitHub".

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

Seu token GitHub pessoal é verificado para confirmar que você tem acesso, entã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.

Como funciona a sincronização

Uma sincronização inicial é executada automaticamente quando você conecta um repositório. No fluxo de criação do GitHub, você também pode desativar "Sincronizar automaticamente", que está ativado por padrão. Com isso ativado, uma sincronização é executada quando um pull request é mesclado na branch que o marketplace segue, ou quando alguém faz push diretamente para essa branch.

A pessoa que ativa ou desativa a sincronização automática deve ter acesso de nível de administrador a esse repositório no GitHub. Isso é verificado através de sua conexão GitHub pessoal, que é separada da instalação do Claude GitHub App. Sem acesso de administrador, a página mostra "Não é possível acessar o repositório. Certifique-se de que o repositório existe e o Claude GitHub App está instalado", mesmo quando o App está instalado corretamente e as atualizações manuais funcionam.

A permissão Webhooks (Leitura e Escrita) do Claude GitHub App também deve ser aprovada na instalação. Em instalações criadas antes dessa permissão ser introduzida, o GitHub mostra um prompt "Claude está solicitando permissões atualizadas" que um administrador do repositório ou organização precisa aprovar.

Uma vez habilitada, a sincronização automática para um repositório GitHub é executada quando um pull request que inclui um bump de versão de plugin é mesclado na branch padrão do repositório. Pushes diretos para a branch padrão não acionam uma sincronização. Você sempre pode acionar uma sincronização manualmente clicando em "Re-sincronizar" no marketplace.

Durante uma sincronizaçã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, 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 membros mantêm a última versão sincronizada de cada plugin. Verifique a mensagem de falha, corrija o repositório e re-sincronize.

Configurar um marketplace sincronizado com GitLab

Você pode sincronizar um marketplace da organização a partir de um repositório no gitlab.com ou em uma instância GitLab auto-gerenciada. Para tipos de fonte de plugin suportados e quais fontes podem ser privadas, consulte Preparar seu repositório acima.

O suporte ao GitLab está em beta e se aplica apenas à sincronização de marketplace de plugin. Claude Code na web ainda não suporta repositórios GitLab.

Antes de começar

  • Função. Você precisa da função Proprietário ou Proprietário Primário para adicionar uma configuração GitLab.

  • Visibilidade do projeto. No gitlab.com, o projeto de marketplace deve ser privado ou interno. Em uma instância auto-gerenciada, qualquer visibilidade funciona.

  • Token de acesso. Crie um token de acesso GitLab para Claude ler o projeto de marketplace e qualquer projeto de fonte de plugin no mesmo host. Tokens de acesso pessoal, de grupo e de projeto funcionam. O usuário do token precisa ter pelo menos a função Reporter nesses projetos.

    • Token legado (com escopo): pelo menos o escopo read_api.

    • Token de acesso pessoal refinado: as permissões Projeto: Leitura, Branch: Leitura e Repositório: Leitura.

    • Opcional, para configuração automática de webhook (etapa 3): a função Maintainer no projeto de marketplace mais o escopo api (legado) ou a permissão Webhook: Criar e Excluir (refinada). Sem isso, você adiciona o webhook manualmente uma vez (etapa 4).

  • Apenas instâncias auto-gerenciadas.

    • O nome do host da instância deve ser resolvido para um endereço IP público, e a instância deve aceitar conexões HTTPS de endereços IP de saída da Anthropic.

    • Se uma autoridade de certificado privada emitiu seu certificado TLS, tenha o certificado da CA (PEM) pronto.

    • As entregas de webhook para sincronização automática vêm de sua instância para api.anthropic.com, portanto a instância deve ser capaz de fazer solicitações HTTPS de saída para esse host.

Etapa 1: Adicionar uma configuração GitLab

Para adicionar uma configuração GitLab:

  1. Em Infraestrutura auto-hospedada, encontre GitLab e clique em "Adicionar configuração".

  2. Digite um nome de exibição, o nome do host (gitlab.com ou o nome do host da sua instância, como gitlab.example.com), o token de acesso e, para uma instância auto-gerenciada com uma CA privada, o certificado da CA.

  3. Clique em "Adicionar configuração". Claude executa um teste de conexão imediatamente e mostra os resultados em um diálogo Teste de conexão GitLab.

  4. (Opcional) Para verificar que o token pode ler seu projeto de marketplace, digite seu caminho (por exemplo, platform/claude-plugins) em Caminho do projeto e clique em "Testar acesso de sincronização".

Você pode executar o teste novamente a qualquer momento no menu da configuração com Testar conexão. O nome do host não pode ser alterado posteriormente. Se mudar, exclua a configuração e adicione uma nova.

Etapa 2: Adicionar o marketplace

Para adicionar o marketplace:

  1. Acesse Configurações da organização > Plugins e skills e clique na aba "Marketplaces".

  2. Clique em "Adicionar" e selecione "Sincronizar do GitLab".

  3. Em URL do repositório GitLab, insira a URL HTTPS do projeto, por exemplo https://gitlab.example.com/platform/claude-plugins. Projetos em subgrupos aninhados funcionam.

  4. Deixe Sincronizar automaticamente ativado se desejar que pushes disparem uma sincronização (veja Etapa 3).

  5. Escolha o Acesso padrão para os plugins que o marketplace contém.

  6. Clique em "Criar".

Claude lê o branch padrão do projeto e valida o arquivo do marketplace antes de criar o marketplace, que é nomeado de acordo com o caminho do projeto.

Etapa 3: Sincronização automática

Com Sincronizar automaticamente ativado, cada push para o branch padrão do projeto dispara uma sincronização através de um webhook no projeto GitLab. Se seu token puder gerenciar webhooks (veja Antes de começar), Claude cria o webhook para você e não há mais nada a fazer.

Você pode ativar ou desativar Sincronizar automaticamente mais tarde no menu do marketplace. Ativá-lo configura o webhook da mesma forma.

Etapa 4: Se Claude não conseguir criar o webhook

Se o token não conseguir gerenciar webhooks, Claude exibe uma mensagem Concluir configuração do webhook no GitLab na tela com uma URL do webhook e um token. O token é exibido apenas uma vez, portanto conclua esta etapa antes de fechar a mensagem.

  1. No seu projeto GitLab, abra Configurações > Webhooks e adicione um novo webhook com a URL da mensagem.

  2. Cole o token no campo.

    1. Se a mensagem mostrar um Token secreto, cole-o no campo Token secreto do GitLab.

    2. Se a mensagem mostrar um Token de assinatura (gitlab.com e versões auto-gerenciadas 19.1 ou posterior), selecione "Gerar token de assinatura" no GitLab e substitua o valor gerado pelo do Claude.

  3. Ative Eventos de push e salve.

  4. (Opcional) Use Teste > Eventos de push no novo webhook no GitLab e confirme que ele relata HTTP 200.

Se perder o token, abra Configurar webhook no menu do marketplace, clique em "Remover webhook" e depois em "Ativar webhook" para obter um novo. O token antigo deixará de funcionar.

Escolha entre upload manual e sincronização de repositório

Cenário

Abordagem recomendada

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

Sincronização GitHub ou GitLab

Múltiplos desenvolvedores colaboram em plugins

Sincronização GitHub ou GitLab

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

Sincronização GitHub ou GitLab

Prototipagem rápida ou ferramentas pontuais

Upload manual

Plugins criados por equipes não técnicas

Upload manual

Ambientes sem acesso ao GitHub ou GitLab

Upload manual

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

Upload manual


Controlar distribuição 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:

Preferência

O que faz

O que os membros veem

Instalado por padrão

Pré-instala o plugin para todos os membros da organização

O plugin aparece em sua lista sem nenhuma ação. Os membros podem desativá-lo se desejarem.

Disponível para instalar

Listado na aba Descobrir

Os usuários o veem na aba Descobrir e podem adicioná-lo por conta própria.

Não disponível

Oculto completamente

Os utilizadores não conseguem ver nem adicionar o plugin. Útil para preparação ou descontinuação de plugins.

Obrigatório

Pré-instala o plugin para todos os membros da organização sem a opção de o remover

O plugin aparece na sua lista sem qualquer ação, marcado como "Este plugin é obrigatório na sua organização." Os utilizadores não conseguem desativá-lo nem removê-lo. Também permanece ativo nas sessões do Claude Code que sincronizam os plugins da conta do membro.

Importante: Os plugins definidos como "Instalado por predefinição" ou "Obrigatório" também são instalados no Claude Code para utilizadores que iniciam sessão com a sua conta Claude. No Claude Code, os hooks, sub-agentes e servidores MCP do plugin são executados no computador do utilizador, e um plugin "Obrigatório" não pode ser desativado lá. Reveja os hooks de um plugin antes de o definir como "Obrigatório." Saiba mais sobre plugins sincronizados na documentação do Claude Code.

Definir preferências

  1. Em Definições da organização > Plugins e competências, clique no separador "Inventário".

  2. Localize o plugin e clique no botão de menu no final da sua linha.

  3. Clique em "Acesso predefinido" e, em seguida, selecione uma opção em Instalar.

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

O que os membros experienciam

Os membros procuram plugins disponíveis no separador Descobrir em Personalizar > Plugins. Os plugins que define como "Instalado por predefinição" ou "Obrigatório" aparecem na sua lista automaticamente. Os plugins que define como "Disponível para instalar" aparecem em Descobrir para os membros adicionarem por si próprios.

Os membros não conseguem editar plugins geridos pela organização, o que evita alterações conflituosas nas ferramentas partilhadas.


Personalizar o acesso ao plugin por grupo

Os administradores empresariais podem substituir a preferência de instalação de um plugin em toda a organização para grupos específicos. Por exemplo, pode instalar automaticamente um plugin para o grupo de Engenharia, disponibilizá-lo para o Departamento Jurídico instalar por sua conta e ocultá-lo de todos os outros.

O acesso ao plugin ao nível do grupo está disponível nos planos Enterprise. Pode defini-lo na mesma página Definições da organização > Plugins e competências, que requer um Proprietário ou uma função personalizada que inclua a gestão das bibliotecas da organização.

Como funcionam as substituições de grupo

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

Quando define uma substituição ao nível do grupo para um plugin, esta substitui a definição em toda a organização para os membros desse grupo. A ordem de resolução é: definição de grupo, depois definição em toda a organização, depois predefinição do marketplace.

Definir o acesso ao plugin para um grupo

  1. Em Definições da organização > Plugins e competências, clique no separador "Inventário".

  2. Localize o plugin que pretende personalizar e clique no botão de menu no final da sua linha.

  3. Clique em "Acesso de grupo...".

  4. Clique em "Adicionar grupos" junto a Direcionamento de instalação.

  5. Selecione o grupo e escolha uma das preferências de instalação listadas acima.

Os grupos criados manualmente e os grupos aprovisionados por SCIM do seu fornecedor de identidade aparecem no seletor de grupos e funcionam da mesma forma.

O que acontece quando um membro está em vários grupos

Se um membro pertence a dois ou mais grupos com definições diferentes para o mesmo plugin, a definição mais permissiva aplica-se. A ordem da mais para a menos permissiva é: Obrigatório > Instalado por predefinição > Disponível para instalar > 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 predefinição", um membro em ambos os grupos obtém o plugin instalado por predefinição.

Nota: Isto difere da forma como os limites de gastos de grupo se resolvem. Os limites de gastos aplicam o valor de grupo superior ou inferior dependendo da sua definição de Limite de gastos de vários grupos. O acesso ao plugin aplica o valor mais permissivo, porque os grupos aqui se destinam a permitir o acesso para equipas que precisam de uma ferramenta, não para atuar como limite de segurança. Se precisar de bloquear completamente um plugin, defina a sua preferência em toda a organização como "Não disponível" e conceda acesso apenas aos grupos que devem tê-lo.

O que acontece quando um grupo é eliminado

Se um grupo for removido (por exemplo, eliminado do seu fornecedor de identidade), a substituição permanece na interface de administração mas é marcada como órfã. Não tem efeito nos membros (uma vez que ninguém pertence a um grupo eliminado) e não conta para o crachá de acesso personalizado. Pode limpar as substituições órfãs nas definições "Acesso de grupo..." do plugin.

As definições de grupo persistem entre ressincronizações do marketplace?

Sim. As substituições ao nível do grupo persistem quando ressincroniza um marketplace ligado a GitHub ou GitLab. São removidas apenas se o próprio plugin for eliminado do marketplace.


Atualizar e remover plugins

Marketplaces manuais

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

Para remover um plugin, elimine-o do seu marketplace em Definições da organização > Plugins e competências no separador "Inventário".

Marketplaces sincronizados com GitHub

Envie as suas alterações para o repositório ligado, depois aceda a Definições da organização > Plugins e competências e clique no separador "Marketplaces", localize o seu marketplace e clique em "Atualizar" para ativar uma sincronização. Cada sincronização substitui todos os plugins pelo estado atual do repositório. Se um proprietário ativou "Sincronizar automaticamente" para o marketplace, uma sincronização também é executada sempre que um pedido de pull com uma atualização de versão de plugin é intercalado no ramo predefinido do repositório.

Para marketplaces sincronizados com GitLab, consulte Configurar um marketplace sincronizado com GitLab.

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


Limites

Limite

Valor

Notas

Tamanho máximo de ZIP de plugin (carregamento)

200 MB

Aplicado tanto no lado do cliente como no lado do servidor

Máximo de plugins por marketplace (manual)

1000

Por marketplace

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

1000

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 sincronizado

Apenas privado ou interno no github.com e gitlab.com

Hospedado em github.com, GitHub Enterprise Server, gitlab.com ou uma instância GitLab auto-gerenciada. Hosts GitLab (incluindo gitlab.com) exigem uma configuração GitLab em Configurações da organização > Claude Code.
​
Repositórios públicos não são suportados.


Regras de nomenclatura

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:

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

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

Nota: Os autores de plugins podem definir um displayName para que um plugin mostre um nome legível no catálogo em vez de seu slug. Se um autor não definir um, o plugin mostra seu slug (por exemplo, deployment-tools).


Solução de problemas

Upload rejeitado

Causas comuns: o arquivo excede 200 MB, não é um arquivo ZIP válido ou o marketplace atingiu o limite de 1000 plugins. Verifique o tamanho e o formato do arquivo e remova plugins não utilizados se estiver no limite. Se a verificação de skill e plugin estiver ativada, um plugin também pode ser rejeitado por ter sido sinalizado como conteúdo malicioso. Revise o motivo, corrija o problema e faça upload do plugin novamente.

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 ativados 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. No Claude Code, os usuários recebem a alteração na próxima vez que iniciarem o Claude Code. Se a atualização ainda não estiver aparecendo, confirme que o upload foi bem-sucedido verificando a versão do plugin no seu marketplace.

Falha na sincronização do GitHub com erro de conteúdo

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 referência de manifesto de plugin.

Falha na sincronização com "Tipo de fonte de plugin externo não suportado. Tipos suportados: git-subdir, github, url" ou plugins são ignorados com "Repositório não encontrado em gitlab.com. Verifique a URL e certifique-se de que o repositório é público."

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 a sincronização da organização não consegue buscá-la. Uma fonte privada funciona apenas em três casos: um repositório github.com compartilha o proprietário do seu repositório de marketplace, um repositório no host GitHub Enterprise da sua organização com seu GitHub Enterprise App instalado nele, ou uma fonte url ou git-subdir no mesmo host GitLab que seu repositório de marketplace (em gitlab.com, também sob o mesmo namespace de grupo ou usuário de nível superior).

Para qualquer outra fonte privada, mova as pastas de plugin para o repositório de marketplace e altere a source de cada entrada para um caminho relativo (por exemplo, "./plugins/my-plugin"), depois envie e ressincronize. Alternativamente, faça upload dos plugins afetados individualmente via Configurações da organização > Plugins & skills Clique em "Adicionar", "Fazer upload de um plugin" e selecione "Adicionar a um marketplace existente." Os plugins enviados através do menu Personalizar de um membro são instalados apenas para esse membro e não são distribuídos para sua organização, embora os membros possam compartilhar plugins com colegas ou grupos específicos se o compartilhamento estiver ativado.

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

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

"Não é possível acessar o repositório" ao ativar "Sincronizar automaticamente"

Se as atualizações manuais funcionam, mas ativar "Sincronizar automaticamente" mostra "Não é possível acessar o repositório. Certifique-se de que o repositório existe e o Claude GitHub App está instalado," há duas causas prováveis:

  • Você não tem acesso de administrador ao repositório. Ativar a sincronização automática cria um webhook, que requer acesso de nível de administrador ao repositório através de sua conexão GitHub pessoal. Peça a um administrador do repositório para ativar a alternância ou faça com que seu acesso GitHub seja atualizado.

  • A permissão de Webhooks do Claude GitHub App não foi aprovada. Em instalações mais antigas, o GitHub mostra um prompt "Claude está solicitando permissões atualizadas". Um administrador de repositório ou organização precisa aprovar a permissão Webhooks (Leitura & Escrita) na instalação.

"Nenhuma instância GitLab está configurada para sua organização ainda. Adicione uma nas configurações do Claude Code e volte aqui" ao adicionar um marketplace

Se você vir esta mensagem ao adicionar um marketplace no GitLab, certifique-se de ter adicionado a configuração GitLab primeiro. Consulte Etapa 1: Adicionar uma configuração GitLab em Configurar um marketplace sincronizado com GitLab.

"Esta URL não está em uma instância GitLab configurada"

Certifique-se de que o nome do host da URL corresponde exatamente a um nome do host GitLab configurado.

Adicionar um projeto gitlab.com falha com "Falha ao criar marketplace. Tente novamente."

Verifique se a visibilidade do projeto é privada ou interna. Projetos públicos do gitlab.com não podem ser usados como marketplaces da organização.

O teste de conexão falha em Reach host (por exemplo "O nome do host não pôde ser resolvido," "A conexão foi recusada," ou "GitLab não respondeu a tempo"), ou adicionar um marketplace em uma instância auto-gerenciada falha com um erro genérico

Confirme se a instância está acessível pela internet pública via HTTPS e se os endereços IP de saída da Anthropic são permitidos através do seu firewall. "Não foi possível estabelecer uma conexão segura" geralmente significa que o certificado CA está ausente ou incorreto.

Erros que começam com "Falha na autenticação para …" ou "Acesso negado"

O token expirou, foi revogado ou está faltando um escopo ou função listado na seção Antes de começar em Configurar um marketplace sincronizado com GitLab. Crie um novo token e cole-o na configuração (Editar > Token de acesso).

Isto respondeu à sua pergunta?