O que é plugin no Claude Code (e como instalar)

Resposta curta: Um plugin no Claude Code é um pacotinho pronto que faz o seu assistente de programação ficar mais esperto. É como baixar um aplicativo novo para o seu celular, que traz funcionalidades extras específicas. Você instala uma vez e o recurso fica disponível para ajudar nas suas tarefas.

Imagine que você tem um assistente de programação incrível, o Claude Code. Ele já é muito bom sozinho. Mas às vezes, para tarefas bem específicas, seria legal se ele tivesse ferramentas especiais, não é? É aí que entram os plugins.

Pense assim: você está montando um móvel. Suas mãos (o Claude Code) são fundamentais. Mas um plugin seria como uma chave de fenda especial que só serve para apertar um tipo de parafuso muito específico. Essa "chave especial" não vem na caixa básica, mas você pode comprar separadamente e guardar na sua caixa de ferramentas. Quando você precisa montar aquele móvel, a ferramenta certa já está lá, na sua mão.

Neste artigo, vamos explicar exatamente o que isso significa para você, que está começando, e mostrar como é fácil instalar e começar a usar.

Índice

1. Um plugin é como um aplicativo para o Claude Code
2. O que vem dentro de um plugin?
3. Como encontrar e instalar seu primeiro plugin (passo a passo)
4. Plugins vs. Skills avulsas: qual a diferença?
5. Dicas de segurança e uso consciente
6. Recomendamos testar estas 3 skills primeiro
7. Perguntas frequentes

Um plugin é como um aplicativo para o Claude Code

Para entender um plugin, vamos lembrar do que é o Claude Code. Ele é um programa que você instala no computador e que usa inteligência artificial para ajudar a escrever, analisar e conversar sobre código. É um assistente muito poderoso.

Um plugin (em português, "plug-in" ou "complemento") é um acréscimo a esse programa principal. Ele adiciona funcionalidades novas ou específicas que não estavam lá originalmente. A analogia clássica é a dos aplicativos de celular:

• Seu smartphone (o Claude Code) já vem com funções básicas: fazer ligações, mensagens, câmera.
• Mas você quer editar fotos de um jeito especial, então baixa um app de edição (o plugin). Agora, essa capacidade nova está integrada ao seu telefone.

Da mesma forma, um plugin no Claude Code pode, por exemplo:

• Ensinar o Claude a criar mensagens de commit (aqueles resumos de alterações no código) seguindo um padrão específico para sua equipe.
• Adicionar ferramentas para trabalhar com um banco de dados especial.
• Criar sub-assistentes que cuidam de partes específicas do seu projeto.

A grande vantagem é que alguém já empacotou tudo o que é necessário em um único lugar, pronto para usar.

---

---

O que vem dentro de um plugin?

Um plugin não é uma coisa mágica. Ele é, na verdade, uma pasta no seu computador que junta vários componentes menores que trabalham juntos. Vamos conhecer cada um, explicando cada palavra nova:

• Skills (Habilidades): São as "instruções" ou "scripts" que ensinam o Claude Code a fazer alguma tarefa muito específica. Imagine uma skill como uma receita de bolo detalhada que você dá para o seu assistente. A skill diz: "Quando o usuário pedir X, faça os passos A, B e C desta forma".
• Subagentes: É como se o seu assistente principal (agente é um termo para um programa autônomo, como o Claude) pudesse chamar um assistente auxiliar especialista em um assunto. Por exemplo, você pergunta sobre um erro, e o Claude automaticamente "chama" um subagente que só entende daquela linguagem de programação para dar uma resposta mais precisa. É uma divisão de trabalho.
• Hooks (Ganchos): São comandos automáticos que são executados em certos momentos, sem você precisar pedir. O exemplo clássico é um hook que roda sempre depois que você edita um arquivo, para verificar se tudo ainda está funcionando. É como um assistente que, toda vez que você guarda uma ferramenta na bancada, já a limpa e coloca no lugar certo.
• Servidores MCP (Model Context Protocol): Aqui temos um termo importante. Pense no MCP como um padrão de conexão universal, tipo uma porta USB-C. Ele permite que aplicativos de IA (como o Claude Code) se conectem a outros programas, arquivos ou serviços online. Um servidor MCP é o programa que fica do outro lado dessa conexão, fornecendo dados ou ferramentas. Um plugin pode trazer um servidor MCP pronto para conectar o Claude ao Google Agenda, por exemplo. Se quiser entender melhor essa parte fundacional, temos um artigo explicando O que é MCP (Model Context Protocol): explicado de um jeito fácil.

