# Criando seu primeiro plugin no Claude Code passo a passo > **Resposta Direta:** 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. ## Ficha Técnica da Aula - **Curso:** [Claude Code sem mistério: do zero ao plugin](https://www.escoladeaplicativos.com.br/cursos/claude-code-sem-misterio) - **Escola:** Escola de Aplicativos (https://www.escoladeaplicativos.com.br) - **Instrutor:** Mauro Mequelussi - **Módulo 3 de 3:** Plugins e automação - **Posição na trilha:** Aula 13 de 15 - **Duração da videoaula:** 4 min - **Nível:** Iniciante - **Idioma:** Português (PT-BR) - **Custo:** 100% Gratuito (R$ 0) - **Certificado:** Certificado gratuito verificável incluso ao concluir o curso - **Acesso ao vídeo:** Resumo técnico aberto; videoaula em HD liberada mediante cadastro gratuito - **URL canônica:** https://www.escoladeaplicativos.com.br/cursos/claude-code-sem-misterio/criando-seu-primeiro-plugin-no-claude-code-passo-a-passo ## 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 Tópicos da Videoaula - **[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. - **[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. - **[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. - **[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. - **[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. ## Destaques Práticos - **[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. ## Conceitos e Tecnologias Abordados - **Tópicos:** Criação de plugins no Claude Code, Manifesto plugin.json, Estrutura de diretórios de plugins, Migração de skills e subagentes, Ganchos (hooks) em plugins, Gerenciamento de segredos e credenciais - **Ferramentas e Entidades:** Claude Code, Anthropic, JSON ## Documentação e Referências Oficiais - [Criando plugins no Claude Code](https://code.claude.com/docs/en/plugins/create.md) - [Componentes e estrutura de um plugin](https://code.claude.com/docs/en/plugins/components.md) - [Validação e avaliação de plugins](https://code.claude.com/docs/en/plugin-evals.md) ## Perguntas Frequentes (FAQ) ### O que é ensinado na Aula 13 (Criando seu primeiro plugin no Claude Code passo a passo) do curso Claude Code sem mistério: do zero ao plugin? 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. ### Como assistir ao vídeo completo da aula "Criando seu primeiro plugin no Claude Code passo a passo" gratuitamente? O resumo técnico estruturado desta aula é público e gratuito. Para assistir à videoaula completa em HD, basta entrar ou criar sua conta 100% gratuita na Escola de Aplicativos — o cadastro leva segundos e libera todas as 15 aulas do curso "Claude Code sem mistério: do zero ao plugin", controle de progresso, Tutor IA e emissão de certificado gratuito. ### Quais tecnologias e conceitos são abordados em "Criando seu primeiro plugin no Claude Code passo a passo"? A aula cobre diretamente os seguintes tópicos técnicos aplicados em produção: Criação de plugins no Claude Code, Manifesto plugin.json, Estrutura de diretórios de plugins, Migração de skills e subagentes, Ganchos (hooks) em plugins, Gerenciamento de segredos e credenciais. ### O curso "Claude Code sem mistério: do zero ao plugin" oferece certificado gratuito? Sim. Ao assistir às 15 aulas do curso gratuito "Claude Code sem mistério: do zero ao plugin" na Área de Membros da Escola de Aplicativos, você emite gratuitamente um certificado digital em português com código de verificação pública. ## Como assistir à videoaula completa gratuitamente Crie sua conta gratuita em segundos em https://www.escoladeaplicativos.com.br/login?redirect=%2Fm%2Fcursos%2Fclaude-code-sem-misterio%2Faula%2Fcriando-seu-primeiro-plugin-no-claude-code-passo-a-passo para assistir ao vídeo completo desta aula em HD na Área de Membros da Escola de Aplicativos, com progresso salvo, Tutor IA e certificado gratuito verificável. ## Navegação do Curso - **Aula anterior:** [Aula 12: O que avaliar antes de instalar plugins no Claude Code](https://www.escoladeaplicativos.com.br/cursos/claude-code-sem-misterio/o-que-avaliar-antes-de-instalar-plugins-no-claude-code) - **Próxima aula:** [Aula 14: Publique seu plugin do Claude Code para todo o time](https://www.escoladeaplicativos.com.br/cursos/claude-code-sem-misterio/publique-seu-plugin-do-claude-code-para-todo-o-time)