O que são mods no Claude Code e o que o Jev tem a ver com isso?

Resposta rápida

Mods no Claude Code são pequenas funções em TypeScript (ou JavaScript) que rodam dentro do processo do Claude Code, reagem a eventos internos e mudam o que o agente faz: reescrevem prompts, bloqueiam chamadas de ferramenta, aprovam ou negam permissões e até desenham interface nova. Chegaram em 1º de outubro de 2026, na versão 2.1.287. Não confunda com skill, que é instrução que o Claude lê. O Jev não é gerenciador de mods: é um modelo de IA da TypeSafe AI que devolve valores tipados, e a comunidade criou mods que chamam o Jev para tomar decisões rápidas

Fala aí, beleza? Bora desfazer duas confusões logo de cara: mod não é um pacote de instruções (isso é skill) e o Jev não é um gerenciador de mods, ele é um modelo de IA da TypeSafe AI 🙂

A Anthropic lançou os mods em 1º de outubro de 2026, na versão 2.1.287 do Claude Code

E a comunidade foi rápida: em poucos dias já tinha gente criando mods que chamam o Jev pra tomar decisões no meio do fluxo do agente

Então neste post eu te conto o que é cada coisa e onde uma encosta na outra, beleza?

O que são mods no Claude Code?

Pela definição oficial, mods são plugins cujas funções em JavaScript ou TypeScript rodam dentro do Claude Code e reagem a eventos

Que eventos? Coisas como uma chamada de ferramenta, um prompt enviado ou uma parte da interface sendo desenhada

Na prática, um mod pode:

  • reescrever um prompt
  • adicionar uma interface nova
  • substituir um recurso nativo
  • adicionar uma funcionalidade que não existia

Ou seja, ele não sugere nada pro modelo, ele MUDA o comportamento do agente por código 😀

Os mods vêm dentro de plugins e são instalados e compartilhados como qualquer plugin

Funcionam no CLI do Claude Code e no app desktop

E como todo lançamento, teve seus tropeços… A versão 2.1.289, de 3 de outubro de 2026, corrigiu os bugs iniciais: mods que não carregavam na primeira sessão depois de atualizar, painéis de plugin desatualizados e travamentos quando a UI de um mod gerava erro

Não foi encontrada nenhuma reversão do recurso, então os mods seguem aí

Como um mod funciona por dentro?

Se você já mexeu com event listener no JavaScript, a ideia é bem semelhante: tu registra uma função e ela roda quando o evento acontece

Quando o mod carrega, o Claude Code chama a função register exportada pelo arquivo e passa pra ela uma função chamada on

Cada chamada de on registra um handler (o hook) pra um evento

Esse handler recebe três parâmetros:

  • $: utilitários
  • e: o evento, como dados simples
  • next: repassa o evento pros outros mods e pro comportamento padrão do Claude Code

Se liga no next, ele é o que deixa vários mods conviverem no mesmo evento sem um atropelar o outro

Outro ponto massa: os hooks têm definições de tipo completas e suporte a LSP, então o editor te ajuda enquanto tu escreve

Mod, hook, skill e servidor MCP: qual a diferença?

Aqui é onde a maioria se perde, então bora colocar lado a lado:

Tipo O que é Onde roda Desenha UI? Guarda estado entre eventos?
Mod Funções em JS/TS que reagem a eventos Dentro do processo do Claude Code Sim Sim
Hook de settings Comando de shell, chamada HTTP ou prompt disparado por um evento Fora, como comando ou requisição Não Não
Skill Instruções que o Claude lê No contexto do modelo Não Não
Servidor MCP Processo que dá ferramentas ao Claude Processo externo Não Não

A frase que resolve a confusão é esta: só mods conseguem ver a interface, guardar estado entre eventos e mudar o que o Claude Code desenha

Por isso chamar mod de pacote de instruções não fecha

Instrução que o Claude lê é skill

Mod é código executável rodando junto com o agente, bem outra coisa

O que um mod consegue fazer no Claude Code?

O que dá pra fazer dentro do loop do agente:

  • reescrever um prompt antes de ele chegar ao modelo
  • bloquear ou repetir uma chamada de ferramenta
  • aprovar ou negar um pedido de permissão
  • ocultar segredos na saída de ferramentas
  • editar ou substituir elementos da interface
  • renderizar painéis, banners de prompt, botões e campos de entrada
  • adicionar slash commands que funcionam sem passar pelo modelo