Para gerenciar tudo isso, o plugin tem um arquivo principal chamado manifesto (em .claude-plugin/plugin.json). Ele é como a caixa e o manual do seu novo aplicativo. Esse arquivo lista tudo o que o plugin contém (quais skills, hooks, etc.) e explica como ele deve ser configurado.

Como encontrar e instalar seu primeiro plugin (passo a passo)

Vamos à parte prática! Instalar um plugin é bem simples, e tudo é feito dentro da própria janela do Claude Code.

1. Abra a tela de plugins. No Claude Code, basta digitar o comando /plugin e pressionar Enter. Uma tela especial vai abrir.
2. Explore o mercado (Marketplace). A tela tem abas. Na aba "Discover" (Descobrir), você verá plugins populares. Eles vêm de catálogos chamados marketplaces (como uma loja de aplicativos). O marketplace oficial da Anthropic (a criadora do Claude) já é adicionado automaticamente para você. Ele se chama claude-plugins-official.
3. Adicione outros marketplaces (opcional). Se você souber de um catálogo público (geralmente um repositório no GitHub), pode adicioná-lo. O comando é: /plugin marketplace add nome-do-usuario/nome-do-repositorio.
4. Instale o plugin desejado. Quando encontrar um plugin que você quer, o comando para instalá-lo é: /plugin install nome-do-plugin@nome-do-marketplace. Por exemplo, para instalar um plugin chamado commit-commands do marketplace oficial: /plugin install commit-commands@claude-plugins-official.
5. Pronto! O plugin será baixado e configurado. Suas skills e ferramentas agora estão disponíveis para o Claude Code usar no seu projeto.

Importante: Um plugin, uma vez instalado e ativado, gasta um pouquinho da memória de contexto do Claude (aquela que é medida em tokens) em toda sessão. Isso porque o nome e a descrição das suas skills precisam ficar sempre disponíveis. É um uso pequeno, mas vale a pena saber. Se não estiver usando um plugin, você pode desativá-lo temporariamente com o comando claude plugin disable diretamente no terminal (a janela de texto onde você digita comandos para o computador).

Plugins vs. Skills avulsas: qual a diferença?

Você pode se perguntar: "Se uma skill é uma parte do plugin, posso ter uma skill sozinha?" A resposta é sim!

O Claude Code permite que você adicione skills avulsas (individualmente) sem precisar de um plugin inteiro. É como, em vez de baixar um pacote completo de ferramentas de pintura (plugin), você só compra um pincel muito bom (skill avulsa).

• Onde colocar? Skills avulsas são simplesmente pastas que você copia para um local especial no seu computador. Existem duas pastas principais:
  • ~/.claude/skills/ (na pasta de usuário): Skills disponíveis para todos os seus projetos.
  • ./claude/skills/ (dentro da pasta do seu projeto): Skills disponíveis só para aquele projeto específico.
• Quando usar? Se você encontrou uma skill solta na internet, ou criou uma você mesmo para uma necessidade pontual, essa é a forma mais direta de adicioná-la.
• E o plugin? O plugin é mais vantajoso quando várias coisas (skills, hooks, servidores MCP) precisam trabalhar juntas e ser gerenciadas como um pacote coeso. Além disso, é mais fácil instalar e atualizar através de um marketplace.

Para explorar essa integração de ferramentas externas mais a fundo, você pode ler sobre O que é um servidor MCP e como funciona e ver uma lista prática em Servidores MCP: lista com exemplos reais.

Dicas de segurança e uso consciente

Instalar um plugin é dar mais poderes ao seu Claude Code. Por isso, é bom ter alguns cuidados, assim como você tem ao baixar um aplicativo no celular.

