Marketplace de plugins do Claude Code: adicionar, instalar e gerenciar
O Claude Code já vem com um marketplace oficial de plugins, o claude-plugins-official. Navegue como numa loja de aplicativos, instale plugins pelo nome com um comando, mantenha tudo atualizado e publique o seu próprio marketplace — 16 passos num terminal real.
A versão curta
- O marketplace oficial claude-plugins-official é adicionado automaticamente na primeira sessão interativa — sem configuração e sem URL para colar.
- Abra o painel /plugin para percorrer as abas Discover, Installed, Marketplaces e Errors, ou instale direto do terminal com claude plugin install frontend-design@claude-plugins-official.
- A rotina cabe em um menu: desativar, Mark for update, Update now, desinstalar — e o claude plugin marketplace remove desvincula um marketplace junto com todos os plugins que vieram dele.
- Publicar o seu é, no fundo, escrever um manifesto: crie o .claude-plugin/marketplace.json, valide localmente com claude plugin validate e teste o plugin com claude --plugin-dir.
Claude Code Plugins Explained In 7 Minutes
Canal: Software Engineer Meets AI7:21
Claude Code Plugins Tutorial: Install & Build Your Own
Canal: Leon van Zyl18:21
Plugins — official Claude Code docs
Documentação: code.claude.com/docs
Os frames vêm do vídeo de sete minutos do canal Software Engineer Meets AI — uma gravação de tela cheia e limpa. Os fatos de instalação, marketplace e publicação foram conferidos com o tutorial mais completo do Leon van Zyl e a documentação oficial de plugins.
Os frames pertencem aos respectivos criadores e são creditados aqui com links diretos para o momento exato; o texto é nosso.
Adicione, instale e gerencie plugins do Claude Code em 16 passos
Saiba o que está instalando
- 1
Entender o que conta como plugin
Um plugin do Claude Code é uma extensão empacotada que reúne skills, subagentes, servidores MCP, hooks e servidores LSP numa única unidade instalável. Como tudo viaja junto, o plugin é a unidade que você compartilha entre projetos ou com o time. Este guia percorre o ciclo completo: navegar, instalar, gerenciar e publicar.
A versão no quadro branco: um plugin com cinco tipos de extensão dentro.Ver em 0:21 - 2
Reconhecer um plugin pela árvore de arquivos
Todo plugin se ancora numa pasta .claude-plugin que guarda o manifesto plugin.json, cercada pelas pastas opcionais commands, agents, skills, output styles e hooks, além de um .mcp.json. Não precisa de tudo: um único comando já basta para publicar. O manifesto é o que transforma uma pasta comum em algo que o Claude Code sabe instalar.
Primeiro o manifesto, depois uma pasta por função — o esqueleto é só isso.Ver em 0:45 - 3
Começar pela página oficial de plugins
A documentação oficial em code.claude.com é a referência para comandos e campos do manifesto, e leva à galeria de plugins. Dê uma lida antes de instalar para que os nomes de painéis e comandos deste guia batam com o que você vê. Tudo funciona no terminal, no app de desktop e no VS Code.
Navegar, instalar e construir numa única página de documentação.Ver em 1:00 - 4
Navegar pela grade do marketplace oficial
O marketplace claude-plugins-official mostra os plugins numa grade com contadores de instalação e filtro Claude Code: Frontend Design, Superpowers, Context7, Code Review, Code Simplifier, GitHub e Playwright. O contador é sinal de popularidade, não selo de qualidade. Anote os nomes exatos: são eles que você digitará na instalação.
Role como numa loja de apps — os nomes são o que a CLI espera.Ver em 1:10
Adicionar um marketplace e instalar
- 5
Avaliar o plugin na página de detalhes
Clicar num plugin abre a página de detalhes: quem mantém, o que traz e quantas instalações acumulou. O Frontend Design, por exemplo, é Made by Anthropic e passa de 400 mil instalações. Antes de entregar acesso a ferramentas, prefira plugins que declaram autor e mostram uso real.
Autor, conteúdo, contador de instalação — três leituras antes de instalar.Ver em 1:40 - 6
Instalar um plugin pelo nome no terminal
O caminho mais rápido é um comando: claude plugin install frontend-design@claude-plugins-official. O ID é sempre nome-do-plugin@nome-do-marketplace, então o mesmo formato vale para qualquer marketplace adicionado depois. O terminal confirma a instalação e lista o que o plugin acabou de registrar.
Uma linha com arroba entre plugin e marketplace — pronto.Ver em 1:53 - 7
Descobrir plugins no painel /plugin
Prefere clicar a digitar? Digite /plugin numa sessão interativa e abra a aba Discover: superpowers com 294,8 mil instalações, context7 com 212,2 mil, code-review com 191,9 mil. Instalar por aqui faz exatamente o que o comando faz — e as atualizações também chegam nesse painel.
A loja dentro do app — mesmo catálogo, zero digitação.Ver em 2:00 - 8
Fazer o inventário da aba Installed
A aba Installed lista todos os seus plugins, cada um habilitado ou desabilitado, ao lado dos servidores MCP conectados e desconectados. É o retrato honesto do que suas sessões realmente carregam. Desative o que não usa em vez de desinstalar — a chave volta atrás quando quiser.
Habilitado significa carregado; desabilitado, instalado mas de lado.Ver em 2:10 - 9
Gerenciar um plugin pelo menu dele
Abra um plugin no painel /plugin e o menu de gestão aparece: Disable plugin, Mark for update, Update now, Uninstall e Back to plugin list. O Mark for update adia a atualização para agrupar; o Update now aplica na hora. O Uninstall remove o plugin, mas o marketplace continua conectado.
Cinco opções cobrem toda a manutenção depois da instalação.Ver em 3:38
Gerenciamento do dia a dia
- 10
Recarregar os plugins depois de qualquer mudança
O Claude Code absorve mudanças de plugins no próximo start, mas você não precisa sair: rode /reload-plugins e a sessão reescaneia na hora. A saída confirma o que está ativo — Enabled frontend-design nesta gravação — além do resumo de plugins, skills e agentes carregados. Torne hábito depois de toda edição manual.
Sem reiniciar — um comando de barra reescaneia a sessão.Ver em 3:45 - 11
Decidir se você precisa mesmo de um plugin
Um diretório .claude independente serve para ajustes pessoais sem versionamento; o plugin compensa quando entram colegas ou vários projetos, porque é versionado e instalável pelo nome. O teste honesto: outra pessoa quereria exatamente esse pacote? Se sim, empacote.
Ajustes pessoais ficam locais; tudo que se compartilha vira plugin.Ver em 4:15 - 12
Entender o que é um marketplace
Um marketplace é só um índice — uma loja de apps cujas entradas apontam para plugins de debug, design, pesquisa e mais. Adicioná-lo apenas diz ao Claude Code onde procurar; ele não traz código por si. O comando claude plugin marketplace add aceita caminho local, o atalho owner/repo ou uma URL de git completa.
A loja é uma lista de ponteiros; os plugins são os produtos.Ver em 4:46
Publicar o seu próprio plugin
- 13
Reunir agentes, comandos e skills
Comece pelo que já funciona: os agentes design-implementer, e2e-test-architect e quality-assurance na pasta .claude do seu projeto são material de plugin. Junte num lugar as pastas que quer publicar — agents, commands, skills. O que você deixa de fora importa tanto quanto o que inclui.
Os melhores moradores do .claude, enfileirados para o empacotamento.Ver em 5:20 - 14
Pedir ao Claude Code o esqueleto do plugin
Não precisa montar a pasta à mão: peça ao Claude Code um plugin de equipe compartilhável que empacote seu agente quality-assurance e o comando fix-issue. Ele arma a estrutura e rascunha o manifesto. Revise o andaime antes de tocar em qualquer campo.
O andaime fica com o Claude; a revisão, com você.Ver em 5:55 - 15
Preencher o manifesto plugin.json
O manifesto em .claude-plugin/plugin.json declara nome, versão e descrição do plugin e lista os arrays agents, commands e skills. Cada entrada aparece para o usuário na instalação, então mantenha tudo preciso e enxuto. Essa árvore de onze arquivos já é um plugin de verdade.
Nome, versão, descrição e os arrays — nada além disso é obrigatório.Ver em 6:25 - 16
Publicar com o modelo de ameaça em mente
Um repositório de marketplace é confiança executável: as revelações da comunidade em 2026 sobre sequestro de plugins mostraram um repositório do GitHub modificado enfiando injeção de prompt e mudanças de permissão em plugins já instalados. Fixe versões, acompanhe mudanças do repositório e lembre: todo plugin roda com as suas permissões completas de usuário.
Anatomia do sequestro: uma edição de repo, dois vetores de ataque.Ver em 6:50
Referência de CLI: todos os comandos de plugins
Seis comandos cobrem o ciclo inteiro. O estado dos plugins vive em ~/.claude/plugins, e os escopos seguem os níveis de sempre: user, project e local.
- 1claude plugin marketplace add — vincula um marketplace por caminho local, atalho owner/repo ou URL completa de git; o claude-plugins-official oficial entra automaticamente na primeira sessão interativa.
- 2claude plugin validate ./my-marketplace — valida o marketplace localmente antes de publicar e cedo expõe erros de manifesto e de source.
- 3claude plugin list — lista cada plugin instalado e o marketplace de origem; os detalhes de um plugin ficam no painel /plugin.
- 4claude plugin install frontend-design@claude-plugins-official — instala por ID, sempre nome-do-plugin@nome-do-marketplace.
- 5claude plugin marketplace remove — desvincula um marketplace desinstalando junto todos os plugins que vieram dele.
- 6claude --plugin-dir ./my-plugin — inicia com uma pasta de plugin local carregada, sem marketplace, ideal para testar enquanto desenvolve.
Dentro da sessão, o painel /plugin oferece as mesmas operações nas abas Discover, Installed, Marketplaces e Errors — e o /reload-plugins reescaneia sem reiniciar.
Segurança de marketplace: leia antes de clicar em Install
Os plugins rodam com as suas permissões de usuário dentro das suas sessões: um plugin malicioso é um segundo você. Cinco hábitos para continuar seguro.
- 1Leia o manifesto primeiro. Antes de instalar, abra o plugin.json e o repositório: quais comandos, hooks e servidores MCP ele registra? Um hook em todo prompt pesa muito mais que um comando de barra.
- 2Repositórios de marketplace podem ser reescritos. As revelações da comunidade em 2026 documentaram sequestro de plugins e envenenamento de dependências — um plugin instalado muda junto com o repositório; revise atualizações como revisa dependências.
- 3Nomes oficiais são reservados. Identificadores como claude-plugins-official recusam imitação de terceiros: um ID com arroba apontando para o marketplace oficial é autêntico — confira o sufixo do marketplace antes de confiar num nome.
- 4Empresas podem controlar o portão. Os managed settings permitem ou bloqueiam marketplaces e pregam as máquinas corporativas num marketplace interno aprovado.
- 5Instale com o mínimo de privilégio. Todo plugin roda como você: instale o essencial, desative o que não usa e desinstale em vez de acumular.
A aba Errors do painel /plugin é seu alarme: um plugin que de repente deixa de carregar após uma atualização merece um diff de manifesto antes da próxima sessão.