Como revisar um plugin do Claude Code antes de instalar

O que é cada coisa

1. Plugin: um pacote que você instala no Claude Code a partir de um marketplace. Segundo a documentação, um plugin instalado "can execute arbitrary code on your machine with your user privileges".
2. Marketplace: o catálogo de onde o Claude Code baixa o plugin. O nome do marketplace diz quem publica o catálogo, não o que cada plugin dele faz. Por isso a revisão vale para qualquer marketplace.
3. Hook: comando de shell que o plugin roda em pontos do ciclo do Claude Code, como antes ou depois de uma chamada de ferramenta.
4. Servidor MCP: o Claude Code se conecta aos servidores MCP que um plugin ativo declara. Um servidor stdio é um processo que o Claude Code inicia na sua máquina.
5. Pasta bin/: o Claude Code coloca a pasta bin/ de cada plugin ativo no PATH do shell da ferramenta Bash. Os comandos Bash do Claude podem rodar qualquer executável que esteja lá.
6. Skills, comandos e agentes: entram no contexto do Claude como instruções. Influenciam o que o Claude faz com as ferramentas que ele já tem.
7. Sandbox: fronteira de isolamento em volta dos comandos de shell que o Claude roda. As regras de permissão e o sandbox cobrem as chamadas de ferramenta que o Claude faz, não o código que o plugin roda sozinho. Hooks e servidores MCP locais rodam fora do sandbox. A página do sandbox diz que ele vem desligado por padrão e que cobre só comandos de shell.
8. Escopo: onde a instalação vale. user vale para você em todos os projetos da máquina. project vale para quem trabalha naquele repositório. local vale para você, só naquele repositório.
9. Atualização automática: quando está ligada no marketplace de onde você instalou, o Claude Code atualiza o plugin em segundo plano, e os arquivos que você revisou podem mudar no disco.

Revisão em quatro etapas

Faça antes de escolher o escopo e instalar.

Etapa 1. Descubra de onde veio o marketplace

No terminal, fora do Claude Code:

claude plugin marketplace list

O comando mostra a origem de cada marketplace, como um repositório do GitHub ou uma pasta. Confira se a origem é a que você espera.

Etapa 2. Abra o painel de detalhes

Dentro de uma sessão do Claude Code:

/plugin

Selecione o plugin. O painel mostra a seção Will install, com comandos, agentes, skills, hooks e servidores MCP e LSP. Em alguns plugins a seção traz só um aviso: Components will be discovered at installation (plugin dentro do marketplace) ou Component summary not available for remote plugin (plugin buscado em outro lugar). Nossa leitura: nesse caso a lista não ajuda, e as etapas 3 e 4 passam a ser as principais.

Para abrir direto nos detalhes de um plugin conhecido:

/plugin install plugin-exemplo@nome-do-marketplace

Em uma sessão, esse comando não instala na hora: ele abre o painel nos detalhes do plugin para você revisar e escolher o escopo. No terminal, claude plugin install instala de imediato, então não use esse comando para revisar.

Etapa 3. Leia os três lugares

A lista Will install mostra que um hook existe, mas não o que ele roda. No painel, use Open homepage ou View on GitHub. Se o painel não oferecer nenhum dos dois, abra o repositório do marketplace que você viu na etapa 1 e procure a pasta do plugin. Leia:

1. hooks/hooks.json: o comando que cada hook roda.
2. .mcp.json: o comando ou a URL de cada servidor.
3. bin/: todos os arquivos da pasta.

Estes são os arquivos que a documentação manda ler. Não é uma lista fechada de tudo que um plugin pode ter.

Etapa 4. Liste o que o plugin contém

Clone o repositório que guarda a pasta do plugin. Em seguida, no terminal:

claude --plugin-dir <pasta do plugin> plugin details <nome do plugin>

Segundo a documentação, o comando lê os arquivos do plugin sem abrir uma sessão e imprime um Component inventory: skills e comandos, agentes, hooks com o evento de cada um, e servidores MCP e LSP. Se a sua empresa bloqueia a opção --plugin-dir, esta etapa não roda: a documentação diz que um administrador pode desligá-la. Nossa recomendação, que não vem da documentação: clonar em geral só baixa os arquivos, mas não rode nenhum script do repositório que você ainda não leu.

