Jev no Claude Code: quanto controle você entrega ao roteador de modelos?
Usar o Jev no Claude Code significa deixar um modelo de decisão tipada da TypeSafe AI classificar seu prompt antes do turno começar, e a partir daí escolher modelo e nível de esforço por você. O Claude Code não chama o Jev sozinho: é uma API hospedada, com chave própria, que exige uma camada externa como o mod jev-model-router. Você mantém a linha de status, o log e o fallback embutido, mas entrega o julgamento de dificuldade da tarefa. O preço listado é US$ 0,042 por milhão de tokens de entrada, com saída gratuita em early access
Tem uma diferença grande entre a IA escrever código pra você e a IA decidir QUEM vai escrever o código antes de você abrir a boca
É exatamente esse o assunto aqui
O Jev é o modelo de decisão tipada da TypeSafe AI, e o mod jev-model-router é a ponte que leva esse julgamento pra dentro do Claude Code
A pergunta que importa não é "funciona?", é: quanto do caminho continua na sua mão depois que essa camada entra no meio? Bora destrinchar 🙂
O que é o Jev e por que ele não decide nada sozinho no Claude Code
A TypeSafe AI lançou o Jev em 15 de setembro de 2026, com US$ 40 milhões de investimento liderado pela DCVC
E ele não é um chatbot, nem um agente
O Jev recebe estado do programa mais perguntas tipadas e devolve respostas tipadas com probabilidades
Sem texto livre
Sem chamar ferramenta
Sem editar arquivo
Sem rodar loop de agente
A própria TypeSafe chama isso de "System One": aquele julgamento rápido, quase reflexo, que responde "isso aqui é fácil ou difícil?" antes do raciocínio longo entrar em cena
Se você conhece a diferença entre um if bem escrito e um agente que fica pensando em voz alta por três minutos, é mais ou menos essa a distância
Curso de Jev: Sistemas Mais Inteligentes, Rápidos e Robustos
Desenvolva sistemas mais inteligentes, rápidos e robustos com Jev
O ponto central de controle
Aqui mora a parte que quase ninguém fala: o Claude Code NÃO consegue chamar o Jev sozinho
O Jev é uma API hospedada separada, com chave própria, e precisa de uma ponte (script, skill ou mod)
Ou seja, a integração é sempre por uma camada externa, feita por terceiro
É o mesmo tipo de trabalho de quando você vai integrar uma API externa nova num projeto: alguém precisa escrever o cliente, tratar a chave e decidir o que fazer quando a resposta não vem
A diferença é que dessa vez o resultado da chamada não é um dado do seu app, é a escolha do modelo que vai mexer no seu código
Preço, latência e o acesso bagunçado
O preço listado pela TypeSafe é US$ 0,042 por milhão de tokens de entrada, com tokens de saída gratuitos
É preço de early access e está sujeito a mudança, então não monte planilha em cima disso
A latência informada pela TypeSafe fica em torno de 100 ms na maioria das chamadas, o que faz sentido pro papel dele (decidir rápido, não escrever)
O acesso, porém, é a parte torta da história:
- em 20 de setembro de 2026 a TypeSafe abriu o Jev sem waitlist
- em 22 de setembro de 2026 pausou novos cadastros citando demanda
- contas já criadas continuam funcionando
- não há data anunciada de reabertura
Mesmo com o cadastro direto pausado, dá pra alcançar o Jev por gateways de terceiros: Vercel AI Gateway (typesafe-ai/jev), OpenRouter (jev-latest e jev-1.13) e Cloudflare roteiam pra ele sem waitlist
Guarda essa distinção desde já: alcançar o Jev é uma coisa, o que o mod aceita como backend é outra (volto nisso mais pra frente)
Onde a decisão passa a ser automática: os três momentos em que o roteador age
O jev-model-router engata em três hooks, e cada um age num instante diferente
Entender esses instantes é entender exatamente onde você perde visibilidade
| Hook | Quando age | O que decide |
|---|---|---|
prompt.submit |
antes do turno começar | classifica o prompt |
turn.step |
na primeira requisição do turno | aplica a decisão (as seguintes do mesmo turno reutilizam) |
agent.spawn |
ao subir um subagente | classifica o prompt do subagente e devolve o modelo dele |
Repara no turn.step: a decisão vale pro turno inteiro
Então se o seu prompt começou "simples" e a conversa virou um monstro no meio do caminho, a classificação daquele turno já foi tomada
O que o Jev responde por requisição
Uma requisição avalia três perguntas em paralelo
Entre elas estão o tier, em três faixas (mecânico e local / engenharia comum / difícil ou de alto risco), e o effort, numa rubrica de quatro níveis
E aqui vem o detalhe mais elegante do desenho: o modelo de decisão nunca vê nome de modelo
Ele não sabe o que é Haiku, não sabe o que é Opus, não sabe o que é caro
Ele só julga a dificuldade da tarefa, e a camada de cima faz o mapeamento
Curso RecomendadoDesenvolva sistemas mais inteligentes, rápidos e robustos com JevConhecer cursoTraduzindo pro seu bolso e pro seu controle: você entrega o julgamento, não o mapeamento
O "isso é difícil?" saiu da sua cabeça
O "difícil vira qual modelo?" continua sendo decisão de configuração
O que continua manual por limite técnico (e isso é bom saber)
Tem gente que instala achando que agora TUDO é automático
Não é, e os limites são técnicos, não preguiça de quem escreveu
Primeiro: o modelo do loop principal só é classificado no início da sessão
O motivo é prompt cache
Trocar o modelo principal no meio da sessão invalida o cache, e o recache pode custar mais que a economia que você tentou fazer
Ou seja, o roteador se segura de propósito ali
Segundo: a ferramenta Agent não tem parâmetro de effort
Então o mod não define o esforço de raciocínio do subagente, mesmo classificando o prompt dele
A consequência prática é bem direta: sessão longa que muda de natureza continua exigindo decisão SUA
Começou renomeando variável e terminou desenhando migração de banco? A escolha do modelo principal é sua, na mão, começando sessão nova se for o caso
Automático não significa adaptativo o tempo todo, beleza?
Quanta visibilidade você mantém: linha de status, log e fallback
A boa notícia é que o mod não é caixa preta total
Ele mantém uma linha de status na tela com a decisão tomada, no formato jev · fast 0.87 → haiku/low
Uma linha só, mas ela te dá o rótulo da classificação, a confiança e o destino
Repara que o rótulo impresso ali é abreviado e não repete literalmente as três faixas de tier que citei antes, então leia como resumo da decisão, não como o nome da faixa
Sobre backends do mod, são dois: a API direta da TypeSafe ou o Vercel AI Gateway
Os outros caminhos que citei lá atrás (OpenRouter e Cloudflare) servem pra você alcançar o Jev, só que não aparecem na lista de backends suportados pelo mod
E aqui está o alerta de controle mais importante do post inteiro
Sem chave configurada, o mod cai para o classificador embutido (builtin) e registra isso uma vez no log
Uma vez
Não é um aviso piscando na tela a cada turno
Tome cuidado! Dá pra passar uma semana inteira achando que está rodando Jev quando na verdade o classificador que decidiu tudo foi o embutido
Se você não abrir o log pelo menos uma vez depois de instalar, sua "integração com o Jev" é uma hipótese, não um fato
Quando vale entregar a decisão e quando vale voltar ao fluxo manual
Vamos ao que interessa na prática
Vale entregar quando:
- a sessão mistura muita tarefa mecânica com engenharia comum (o roteador ganha justamente na variedade)
- você sobe muitos subagentes e não quer escolher modelo pra cada um na mão
- seu custo de contexto está alto e cada pedaço economizado conta
Vale voltar ao manual quando:
- o trabalho inteiro é de alto risco, e não tem tarefa mecânica no meio pra compensar
- você está depurando e quer o MESMO modelo do começo ao fim, pra não confundir mudança de comportamento com mudança de modelo
- o ambiente não tolera API instável nem falha silenciosa (early access em duas frentes é bastante coisa)
O caso à parte: jev-skill-suggestion
Existe um segundo mod no mesmo repositório, o jev-skill-suggestion, e ele resolve outro problema
Ele retira a listagem de skills do contexto e deixa o Jev sugerir no máximo UMA skill por prompt, com as skills configuradas como user invocable only
O ganho é contexto puro
A listagem padrão do Claude Code gasta uma linha por skill instalada, cada entrada podendo chegar a 1.536 caracteres, e a listagem inteira fica limitada a 1% da janela de contexto
Se você acumula skills mais encorpadas, tipo um agente de SEO no Claude Code junto com meia dúzia de outras, esse 1% some rápido

