Marketplaces de plugins - Claude Code Docs

Marketplaces de plugins são catálogos de plugins disponíveis que facilitam a descoberta, instalação e gerenciamento de extensões Claude Code. Este guia mostra como usar marketplaces existentes e criar o seu próprio para distribuição em equipes.

Visão geral

Um marketplace é um arquivo JSON que lista plugins disponíveis e descreve onde encontrá-los. Marketplaces fornecem:

Descoberta centralizada: Navegue por plugins de múltiplas fontes em um único lugar
Gerenciamento de versões: Rastreie e atualize versões de plugins automaticamente
Distribuição em equipes: Compartilhe plugins necessários em toda a sua organização
Fontes flexíveis: Suporte para repositórios git, repositórios GitHub, caminhos locais e gerenciadores de pacotes

Pré-requisitos

Claude Code instalado e em execução
Familiaridade básica com formato de arquivo JSON
Para criar marketplaces: Repositório Git ou ambiente de desenvolvimento local

Adicionar e usar marketplaces

Adicione marketplaces usando os comandos /plugin marketplace para acessar plugins de diferentes fontes:

Adicionar marketplaces do GitHub

Adicione um repositório GitHub contendo .claude-plugin/marketplace.json

/plugin marketplace add owner/repo

Adicionar repositórios Git

Adicione qualquer repositório git

/plugin marketplace add https://gitlab.com/company/plugins.git

Adicionar marketplaces locais para desenvolvimento

Adicione diretório local contendo .claude-plugin/marketplace.json

/plugin marketplace add ./my-marketplace

Adicione caminho direto para arquivo marketplace.json

/plugin marketplace add ./path/to/marketplace.json

Adicione marketplace.json remoto via URL

/plugin marketplace add https://url.of/marketplace.json

Instalar plugins de marketplaces

Depois de adicionar marketplaces, instale plugins diretamente:

Instale de qualquer marketplace conhecido

/plugin install plugin-name@marketplace-name

Navegue por plugins disponíveis interativamente

/plugin

Verificar instalação do marketplace

Depois de adicionar um marketplace:

Listar marketplaces: Execute /plugin marketplace list para confirmar que foi adicionado
Navegue por plugins: Use /plugin para ver plugins disponíveis do seu marketplace
Teste a instalação: Tente instalar um plugin para verificar se o marketplace funciona corretamente

Configurar marketplaces de equipe

Configure a instalação automática de marketplaces para projetos de equipe especificando marketplaces necessários em .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    },
    "project-specific": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}

Quando os membros da equipe confiam na pasta do repositório, Claude Code instala automaticamente esses marketplaces e quaisquer plugins especificados no campo enabledPlugins.

Criar seu próprio marketplace

Construa e distribua coleções de plugins personalizadas para sua equipe ou comunidade.

Pré-requisitos para criação de marketplace

Repositório Git (GitHub, GitLab ou outro serviço de hospedagem git)
Compreensão do formato de arquivo JSON
Um ou mais plugins para distribuir

Criar o arquivo do marketplace

Crie .claude-plugin/marketplace.json na raiz do seu repositório:

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

Schema do marketplace

Campos obrigatórios

Campo	Tipo	Descrição
`name`	string	Identificador do marketplace (kebab-case, sem espaços)
`owner`	object	Informações do mantenedor do marketplace
`plugins`	array	Lista de plugins disponíveis

Metadados opcionais

Campo	Tipo	Descrição
`metadata.description`	string	Breve descrição do marketplace
`metadata.version`	string	Versão do marketplace
`metadata.pluginRoot`	string	Caminho base para fontes de plugins relativos

Entradas de plugins

As entradas de plugins são baseadas no schema de manifesto de plugin (com todos os campos opcionais) mais campos específicos do marketplace (source, category, tags, strict), sendo name obrigatório.

Campos obrigatórios:

Campo	Tipo	Descrição
`name`	string	Identificador do plugin (kebab-case, sem espaços)
`source`	string\|object	De onde buscar o plugin

Campos opcionais de plugin

Campos de metadados padrão:

Campo	Tipo	Descrição
`description`	string	Breve descrição do plugin
`version`	string	Versão do plugin
`author`	object	Informações do autor do plugin
`homepage`	string	URL da página inicial ou documentação do plugin
`repository`	string	URL do repositório de código-fonte
`license`	string	Identificador de licença SPDX (ex: MIT, Apache-2.0)
`keywords`	array	Tags para descoberta e categorização de plugins
`category`	string	Categoria do plugin para organização
`tags`	array	Tags para pesquisabilidade
`strict`	boolean	Exigir plugin.json na pasta do plugin (padrão: true) ¹

