Módulo 3: Plugins e automaçãoAula 13 de 154 minResumo aberto · Vídeo com cadastro grátis

Criando seu primeiro plugin no Claude Code passo a passo

Por Mauro Mequelussi · Curso gratuito Claude Code sem mistério: do zero ao plugin · Português (PT-BR)

Resposta direta · O que esta aula resolve

A Aula 13 de 15 ("Criando seu primeiro plugin no Claude Code passo a passo"), parte do módulo "Plugins e automação" do curso gratuito "Claude Code sem mistério: do zero ao plugin" na Escola de Aplicativos (ministrado por Mauro Mequelussi), ensina na prática: Transforme as automações do seu projeto em um plugin instalável para qualquer repositório. O passo a passo mostra como estruturar o manifesto plugin.json, migrar componentes da pasta .claude, configurar hooks com caminhos relativos e gerenciar credenciais com segurança.

Aula gratuita · Cadastro rápido

Crie sua conta grátis para assistir a esta videoaula em HD

O resumo técnico e os capítulos abaixo são abertos para consulta. Crie sua conta 100% gratuita em segundos para liberar todas as 15 videoaulas em HD, controle automático de progresso, Tutor IA e certificado gratuito verificável.

Criar conta grátis e assistir aulaJá tenho conta · Entrar
  • R$ 0 · Sem cartão de crédito
  • Tutor IA tira-dúvidas da aula
  • Certificado gratuito incluso

O que você vai aprender

  • Criar e configurar o manifesto plugin.json dentro da pasta .claude-plugin
  • Organizar pastas de skills, agentes e comandos na raiz do plugin
  • Validar a formatação e testar o plugin em sessões locais sem instalação definitiva
  • Migrar ganchos (hooks) usando caminhos relativos à raiz do plugin
  • Configurar variáveis sensíveis mascaradas para conexão com bancos ou APIs
  • Evitar conflitos e execuções duplicadas ao migrar arquivos do projeto

Pontos-chave da aula

  • Apenas o arquivo plugin.json vai dentro da pasta .claude-plugin; as skills devem ficar na raiz
  • O nome definido no manifesto é adotado automaticamente como prefixo para skills e agentes
  • Ganchos não utilizam prefixo de namespace, portanto mantenha apenas a versão do plugin ativa para evitar execuções em duplicidade
  • Mantenha descrições de skills curtas e objetivas para não sobrecarregar a janela de contexto de cada sessão

Capítulos e roteiro técnico da aula

5 capítulos minutados
  1. 00:00

    O que é um plugin e como criar o manifesto

    Entenda a diferença entre manter automações presas a um repositório e empacotá-las em um plugin reutilizável com o manifesto plugin.json.

  2. 00:53

    Pastas de skills, validação e teste local

    Veja onde posicionar as pastas de skills para evitar erros comuns e aprenda a validar e rodar o plugin localmente sem instalação.

  3. 01:48

    Migrando skills, agentes e ganchos do projeto

    Descubra como reaproveitar o código existente sem reescrever linhas, movendo skills, agentes e ajustando os hooks para caminhos dinâmicos.

  4. 02:40

    Configurações sensíveis, prefixos e conflitos

    Configure variáveis mascaradas para chaves de API, entenda a aplicação de prefixos e evite a execução dupla de ganchos em paralelo.

  5. 03:35

    Custo de contexto, ferramentas e depuração

    Saiba como economizar tokens de contexto nas descrições de skills e use ferramentas oficiais para desenhar e depurar plugins.

Momentos de destaque na prática

00:22

Estrutura do manifesto e a pegadinha das pastas

Descubra o erro simples na organização de pastas que faz seu plugin aparecer totalmente vazio no Claude Code.

02:10

Hooks com caminhos dinâmicos e chaves sensíveis

Veja como garantir que seus scripts funcionem em qualquer máquina sem expor senhas ou caminhos fixos.

03:09

Evitando conflitos de ganchos e controlando custos

Entenda por que manter arquivos antigos no repositório faz ganchos rodarem em dobro e aprenda a poupar tokens de contexto.

Notas de aula e guia de estudo

Nesta aula, você aprende a transformar as automações locais da pasta .claude em um plugin independente e reutilizável para qualquer projeto. O processo não exige reescrever scripts ou comandos: basta organizar a estrutura de arquivos correta e definir o manifesto da extensão.

Você também verá boas práticas para lidar com caminhos dinâmicos em ganchos, prompts interativos para chaves de API sensíveis e como evitar armadilhas de duplicação durante os testes locais.

O que você vai aprender

  • Criar e configurar o manifesto plugin.json dentro da pasta .claude-plugin
  • Organizar pastas de skills, agentes e comandos na raiz do plugin
  • Validar a formatação e testar o plugin em sessões locais sem instalação definitiva
  • Migrar ganchos (hooks) usando caminhos relativos à raiz do plugin
  • Configurar variáveis sensíveis mascaradas para conexão com bancos ou APIs
  • Evitar conflitos e execuções duplicadas ao migrar arquivos do projeto

Pontos-chave

  • Apenas o arquivo plugin.json vai dentro da pasta .claude-plugin; as skills devem ficar na raiz
  • O nome definido no manifesto é adotado automaticamente como prefixo para skills e agentes
  • Ganchos não utilizam prefixo de namespace, portanto mantenha apenas a versão do plugin ativa para evitar execuções em duplicidade
  • Mantenha descrições de skills curtas e objetivas para não sobrecarregar a janela de contexto de cada sessão

Conceitos e ferramentas abordados nesta aula

Criação de plugins no Claude CodeManifesto plugin.jsonEstrutura de diretórios de pluginsMigração de skills e subagentesGanchos (hooks) em pluginsGerenciamento de segredos e credenciaisClaude CodeAnthropicJSON

Documentação e referências oficiais citadas

Perguntas frequentes sobre esta aula

Nesta aula do módulo "Plugins e automação" na Escola de Aplicativos, você aprende de forma prática: Criar e configurar o manifesto plugin.json dentro da pasta .claude-plugin; Organizar pastas de skills, agentes e comandos na raiz do plugin; Validar a formatação e testar o plugin em sessões locais sem instalação definitiva; Migrar ganchos (hooks) usando caminhos relativos à raiz do plugin.