English 中文 العربية 日本語 Português

Claude Code: Sistema de Plugins

Última atualização: 2026-08-31

Plugins tornam as capacidades do Claude Code plug-and-play — instale um plugin, ganhe uma nova habilidade, sem modificar o código central.

💡 Dica: Plugins do Claude Code e MCP são dois métodos de extensão diferentes. Plugins modificam o comportamento do próprio Claude Code; MCP expande sua capacidade de conexão com o mundo exterior.

📋 Pré-requisitos: Capítulo 13 - SubAgents

1. O Que Você Vai Aprender

2. Arquitetura do Sistema de Plugins

(1) Tipos de Plugins

Tipo Propósito Exemplo
Plugins de ferramenta Adicionar novas ferramentas/comandos Ferramenta de análise de código
Plugins de hook Comportamento customizado em eventos específicos Auto-lint antes de commit
Plugins de tema Mudar estilo de saída Exibição de diff colorido
Plugins de integração Conectar serviços de terceiros Integração com Jira

(2) Comparação Plugin vs MCP

Dimensão Plugin MCP
Direção de extensão Modificar comportamento do Claude Code Conectar serviços externos
Local de execução Dentro do processo do Claude Code Processo independente
Comunicação Chamadas diretas de função Comunicação por protocolo
Caso de uso Adicionar comandos, mudar saída Bancos de dados, APIs, browsers
Dificuldade de dev Média Baixa

3. Plugins Oficiais e Comunitários

(1) Plugins Oficiais

Plugin Função Instalar
claude-plugin-lint Auto-lint em arquivos modificados claude plugin add lint
claude-plugin-test Auto-executar testes após modificações claude plugin add test
claude-plugin-git Integração git aprimorada claude plugin add git
claude-plugin-doc Auto-gerar documentação claude plugin add doc

(2) Gerenciamento de Plugins

BASH 
# Ver plugins instalados
claude plugin list

# Instalar plugin oficial
claude plugin add lint

# Instalar plugin comunitário
claude plugin add @community/claude-plugin-jira

# Desabilitar plugin
claude plugin disable lint

# Desinstalar plugin
claude plugin remove lint

# Atualizar plugins
claude plugin update

▶ Exemplo 1: Fluxo de Trabalho do Plugin Lint

TEXT 📖 Somente leitura 
# Após instalar o plugin lint

> Refactor slugify function in src/utils/string.ts

Claude Code:
  → Reading src/utils/string.ts
  → Modifying slugify function...
  → [lint plugin] Running: npm run lint -- --fix
  → [lint plugin] Found 1 issue: missing return type
  → Auto-fixing: adding string return type
  → [lint plugin] All clean ✓
  → Running: npm test -- string.test.ts
  ✅ All tests passed

4. Configuração de Plugins

(1) Configuração Global

JSON 
// ~/.claude/plugins.json
{
  "plugins": [
    {
      "name": "lint",
      "enabled": true,
      "config": {
        "runOnSave": true,
        "fix": true
      }
    }
  ]
}

(2) Configuração em Nível de Projeto

JSON 
// .claude/plugins.json
{
  "plugins": [
    {
      "name": "lint",
      "config": {
        "command": "npm run lint:fix",
        "files": ["src/**/*.ts"]
      }
    }
  ]
}

5. Desenvolvimento Básico de Plugins

▶ Exemplo 2: Plugin Simples

TYPESCRIPT 
export default {
  name: "my-custom-linter",
  version: "1.0.0",

  hooks: {
    "after:file:write": async (context) => {
      const { filePath } = context;
      if (filePath.endsWith(".ts")) {
        const { execSync } = require("child_process");
        try {
          execSync(`npx eslint --fix ${filePath}`, { stdio: "pipe" });
        } catch (e) {
          console.log(`[my-linter] Issues in ${filePath}`);
        }
      }
    },
  },
};

6. Melhores Práticas de Plugins

Princípio Descrição
Minimalismo Apenas instalar plugins necessários
Verificar fonte Preferir oficiais; auditar plugins comunitários
Testar primeiro Validar novos plugins em projetos de teste
Limpeza regular Remover plugins não utilizados
Evitar duplicatas Plugins do mesmo tipo podem conflitar

❓ Perguntas Frequentes

P: Plugin ou MCP? R: Use MCP para conectar serviços externos (bancos, GitHub); use plugins para modificar comportamento do Claude Code (auto-lint, comandos customizados). Ambos podem coexistir.

P: Muitos plugins deixam lento? R: Sim. Cada plugin usa tempo de carregamento e memória. Instale apenas o necessário.

P: Plugins comunitários são seguros? R: Não garantido. Verifique código-fonte e reputação do autor antes de instalar.

P: Posso instalar múltiplos plugins do mesmo tipo? R: Possível mas pode conflitar. Dois plugins de lint podem aplicar regras diferentes. Mantenha um por tipo.

📖 Resumo

📝 Exercícios

  1. Básico (⭐): Instale o plugin oficial lint, verifique auto-lint na modificação de arquivos.
  2. Intermediário (⭐⭐): Instale e configure dois plugins garantindo sem conflitos.
  3. Avançado (⭐⭐⭐): Desenvolva um plugin customizado que auto-executa format e lint após cada modificação de arquivo.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%