Workbranch › Guias

Como instalar plugins no Claude Code

Plugins reúnem skills, agentes, hooks e servidores MCP em uma única instalação. Este guia mostra de onde vêm os plugins, como instalar um pelo terminal, qual escopo escolher e como atualizá-lo ou removê-lo depois.

Atualizado em 30 de outubro de 2026

Os passos abaixo seguem a documentação do Claude Code da Anthropic em outubro de 2026. Eles são para o terminal; o app desktop e o VS Code têm telas de plugins próprias, descritas rapidamente mais abaixo. Novo no Claude Code? Comece por como começar a usar o Claude Code.

Marketplaces: de onde vêm os plugins

Um marketplace é um catálogo de plugins. O Claude Code registra o marketplace oficial da Anthropic, claude-plugins-official, na primeira vez que você abre uma sessão interativa no terminal, então os plugins dele já estão prontos para instalar. Qualquer outro (o catálogo de um colega, o marketplace da comunidade da Anthropic, um repositório da empresa) precisa ser adicionado uma vez antes de você poder instalar a partir dele.

1. Inicie o Claude Code com claude.
2. Rode /plugin marketplace add seguido da origem:
   • Um repositório do GitHub: /plugin marketplace add owner/repo (acrescente #v1.2.0 para fixar uma tag ou branch)
   • Qualquer outro host git: a URL de clone completa, incluindo https://
   • Uma pasta no seu computador: um caminho começando com ./ ou ../
   • Um arquivo de catálogo hospedado: a URL https:// do seu marketplace.json
3. Procure a mensagem Successfully added marketplace. Os plugins dele agora aparecem na aba Discover.

Para um repositório privado, o Claude Code usa as credenciais git que já estão no seu computador e nunca pede senha, então confira antes se um git clone normal dele funciona.

Instale um plugin

1. Rode /plugin install name@marketplace, por exemplo /plugin install commit-commands@claude-plugins-official. Em uma sessão, isso abre os detalhes do plugin em vez de instalar direto. Para navegar, rode só /plugin, digite para buscar em Discover e pressione Enter em um plugin.
2. Leia o painel de detalhes. Will install (vai instalar) lista os comandos, agentes, skills, hooks e servidores que ele adiciona. Para plugins do marketplace oficial da Anthropic, ele também mostra Last updated (última atualização) e, quando você abre o plugin com o comando de instalação ou pela aba Marketplaces, uma estimativa de Context cost (custo de contexto) em tokens.
3. Escolha um escopo (veja a tabela abaixo).
4. Leia a última linha do resumo da instalação. Plugin is now active significa que acabou. Se ela pedir para rodar /reload-plugins, o Claude Code faz isso por você quando o painel fecha. Se um servidor incluído precisar de configuração, abra o plugin na aba Installed (instalados) e escolha Configure.
5. Confira se funcionou: digite / e procure as skills do plugin no formato /plugin-name:skill, ou rode claude plugin list no seu shell.

Atalho para um marketplace que você ainda não adicionou: /plugin install name --marketplace owner/repo adiciona o marketplace (depois de pedir sua confirmação) e abre o plugin de uma vez. Em uma sessão, isso exige o Claude Code v2.1.275 ou mais recente.

Qual escopo escolher

O escopo de projeto ativa o plugin para os colegas, mas não o baixa para eles: cada um roda claude plugin install name@marketplace --scope project uma vez. Quando um plugin está definido em vários escopos, local vence projeto e projeto vence usuário.

Atualize os plugins

• Automático: ligado por padrão para o marketplace oficial da Anthropic, desligado por padrão para marketplaces da comunidade, de terceiros e locais. Ligue ou desligue por marketplace na aba Marketplaces do /plugin com Enable auto-update ou Disable auto-update.
• O que você vai ver: a sessão em andamento mantém a versão antiga. Uma mensagem pede para rodar /reload-plugins; senão, a próxima sessão já pega a versão nova.
• Um plugin agora: abra-o na aba Installed e selecione Update now, ou rode claude plugin update name@marketplace.
• Todos os plugins de um marketplace: selecione o marketplace na aba Marketplaces e escolha Update marketplace. Não existe um comando que atualize de uma vez todos os seus plugins de todos os marketplaces.

Desative ou desinstale um plugin

1. Rode /plugin e pressione Tab até chegar em Installed.
2. Pressione Space (espaço) em um plugin para desligá-lo ou ligá-lo, ou pressione Enter e escolha Disable plugin ou Uninstall.
3. Pelo shell, use claude plugin disable, enable ou uninstall com name@marketplace; acrescente --scope project quando necessário.

O título Not used recently (não usados recentemente) na aba Installed é um jeito rápido de achar plugins que continuam gastando contexto em toda sessão. Remover um marketplace inteiro (/plugin marketplace remove name) também desinstala todos os plugins que você instalou a partir dele.

Bom saber

• Confiança: um plugin pode rodar hooks e servidores MCP no seu computador. Leia o painel de detalhes antes de instalar qualquer coisa de um marketplace que você não conhece.
• Outros apps: na aba Code do app desktop, clique em + ao lado da caixa do prompt e escolha Add plugins. No VS Code, digite /plugins para abrir Manage plugins.
• Plugins do claude.ai: plugins ativados na sua conta do claude.ai são sincronizados com as sessões no terminal e aparecem como name@synced. Remova esses no claude.ai.
• Regras da empresa: plugins instalados pela sua organização mostram o escopo Managed (gerenciado) e você não pode removê-los.

Se não funcionar

• A URL do marketplace é recusada: inclua https://. Um gitlab.example.com/group/repo.git sem o prefixo é lido como atalho do GitHub e falha.
• Os comandos não aparecem depois da instalação: rode /reload-plugins. Se o resumo disse The plugin couldn't be loaded, abra a aba Errors (erros) no /plugin para ver o motivo.
• "/plugin isn't available in this environment": você está em uma execução não interativa, como claude -p. Use os comandos de shell claude plugin no lugar.
• Falta o plugin de projeto para um colega: ele está ativado no repositório, mas não instalado no computador dele; ele roda o comando de instalação com --scope project.

Acompanhe o que cada sessão deixa em aberto

Se você trabalha em muitas sessões do Claude Code, o plugin do Workbranch para o Claude Code se instala do mesmo jeito que qualquer outro plugin. Diga "save this to Workbranch" (salve isto no Workbranch) e o Claude organiza as tarefas, decisões e dúvidas em aberto da sessão em um projeto, e quando você inicia uma sessão em uma pasta vinculada a esse projeto, ele mostra o que ainda está pendente. Os detalhes estão na página Workbranch para o Claude.

Fontes

• Claude Code user FAQ (Central de Ajuda do Claude, conferido em 30 de outubro de 2026)
• Install and manage plugins (Claude Code Docs, conferido em 30 de outubro de 2026)

Perguntas frequentes