O que é o JEV e para que ele serve no Claude Code?

Fala aí, beleza? O nome JEV apareceu do nada nas timelines e todo mundo repetiu a sigla sem dizer o que é a coisa

E aí vem a confusão clássica: é uma skill? é um slash command novo? é plugin? é modelo?

Vou cortar o caminho pra ti: JEV é um modelo, de outra empresa, que não tem nada de nativo no Claude Code

Ele não escreve código, não conversa e não substitui o modelo que roda por trás do agente

O que existe de JEV no Claude Code é uma agent skill oficial publicada pela TypeSafe, a empresa do modelo, que ensina o agente a usar a API dele

Ou seja: JEV é peça de fluxo, não é botão do Claude Code

Bora destrinchar isso direito?

De onde saiu o JEV e quem está por trás

O JEV é o primeiro modelo público da TypeSafe AI, apresentado como um "System One model", anunciado em 15/09/2026

A empresa saiu do stealth no mesmo dia, com uma seed de US$ 40 milhões liderada pela DCVC

Fundadores: Diogo Almeida, Erik Gafni e Sasha Sheng

No lançamento tinha waitlist, e isso acabou: em 21/09/2026 a lista de espera foi removida

Formação Recomendada

Formação Claude Code

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

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

Hoje qualquer pessoa cria conta em console.typesafe.ai e já começa com US$ 5 em créditos iniciais, algo em torno de 120 milhões de tokens

E se tu não quer criar conta lá, o modelo também aparece em provedor de terceiro: o OpenRouter lista typesafe/jev-1.13 e typesafe/jev-latest

Uma observação honesta antes de seguir: a página de modelos da TypeSafe e o OpenRouter não batem na numeração de versão, então não vou cravar qual é a versão corrente aqui

Que problema o JEV tenta resolver

Aqui é onde a ficha cai, então presta atenção nessa parte

Pensa no teu fluxo com agente hoje

No meio do caminho existe um monte de decisão pequena e repetida: essa tarefa é de código ou de documentação? esse arquivo é relevante? preciso carregar essa skill? esse teste é flaky ou quebrou de verdade?

Hoje essas microdecisões são tomadas pelo MESMO LLM generativo que escreve o código

E aí tu paga token de output, espera geração de texto e recebe resposta em linguagem natural que teu código precisa interpretar de novo, com parse frágil e tudo mais

É decisão binária vestida de redação

O desenho do JEV vai no contrário: tu manda um estado mais perguntas tipadas, e ele devolve resposta estruturada com probabilidade que o código consome direto

Sem texto livre no meio

O caso oficial que a TypeSafe publicou é de "skill suggestion", e ele é bem didático pra entender o encaixe

A ideia é usar o JEV pra ranquear as descrições das skills disponíveis e deixar o agente carregar no máximo UMA SKILL.md no prompt

No roster de 182 skills do Hermes (Nous Research), o cookbook reporta carregamento de skill errada caindo de 16,8% para 7,3%, e carregamento desnecessário caindo de 9,8% para 4,0%

Isso usando duas requisições por turno, com cerca de 100 a 300 ms por chamada

Vale marcar: esse número é medição da própria TypeSafe, no material dela

JEV não é substituto do modelo do Claude Code: a diferença na prática

Essa é a parte que mais gerou ruído, e a própria documentação da TypeSafe é explícita: o JEV não é drop-in replacement do modelo que roda por trás do Claude Code

Não existe "troca o modelo do Claude Code pelo JEV e fica mais barato"

O uso é outro: tu escreve código que chama o JEV pra decidir

Lendo a tabela fica claro que os dois não competem, eles se empilham

Um escreve, o outro decide

Os três tipos de pergunta do JEV: Choice, Score e Noul

O JEV só aceita pergunta em três formatos, e é justamente isso que torna a resposta previsível

Se tu conhece tipagem em TypeScript, o espírito é o mesmo: tu não pede "me diz aí", tu declara o contrato da resposta antes

• Choice: uma opção entre N, com até 255 opções. É o formato de roteamento e classificação. Qual skill carregar, qual arquivo abrir primeiro, qual categoria esse erro pertence
• Score: posição numa escala, de 2 a 10 níveis. Serve pra graduar coisa que não é sim ou não. Nível de risco de um diff, prioridade de uma tarefa, confiança de um match
• Noul: probabilidade de verdadeiro ou falso, num número de 0 a 1. É o teu gate. "Esse PR precisa de revisão humana?" e tu decide o threshold no teu código

E aqui vem a mudança de cabeça que o JEV exige do dev

Tu precisa parar de escrever pergunta em forma de pedido e começar a escrever pergunta em forma de contrato

Sai de "analise esse diff e me diga se está seguro" e vai pra "dado esse estado, qual a probabilidade de esse diff tocar em comportamento crítico?"

A primeira gera parágrafo pra tu ler

A segunda gera número pra teu if usar

Quem já passou o perrengue de revisar um diff grande do agente sente rápido onde esse tipo de gate ajudaria a separar o que merece olho humano do que é ruído

Em que ponto do fluxo do Claude Code o JEV entra

São dois pontos de entrada diferentes, e misturar os dois é a fonte de quase toda a confusão

