Como usar o Jev no Claude Code e no Codex

Por que o Jev não pode ser o modelo

O Claude Code conversa com a Anthropic Messages API. O Codex conversa com a OpenAI Responses API. Ambos permitem que você mude a URL base, mas o formato de transmissão continua o mesmo, e esse é justamente o problema: o formato de requisição do Jev é um state mais um mapa de questions tipadas, e sua resposta são answers tipadas com probabilidades por opção. Não há mensagem de assistente para renderizar, nenhum stream de tokens para imprimir, nenhuma chamada de ferramenta para parsear.

A TypeSafe documenta exatamente um endpoint de avaliação, POST /v1/systemone, além de GET /v1/models para listar os aliases que sua conta pode enviar no campo model. jev-latest é o padrão; IDs versionados como jev-1.13.0 são aceitos quer apareçam ou não na lista. Nada na documentação descreve uma superfície compatível com OpenAI ou Anthropic.

Isso não é uma lacuna que a TypeSafe esqueceu de preencher. O Jev é um modelo de decisão de propósito: ele retorna uma resposta dentro de um esquema que você definiu, e não cobra nada pela saída porque não há saída. Uma CLI de código é o tipo oposto de programa — ela existe para escrever texto. Então a pergunta útil não é "o Jev pode ser o modelo", é "quais decisões dentro do agente o Jev deveria assumir", e há quatro lugares onde essa resposta se encaixa.

Rota 1: a skill oficial de agente

Esta é a única integração oficialmente suportada, é publicada pela TypeSafe, e é a primeira a instalar porque não pode quebrar nada: ela ensina o agente, não intercepta o agente.

Claude Code, como plugin:

claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai

Então invoque-a diretamente com /typesafe:typesafe-ai, ou apenas mencione-a em um prompt — "use a skill TypeSafe". Para atualizar:

claude plugin marketplace update typesafe-ai
claude plugin update typesafe@typesafe-ai

Reinicie o Claude Code ou rode /reload-plugins. Atualizações automáticas podem ser ativadas em /plugin → Marketplaces → typesafe-ai.

Codex e todo o resto, através do instalador de skills:

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

Ele pergunta em qual agente instalar. Você também pode colar o prompt da própria TypeSafe no agente e deixá-lo fazer a instalação, ou copiar o diretório skills/typesafe-ai manualmente para a pasta de skills do seu agente. O repositório é licenciado sob MIT, o manifesto do plugin é typesafe v0.5.7, e a skill em si é um único arquivo Markdown mais referências.

O que a skill realmente muda vale a pena conhecer, porque não é só trivia de API. Ela carrega os três tipos de pergunta, como construir o state, o que significa confiança em oposição a probabilidade, os padrões arquiteturais e uma tabela apontando para a página de documentação certa para cada tarefa — incluindo o truque de acrescentar .md a qualquer URL de documentação retorna o Markdown. A documentação da TypeSafe é explícita sobre o modo de falha que ela está corrigindo: "agentes de código caem no hábito de uma pergunta por chamada mais do que as pessoas". A skill diz ao agente para colocar muitas perguntas em uma chamada, incluindo perguntas especulativas cujas respostas só importam para algumas entradas, e deixar seu código decidir quais respostas usar. Esse padrão é a razão pela qual os números fecham — o próprio exemplo de GDPR da TypeSafe agrupa 13 perguntas em uma chamada e reporta como 12,2× mais barato e 10,0× mais rápido no índice do cookbook, 11,5× mais barato e 9,6× mais rápido no guia de construção, sem mudança nas respostas. Dois números ligeiramente diferentes para o mesmo teste; trate ambos como medição da própria fornecedora.

Um limite para planejar em torno: o state e todas as perguntas em uma requisição compartilham um orçamento de aproximadamente 32.000 tokens, cerca de 150.000 caracteres de inglês.

Rota 2: colocar o Jev nas fronteiras

É aqui que está a maior parte do uso real, e é tudo trabalho da comunidade. O padrão é o mesmo em todos os lugares: a CLI não é modificada, um hook ou proxy é, e o Jev faz um julgamento limitado em um momento em que um modelo de linguagem gastaria tokens e segundos.

