Mods com Jev no Claude Code valem a pena ou são só mais uma camada para manter?

Fala aí, beleza? Mod com Jev pode cortar custo e ruído no seu Claude Code, mas tem um detalhe que muita gente pula: é código de terceiro rodando com as SUAS permissões

Os Claude Mods chegaram na versão 2.1.287 do Claude Code CLI, lançada em 1º de outubro de 2026, e em poucos dias já apareceram vários mods comunitários usando o Jev, o modelo de decisão da TypeSafe

Neste post eu peso o ganho de produtividade contra o custo de manter mais uma peça no setup, e mostro em quais perfis de dev a resposta muda

Se liga: não tem teste próprio aqui, beleza? Tudo vem da documentação oficial e das páginas dos próprios mods 🙂

O que são Claude Mods e onde o Jev entra

Curso Recomendado

Curso de Jev: Sistemas Mais Inteligentes, Rápidos e Robustos

Desenvolva sistemas mais inteligentes, rápidos e robustos com Jev

Conhecer curso

O changelog da 2.1.287 resume numa linha: "Added Claude Mods: plugins may now modify deeper behavior"

Tá, mas o que isso quer dizer na prática?

Pela documentação oficial de mods, um mod é um plugin cujo código registra handlers de eventos (os hooks) com as funções register e on

O Claude Code executa esses handlers quando o evento acontece, por exemplo quando o Claude chama uma ferramenta ou quando o spinner é desenhado no terminal

Se você já mexeu com event listener em JavaScript, é bem semelhante: você diz "quando X acontecer, roda essa função" e pronto

Quais arquivos um mod tem?

Um mod pequeno tem só três arquivos:

• plugin.json: o manifesto do plugin
• hooks.json: aponta para o código dos hooks
• register.js: o módulo onde os hooks são registrados de fato

Guarda o nome desse register.js, porque é ele que você vai querer ler antes de instalar qualquer coisa (já já explico o porquê)

O caminho geral pra instalar plugins que incluem mod é o comando /plugin dentro do CLI do Claude Code

Mas se liga: alguns mods da comunidade vêm com instalador próprio, e é o caso do Jev Model Router, que você vai ver mais abaixo

E o Jev, o que é?

O Jev é um modelo de decisão da TypeSafe, o primeiro da linha "System One"

Em vez de gerar texto, ele devolve uma resposta tipada com probabilidades

Ou seja: você pergunta "qual dessas opções?" e ele responde com a escolha e o quanto confia nela, sem textão no meio 😀

A versão atual no OpenRouter é a Jev 1.13 (ID typesafe/jev-1.13, alias ~typesafe/jev-latest), lançada em 18 de setembro de 2026, com janela de contexto de 32.000 tokens

Ele fica disponível para qualquer pessoa com chave de API do OpenRouter, e a cobrança vai para a conta do OpenRouter:

• US$ 0,042 por milhão de tokens de entrada
• US$ 0 por milhão de tokens de saída

É por isso que ele casa tão bem com mods: um hook precisa decidir algo rápido (qual modelo, qual skill, liberar ou bloquear), e o Jev foi feito justamente pra decidir

Cuidado com README antigo!

Caso você ache um tutorial mandando setar CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1, tome cuidado

Essa variável era o switch do early access, e a documentação diz que o Claude Code v2.1.287 ou posterior simplesmente ignora ela

Quem configurou deve remover, e READMEs de setembro que mandam setar estão desatualizados

Mods com Jev disponíveis: o que cada um faz e quanto setup exige

Hoje os mods com Jev que dá pra apontar com fonte são quatro

A tabela abaixo resume o que cada um resolve e o que ele pede de você:

Jev Model Router: como instala?

Ele é um mod da comunidade que vive no repositório davila7/claude-code-templates, na pasta cli-tool/components/mods/productivity/jev-model-router

Antes de cada turno, ele consulta o Jev pra escolher qual modelo atende aquele subagente ou turno

Aqui a instalação não passa pelo /plugin: o mod é distribuído pelo próprio claude-code-templates, que tem um comando de instalação dele:

npx claude-code-templates@latest --mod productivity/jev-model-router

O erro comum aqui: instalar, não colocar a chave e achar que o Jev está roteando

Sem typesafeApiKey ou gatewayApiKey no ~/.claude/settings.json, o mod usa o classificador do próprio engine ($.model.classify) como fallback

Funciona, mas aí você tem a camada extra sem o Jev de verdade por trás 😛

Jev Skill Suggestion: pra que serve?

Quem acumulou muita skill sabe: a listagem delas ocupa espaço na janela de contexto em todo prompt

Esse mod tira essa listagem do contexto e deixa o Jev escolher, a partir das descrições, no máximo uma skill por prompt, anexando o SKILL.md dela

cc-mod-jev e claude-code-jev

O cc-mod-jev, do JayDoubleu, usa a pontuação do Jev via OpenRouter pra podar a janela de contexto, com compactação verbatim

Já o claude-code-jev, do RahulBalakavi, é um gate de permissão: antes de o Claude Code executar uma ação, o Jev classifica como allow, block ou ask

O próprio autor marca como experimental, então trate como experimental mesmo

Onde um mod com Jev tende a compensar

Antes de tudo: não existe benchmark independente mostrando quanto o Model Router ou os mods de compactação economizam de verdade

Os números que circulam por aí são autodeclarados pelos autores, então eu não vou repetir nenhum

