Jev no Claude Code: em quais tarefas ele rende e em quais é melhor não usar?
O Jev no Claude Code não troca o modelo do agente: ele é o modelo de decisão tipada da TypeSafe AI, anunciado em 15/09/2026, que devolve probabilidade em vez de texto. A documentação oficial é clara: use o agente para escrever código que chama o Jev nos pontos de decisão. Ele rende em roteamento para destinos fixos, pontuação contra rubrica, checagem de afirmação sobre documento e troca do prompt frágil que pede JSON. Não rende em gerar código, redigir texto, conta numérica, comparação de datas e conversa. Latência de 70 a 500 ms, US$ 0,042 por 1 milhão de tokens de entrada.
O Jev não é um Claude melhor, não é um Claude pior, não é um Claude nenhum
Fala aí, beleza? Em 15/09/2026 a TypeSafe AI anunciou o Jev, o primeiro modelo "System One" deles, e a proposta é meio esquisita de entender na primeira leitura: ele abre mão de gerar strings em troca de saída estruturada. Em vez de te devolver texto, devolve decisão tipada com probabilidade calibrada. Sim, o modelo não escreve nada 🙂
E é justamente por isso que a pergunta "o Jev é melhor que o modelo do Claude Code?" não faz sentido nenhum
A pergunta certa é outra: em QUAL tarefa essa camada extra paga a etapa que ela adiciona, e em qual ela só coloca mais um salto de rede no meio do seu fluxo? É esse mapa que eu quero montar aqui, com o que está verificado na documentação oficial e nos cookbooks, sem achismo
O que o Jev faz (e o que ele não faz) dentro do Claude Code
Antes de julgar caso de uso, precisa da base técnica mínima. É pouca coisa, felizmente
O Jev aceita exatamente três tipos de pergunta, e toda chamada é montada com eles:
- Noul: sim ou não, devolve uma probabilidade entre 0 e 1
- Choice: escolhe uma opção de uma lista de até 255, com probabilidade por opção mais um valor de confiança
- Score: posiciona o estado numa escala ordenada de 2 a 10 níveis descritos em palavras
Curso de Jev: Sistemas Mais Inteligentes, Rápidos e Robustos
Desenvolva sistemas mais inteligentes, rápidos e robustos com Jev
É isso. Não tem um quarto tipo escondido
Os limites de contexto também são apertados de propósito: 64 mil tokens para o estado somado a todas as perguntas, e 32 mil tokens para o estado somado à pergunta mais longa. A versão publicada é a jev-1.13.0, lançada em 15/09/2026, com os aliases jev-latest e jev-preview apontando pra ela
E aqui vem a parte que mais gera confusão. A documentação oficial pra agentes de código diz com todas as letras que o Jev não substitui o LLM por trás do Claude Code, do Cursor, do opencode, do Copilot e afins
Ele não gera texto
Ele não escreve código
Ele não mantém conversa
O caminho indicado pela própria TypeSafe é: usar o agente de código pra escrever código que chama o Jev nos pontos de decisão. Se você conhece o papel de uma função de validação dentro de um app, é mais ou menos isso: o agente continua sendo o cérebro que constrói, e o Jev é a peça chamada quando precisa cravar "é isso ou aquilo" com um número junto
Jev ou prompt cru: comparação por tipo de tarefa
A documentação oficial lista quatro encaixes bons pro Jev, e a página de limitações da jev-1.13 lista onde ele erra mais. Botei os dois lados na mesma tabela pra facilitar a decisão
| Tipo de tarefa | O que o Jev entrega | O que o prompt cru entrega | Veredito |
|---|---|---|---|
| Rotear requisição pra destinos fixos | Choice com probabilidade por opção e valor de confiança | Texto que você ainda precisa parsear | Jev, é caso listado como bom encaixe |
| Pontuar algo contra uma rubrica | Score numa escala ordenada de 2 a 10 níveis | Nota solta, sem garantia de escala estável | Jev, é caso listado como bom encaixe |
| Checar se uma afirmação é verdadeira sobre um documento | Noul com probabilidade entre 0 e 1 | "Sim, porque…" em prosa | Jev, é caso listado como bom encaixe |
| Substituir prompt frágil de "retorne JSON" | Valores tipados por construção | JSON que quebra quando o modelo resolve conversar | Jev, é caso listado como bom encaixe |
| Gerar código | Nada, ele não escreve código | O trabalho inteiro | Prompt cru, no LLM do agente |
| Redigir texto | Nada, ele não gera strings | O trabalho inteiro | Prompt cru, no LLM do agente |
| Cálculo numérico | A doc registra dificuldade com tarefas que exigem precisão numérica | Também não é calculadora, mas pode chamar uma | Nem um nem outro, resolve em código |
| Comparação de datas | A doc registra datas lidas como texto, não como quantidades ordenadas | Depende do modelo, mesmo risco | Nem um nem outro, resolve em código |
| Conversa com o usuário | Nada, ele não mantém conversa | O trabalho inteiro | Prompt cru, no LLM do agente |
Repara no padrão: tudo que cabe numa pergunta fechada tende pro Jev, tudo que precisa produzir algo fica com o modelo do agente
Onde o Jev rende: quatro encaixes com evidência
Agora o mapa com dado real, não com "eu acho que dá certo"
1. Sugestão de skill, com número medido
Esse é o mais bem documentado. O cookbook oficial de skill suggestion descreve um padrão de duas requisições por turno pra escolher no máximo uma skill
A primeira requisição ranqueia todas as skills do roster contra o turno do usuário e responde se aquele turno precisa de alguma skill
A segunda relê só as três melhores, agora com a descrição completa e o começo das instruções, e pode rejeitar todas
O resultado medido: em 488 requisições sobre as 182 skills do catálogo Hermes da Nous Research, os loads de skill errada caíram de 16,8% para 7,3%, e os loads desnecessários caíram de 9,8% para 4,0%. As duas requisições ao Jev levaram cerca de 0,2 a 0,3 segundo
Curso RecomendadoDesenvolva sistemas mais inteligentes, rápidos e robustos com JevConhecer cursoIsso é ponto de decisão repetido, destinos fixos e volume. O trio perfeito pro modelo
2. Auto-aprovação de prompts de permissão
O cookbook da OpenRouter mostra um arquivo TypeScript carregado como plugin do OpenCode ou como permission hook no Claude Code, no Codex CLI e no Cursor
O arquivo faz duas perguntas do tipo Noul ao Jev e só aprova quando o modelo está com no mínimo 90% de confiança de que o comando é reversível E casa com a tarefa em andamento
E tem o detalhe que eu acho o mais inteligente do cookbook: comandos irreversíveis e que tocam credenciais ficam numa lista estática no código, avaliada ANTES do Jev. Ou seja, os rm -rf da vida nem chegam a virar pergunta
Esse caso é irmão de um problema que já rolou aqui no blog, o de aceitar código que você não sabe revisar: quanto mais o agente propõe coisa que você não consegue auditar linha a linha, mais valor tem um filtro que responde com número em vez de prosa
3. Roteamento pra conjunto fixo de destinos
Caso listado pela doc oficial, e o tipo Choice existe literalmente pra isso: uma lista de até 255 opções, probabilidade por opção, valor de confiança junto
Se o seu fluxo tem aquele ponto onde um prompt decide "isso vai pro handler A, B ou C", é ali que a troca faz sentido
4. Rubrica com Score e checagem factual com Noul
Pontuar algo contra uma rubrica vira Score, com a escala em palavras e ordenada
Checar se uma afirmação é verdadeira sobre um documento vira Noul, com a probabilidade na mão pra você escolher o corte
Os dois são casos que a documentação lista como bom encaixe, e os dois têm a mesma característica: você não quer texto de volta, você quer um valor com o qual dá pra fazer if
Onde o Jev só adiciona etapa: tarefas para deixar no prompt cru
A TypeSafe mantém uma página de limitações da jev-1.13 e ela é bem honesta, o que já é um ponto a favor deles. Vale ler antes de sair plugando o modelo em tudo
O que está registrado lá como ponto fraco:
- Leitura muito literal, então enunciado que depende de subentendido sofre
- Precisão numérica: tarefa que exige conta certa não é lugar dele
- Dupla negativa e indireção complexa reduzem a confiabilidade
- Context rot (nome usado pela própria TypeSafe): a acurácia cai quando o estado cresce com conteúdo irrelevante pra decisão
- Instruções e critérios que se contradizem pioram a resposta
- Datas lidas como texto e não como quantidades ordenadas
Soma a isso o corte estrutural, que é mais duro ainda: tudo que exige gerar texto, escrever código ou manter conversa fica com o LLM do agente, ponto
E aí dá pra destilar numa regra prática de decisão que eu acho que resolve 90% das dúvidas:
Se a pergunta não cabe em Noul, Choice ou Score, é sinal de que a camada não compensa
Se você está torcendo o problema pra caber num dos três, provavelmente está forçando. Deixa no prompt cru
Armadilhas de quem liga o Jev no Claude Code
Aqui eu vou só com o que está registrado em fonte, porque esse tema é novo demais pra folclore
Sintoma: HTTP 400 quando o catálogo é grande
Causa: o limite de 255 opções do Choice. Catálogo de skills acima disso estoura
Solução: reduzir ou particionar o conjunto de opções antes de montar a pergunta
Como prevenir: contar as opções na hora de desenhar a chamada, e não descobrir o teto em produção. Esse comportamento está registrado em issue aberta do repositório davila7/claude-code-templates, que hospeda o mod de comunidade jev-skill-suggestion (projeto de comunidade, não é da Anthropic nem da TypeSafe)
Sintoma: a segunda requisição simplesmente não volta
Causa: o timeout padrão de 800 ms perde a segunda requisição quando o catálogo é grande. Mesma origem, as issues do próprio repo
Solução: ajustar o timeout pro tamanho real do seu catálogo
Como prevenir: lembrar que a latência reportada pela TypeSafe é de 70 a 500 ms ponta a ponta, então um teto de 800 ms pra DUAS requisições encadeadas é justo demais
Sintoma: a decisão muda por causa do conteúdo que chegou
Causa: a página oficial de limitações diz que conteúdo adversarial pode mover a resposta do Jev. Instrução injetada, enquadramento enganoso ou texto que argumenta pela própria classificação mudam a decisão, porque a jev-1.13 não trata o estado como hostil por padrão

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.E isso não é teoria: a Check Point publicou uma análise demonstrando injeção de prompt contra o Jev, apesar dele não ser um modelo de linguagem gerativo. Insano, né?
Solução: triar o texto enviado pelo usuário. A própria documentação coloca isso como responsabilidade de quem chama, não do modelo
Como prevenir: duas coisas. Manter comandos irreversíveis e que tocam credenciais numa lista estática avaliada ANTES do Jev, exatamente como faz o cookbook da OpenRouter, e manter no estado só o que a decisão precisa (o que ainda ajuda contra o context rot, dois coelhos numa cajadada)
Como deixar o Jev disponível no seu fluxo antes de decidir onde usar
Não dá pra mapear caso de uso sem ter a peça na mão. Os passos abaixo são curtos
- Resolva o acesso. O acesso direto à API da TypeSafe está com novos cadastros pausados por excesso de demanda. Eles tinham liberado sem waitlist, com US$ 5 de crédito pra todo mundo (cerca de 120 milhões de tokens), e logo depois pausaram os cadastros pra preservar qualidade de serviço. Contas já criadas seguem funcionando, e até 25/09/2026 não houve reabertura anunciada
- Se você não tem conta lá, vá de gateway. O
typesafe/jev-1.13e o alias~typesafe/jev-latestestão disponíveis pra qualquer chave de API da OpenRouter, sem waitlist e sem conta TypeSafe separada. O Jev também está listado no AI Gateway da Netlify. Erro comum deste passo: ficar parado esperando a waitlist voltar quando já existe caminho aberto
- Instale o marketplace do agent skill oficial no Claude Code:
claude plugin marketplace add typesafe-ai/skills
- Instale o plugin:
claude plugin install typesafe@typesafe-ai
- Invoque quando precisar do contexto:
/typesafe:typesafe-ai
Erro comum deste passo: achar que a skill decide por você. Ela não intercepta nada. O que ela faz, segundo o SKILL.md do repositório typesafe-ai/skills, é dar ao agente de código o contexto completo da API da TypeSafe: os três tipos de pergunta, os padrões arquiteturais e as boas práticas pra estruturar avaliações. Ela ENSINA o agente, e é o agente que escreve o código que chama o Jev
- Em outro agente de código, use o instalador genérico:
npx skills add typesafe-ai/skills --skill typesafe-ai
- Fixe a versão no campo model. A publicada é a
jev-1.13.0, e os apelidos aceitos sãojev-latestejev-preview, ambos apontando pra ela hoje. Se o seu fluxo não pode mudar de comportamento sem aviso, aponta pra versão exata
Veredito: a camada extra compensa para quem?
Vou ser direto
Compensa quando você tem um ponto de decisão repetido, com destinos fixos e volume de chamadas. Aí a latência de 70 a 500 milissegundos cabe no orçamento de tempo do turno, e o custo cabe no bolso: o Jev cobra só token de entrada, US$ 0,042 por 1 milhão de tokens de input, com a saída não medida, US$ 0 por 1 milhão de tokens de output
É um preço que só faz sentido justamente porque ele não gera texto
Não compensa em decisão pontual, daquelas que acontecem uma vez por semana. O ganho não paga o trabalho de montar a chamada
Não compensa em tarefa criativa, numérica ou de data, pelos motivos que a própria página de limitações lista
E não compensa pra quem ainda não tem o fluxo estável o suficiente pra saber qual é o ponto de decisão. Se você está na fase de descobrir o que o agente resolve bem, tipo quando a gente discute usar o Claude Code sem programar, otimizar decisão é cedo demais: primeiro o fluxo precisa existir e se repetir
E mais uma vez, com todas as letras, porque é o erro de leitura mais comum nesse assunto: o Jev não troca o modelo do Claude Code. Ele entra como componente de decisão dentro do fluxo que o agente escreve
Conclusão
O mapa fica assim na cabeça:
Aciona o Jev: roteamento pra destinos fixos, pontuação contra rubrica, checagem de afirmação sobre documento, e qualquer lugar onde hoje você tem um prompt frágil pedindo "retorne JSON"
Não aciona: gerar código, redigir texto, conta numérica, comparação de datas, conversa com o usuário, e tudo que não cabe em Noul, Choice ou Score
Próximo passo concreto, e é um só: escolhe UM ponto do seu fluxo que hoje depende de um prompt pedindo JSON. Reescreve como Noul, Choice ou Score. E mede antes e depois, no mesmo espírito do cookbook de skill suggestion, que só virou recomendação porque tinha 488 requisições atrás dele
Sem medida, é achismo. E achismo em camada de decisão é o tipo de coisa que você só descobre que estava errada quando já rodou mil vezes…
Até o próximo post! 😀
Perguntas frequentes
Quanto custa usar o Jev no Claude Code?
O Jev cobra só por token de entrada: US$ 0,042 por 1 milhão de tokens de input. A saída não é medida, custa US$ 0 por 1 milhão de tokens de output, já que o modelo não gera texto, só devolve decisão tipada.
Como instalar o agent skill da TypeSafe no Claude Code?
Roda claude plugin marketplace add typesafe-ai/skills e depois claude plugin install typesafe@typesafe-ai. Com o plugin instalado, dá pra invocar /typesafe:typesafe-ai direto no Claude Code. Esse skill só dá contexto e documentação da API pro agente, ele não intercepta nenhuma decisão.
É seguro usar o Jev pra decisões automáticas no fluxo do agente?
A própria página de limitações do jev-1.13 avisa que conteúdo adversarial pode mover a resposta, e que triar o texto enviado é responsabilidade de quem chama o modelo. Uma análise publicada pela Check Point já demonstrou injeção de prompt contra o Jev, mesmo ele não sendo um modelo de linguagem gerativo. Por isso o cookbook de auto-aprovação deixa comando irreversível numa lista estática, avaliada antes de qualquer pergunta ao Jev.
Dá pra usar o Jev sem criar conta na TypeSafe?
Dá. O modelo está disponível como typesafe/jev-1.13 (e o alias ~typesafe/jev-latest) pra qualquer chave de API da OpenRouter, sem waitlist nem conta TypeSafe separada. Ele também aparece listado no changelog do AI Gateway da Netlify.
Por que a TypeSafe pausou o cadastro direto na API?
A TypeSafe tirou a waitlist e passou a dar US$ 5 de crédito inicial pra todo mundo, o equivalente a cerca de 120 milhões de tokens. Depois pausou novos cadastros por excesso de demanda, pra preservar a qualidade do serviço, mas as contas já criadas continuam funcionando normalmente. Até 25/09/2026 não tinha reabertura anunciada.
O que acontece se o catálogo de skills for maior que o limite do Jev?
O tipo Choice aceita no máximo 255 opções, e o mod de comunidade jev-skill-suggestion (mantido no repositório davila7/claude-code-templates) registra em issues abertas que catálogos acima desse limite recebem HTTP 400 da TypeSafe. O mesmo mod também tem issue mostrando que o timeout padrão de 800 ms perde a segunda requisição quando o catálogo é grande.
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.