E isso não é teoria não, a própria Anthropic já usa mods pra recursos nativos

O /diff é o mod nativo cc-plugin-diff e o suporte a AGENTS.md é o mod cc-plugin-agents-md

O código de alguns deles é público na pasta mods do repositório anthropics/claude-code, ótimo lugar pra ver um mod de verdade funcionando 😛

Mods são seguros? O que eles podem acessar

Tome cuidado aqui, é a parte mais importante do post

Mods NÃO rodam em sandbox

Um mod roda com as permissões do seu usuário, então ele:

  • lê e grava arquivos onde a sua conta tiver acesso
  • lê variáveis de ambiente e arquivos de configuração, inclusive chaves de API
  • vê todo prompt e toda chamada de ferramenta
  • pode gastar o seu uso

E tem um detalhe que pega muita gente: o sandboxing isola os comandos Bash que o Claude executa, mas não os processos iniciados por um mod

É como contratar um cara pra arrumar sua casa e entregar a chave de todos os cômodos, haha

Pra segurar um pouco isso, existe o mod nativo sec-default, que carrega primeiro e impede que mods instalados por você façam ações arriscadas, como sobrescrever regras de deny

Ainda assim, ele não substitui o seu julgamento, assim como a revisão de segurança do Claude Code não pega tudo sozinha

Se um mod começar a dar problema, dá pra desligar os mods sem fazer rollback, escolhendo quantos parar e por quanto tempo (isso está documentado na página de troubleshooting dos mods)

E se algo travar no meio do trabalho, vale saber como retomar a sessão do Claude Code sem perder o que já foi feito

A recomendação oficial é simples: instale só mods de fontes confiáveis

O que é o Jev (e por que ele não é um gerenciador de mods)?

Agora a segunda confusão

O Jev é o primeiro modelo público da TypeSafe AI, apresentado como "System One Model"

Segundo a cobertura do The New Stack, ele foi anunciado em 15 de setembro de 2026, quando a TypeSafe saiu de dois anos em modo stealth com US$ 40 milhões de seed liderada pela DCVC

E, pela mesma reportagem, quem criou foi Diogo Almeida, coinventor de RLHF e InstructGPT na OpenAI

E o que ele faz de diferente? Ele não gera texto!

O Jev recebe uma entrada não estruturada e um schema definido antes, e devolve valores tipados com scores de confiança calibrados

Pensa em tarefas como classificação, roteamento, pontuação e extração: perguntas com resposta curta e estruturada

O preço é US$ 0,042 por milhão de tokens de entrada, com tokens de saída gratuitos

E segundo a própria TypeSafe (dado do fabricante, beleza?), ele responde todas as perguntas tipadas numa passada paralela, em 70 a 500 milissegundos

Resumindo: o Jev não instala, não lista e não gerencia mod nenhum

Ele é um modelo que alguns mods chamam

Mods da comunidade que usam o Jev

Aí está o encaixe de verdade: o Jev virou o cérebro de decisões rápidas dentro de vários mods e plugins da comunidade

Esses projetos acessam o Jev via OpenRouter, Vercel AI Gateway, Cloudflare Workers AI, LiteLLM ou a API da TypeSafe

Jev Model Router

Construído sobre os function hooks do Claude Code

Antes de cada turno, pergunta ao Jev o quanto a tarefa é mecânica, quanto raciocínio ela exige e se é arriscada, e direciona pro nível de modelo adequado

Foi divulgado por Daniel San (@dani_avila7) e está listado no catálogo aitmpl.com

Jev Skill Suggestion

Usa o Jev pra decidir se uma skill é necessária, ranqueia as skills disponíveis e injeta no contexto do Claude só a documentação da skill escolhida

Menos contexto jogado fora, que é sempre bem-vindo 😀

JayDoubleu/cc-mod-jev

O cc-mod-jev poda a janela de contexto com o Jev via OpenRouter, usando uma compactação que mantém trechos literais

RahulBalakavi/claude-code-jev

O claude-code-jev é experimental: classifica cada ação antes de o Claude Code executar, com três saídas possíveis (permitir, bloquear ou perguntar), via OpenRouter

