Jev no Claude Code: quanto controle você entrega ao roteador de modelos?

Resposta rápida

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

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

Traduzindo 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

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

  1. 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

  1. 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

  1. Aceite o trust prompt do projeto. O --mod escreve 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

  1. 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

  1. 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.



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.

Formações

Formação Claude Code

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

  • 120 aulas
  • 4 projetos
  • 9h 48min

Blog | Mais populares