Formulário de contato

Nome

E-mail *

Mensagem *

Imagem

Plugin no Claude Code: Crie e Publique o Seu em 2026

Plugin no Claude Code: Crie e Publique o Seu em 2026

Publicado por em


@CanalQb no YouTube


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.


@CanalQb no YouTube


@CanalQb

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/ ou hooks/ dentro de .claude-plugin/. Elas v?o na raiz do plugin.
  • No final voc� sai com manifest correto, hooks.json port�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.

[ESPA�O PARA IMAGEM 1]
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 /revisar vira /meu-plugin:revisar depois 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.

[ESPA�O PARA IMAGEM 2]
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.

[ESPA�O PARA IMAGEM 3]
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.

[ESPA�O PARA IMAGEM 4]
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.

[ESPA�O PARA IMAGEM 5]
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 pluginDepois do pluginPor qu�
/research/content-ops:researchEvita colis?o com skills de mesmo nome de outros plugins instalados
/draft/content-ops:draftNamespace deixa claro de qual plugin a skill vem
/review/content-ops:reviewRefer�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.

[ESPA�O PARA IMAGEM 6]
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.

1
Crie a estrutura de pastas do plugin. Use mkdir -p para gerar de uma vez todas as pastas: .claude-plugin, agents, skills, hooks e templates, al�m das subpastas de cada skill.
2
Copie os agents existentes. Arquivos .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.
3
Copie as skills. Cada skill vai para skills/<nome>/SKILL.md. Esse � o formato exigido ? uma subpasta por skill, sempre com o arquivo SKILL.md dentro.
4
Mova os scripts de hook e escreva o hooks.json port�til. Use sempre ${CLAUDE_PLUGIN_ROOT} nos caminhos, com o wrapper "hooks" envolvendo os blocos de eventos.
5
Copie .mcp.json, templates e escreva o manifest e o README. O manifest vai em .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.
6
Teste localmente antes de publicar. Use a flag --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.

[ESPA�O PARA IMAGEM 7]
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.

[ESPA�O PARA IMAGEM 8]
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.

[ESPA�O PARA IMAGEM 9]
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.

[ESPA�O PARA IMAGEM 10]
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 compartilharFormato recomendadoPor qu�
Regras de um �nico projetoCLAUDE.md no reposit�rioCarrega automaticamente, sem instala�?o
Uma skill ou agent isoladoArquivo .md avulsoBasta colocar em .claude/skills/ ou .claude/agents/
Conjunto conectado de agents + skills + hooksPluginInstala�?o �nica, skills com namespace, caminhos port�veis
App web, CLI ou SaaS que usa Claude CodeAgent SDKAcesso program�tico, sem precisar de terminal
Revis?o autom�tica em cada PR ou pushGitHub ActionRoda 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.

[ESPA�O PARA IMAGEM 11]
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.

[ESPA�O PARA IMAGEM 12]
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.

[ESPA�O PARA IMAGEM 13]
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.

[ESPA�O PARA IMAGEM 14]
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.json est� apenas dentro de .claude-plugin/, e todas as outras pastas est?o na raiz do plugin.
  • O campo name est� presente, e version foi definido explicitamente se voc� quer controlar quando o aviso de atualiza�?o aparece.
  • Todo caminho dentro de hooks.json usa ${CLAUDE_PLUGIN_ROOT}, sem nenhum caminho absoluto da sua m�quina.
  • O wrapper "hooks" envolve os blocos PreToolUse e PostToolUse dentro de hooks.json.
  • O README documenta as skills j� com o namespace correto, ex: /content-ops:research.
  • Voc� testou com claude --plugin-dir ./seu-plugin em um diret�rio de projeto diferente, e usou /reload-plugins ap�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@v1 com --bare e --max-turns definidos.
[ESPA�O PARA IMAGEM 15 - OPCIONAL]
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


Fontes e Refer�ncias


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.

Nota Tecnica: Este post e estritamente informativo. Teste em ambiente controlado antes de repetir procedimentos.

Perguntas Frequentes

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.

Marcadores: Agent SDK automa�?o Claude Code Desenvolvimento IA Plugins

© junho 14, 2026 CanalQb — Python, Scripts, Automação, Airdrops e Criptomoedas | Web3 e Tech na Prática



SEO Dashboard @CanalQb

Carregando dados...

Dados GA4 + Search Console | Atualizar | gerado via API Google