FrancoisChastel/jev-code

Aqui um cuidado: o jev-code não é mod, é ferramenta

Ou seja, se tu tá procurando um mod pra instalar, não é ele, o papel dele é outro, se liga

Ele disponibiliza o Jev como tool dentro do Claude Code, Codex, Pi e OpenCode, com as ações classify, check, score, rank e ask

E lembra da seção de segurança? Todos esses são projetos de terceiros

Um mod que roda com as suas permissões e ainda manda dados pra um provedor externo merece uma leitura com calma antes de instalar

Como instalar um mod e onde encontrar outros?

Como mods vêm dentro de plugins, a instalação é a mesma de um plugin de marketplace:

claude plugin install <nome-do-plugin>@<nome-do-marketplace>

O exemplo da documentação oficial é este:

claude plugin install token-chart@your-org

A configuração de chave e de provedor de cada mod do Jev depende do projeto, então o caminho é ler o README de cada um antes de sair rodando

Pra achar outros mods, o catálogo comunitário awesome-claude-code-mods lista mods públicos do Claude Code encontrados no GitHub

O mais legal é que ele mostra o que cada mod pode ler, gravar, executar ou enviar pela rede, e dá pra navegar por ele em mods.aidojo.si

É um jeito prático de avaliar a confiança antes de instalar, em vez do bom e velho next, next e finish haha

Resumo: mods são o mecanismo, o Jev é uma peça que alguns usam

Mod é código que roda dentro do Claude Code e reage a eventos, com poder pra mudar prompt, ferramenta, permissão e interface

O Jev é um modelo externo da TypeSafe AI que alguns mods chamam pra classificar e decidir rápido

Se quiser começar, comece pelos mods nativos como o /diff pra entender o conceito na prática, depois explore o catálogo comunitário e leia o que cada mod acessa antes de instalar

E aí, já pensou em algum mod que faria sua vida mais fácil? Bora trocar uma ideia nos comentários 🙂

Até o próximo post!

Perguntas frequentes

Como instalar um mod no Claude Code?

Mod vem dentro de um plugin, então a instalação usa o mesmo comando de plugin: claude plugin install <nome-do-plugin>@<nome-do-marketplace>

A própria documentação dá o exemplo claude plugin install token-chart@your-org, trocando pelo nome do plugin e do marketplace que você quer usar

Mods funcionam no app desktop do Claude Code ou só no terminal?

Funcionam nos dois! Como mods são instalados e compartilhados como qualquer plugin, eles rodam tanto no CLI do Claude Code quanto no app desktop

Não tem recurso exclusivo de um ou de outro nesse ponto

É possível usar o Jev dentro de um mod do Claude Code?

Sim, e é exatamente aí que o Jev encosta nos mods: a comunidade criou vários mods que chamam o Jev via OpenRouter, Vercel AI Gateway, Cloudflare Workers AI, LiteLLM ou a API da TypeSafe

Exemplos já divulgados são o Jev Model Router, o Jev Skill Suggestion, o cc-mod-jev (poda de contexto), o claude-code-jev (gate de permissão) e o jev-code

Quanto custa usar o Jev nos mods que dependem dele?

O Jev cobra US$ 0,042 por milhão de tokens de entrada, e os tokens de saída são gratuitos

Como os mods citados chamam o Jev por API externa (OpenRouter, Vercel AI Gateway e outros), esse custo é separado do seu uso dentro do Claude Code

O mod sec-default bloqueia qualquer ação de outros mods?

Não, ele é mais específico que isso: o sec-default é o mod nativo que carrega primeiro e impede que mods instalados por você façam ações arriscadas, como sobrescrever regras de deny

Mas como mods não rodam em sandbox, ele reduz risco, não elimina a necessidade de instalar só fontes confiáveis

Onde encontrar mods do Claude Code já publicados pela comunidade?

O catálogo karanb192/awesome-claude-code-mods reúne mods públicos encontrados no GitHub, mostrando o que cada um pode ler, gravar, executar ou enviar pela rede

Tem também navegação visual desse mesmo catálogo em mods.aidojo.si



Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Subscribe
Notify of
guest

0 Comentários
Oldest
Newest Most Voted

Formações

Formação Vibe Coding

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

  • 474 aulas
  • 20 projetos
  • 39h 30min

Blog | Mais populares