Onde fica	Projeto	★	Agentes
Compactação de sessão	tamaratran/fast-jev-compaction	4.697	Plugin do Claude Code; substitui o resumo de compactação por julgamentos de manter/descartar por item
Compactação de sessão	leonaaardob/fast-dev-compaction	3	Plugin do Codex, uma portabilidade da mesma ideia
Saída de terminal	tamaratran/jev-pruner	122	Claude Code; reduz saídas longas do Bash antes que o modelo as veja
Proxy de contexto	compozy/yoshi	18	Claude Code, Codex; o Jev julga qual histórico ainda é necessário
Porta pré-ferramenta	shiftynick/jev-axi	17	Claude Code, Codex; pontua cada comando de shell quanto a destrutividade, exfiltração, RCE e enfraquecimento de segurança antes de executa-lo
Porta pré-ferramenta	leepokai/jev-guard	12	Claude Code, Codex, Pi, ACP
Hook de parada	valentynkit/jev-belay	13	Claude Code; lê a transcrição antes de confiar em uma alegação de "pronto"
Acima dos workers do Codex	thruwire/foreman	418	Codex; o Jev julga se uma implementação está completa e se seus testes são suficientes
Ponte MCP e ACP	tacticocc/Jevbridge	26	Codex, Claude, Grok, OpenCode
Pacote de plugins	shitianfang/jev-use	9	Claude Code, Codex, Pi; instala hooks, uma skill de roteamento e a porta PreToolUse em um único comando
Ações de desktop	yikangy873-gif/jev-desktop	31	Codex Computer Use; escolhe entre ações de desktop em vez de perguntar a um modelo de linguagem a cada passo

Dois deles valem a leitura antes de você instalar qualquer coisa. O jev-axi publica seu próprio conjunto rotulado de 44 chamadas de ferramenta — 24 das quais devem ser bloqueadas ou escaladas, incluindo as ofuscadas em base64 — e reporta 44 de 44 decididas conforme o rótulo; também documenta a aresta honesta, que é o fato de que quando o hook não consegue ler a transcrição do agente ele não faz nada. O jev-belay mostra o controle de custo que faz toda essa categoria funcionar: ele gasta uma chamada ao Jev de quatro perguntas, e só quando arquivos mudaram sem um check aprovado desde então, e ele falha aberto em qualquer erro.

Duas ressalvas que você deve manter em mente. Esses repositórios têm dias de vida — a maioria foi criada entre 17 e 20 de setembro de 2026 — então as contagens de estrelas acima são atenção, não maturidade, e tirando o fast-jev-compaction, são projetos pequenos. E os comandos de instalação variam por projeto; leia o README em vez de assumir que o comando no estilo da skill funciona.

O ponto de entrada de um comando só, se você quiser o pacote em vez de um único hook:

npx -y jev-use install    # conecta Claude Code, Codex e Pi, o que encontrar
npx -y jev-use doctor     # verifica a fiação

O jev-use lê sua chave de TYPESAFE_API_KEY, OPENROUTER_API_KEY ou AI_GATEWAY_API_KEY, e JEV_BACKEND=mock oferece um dry run sem chave que mantém cada julgamento local. Seus demos publicados valem a leitura pelo formato dos ganhos: uma execução de compactação de contexto que julgou 200 mensagens em 7 chamadas e levou uma janela 94% cheia para 44%, e uma porta de comandos de shell que negou comandos perigosos em cerca de 230 ms com zero tokens de modelo de linguagem.

Rota 3: ferramentas MCP

Se você quer o Jev disponível ao modelo como uma ferramenta chamável em vez de como um hook, o MCP é a rota portátil — e é apenas da comunidade. A documentação da própria TypeSafe nunca menciona MCP, então não há servidor de primeira linha para instalar.

Claude Code:

claude mcp add jev -e TYPESAFE_API_KEY=sk-... -- npx -y @jkudish/jev-mcp

Codex, em ~/.codex/config.toml:

[mcp_servers.jev]
command = "npx"
args = ["-y", "@jkudish/jev-mcp"]
env = { TYPESAFE_API_KEY = "sk-..." }

Esse servidor (npm @jkudish/jev-mcp 0.5.0) expõe dez ferramentas — jev_verify, jev_screen, jev_find, jev_rerank, jev_classify, jev_decide, jev_compare, jev_extract, jev_review e jev_gate — e seu README cita aproximadamente 150 a 500 ms por julgamento a uma fração de centavo. O ponto de design é o que importa aqui: essas são as verificações mecânicas baratas que um agente pula porque um modelo de fronteira é lento demais para rodá-las em cada página, alegação ou lista de candidatos.

Existem alternativas se você quiser um formato diferente: itsmostafa/typesafe-mcp (★128) é um servidor e CLI em Go, e o Jevbridge fala MCP via stdio a partir de um clone do código-fonte, que é como seu exemplo de Codex está escrito:

[mcp_servers.jevbridge]
command = "node"
args = ["--experimental-strip-types", "/absolute/path/to/Jevbridge/src/cli.ts", "mcp"]

Um aviso sobre nomes: agora existem dois pacotes npm não relacionados nesse espaço, @jkudish/jev-mcp e um jev-mcp sem escopo publicado de um repositório diferente. Fixe o nome com escopo na sua configuração para que um futuro npx não resolva para o errado.

Rota 4: roteamento de modelo por turno

Este é o uso mais visível do Jev em um agente de código, e é engenhoso: o Jev não responde nada por si só, ele escolhe qual modelo deveria. Uma chamada ao Jev por turno novo do usuário escolhe um nível, e a CLI roda exatamente como antes.

npm install -g jev-router
echo "JEV_API_KEY=..." > ~/.jev-router.env
jev-claude      # Claude Code, com o Jev Router selecionado em /model
jev-codex       # Codex, com um provedor temporário Jev Router selecionado

Requer Node.js 20.12+ e pelo menos uma das duas CLIs. Seu claude login ou codex login existente não é tocado — o proxy de loopback encaminha os cabeçalhos de autorização da própria CLI sem lê-los, armazená-los ou modificá-los, e nenhuma chave de API da Anthropic ou OpenAI está envolvida. O Claude Code é redirecionado via ANTHROPIC_BASE_URL; o Codex recebe um provedor customizado temporário com requires_openai_auth=true. Em ambos, Jev Router aparece no seletor de modelos: selecionar um modelo concreto pausa o roteamento, selecionar Jev Router o retoma. Chamadas de ferramenta, permissões, sessões, /compact e /resume se comportam como sempre, porque ainda são da própria CLI.

A tabela de níveis é a parte que deve interessar a qualquer um que compre acesso de API:

Nível	Padrão do Claude Code	Padrão do Codex
Rápido	Haiku	gpt-5.6-luna
Equilibrado	Sonnet	gpt-5.6-terra
Forte	Opus	gpt-5.6-sol
Longo	Fable (opt-in)	gpt-6-astra

Todo modelo nessa tabela está em promoção na APIMaster hoje aos preços da resposta rápida, de cerca de 89% a cerca de 96% abaixo da lista. Comprar a metade roteada aqui e pagar à TypeSafe diretamente pela metade do julgamento é a versão mais barata dessa configuração que conseguimos ver — os próprios padrões do roteador apontam para nosso catálogo, e o ponto todo do padrão é que a maioria dos turnos caia no nível barato.

A política é mais cuidadosa do que "escolha o mais barato", e os detalhes são a razão pela qual ela não briga com você: um pedido explícito como "use opus" vence; confiança baixa nunca faz downgrade e limita os upgrades ao nível equilibrado; conversas grandes recusam downgrades que desperdiçariam mais trabalho de cache de prompt do que economizariam; um nível indisponível sobe em vez de escolher silenciosamente algo mais fraco; e o nível longo fica desligado a menos que você defina JEV_ALLOW_FABLE=1. O roteamento é fail-open — uma falha do Jev deixa o modelo atual no lugar em vez de bloquear a CLI — e cada launcher restaura o padrão anterior da CLI ao sair.

Existe um projeto irmão com o mesmo nome que também cobre a CLI do Grok e o opencode. Seu README dá um comando npm que ainda não foi publicado, então use o clone do repositório se você precisar desses dois agentes.

O que instalar primeiro

1. A skill, no agente que você mais usa. É MIT, não muda nenhum comportamento que você não pediu, e torna cada passo posterior mais fácil porque o agente deixa de fazer uma pergunta por chamada.
2. Um hook de fronteira, escolhido pelo que te incomoda. Se sessões longas ficam caras, compactação. Se você fica nervoso com comandos de shell, a porta pré-ferramenta. Se você continua recebendo "pronto" em trabalho inacabado, o hook de parada.
3. Roteamento, só se você já estiver confortável com um proxy na frente da sua CLI. É o de maior alavancagem e o mais invasivo dos quatro.
4. Mantenha a aritmética, as datas e a contagem no seu próprio código. O Jev documenta essas coisas como não confiáveis, e o mesmo vale para os modelos acima.

Três coisas que as pessoas entendem errado