Ponto 1, o teu código: o JEV é consumido por requisição. É POST em https://api.typesafe.ai/v1/systemone com a tua chave da TypeSafe

Se tu preferir o SDK oficial, o cliente lê a variável de ambiente TYPESAFE_API_KEY e chama jev-latest por padrão

Repara: quem chama o JEV é o SOFTWARE que tu escreve, não o chat

Ponto 2, o agente: a TypeSafe publica uma agent skill oficial que serve de drop-in pro Claude Code e pra outros agentes

O que essa skill faz é dar ao agente o contexto completo da API: os tipos de pergunta, os padrões de uso e as boas práticas

Tradução: ela existe pra que o Claude Code escreva o código do ponto 1 direito, sem chutar formato de payload

Então o fluxo real é esse: tu instala a skill, pede pro agente implementar a decisão, ele escreve a chamada pro JEV dentro do teu projeto, e no runtime é o teu projeto que fala com a API

Como instalar a skill oficial da TypeSafe no Claude Code

O Claude Code tem sistema oficial de plugins e marketplaces, com comando de linha pra adicionar marketplace e o /plugin pra gerenciar

A skill da TypeSafe usa exatamente esse caminho, então não tem gambiarra aqui

1. Adiciona o marketplace da TypeSafe

claude plugin marketplace add typesafe-ai/skills

2. Instala o plugin

claude plugin install typesafe@typesafe-ai

Por padrão a instalação é local ao projeto

Se tu quer a skill disponível em qualquer projeto teu, usa a flag -g pra instalação global

O erro comum deste passo é instalar dentro de um projeto, gostar do resultado, e semanas depois abrir outro repo achando que a skill sumiu

3. Invoca a skill

Tem dois jeitos: o comando /typesafe:typesafe-ai, ou simplesmente pedir no prompt pro agente usar a skill da TypeSafe

O erro comum deste passo é o mais importante do post inteiro: instalar a skill NÃO é configurar acesso ao modelo

A skill dá contexto de API pro agente

A chamada real precisa da chave em TYPESAFE_API_KEY no ambiente onde o teu código roda

São duas coisas separadas, e confundir isso gera aquele erro de autenticação que parece bug da skill e não é

4. Opcional, liga a atualização automática

Vai em /plugin > Marketplaces > typesafe-ai > Enable auto-update

É um modelo novo, com documentação mexendo, então manter atualizado aqui faz sentido

Usa outro agente e não o Claude Code? A mesma skill é instalável por:

npx skills add typesafe-ai/skills --skill typesafe-ai

E depois tu seleciona o agente na lista

Se tu é do tipo que gosta de ler a fonte antes de instalar qualquer coisa (e deveria ser, os rm -rf da vida existem), o código vive no repositório typesafe-ai/skills no GitHub, e o arquivo que define a skill é skills/typesafe-ai/SKILL.md

Abre lá, lê, é texto

Vale olhar o JEV agora?

Veredito sem enrolação, e separando por perfil

Se tu só usa o Claude Code no dia a dia pra escrever e refatorar código: não muda nada hoje

Não tem ganho automático, não tem chave mágica, não tem "fica mais barato"

O JEV não entra no teu prompt do dia, ele entra em código que alguém escreve

Quem usa o agente mais como ferramenta de produtividade, tipo resolver tarefas repetitivas sem programar, pode tranquilamente ignorar o assunto por enquanto

Se tu constrói ferramenta, agente próprio ou roteamento de skills: aí sim vale abrir a documentação hoje

O caso de skill suggestion é o exemplo mais direto: quem tem roster grande de skills conhece a dor do agente carregar a skill errada e queimar contexto à toa

E o cookbook oficial dá número concreto pra tu avaliar, o que é melhor que promessa vaga

Só não esquece o asterisco: esses percentuais são medição da própria TypeSafe, no material dela, com o roster e as condições que ela escolheu

Não é benchmark independente

Não existe leaderboard público confirmado comparando a acurácia do JEV contra outros modelos nomeados, então ceticismo saudável aqui é gratuito e recomendado

A parte boa é que o custo de descobrir na prática é baixo: input a US$ 0,042 por milhão de tokens e output a US$ 0, mais os créditos iniciais da conta nova

Dá pra testar sem dor no cartão

Conclusão

Recapitulando pra não sobrar dúvida na classificação

O JEV é um modelo de decisão da TypeSafe AI, não é skill do Claude Code, não é slash command nativo e não é substituto do modelo que roda o agente

Ele recebe estado mais perguntas tipadas e devolve choice, score ou noul com probabilidade, num orçamento de 64k de contexto pro conjunto e 32k pro estado mais a pergunta mais longa

O que existe pro Claude Code é a agent skill oficial da TypeSafe, que ensina o agente a escrever a chamada certa

Se tu quer sair da teoria, o caminho mais curto é esse: cria a conta no console pra usar os créditos iniciais, instala a skill oficial, escolhe UMA decisão pequena e chata do teu fluxo e reescreve ela como pergunta tipada

Uma decisão só, pra sentir o formato

É um modelo novo, de empresa nova, com documentação ainda esquentando, então é bem provável que esse assunto renda continuação por aqui…

até o próximo post! 😀