A ideia que atravessa o curso
Um mod é três arquivos e uma função.
Um plugin.json, um hooks.json e um módulo que exporta register(on, options). Cada hook tem a forma ($, e, next) e entra numa cadeia com os outros plugins e o próprio Claude Code. Quem chama next deixa passar; quem não chama decide.
Com isso você conta o que o Claude toca, nega um comando perigoso, desenha uma faixa acima do prompt, abre um painel com botões e cria comandos que respondem sem gastar modelo — e prova tudo com claude plugin test.
Para quem é
Rafa, 34 — dev de uma agência pequena
Usa o Claude Code todo dia. Quer ver o que o Claude toca no repositório, ser perguntado antes de algo ser apagado e não perder trabalho entre sessões. É ele quem aparece nos exemplos do curso.
Você, se programa (ou quase)
Sabe usar o terminal, já leu JavaScript ou TypeScript e já usou o Claude Code. Não precisa conhecer a API de mods: cada termo (hook, $, next, dispatch, superfície, matcher, atom...) é definido na primeira vez que aparece.
O que você vai construir
O /readcount do starter-mod, rodando por claude -p sem chamar o modelo.
Contrato tipado, $.state na sessão e $.store entre sessões.
Desenho com ui.render, botões com hotkey e teste em terminal e desktop.
Interceptar tool.call, negar com motivo e perguntar ao humano antes de apagar.
As 4 trilhas
🧬 Anatomia
O que é um mod por dentro, a estrutura de arquivos e o manifesto, carregar, recarregar e instalar, e o seu primeiro mod: comando e contador.
⚡ Eventos e estado
O mapa de eventos, a cadeia com next, estado que sobrevive ao reload e trabalho fora do dispatch com relógio, arquivos e processos.
🖥️ Telas e comandos
ui.render e as superfícies, faixa, status e avisos, painéis e botões, comandos de barra, ferramentas para o modelo e configuração.
🛡️ Controlar, testar e distribuir
Mods que mudam o fluxo, testes com claude plugin test, depuração e as pegadinhas, marketplace e o projeto final.
🏁 Projeto final: o seu mod
Um mod próprio, como o do Rafa: um comando /x, uma faixa ou um painel, estado em $.state, teste com claude plugin test (mocks antes do $), claude plugin validate OK, um botão ou comando para desligar e um README.
A prova: claude plugin test <pasta> com 0 fail e claude -p "/<comando>" --plugin-dir <pasta> respondendo sem modelo. Detalhes no módulo 4.4.
⚠️ Versão conferida
Tudo neste curso foi conferido no Claude Code 2.1.289, em 05/10/2026, numa máquina Linux ARM64. A API de mods está em acesso antecipado e muda entre versões.
A autoridade é o arquivo de tipos da sua instalação: .claude-plugin/types/claude-code/index.d.ts, que o Claude Code escreve dentro da pasta do mod quando ele carrega. O curso ensina a ler esse arquivo; nenhum nome é prometido para sempre.
O que você precisa
Claude Mods Starter Kit
Kit da Prompt Advisers (licença MIT): 10 plugins, o modelo starter-mod e scripts de checagem. Cópia usada no curso: github.com/inematds/claude-mods-starter-kit.
inema-mods
18 mods em português, testados, com o guia COMO-FAZER-UM-MOD.md e as 23 pegadinhas: github.com/inematds/inema-mods.
Na sua máquina
Claude Code instalado (confira com claude --version), git e um editor. TypeScript ajuda a partir da trilha 2, mas não precisa de compilação: o Claude Code carrega .ts e .tsx direto.
Depois do curso
Os hooks clássicos do settings.json, a fundo.
Plugins de produção para o Claude Code.
Trilha 4: guarda e painel para agentes que usam ferramentas.
Para quem não programa. Em breve.
Como estudar aqui
Cada tópico tem um botão. O progresso aparece aqui, na trilha e no módulo.
"Tenho dúvida" guarda o tópico para você revisar depois.
Selecione um trecho do texto para grifar ou escrever uma nota.
Progresso, dúvidas e notas num lugar só. Exporte em arquivo para não perder.
Tudo fica salvo só no seu navegador. Nada é enviado para servidor nenhum.