Crie sistemas com IA para vender
Prompts, modelos e checklists para criar e publicar seu sistema com IA e preparar a oferta para o primeiro cliente.
Quero o e-book gratuito Receba o livro e os bônus no seu e-mail.O que se perde? Ver a lista
Você deixa de ter o cardápio na frente e passa a confiar que o sugestor achou a skill certa
É a mesma troca do post inteiro, só que aplicada a skill em vez de modelo
Como ligar o jev-model-router no Claude Code
Mods é o nome de produto da Anthropic para os function hooks do Claude Code
Estão em early access atrás de flag, e a API pode mudar entre releases
Guarde isso antes de colocar num projeto que paga boleto
- Cheque a versão e ligue a flag. O requisito é Claude Code 2.1.259 ou superior, com a variável de ambiente ligada:
export CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1
O erro comum deste passo é justamente pular ele: sem a variável, o mod carrega e não faz nada, sem aviso nenhum
Nada quebra, nada reclama, e você fica esperando uma mágica que não vai acontecer
- Instale o mod:
npx claude-code-templates@latest --mod productivity/jev-model-router
O mod vive no repositório claude-code-templates, mantido por Daniel Avila (davila7), na pasta cli-tool/components/mods/productivity/jev-model-router
- Aceite o trust prompt do projeto. O
--modescreve o plugin em.claude/skills/do projeto, e o Claude Code só adota depois que o projeto é marcado como confiável, no prompt de confiança do primeiro launch
E sim, o nome da pasta confunde: o destino do --mod é .claude/skills/ mesmo, mas quem faz o trabalho aqui continuam sendo os hooks (prompt.submit, turn.step, agent.spawn), não uma skill que você chama na mão
Erro comum aqui: instalar, dar next e finish no automático, recusar a confiança sem ler e depois jurar que o mod não funciona
- Confirme o backend. São dois caminhos suportados: API direta da TypeSafe ou Vercel AI Gateway
Sem chave configurada o comportamento é cair no classificador embutido e registrar isso uma vez no log
Então o passo real aqui é abrir o log e confirmar qual dos dois está rodando
- Se quiser o segundo mod, o comando é esse:
npx claude-code-templates@latest --mod productivity/jev-skill-suggestion
Vale entregar esse controle agora?
De um lado da balança: preço de entrada baixíssimo (US$ 0,042 por milhão de tokens de entrada, saída gratuita em early access), latência em torno de 100 ms e um desenho de decisão que é honesto sobre os próprios limites
Gostei especialmente do fato do modelo de decisão nunca ver nome de modelo
Do outro lado: cadastro direto pausado desde 22 de setembro, sem data de reabertura, early access em DUAS frentes ao mesmo tempo (o Jev e os mods do Claude Code) e uma falha silenciosa que faz o fallback passar despercebido
Meu veredito, sem enrolação: interessante pra quem já tem conta criada ou usa um dos gateways, e aceita a disciplina de ler o log
Quem precisa de previsibilidade, em projeto de cliente ou em time grande, espera
Não tem pressa aqui, o desconto de hoje é de early access e a API pode mudar entre releases
Conclusão
A régua que eu usaria pra qualquer camada desse tipo é simples: pode automatizar a decisão, desde que sobre um ponto de verificação
No caso do jev-model-router, esse ponto é a linha de status mais o log
Se você não olha nenhum dos dois, não é automação, é fé 😛
Próximo passo bem concreto: confere a versão do Claude Code e a variável CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1, instala num projeto de teste e acompanha a linha de status por alguns turnos
Vê se a classificação bate com o que você faria na mão
Só depois disso leva pro projeto principal
Até o próximo post!
Perguntas frequentes
Precisa de conta na TypeSafe pra usar o Jev no Claude Code?
Não necessariamente. O cadastro direto na TypeSafe está pausado desde 22 de setembro de 2026, mas dá pra chegar no Jev por gateways de terceiros como Vercel AI Gateway, OpenRouter e Cloudflare, sem waitlist. Se você já tinha conta antes da pausa, ela continua funcionando normalmente. Só atenção num detalhe: os backends suportados pelo jev-model-router são a API direta da TypeSafe ou o Vercel AI Gateway, então os demais gateways servem pra alcançar o Jev, não pra ser backend do mod.
Como instalar o jev-model-router no Claude Code?
O comando é npx claude-code-templates@latest --mod productivity/jev-model-router. Antes dele, você precisa de Claude Code 2.1.259 ou superior com a variável CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1, senão o mod carrega e não faz nada, sem aviso. O comando escreve o plugin em .claude/skills/ do projeto (é essa a pasta que o --mod usa, mesmo o jev-model-router agindo por hooks), e o Claude Code só passa a usar depois que você aceita o prompt de confiança do projeto no primeiro launch.
O jev-model-router funciona sem configurar chave de API?
Funciona, mas não com o Jev de verdade. Sem chave da TypeSafe ou do Vercel AI Gateway configurada, o mod cai pro classificador embutido (builtin) e registra isso uma vez no log, sem aviso repetido na tela.
O roteador troca o modelo no meio da conversa?
O modelo do loop principal só é classificado no início da sessão, justamente pra não invalidar o prompt cache. Trocar no meio custaria mais caro pelo recache do que a economia que a troca traria, então o mod se segura de propósito nesse ponto.
Quanto custa usar o Jev pra classificar os prompts?
O preço listado pela TypeSafe é de US$ 0,042 por milhão de tokens de entrada, com tokens de saída gratuitos. É valor de early access e pode mudar, então vale conferir antes de rodar em escala.
Dá pra saber qual modelo o Jev escolheu pra cada prompt?
Dá sim, o mod mantém uma linha de status na tela com o formato jev · fast 0.87 → haiku/low, mostrando a classificação, a confiança e o modelo de destino. O rótulo que aparece na linha é abreviado, não o nome completo da faixa de tier. É pouca informação, mas é o suficiente pra você acompanhar a decisão em tempo real.
Formações
Formação Claude Code
Domine Claude Code do absoluto zero até o avançado
- 120 aulas
- 4 projetos
- 9h 48min
Blog | Mais populares

Como montar um workflow de automação combinando decisões do Jev em código
Aprenda a montar um workflow com Jev: decisões tipadas encadeadas em código, alta confiança agindo sozinha e casos incertos escalando para revisão.

Jev decide, LLM escreve: como dividir os papéis dentro de um agente de IA
Jev é o modelo que decide, não escreve: entenda como dividir papéis entre Jev e LLM dentro de um agente de IA e quando usar cada um.

Para quem o Jev serve (e para quem não serve)?
Jev serve pra roteamento, scoring e guardrails em IA, não pra texto ou código. Veja pra quem o Jev serve e quando evitar.