Campos de configuração de componentes:

Campo	Tipo	Descrição
`commands`	string\|array	Caminhos personalizados para arquivos ou diretórios de comandos
`agents`	string\|array	Caminhos personalizados para arquivos de agentes
`hooks`	string\|object	Configuração de hooks personalizados ou caminho para arquivo de hooks
`mcpServers`	string\|object	Configurações de servidor MCP ou caminho para configuração MCP

^{1 - Quando strict: true (padrão), o plugin deve incluir um arquivo de manifesto plugin.json, e os campos do marketplace complementam esses valores. Quando strict: false, o plugin.json é opcional. Se estiver faltando, a entrada do marketplace serve como o manifesto completo do plugin.}

Fontes de plugins

Caminhos relativos

Para plugins no mesmo repositório:

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

Repositórios GitHub

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

Repositórios Git

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

Entradas de plugins avançadas

As entradas de plugins podem substituir locais de componentes padrão e fornecer metadados adicionais. Observe que ${CLAUDE_PLUGIN_ROOT} é uma variável de ambiente que se resolve para o diretório de instalação do plugin (para detalhes, consulte Variáveis de ambiente):

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise workflow automation tools",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "[email protected]"
  },
  "homepage": "https://docs.company.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": [
    "./agents/security-reviewer.md",
    "./agents/compliance-checker.md"
  ],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{"type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"}]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}

Relação de schema: As entradas de plugins usam o schema de manifesto de plugin com todos os campos opcionais, mais campos específicos do marketplace (source, strict, category, tags). Isso significa que qualquer campo válido em um arquivo plugin.json também pode ser usado em uma entrada de marketplace. Quando strict: false, a entrada do marketplace serve como o manifesto completo do plugin se nenhum plugin.json existir. Quando strict: true (padrão), os campos do marketplace complementam o arquivo de manifesto do próprio plugin.

Hospedar e distribuir marketplaces

Escolha a melhor estratégia de hospedagem para suas necessidades de distribuição de plugins.

Hospedar no GitHub (recomendado)

GitHub fornece o método de distribuição mais fácil:

Crie um repositório: Configure um novo repositório para seu marketplace
Adicione arquivo de marketplace: Crie .claude-plugin/marketplace.json com suas definições de plugins
Compartilhe com equipes: Os membros da equipe adicionam com /plugin marketplace add owner/repo

Benefícios: Controle de versão integrado, rastreamento de problemas e recursos de colaboração em equipe.

Hospedar em outros serviços git

Qualquer serviço de hospedagem git funciona para distribuição de marketplace, usando uma URL para um repositório git arbitrário. Por exemplo, usando GitLab:

/plugin marketplace add https://gitlab.com/company/plugins.git

Usar marketplaces locais para desenvolvimento

Teste seu marketplace localmente antes da distribuição:

Adicione marketplace local para teste

/plugin marketplace add ./my-local-marketplace

Teste instalação de plugin

/plugin install test-plugin@my-local-marketplace

Gerenciar operações de marketplace

Listar marketplaces conhecidos

Liste todos os marketplaces configurados

/plugin marketplace list

Mostra todos os marketplaces configurados com suas fontes e status.

Atualizar metadados do marketplace

Atualize metadados do marketplace

/plugin marketplace update marketplace-name

Atualiza listagens de plugins e metadados da fonte do marketplace.

Remover um marketplace

Remova um marketplace

/plugin marketplace remove marketplace-name

Remove o marketplace de sua configuração.

Remover um marketplace desinstalará quaisquer plugins que você instalou dele.

Solução de problemas de marketplaces

Problemas comuns de marketplace

Marketplace não carregando

Sintomas: Não consegue adicionar marketplace ou ver plugins dele Soluções:

Verifique se a URL do marketplace está acessível
Verifique se .claude-plugin/marketplace.json existe no caminho especificado
Certifique-se de que a sintaxe JSON é válida usando claude plugin validate
Para repositórios privados, confirme que você tem permissões de acesso

Falhas na instalação de plugins

Sintomas: Marketplace aparece mas a instalação de plugin falha Soluções:

Verifique se as URLs de origem do plugin estão acessíveis
Verifique se os diretórios de plugins contêm arquivos necessários
Para fontes do GitHub, certifique-se de que os repositórios são públicos ou você tem acesso
Teste fontes de plugins manualmente clonando/baixando

Validação e teste

Teste seu marketplace antes de compartilhar:

Valide sintaxe JSON do marketplace

claude plugin validate .

Adicione marketplace para teste

/plugin marketplace add ./path/to/marketplace

Instale plugin de teste

/plugin install test-plugin@marketplace-name

Para fluxos de trabalho completos de teste de plugins, consulte Teste seus plugins localmente. Para solução de problemas técnicos, consulte Referência de plugins.

Próximos passos

Para usuários de marketplace

Descubra marketplaces da comunidade: Pesquise no GitHub por coleções de plugins Claude Code
Contribua com feedback: Relate problemas e sugira melhorias aos mantenedores de marketplace
Compartilhe marketplaces úteis: Ajude sua equipe a descobrir coleções de plugins valiosas

Para criadores de marketplace

Construa coleções de plugins: Crie marketplace temático em torno de casos de uso específicos
Estabeleça versionamento: Implemente políticas claras de versionamento e atualização
Engajamento da comunidade: Colete feedback e mantenha comunidades de marketplace ativas
Documentação: Forneça arquivos README claros explicando o conteúdo do seu marketplace

Para organizações

Marketplaces privados: Configure marketplaces internos para ferramentas proprietárias
Políticas de governança: Estabeleça diretrizes para aprovação de plugins e revisão de segurança
Recursos de treinamento: Ajude equipes a descobrir e adotar plugins úteis efetivamente

Veja também

Plugins - Instalando e usando plugins
Referência de plugins - Especificações técnicas completas e schemas
Desenvolvimento de plugins - Criando seus próprios plugins
Configurações - Opções de configuração de plugins

Administração

​Visão geral

​Pré-requisitos

​Adicionar e usar marketplaces

​Adicionar marketplaces do GitHub

​Adicionar repositórios Git

​Adicionar marketplaces locais para desenvolvimento

​Instalar plugins de marketplaces

​Verificar instalação do marketplace

​Configurar marketplaces de equipe

​Criar seu próprio marketplace

​Pré-requisitos para criação de marketplace

​Criar o arquivo do marketplace

​Schema do marketplace

​Campos obrigatórios

​Metadados opcionais

​Entradas de plugins

​Campos opcionais de plugin

​Fontes de plugins

​Caminhos relativos

​Repositórios GitHub

​Repositórios Git

​Entradas de plugins avançadas

​Hospedar e distribuir marketplaces

​Hospedar no GitHub (recomendado)

​Hospedar em outros serviços git

​Usar marketplaces locais para desenvolvimento

​Gerenciar operações de marketplace

​Listar marketplaces conhecidos

​Atualizar metadados do marketplace

​Remover um marketplace

​Solução de problemas de marketplaces

​Problemas comuns de marketplace

​Marketplace não carregando

​Falhas na instalação de plugins

​Validação e teste

​Próximos passos

​Para usuários de marketplace

​Para criadores de marketplace

​Para organizações

​Veja também

Visão geral

Pré-requisitos

Adicionar e usar marketplaces

Adicionar marketplaces do GitHub

Adicionar repositórios Git

Adicionar marketplaces locais para desenvolvimento

Instalar plugins de marketplaces

Verificar instalação do marketplace

Configurar marketplaces de equipe

Criar seu próprio marketplace

Pré-requisitos para criação de marketplace

Criar o arquivo do marketplace

Schema do marketplace

Campos obrigatórios

Metadados opcionais

Entradas de plugins

Campos opcionais de plugin

Fontes de plugins

Caminhos relativos

Repositórios GitHub

Repositórios Git

Entradas de plugins avançadas

Hospedar e distribuir marketplaces

Hospedar no GitHub (recomendado)

Hospedar em outros serviços git

Usar marketplaces locais para desenvolvimento

Gerenciar operações de marketplace

Listar marketplaces conhecidos

Atualizar metadados do marketplace

Remover um marketplace

Solução de problemas de marketplaces

Problemas comuns de marketplace

Marketplace não carregando

Falhas na instalação de plugins

Validação e teste

Próximos passos

Para usuários de marketplace

Para criadores de marketplace

Para organizações

Veja também