Depois de instalar

Para ver o mesmo inventário do plugin instalado, que fica em ~/.claude/plugins/cache/<marketplace>/<plugin>/<versão>/:

claude plugin details <nome do plugin>

Atualização automática: o que muda e como controlar

Padrões de cada tipo de marketplace, segundo a documentação:

• claude-plugins-official e os demais nomes oficiais, exceto knowledge-work-plugins e first-party-plugins: ligada por padrão.
• Marketplaces adicionados pelo claude.ai: ligada por padrão.
• Qualquer outro, comunitário, de terceiros ou local de desenvolvimento: desligada por padrão.

Para ligar ou desligar, em uma sessão: /plugin, aba Marketplaces, escolha o marketplace e selecione Enable auto-update ou Disable auto-update.

Quando um plugin é atualizado, a sessão aberta continua com a versão que já carregou. Você vê Plugin updated: <nome> · Run /reload-plugins to apply, e a próxima sessão carrega a versão nova. Se você revisou uma versão, o que roda depois pode ser outra. Nossa recomendação, que não vem da documentação: revise de novo quando o plugin atualizar.

Se você desconfiou: como remover

No terminal, com o mesmo escopo da instalação:

claude plugin uninstall plugin-exemplo --scope user

O escopo aceita user, project ou local. Sem a opção, o uninstall age no escopo user. Depois confira o que ficou:

1. Dados persistentes: se esse era o último escopo em que o plugin estava instalado, a desinstalação também apaga a pasta de dados persistentes do plugin, a menos que você use --keep-data.
2. Arquivos em cache: ficam em ~/.claude/plugins/cache/ por 14 dias, até uma varredura em segundo plano removê-los. Se, com essa desinstalação, não sobrou nenhum plugin instalado, as pastas órfãs ficam até você instalar outro. Para apagar antes, remova você mesmo a pasta ~/.claude/plugins/cache/<marketplace>/<plugin>/.
3. O marketplace: se você também não confia em quem o publica, remova o marketplace. Isso desinstala todos os plugins que você instalou por ele.

claude plugin marketplace remove <nome do marketplace>

O que o Claude Code avisa ou recusa

O painel de detalhes mostra um aviso de confiança antes da instalação, igual para qualquer marketplace: confie no plugin antes de instalar, atualizar ou usar, porque a Anthropic não controla o que há nos plugins. O Claude Code também recusa carregar um marketplace que use nome oficial ou da comunidade com origem fora de github.com/anthropics/, e recusa instalar um plugin de origem archive cujo arquivo baixado não bata com o sha256 fixado pelo marketplace.

Resumo para guardar

1. Veja a origem: claude plugin marketplace list.
2. Abra o painel: /plugin, e leia Will install, sabendo que ele não mostra o que cada hook roda.
3. Leia hooks/hooks.json, .mcp.json e bin/.
4. Liste o inventário: claude --plugin-dir <pasta> plugin details <nome>.
5. Confira se a atualização automática está ligada no marketplace.
6. Desconfiou: claude plugin uninstall <plugin> --scope <escopo> e limpe o cache.

Mito x verdade

• Mito: "plugin é só um atalho". Verdade: skills, comandos e agentes entram como instruções, mas hooks e servidores MCP locais (stdio) rodam código na sua máquina, fora do sandbox.
• Mito: "se eu li antes de instalar, está tudo certo". Verdade: com a atualização automática ligada, os arquivos que você revisou podem mudar.
• Mito: "desinstalar apaga tudo na hora". Verdade: os arquivos ficam em cache por 14 dias (e, se não sobrou nenhum plugin instalado, até você instalar outro), a menos que você apague a pasta.

Fontes

Páginas da documentação do Claude Code abertas em 11/11/2026: Plugin security and trust, Install and manage plugins, Sandboxing e Plugin CLI reference.

Comandos: claude plugin --help e claude plugin marketplace list conferidos no Mac do autor em 11/11/2026, na versão 2.1.319 do Claude Code. Conteúdo educativo e independente, sem vínculo com a Anthropic.