1. Fonte Confiável: Prefira plugins do marketplace oficial ou de fontes com boa reputação (como projetos de código aberto conhecidos). Um plugin malicioso poderia, em teoria, tentar executar comandos indesejados no seu computador.
2. Permissões: Lembre-se que o plugin roda com as suas permissões. Ou seja, ele pode acessar os arquivos e pastas que o seu usuário no computador tem permissão para acessar. Não instale plugins de procedência duvidosa.
3. Custo de Contexto: Como mencionado, cada plugin ativo ocupa um espaço na memória do Claude (os tokens). Se você instalar muitos plugins, pode estar gastando tokens preciosos que poderiam ser usados para analisar seus arquivos. Mantenha ativos apenas os que você realmente usa. Para entender melhor esse "combustível" das IAs, dê uma olhada em O que são tokens em IA (e por que eles acabam tão rápido).
4. Comece Simples: Para seu primeiro projeto, experimente um plugin pequeno e bem avaliado. Não precisa instalar dez de uma vez. Aos poucos, você entende o que realmente agrega ao seu fluxo de trabalho.

Por fim, se você ficou animado e quer criar suas próprias automações, mesmo sem ser programador, explore o conceito de Agente de IA: o que é, como funciona e como criar o seu (sem programar).

Recomendamos testar estas 3 skills primeiro

Antes de mergulhar em plugins complexos, que tal experimentar algumas skills avulsas úteis? Você pode encontrar muitas no repositório oficial ou em nossa página para buscar skills. Aqui vão três sugestões para começar:

1. Skill: mcp-builder-anthropics: Esta skill ensina o Claude Code a te ajudar a criar seus próprios servidores MCP. É como um tutor que guia você no processo de construir aquele "adaptador USB-C" para conectar o Claude às suas ferramentas.
2. Skill: skill-creator-anthropics: Como o nome diz, é uma skill que ajuda você a criar outras skills. Percebeu uma tarefa repetitiva? Use esta skill para gerar a "receita de bolo" (a skill) que automatiza esse trabalho no futuro.
3. Skill: mcp-server-patterns-affaan-m: Ela fornece exemplos e modelos (padrões) de códigos para servidores MCP. É uma ótima referência para quando você quiser entender como essas conexões são feitas por baixo dos panos, seguindo o que você aprendeu em O que é MCP (Model Context Protocol): explicado de um jeito fácil.

---

Perguntas frequentes

Preciso pagar para usar plugins no Claude Code? Não diretamente. Os plugins em si são gratuitos. No entanto, para usar o Claude Code, você precisa de um plano pago do Claude (Pro, Max, Team ou Enterprise). O plano Free não inclui acesso ao Claude Code.

Posso criar meus próprios plugins? Sim! A especificação é aberta. Você pode agrupar suas skills, hooks e configurações MCP em uma pasta com o arquivo de manifesto (plugin.json) e compartilhar. É um processo mais técnico, indicado para quem já tem familiaridade.

Instalei um plugin, mas não sei como usá-lo. O que fazer? Normalmente, o plugin ativa novas skills ou comandos automaticamente. Tente conversar com o Claude Code normalmente e descrever a tarefa que o plugin promete ajudar. Por exemplo: "Claude, quero criar uma mensagem de commit para as minhas alterações". Se ele tiver um plugin para isso, usará a skill correspondente. Você também pode ver as skills instaladas na pasta .claude/skills/ do seu projeto.

O plugin funciona em todos os meus projetos de uma vez? Depende do escopo da instalação. Plugins podem ser instalados para o usuário (todos os projetos), para um projeto específico (ideal para trabalho em equipe) ou apenas localmente. A instalação via comando /plugin install geralmente é por projeto.

Plugin do Claude Code é a mesma coisa que a extensão do VS Code? Não, são coisas diferentes. A extensão do Claude para VS Code (ou JetBrains) é um programa que leva a inteligência do Claude para dentro desses ambientes de desenvolvimento específicos. Já um plugin do Claude Code é um pacote de recursos que funciona dentro do próprio aplicativo Claude Code. Um não depende do outro.

Leia também

• Claude Code: o que é, como baixar, instalar e quanto custa (guia 2026)
• Como conectar MCP no Claude (Desktop e Code)
• Melhores MCPs para Claude: Figma, Drive, WhatsApp, Power BI

6. O que é um servidor MCP e como funciona

---

---

Fontes

• O que é o Model Context Protocol (consultado em 16/10/2026)
• Claude Code: MCP (consultado em 16/10/2026)
• Claude Code: plugins (consultado em 16/10/2026)
• Claude Code: plugins (consultado em 16/10/2026)
• Planos e preços do Claude (consultado em 16/10/2026)