• "Aponte o Claude Code para o Jev." Não existe endpoint compatível. Este é o erro mais comum no conteúdo escrito sobre o Jev nesta semana.
• "Uma pergunta por chamada." A economia de um modelo de decisão vem de perguntas paralelas sobre um state compartilhado. Fazer uma pergunta por requisição joga fora a maior parte da vantagem e todo o argumento de latência.
• "Confiança é acurácia." A confiança do Jev é calibrada, o que é uma propriedade diferente e mais útil: ela te diz quais respostas escalar. Passamos pelos números de calibração publicados em Jev vs LLMs.

FAQ

Posso usar o Jev como o modelo no Claude Code ou no Codex? Não. O Jev retorna decisões tipadas e não gera texto, e sua API é POST /v1/systemone sem nenhuma superfície no formato OpenAI ou Anthropic. Use-o como uma camada de julgamento, não como o assistente.

O Jev tem um endpoint compatível com OpenAI? Não conforme documentado. A referência da API lista o endpoint de avaliação e GET /v1/models, e nada mais.

A TypeSafe publica um servidor MCP? Não em sua documentação — MCP não aparece no pacote de docs de forma alguma. Existem servidores da comunidade, e o mais completo é @jkudish/jev-mcp.

O que exatamente a skill oficial instala? No Claude Code, um plugin chamado typesafe do marketplace typesafe-ai, invocado como /typesafe:typesafe-ai. Em todos os outros lugares, um diretório de skill que npx skills add typesafe-ai/skills --skill typesafe-ai coloca na pasta certa para o seu agente.

Ainda preciso da minha assinatura do Claude ou ChatGPT? Para a configuração de roteamento, sim — os launchers reutilizam o login que a CLI já tem, então uma assinatura Pro, Max, ChatGPT ou SuperGrok funciona como está. Sem uma chave do Jev você tem a CLI pura sem roteamento.

Preciso de uma chave da TypeSafe? Para qualquer coisa que chame o Jev, sim. Obtenha uma na TypeSafe, ou aponte o ferramental para o OpenRouter ou o Vercel AI Gateway, que o jev-use também suporta.

Posso testar sem uma chave? JEV_BACKEND=mock no jev-use roda cada julgamento localmente sem chamada a provedor, o que é suficiente para ver se os hooks disparam onde você espera.

O Jev está disponível na APIMaster? Está em processo de integração, e esta página será atualizada quando a integração estiver ativa. Os modelos para os quais um roteador Jev envia trabalho já estão aqui, aos preços acima.

Alguma dessas coisas vai quebrar minha CLI? A skill não muda nada sobre como a CLI roda. O proxy de roteamento é fail-open e restaura seu padrão de modelo anterior ao sair. Os hooks são o único lugar para ter cuidado, e os melhores documentam seu comportamento fail-open explicitamente.

Quanto custa um julgamento do Jev? US$ 42 por bilhão de tokens de entrada, sem cobrança de saída, porque não há saída. Uma decisão de roteamento por turno do usuário, ou um conjunto de perguntas por disparo de hook, é a conta inteira.

Qual rota devo escolher para um time? A skill para todos, um hook de fronteira para a dor compartilhada, e roteamento só onde a conta de modelos é grande o suficiente para medir.

Fontes e leitura adicional

• TypeSafe — Referência da API — o formato da requisição POST /v1/systemone, tipos de pergunta e respostas
• TypeSafe — Models — aliases, IDs versionados, preço de US$ 42/Btok e limites
• TypeSafe — Agent skill — o plugin oficial do Claude Code e a rota npx skills, com os comandos de atualização
• TypeSafe — How to build with TypeSafe — fan-out especulativo, o orçamento de 32.000 tokens por requisição e a comparação de agrupamento
• typesafe-ai/skills — o código-fonte da skill, MIT
• gargpratyush/jev-router — o proxy de roteamento, sua tabela de níveis e notas de compatibilidade
• jkudish/jev-mcp — o conjunto de ferramentas MCP
• shiftynick/jev-axi — a porta pré-ferramenta e seus 44 casos rotulados
• tamaratran/fast-jev-compaction — o plugin de compactação

Estrelas de repositório, comandos de instalação, versões de pacotes npm e preços de rotas da APIMaster foram todos verificados em 20 de setembro de 2026. Projetos da comunidade nesse espaço se movem diariamente; verifique o repositório antes de instalar.

Crie uma conta na APIMaster, adicione crédito pré-pago a partir de US$ 1, crie uma chave no console e aponte um cliente compatível com OpenAI ou Anthropic para https://apimaster.ai/v1. Os guias de configuração para as duas CLIs neste artigo são Claude Code e Codex.