O que dá pra fazer é ligar cada mod ao cenário onde ele faz sentido

Muitos subagentes e vontade de rotear modelo

Se o seu fluxo dispara subagente pra tudo, faz sentido querer que tarefa simples vá pro Haiku e só o pesado vá pro Opus

É exatamente o problema que o Jev Model Router ataca, decidindo turno a turno

Skills demais pesando no contexto

Tem gente com dezenas de skills instaladas, e a listagem delas vai junto em todo prompt

Aí o Jev Skill Suggestion entra limpando isso e trazendo só a skill que importa naquele momento

Sessões longas

Sessão que dura horas acumula contexto que já não serve pra nada

Pra esse caso, a poda com pontuação do Jev do cc-mod-jev é a proposta mais direta

Times que querem mais uma decisão antes de agir

Se a ideia é ter uma camada extra classificando cada ação antes de rodar, o claude-code-jev vai nessa linha

Mas é experimental, e não substitui entender o controle de permissões do Claude Code que já existe nativamente

Por que o Jev em si sai barato?

Pela tabela de preços do OpenRouter, a saída do Jev custa US$ 0 e a entrada custa US$ 0,042 por milhão de tokens

Como ele devolve uma escolha tipada em vez de texto, quase todo o custo está no que você manda pra ele, e esse preço de entrada é baixinho

O ponto é: o custo do Jev raramente é o problema, beleza? O custo de verdade está no resto, que é a próxima seção

O custo real: segurança, manutenção e um recurso ainda instável

Mods não rodam em sandbox

Esse é o ponto que mais pesa

A documentação oficial avisa: mods são código executado com as suas permissões, e podem ler e escrever arquivos, iniciar processos e fazer requisições de rede

A orientação oficial é instalar só de autores e marketplaces confiáveis

É como contratar alguém pra mexer no seu PC e dar a senha de admin no primeiro dia…

O que a Pluto Security encontrou?

Uma pesquisa da Pluto Security aponta riscos nos hooks de mods:

• um mod pode ler em silêncio o ~/.claude/.credentials.json
• pode ler o seu histórico de prompts
• pode falsificar prompts de credencial no terminal
• pode falsificar diálogos de confirmação

Ou seja: aquela caixinha pedindo sua confirmação pode nem ser do Claude Code 😬

Por isso eu insisto no register.js: é ali que você vê o que o mod realmente faz

Mais uma chave e mais uma conta

Todos esses mods dependem do Jev, e o Jev é cobrado na conta do OpenRouter (ou, no caso do Model Router, também aceita gatewayApiKey)

Isso é mais uma chave pra guardar, rotacionar e mais uma fatura pra acompanhar

Pra dev solo é tranquilo, pra time já vira processo

Um recurso ainda instável

A documentação diz que os mods vêm ligados por padrão desde a 2.1.287

Só que a issue #99130, aberta em 3 de outubro de 2026 no repositório oficial, relata que na 2.1.288 os mods aparecem desligados remotamente pra alguns usuários (o rollout switch serve "off")

Ou seja: tu instala, configura, e pode ser que o mod simplesmente não rode

E pra empresas?

Existe uma página oficial chamada Manage mods for your organization, na documentação de administração de mods do Claude Code

Se você precisa passar isso pelo time de segurança da empresa, é por ela que a conversa começa, antes de qualquer dev instalar mod por conta própria

Veredito por perfil de dev

Não tem resposta única aqui, e quem te disser que tem tá vendendo alguma coisa haha

Dev solo que paga por uso e roda muito subagente

Tende a valer a pena

Começa por um mod só, provavelmente o Jev Model Router, que ataca justamente a escolha de modelo por turno

E coloca a chave, senão você fica no fallback

Dev com setup enxuto e poucas skills

Provavelmente é camada desnecessária

Se você não sente o contexto pesando nem tem um monte de subagente, o mod vira só mais uma coisa pra quebrar

Quem trabalha com repositórios ou credenciais sensíveis

Só depois de ler o código do mod linha a linha

Com o que a Pluto Security apontou, instalar no escuro aqui é pedir pra ter dor de cabeça

Times e empresas

Governe primeiro, libere depois

A gestão de mods da organização existe pra isso, e é bem melhor que cada dev instalando o que achou no GitHub

Quem quer estabilidade

Espera o rollout assentar

Com relato de mods desligados remotamente na 2.1.288, não faz sentido montar um fluxo crítico em cima disso agora

Critérios para decidir se adota um mod com Jev agora

Em vez de te dar um "instala sim" genérico, bora pro checklist:

• Você tem um problema concreto que um desses mods resolve (roteamento de modelo, skills demais, sessão longa, gate de ação)?
• Consegue ler e auditar o register.js antes de instalar?
• A fonte é um autor ou marketplace em que você confia?
• Aceita gerenciar mais uma chave e a cobrança no OpenRouter?
• Está na 2.1.287 ou posterior e já removeu a CLAUDE_CODE_ENABLE_FUNCTION_HOOKS?
• Tolera um recurso com rollout ainda instável?

Se a resposta for "sim" pra tudo, o próximo passo é simples: escolher no máximo um mod, revisar o código e só então instalar

Se travou em alguma, tudo bem esperar, os mods com Jev no Claude Code não vão sumir daqui a uma semana 🙂

E aí, já tá usando algum mod? Bora trocar uma ideia nos comentários

Até o próximo post!