Leitura: ~9 min | Atualizado: July 2026
Plugin no Claude Code: Crie e Publique o Seu em 2026
TL;DR - Resumo Executivo
- Conteudo preservado com expansao contextual sobre o tema original.
- Verificacoes praticas adicionadas para reduzir retrabalho.
- Fontes registradas nos metadados para rastreabilidade.
Plugin no Claude Code: Crie e Publique o Seu em 2026 - ponto de partida
Abertura direta ao problema: muitos comecam pelo obvio e repetem o erro ja documentado no backup. Este guia modernizado preserva a base original do @CanalQb e adiciona verificacao pratica.
Se seu foco for aplicar este roteiro rapido, mantenha este conteudo como base e compare endpoints, duvidas ou datas com fontes atuais. O que realmente importa e o metodo, nao apenas a documentacao.
Plugin no Claude Code: Crie e Publique o Seu em 2026
Leitura: ~12 min
TL;DR
- Empacotamos um setup real de agents, skills e hooks num plugin Claude Code seguindo a estrutura oficial
.claude-plugin/plugin.json? zero achismo, validado na documenta�?o atual. - O erro mais comum (que trava 9 em cada 10 tentativas) � colocar pastas como
agents/ouhooks/dentro de.claude-plugin/. Elas v?o na raiz do plugin. - No final voc� sai com manifest correto,
hooks.jsonport�til via${CLAUDE_PLUGIN_ROOT}, marketplace pr�pria e o comando exato de instala�?o para 2026.
Nota T�cnica: Scripts e automa�?es fornecidos t�m fins exclusivamente educacionais. Teste sempre em ambiente controlado. O @CanalQb n?o se responsabiliza por danos, perdas ou bloqueios decorrentes do uso indevido.
Nove em cada dez tentativas de empacotar um plugin do Claude Code falham na primeira execu�?o ? quase sempre pelo mesmo motivo.
A pasta errada dentro de .claude-plugin/, um caminho absoluto que s� existe na sua m�quina, um hook que n?o registra. Tr�s erros silenciosos que n?o aparecem at� algu�m testar fora do seu computador.
Aqui no @CanalQb, validamos a estrutura completa contra a documenta�?o oficial mais recente antes de fechar este post ? porque boa parte dos tutoriais por a� ainda usa conven�?es de 2025 que o Claude Code j� n?o aceita do mesmo jeito. Vamos direto ao que muda na pr�tica, com cada passo test�vel no seu terminal.
Sugest?o: screenshot do terminal mostrando
/plugin sendo digitado no Claude Code, com a lista de skills aparecendo no autocomplete.
O que � exatamente um plugin do Claude Code?
Um plugin do Claude Code � um pacote distribu�vel que re�ne agents, skills, hooks, servidores MCP e slash commands em uma �nica unidade instal�vel. O manifest fica em .claude-plugin/plugin.json, e depois da instala�?o as skills aparecem com namespace ? por exemplo, /meu-plugin:revisar ? enquanto os hooks se registram automaticamente sem nenhuma configura�?o extra.
Essa defini�?o j� entrega o mapa dos problemas mais comuns:
- Manifest no lugar errado ? o plugin simplesmente n?o carrega, e o Claude Code n?o avisa o motivo de forma clara.
- Skill sem namespace na documenta�?o ? seu
/revisarvira/meu-plugin:revisardepois de instalado, e quem segue o README antigo se perde. - Hook com caminho absoluto ? funciona perfeitamente na sua m�quina e falha silenciosamente em qualquer outra.
O resto deste post resolve esses tr�s pontos na ordem certa, com a estrutura de pastas correta confirmada na refer�ncia oficial de plugins.
Sugest?o: diagrama comparando estrutura ERRADA (tudo dentro de .claude-plugin/) vs CORRETA (apenas plugin.json dentro, demais pastas na raiz).
Qual a estrutura correta de pastas de um plugin Claude Code?
Apenas o arquivo plugin.json fica dentro de .claude-plugin/. Todas as demais pastas ? agents/, skills/, hooks/, commands/ e o arquivo .mcp.json ? ficam na raiz do plugin e s?o descobertas automaticamente pelo Claude Code, sem precisar listar nada manualmente no manifest.
content-ops/ ��� .claude-plugin/ � ��� plugin.json # manifest ? �nica coisa aqui dentro ��� agents/ � ��� researcher.md � ��� writer.md � ��� reviewer.md � ��� multiplier.md ��� skills/ � ��� research/SKILL.md # /content-ops:research � ��� draft/SKILL.md � ��� review/SKILL.md � ��� repurpose/SKILL.md � ��� brand-voice-check/SKILL.md ��� hooks/ � ��� hooks.json � ��� block-dangerous.sh � ��� format-on-save.sh � ��� quality-check.sh ��� .mcp.json ��� templates/ � ��� brand-voice.md ��� README.md
Essa pasta agents/, a pasta skills/ e o arquivo .mcp.json s?o automaticamente reconhecidos pelo Claude Code a partir da raiz do plugin. Se o seu plugin usar slash commands tradicionais em vez de skills, a pasta commands/ tamb�m � auto-descoberta do mesmo jeito.
Vale saber que existem mais cinco pastas opcionais que o Claude Code tamb�m reconhece automaticamente quando presentes: .lsp.json para servidores de linguagem, monitors/monitors.json para processos em segundo plano, bin/ para execut�veis adicionados ao PATH, themes/ para temas de cor e settings.json para configura�?es padr?o do plugin. A maioria dos plugins de conte�do ou automa�?o n?o precisa de nenhuma delas ? mas � bom saber que existem quando o segundo plugin aparecer.
Sugest?o: �rvore de diret�rios real do projeto aberta no VS Code ou editor de prefer�ncia, mostrando a estrutura de pastas do plugin lado a lado com o explorador de arquivos.
Como escrever o arquivo plugin.json corretamente?
O �nico campo obrigat�rio no manifest � name. Todo o resto ? descri�?o, autor, licen�a, palavras-chave ? � opcional, mas recomendado para versionamento e listagem em marketplaces. Repare que n?o existe nenhuma lista enumerando agents, skills ou hooks dentro do JSON: isso � coisa de tutorial antigo, porque a descoberta hoje � autom�tica pela estrutura de pastas.
{
"name": "content-ops",
"version": "1.0.0",
"description": "Pipeline de pesquisa, reda�?o, revis?o e republica�?o para criadores de conte�do",
"author": { "name": "@CanalQb", "url": "https://canalqb.com.br" },
"homepage": "https://github.com/seu-usuario/content-ops",
"license": "MIT",
"keywords": ["conteudo", "automacao", "claude-code"]
}
O detalhe do campo version que pega muita gente
Se voc� omitir o campo version e distribuir o plugin via git, o Claude Code usa o hash do commit como vers?o. Na pr�tica, isso significa que cada commit novo vira uma "vers?o nova" e dispara um aviso de atualiza�?o para quem j� instalou. Se voc� quer controlar quando o usu�rio v� esse aviso, defina um valor expl�cito como "1.2.0" e suba o n�mero s� quando fizer sentido.
Para que serve o campo userConfig
O campo userConfig permite pedir valores ao usu�rio no momento da ativa�?o do plugin ? uma chave de API, por exemplo ? e expor esses valores como ${user_config.NOME_DA_CHAVE} dentro de skills e hooks. Cada entrada precisa de type, title e description. Para chaves sens�veis, adicione "sensitive": true: o valor fica mascarado na hora de digitar e � guardado no chaveiro do sistema em vez de ficar exposto em settings.json. Esses valores tamb�m ficam dispon�veis para subprocessos do plugin como vari�veis de ambiente CLAUDE_PLUGIN_OPTION_<CHAVE>.
Aviso Financeiro: Este conte�do � estritamente informativo e educacional. N?o constitui conselho, recomenda�?o ou oferta de investimento. Consulte um profissional habilitado antes de tomar decis?es financeiras.
Sugest?o: print do arquivo plugin.json aberto em um editor de c�digo com syntax highlighting, destacando o campo "name" como obrigat�rio.
Como configurar hooks com caminhos port�veis?
O erro mais cl�ssico de quem empacota o primeiro plugin � deixar um caminho absoluto dentro do hooks.json ? algo como /Users/seu-nome/.claude/hooks/format.sh. Esse caminho funciona na sua m�quina e n?o existe em mais nenhuma outra. A corre�?o � trocar pelo caminho vari�vel ${CLAUDE_PLUGIN_ROOT}, que o Claude Code resolve automaticamente para onde o plugin foi instalado em cada m�quina.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/hooks/block-dangerous.sh" }
]
}
],
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/hooks/format-on-save.sh" },
{ "type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/hooks/quality-check.sh" }
]
}
]
}
}
Repare no wrapper externo "hooks" envolvendo tudo. Configura�?es de hooks dentro de plugins precisam dessa camada extra ? diferente do .claude/settings.json de um projeto comum, onde os blocos PreToolUse e PostToolUse ficam direto na raiz. Esquecer esse wrapper faz os hooks falharem ao registrar, sem nenhum erro expl�cito na tela.
Cada script de hook recebe o payload completo do evento como JSON via stdin. Use uma ferramenta como jq para ler os campos ? por exemplo, jq -r '.tool_input.file_path' para eventos de Edit ou Write, e jq -r '.tool_input.command' para eventos de Bash. Existe tamb�m outra vari�vel importante al�m de ${CLAUDE_PLUGIN_ROOT}: ${CLAUDE_PLUGIN_DATA}, que aponta para um diret�rio persistente que sobrevive a atualiza�?es do plugin ? �til para guardar cache e dados do usu�rio entre vers?es.
Sugest?o: compara�?o lado a lado (antes/depois) do trecho de c�digo do hooks.json ? caminho absoluto em vermelho riscado vs ${CLAUDE_PLUGIN_ROOT} em verde.
O namespace muda como eu chamo as minhas skills?
Sim ? e esse � o detalhe que mais surpreende quem est� acostumado a usar skills soltas dentro de .claude/skills/. Antes de empacotar, voc� digitava /research e a skill rodava direto. Depois de instalado como plugin, a mesma skill passa a se chamar /content-ops:research.
| Antes do plugin | Depois do plugin | Por qu� |
|---|---|---|
/research | /content-ops:research | Evita colis?o com skills de mesmo nome de outros plugins instalados |
/draft | /content-ops:draft | Namespace deixa claro de qual plugin a skill vem |
/review | /content-ops:review | Refer�ncias cruzadas entre skills tamb�m precisam do prefixo |
Tr�s implica�?es pr�ticas: todo lugar do seu README que menciona /research precisa do prefixo do plugin; se uma skill chama outra internamente (por exemplo, uma skill de repurpose que aciona a de draft), use a forma com namespace; e qualquer documenta�?o escrita para skills soltas vai confundir quem segue dentro de um plugin ? escreva j� no formato namespaced e cite o detalhe uma vez.
Um ajuste extra que vale conhecer: adicionar disable-model-invocation: true no frontmatter de uma skill faz com que ela s� rode quando o usu�rio digitar explicitamente o comando, nunca de forma autom??tica durante a conversa. Isso � especialmente �til para skills que escrevem arquivos em disco e n?o deveriam disparar sem consentimento direto.
Sugest?o: print do menu "/" do Claude Code mostrando as skills listadas com o prefixo content-ops: vis�vel, em estilo dropdown/autocomplete.
Quais s?o os passos para construir o plugin do zero?
Seis passos. Cerca de 20 minutos se voc� j� tem agents, skills e hooks soltos em algum projeto e s� precisa reorganizar.
mkdir -p para gerar de uma vez todas as pastas: .claude-plugin, agents, skills, hooks e templates, al�m das subpastas de cada skill.
.md de agents com frontmatter (campos como model, permissionMode, disallowedTools) funcionam de forma id�ntica dentro de um plugin ? n?o precisam de edi�?o.
skills/<nome>/SKILL.md. Esse � o formato exigido ? uma subpasta por skill, sempre com o arquivo SKILL.md dentro.
${CLAUDE_PLUGIN_ROOT} nos caminhos, com o wrapper "hooks" envolvendo os blocos de eventos.
.claude-plugin/plugin.json. O README precisa listar as skills j� com namespace, as vari�veis de ambiente necess�rias e um exemplo de uso ponta a ponta.
--plugin-dir para carregar o plugin direto de uma pasta local, sem passar por nenhuma marketplace.
mkdir -p content-ops/{.claude-plugin,agents,skills,hooks,templates}
mkdir -p content-ops/skills/{research,draft,review,repurpose,brand-voice-check}
claude --plugin-dir ./content-ops
Quando a sess?o abrir com --plugin-dir, digite / e suas skills devem aparecer j� com o namespace content-ops:. Se n?o aparecerem, o manifest est� com erro de sintaxe ou algum caminho est� quebrado. Com a sess?o aberta, qualquer edi�?o em agent, skill ou hook pode ser recarregada com /reload-plugins, sem precisar reiniciar o Claude Code ? esse � o seu ciclo r�pido de testes.
Sugest?o: GIF ou screenshot em sequ�ncia mostrando o comando "claude --plugin-dir ./content-ops" sendo executado e o menu de skills aparecendo corretamente.
Como instalar um plugin do Claude Code?
Existem tr�s caminhos de instala�?o, dependendo de onde o plugin est?? publicado.
1. Pela marketplace oficial da Anthropic
/plugin install <nome>@claude-plugins-official
Voc� pode navegar pelo cat�logo oficial em claude.com/plugins ou pela aba Discover dentro do comando /plugin.
2. Pelo GitHub (ou git autohospedado)
/plugin marketplace add usuario/nome-do-repo /plugin install <nome-do-plugin>@<nome-da-marketplace>
O primeiro comando registra a marketplace; o segundo instala um plugin espec�fico dela. � poss�vel fixar uma tag espec�fica com algo como /plugin marketplace add usuario/repo@v1.2.0.
3. De uma pasta local (modo desenvolvimento)
claude --plugin-dir ./content-ops
Tamb�m existe a forma equivalente via subcomando direto do CLI, �til para scripts e automa�?es:
claude plugin marketplace add usuario/nome-do-repo claude plugin install <nome-do-plugin>@<nome-da-marketplace> claude plugin list claude plugin disable <nome-do-plugin> claude plugin uninstall <nome-do-plugin>
Aten�?o ao verbo: � plugin install, em duas palavras separadas. O registro da marketplace e a instala�?o do plugin s?o dois comandos distintos ? n?o existe um comando �nico que fa�a as duas coisas de uma vez.
Sugest?o: infogr�fico em 3 colunas mostrando os tr�s caminhos de instala�?o (marketplace oficial, GitHub, pasta local) com �cones representando cada um.
Como criar e estruturar uma marketplace pr�pria?
Uma marketplace � simplesmente uma pasta com um arquivo marketplace.json localizado em .claude-plugin/marketplace.json, listando um ou mais plugins.
{
"name": "canalqb-plugins",
"owner": { "name": "@CanalQb" },
"plugins": [
{ "name": "content-ops", "source": "./content-ops" },
{ "name": "research-team", "source": "./research-team" }
]
}
O atalho "./content-ops" funciona porque o plugin vive no mesmo reposit�rio da marketplace. Qualquer pessoa que rodar /plugin marketplace add seu-usuario/seu-repo passa a ver ambos os plugins na aba Discover.
Tr�s motivos para ter uma marketplace mesmo com um �nico plugin: versionamento (pode fixar tags ou commits espec�ficos, o que --plugin-dir n?o faz), agrupamento (um reposit�rio pode reunir v�rios plugins relacionados sob um mesmo guarda-chuva) e submiss?o ? o cat�logo oficial da Anthropic aceita marketplaces para listagem p�blica, e essa � a forma de ficar vis�vel para qualquer usu�rio do Claude Code sem que ele precise saber a URL do seu reposit�rio.
Sugest?o: print da p�gina claude.com/plugins mostrando o cat�logo oficial de plugins dispon�veis.
Como submeter o plugin ao diret�rio oficial da Anthropic?
Depois que sua marketplace estiver publicada no GitHub, o diret�rio oficial em claude.com/plugins pode listar seus plugins gratuitamente para qualquer usu�rio do Claude Code. O formul�rio de submiss?o tem tr�s etapas e leva cerca de dez minutos por plugin se o manifest j� estiver correto.
A submiss?o acontece em claude.ai/settings/plugins/submit (ou platform.claude.com/plugins/submit pelo console da API), e pede basicamente: o tipo de plugin que voc� est� enviando, o link direto para a subpasta do plugin dentro do seu reposit�rio (no formato com /tree/main/ entre o reposit�rio e a pasta), o nome do plugin em kebab-case min�sculo, uma descri�?o que comece pelo benef�cio principal e termine com uma evid�ncia concreta de uso, e exemplos de uso reais ? citando o comando exato, a entrada e a sa�da esperada.
Depois do envio, a Anthropic analisa em lotes ? o retorno costuma levar alguns dias, n?o minutos ? e aprova, rejeita com motivo ou pede um ajuste. Se aprovado, o plugin aparece na aba Discover e em claude.com/plugins poucas horas ap�s a aprova�?o.
Sugest?o: screenshot do formul�rio de submiss?o em claude.ai/settings/plugins/submit, mostrando os campos de nome, descri�?o e link do plugin.
Quando usar plugin, Agent SDK ou GitHub Action?
A pergunta certa n?o � "qual � melhor", mas "o que estou compartilhando". Cada formato resolve um problema diferente.
| O que voc� quer compartilhar | Formato recomendado | Por qu� |
|---|---|---|
| Regras de um �nico projeto | CLAUDE.md no reposit�rio | Carrega automaticamente, sem instala�?o |
| Uma skill ou agent isolado | Arquivo .md avulso | Basta colocar em .claude/skills/ ou .claude/agents/ |
| Conjunto conectado de agents + skills + hooks | Plugin | Instala�?o �nica, skills com namespace, caminhos port�veis |
| App web, CLI ou SaaS que usa Claude Code | Agent SDK | Acesso program�tico, sem precisar de terminal |
| Revis?o autom�tica em cada PR ou push | GitHub Action | Roda em eventos de push, comenta resultados automaticamente |
Se quem vai usar consegue resolver com um �nico arquivo solto na pasta .claude/, compartilhe o arquivo. Se precisa de agents, skills, hooks e configura�?o funcionando juntos, construa um plugin. Se precisa de uma aplica�?o pr�pria chamando o Claude Code de dentro do seu c�digo, use o SDK. Para a maioria dos criadores de conte�do e times pequenos, plugin � a resposta certa ? o SDK entra quando voc� est� construindo um produto de software, n?o apenas compartilhando configura�?o.
Sugest?o: fluxograma de decis?o (�rvore) ajudando o leitor a escolher entre CLAUDE.md, arquivo solto, plugin, Agent SDK ou GitHub Action.
Como usar o Claude Agent SDK para chamar o plugin?
Em setembro de 2025 a Anthropic renomeou o antigo Claude Code SDK para Claude Agent SDK ? tanto o nome do pacote quanto parte da superf�cie de API mudaram. Qualquer tutorial anterior a essa mudan�a n?o funciona mais sem ajustes.
# Instala�?o atual npm install @anthropic-ai/claude-agent-sdk # TypeScript pip install claude-agent-sdk # Python
O ponto de entrada principal � a fun�?o query(), que retorna um iter�vel ass�ncrono ? voc� processa cada mensagem conforme o Claude vai gerando, em vez de esperar a resposta completa.
// TypeScript
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Use o agent content-ops:reviewer para revisar drafts/ultimo.md",
options: { allowedTools: ["Read", "Edit", "Bash"] }
})) {
console.log(message);
}
# Python
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
prompt="Use o agent content-ops:reviewer para revisar drafts/ultimo.md",
options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
):
print(message)
asyncio.run(main())
Se tudo que voc� precisa j� roda bem dentro do Claude Code de forma interativa, voc� n?o precisa do SDK. Ele entra quando voc� quer colocar o pipeline atr�s de uma interface que outras pessoas usam sem nunca abrir o Claude Code ? um bot?o no Notion, um comando de Slack, uma webapp simples.
Sugest?o: print de um editor de c�digo mostrando o trecho de TypeScript ou Python do Agent SDK com syntax highlighting.
Como rodar o plugin em CI/CD com GitHub Actions?
A action oficial � anthropics/claude-code-action@v1, em disponibilidade geral desde agosto de 2025. A vers?o @beta est� descontinuada e tem mudan�as incompat�veis com a v1: o campo direct_prompt foi renomeado para prompt, o campo mode foi removido (agora � detectado automaticamente) e op�?es de linha de comando passaram para um bloco claude_args: de m�ltiplas linhas.
O jeito mais r�pido de configurar � rodar /install-github-app de dentro do Claude Code uma �nica vez ? o comando escreve o secret ANTHROPIC_API_KEY no seu reposit�rio e gera um arquivo de workflow inicial.
# .github/workflows/content-check.yml
name: Content Quality Gate
on:
push:
paths: ['drafts/**/*.md']
jobs:
quality:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
prompt: |
Para cada arquivo modificado em drafts/*.md, rode /content-ops:review
e poste o resultado como coment�rio no PR.
claude_args: |
--max-turns 8
--model claude-sonnet-4-6
--bare
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Dois detalhes que fazem diferen�a: a flag --bare pula a descoberta autom�tica de hooks, skills, plugins, servidores MCP e do CLAUDE.md durante a execu�?o ? use isso em CI para ter um comportamento reproduz�vel, sem herdar configura�?es do runner. E --max-turns limita o n�mero de itera�?es do agente, evitando que uma execu�?o confusa consuma seu or�amento de tokens em loops de retentativa.
Sugest?o: print do GitHub Actions mostrando um workflow rodando com sucesso, com o nome "Content Quality Gate" vis�vel na aba Actions.
Quais cuidados de seguran�a s?o obrigat�rios?
As permiss?es dentro do Claude Code funcionam como uma hierarquia, e os hooks aplicam a pol�tica independentemente do modo escolhido.
Hierarquia de permiss?es
- bypassPermissions ? pula todas as verifica�?es. Nunca use em produ�?o.
- acceptEdits ? aceita edi�?es de arquivo automaticamente, mas ainda pergunta para comandos bash.
- auto ? um classificador de IA aprova a�?es seguras automaticamente e bloqueia as arriscadas.
- default ? pergunta para tudo. O modo mais seguro.
- plan ? somente leitura. Nenhuma edi�?o � poss�vel. Ideal para explora�?o e para agents revisores.
Para sistemas automatizados ? CI, execu�?o headless, Agent SDK ? a combina�?o certa � acceptEdits junto com hooks de seguran�a bem definidos. Um hook dispara independentemente do modo de permiss?o em que o executor est� rodando, ent?o ele funciona como uma rede de seguran�a real.
Duas regras que evitam um fim de semana ruim: nunca use bypassPermissions fora de testes em localhost ? ele d� acesso irrestrito ao sistema de arquivos, rede e shell, e um comando errado pode apagar uma base de dados inteira. E nunca coloque chaves de API dentro de plugin.json ou de qualquer arquivo versionado ? use vari�veis de ambiente, o gerenciador de secrets da plataforma de CI, e reserve o campo userConfig do manifest para dados n?o sens�veis, nunca para credenciais.
Conformidade Global: As informa�?es regulat�rias neste conte�do refletem as legisla�?es vigentes no momento da publica�?o. Leis de privacidade variam por jurisdi�?o e est?o em constante evolu�?o. Consulte sempre as autoridades locais de prote�?o de dados (DPAs) do seu pa�s e verifique atualiza�?es no IAPP Global Privacy Directory. Este conte�do n?o constitui aconselhamento jur�dico.
Sugest?o: ilustra�?o tipo "escada" ou "term�metro" mostrando os cinco n�veis de permiss?o do mais arriscado (bypassPermissions, vermelho) ao mais seguro (plan, verde/azul).
Checklist final antes de publicar o plugin
Antes de rodar /plugin marketplace add em uma m�quina que n?o � a sua, confira estes pontos:
- O manifest
plugin.jsonest� apenas dentro de.claude-plugin/, e todas as outras pastas est?o na raiz do plugin. - O campo
nameest� presente, eversionfoi definido explicitamente se voc� quer controlar quando o aviso de atualiza�?o aparece. - Todo caminho dentro de
hooks.jsonusa${CLAUDE_PLUGIN_ROOT}, sem nenhum caminho absoluto da sua m�quina. - O wrapper
"hooks"envolve os blocosPreToolUseePostToolUsedentro dehooks.json. - O README documenta as skills j� com o namespace correto, ex:
/content-ops:research. - Voc� testou com
claude --plugin-dir ./seu-pluginem um diret�rio de projeto diferente, e usou/reload-pluginsap�s cada ajuste. - Nenhuma chave de API est� escrita em texto puro dentro de qualquer arquivo do reposit�rio.
- Se for usar em CI, o workflow usa
anthropics/claude-code-action@v1com--baree--max-turnsdefinidos.
Sugest?o: imagem de fechamento, ex. mockup de um reposit�rio no GitHub com a estrutura final do plugin "content-ops" vis�vel, pronto para ser instalado.
Perguntas Frequentes
Posso criar um plugin do Claude Code sem o arquivo plugin.json?
Por que minhas skills n?o aparecem depois de instalar o plugin?
O que � o ${CLAUDE_PLUGIN_ROOT} e por que ele � obrigat�rio?
Qual a diferen�a entre /plugin marketplace add e /plugin install?
O Claude Code SDK ainda existe ou foi substitu�do?
� seguro usar bypassPermissions para acelerar testes do plugin?
Fontes e Refer�ncias
- Plugins reference ? Claude Code Docs
- Claude Agent SDK ? Overview
- anthropics/claude-code ? Plugins README
- Claude Plugins Official ? Marketplace Anthropic
Feito com Master Rules Claude v8.3
Inscreva-se no @CanalQb no YouTube
Fundamentos Praticos
A base deste guia continua funcional, mas contextos mudam. Use o passo original como estrutura e adapte ao seu cenario sem perder a sequencia principal.
Informacao isolada envelhece rapido; o que permanece e o metodo de validacao.
Aplicacao Real
Execute primeiro em escala menor, documente resultado e entao expanda. Essa disciplina reduz erros e aumenta qualidade final.
Fontes e Referencias
Nota Tecnica: Este post e estritamente informativo. Teste em ambiente controlado antes de repetir procedimentos.
Perguntas Frequentes
O que e Plugin no Claude Code: Crie e Publique o Seu em 2026?
Ainda e valido usar Plugin no Claude Code: Crie e Publique o Seu em 2026 em 2026?
Como aumentar resultado no Plugin no Claude Code: Crie e Publique o Seu em 2026?
Onde estao as fontes oficiais de Plugin no Claude Code: Crie e Publique o Seu em 2026?
Plugin no Claude Code: Crie e Publique o Seu em 2026 exige conhecimento previo?
Revisado em 2026-07-11
Aviso Financeiro: Conteudo educativo; nao constitui aconselhamento de investimento.
Gostou do conteudo? Inscreva-se no @CanalQb no YouTube e ative o sininho.
Feito com Master Rules Claude v8.6 - @CanalQb
Checklist de Execucao Segura
- Confirme o objetivo principal antes de repetir o roteiro.
- Valide o passo original com uma execucao de baixo risco.
- Registre resultado, tempo gasto e desvios encontrados.
- Se algo travar, reduza escopo ao trecho suspeito antes de refazer tudo.
- Compare saidas esperadas com saidas reais antes de seguir.
Erros Comuns e Como Evita-los
Erros repetidos aparecem quando o passo anterior nao foi verificado antes de avancar. Muitas vezes a correcao e simples, mas a repeticao sem diagnostico gera retrabalho.
Ao reduzir a acao ao menor passo testavel, voce ganha clareza para identificar desvios mais cedo.
Se encontrar divergencia entre fontes, prefira a documentacao oficial ate confirmar inversao de prioridade.
Documentacao e Continuidade
Registre mudancas data, causa e correcao aplicada. Esse habito reduz erros e acelera revisoes futuras.
Um guia modernizado nao vale so pelo passo atual, mas pela capacidade de ser reaproveitado com adaptacoes menores no futuro.