Como usar o Jev no Claude Code e no Codex

Por que o Jev não pode ser o modelo

O Claude Code fala com a API Anthropic Messages. O Codex fala com a API OpenAI Responses. Ambos permitem que você mude a URL base, mas o formato de transmissão continua o mesmo, e esse é todo 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 analisar.

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, apareçam ou não na lista. Nada na documentação descreve uma superfície compatível com OpenAI ou com 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 codificação é 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, vem da 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

Depois invoque diretamente com /typesafe:typesafe-ai, ou apenas mencione 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 execute /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 para a pasta de skills do seu agente manualmente. 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 é apenas curiosidade sobre 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 docs para obter o Markdown. A documentação da TypeSafe é explícita sobre o modo de falha que ela está corrigindo: "agentes de codificação 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 única chamada, incluindo 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 fazem sentido — o próprio exemplo de GDPR da TypeSafe agrupa 13 perguntas em uma chamada e reporta isso 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 do próprio fornecedor.

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

Rota 2: coloque o Jev nas fronteiras

É aqui que está a maior parte do uso no mundo real, e é tudo trabalho da comunidade. O padrão é o mesmo em todos os lugares: a CLI não é modificada, um hook ou um 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 item a item
Compactação de sessão	leonaaardob/fast-dev-compaction	3	Plugin do Codex, uma adaptação da mesma ideia
Saída de terminal	tamaratran/jev-pruner	122	Claude Code; enxuga 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
Portão 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 executá-lo
Portão 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 "concluído"
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 o portão 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; ele também documenta a aresta honesta, que é 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 nenhuma verificação aprovada desde então, e 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, exceto pelo fast-jev-compaction, são projetos pequenos. E os comandos de instalação diferem por projeto; leia o README em vez de presumir 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 conexão

O jev-use lê sua chave de TYPESAFE_API_KEY, OPENROUTER_API_KEY ou AI_GATEWAY_API_KEY, e JEV_BACKEND=mock oferece uma execução a seco sem chave que mantém todo julgamento local. Suas demos publicadas valem a leitura pelo formato das vitórias: uma execução de compactação de contexto que julgou 200 mensagens em 7 chamadas e reduziu uma janela 94% cheia para 44%, e um portão 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 um hook, o MCP é a rota portátil — e é exclusivamente da comunidade. A própria documentação da TypeSafe nunca menciona MCP, então não há servidor de primeira parte 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 executá-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 para Codex é 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 a partir 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 codificação, e é engenhoso: o Jev não responde nada por conta própria, 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 permanece intacto — o proxy de loopback encaminha os próprios cabeçalhos de autorização da CLI sem lê-los, armazená-los ou modificá-los, e nenhuma chave de API da Anthropic ou da OpenAI está envolvida. O Claude Code é redirecionado via ANTHROPIC_BASE_URL; o Codex recebe um provedor personalizado 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 continuam sendo da própria CLI.

A tabela de níveis é a parte que deveria interessar a qualquer um que compra acesso a 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 pelos preços da resposta rápida, de cerca de 89% a cerca de 96% abaixo da tabela. Comprar a metade roteada aqui e pagar a TypeSafe diretamente pela metade de 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 central do padrão é que a maioria dos turnos cai 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; baixa confiança nunca rebaixa e limita upgrades ao nível equilibrado; conversas grandes recusam rebaixamentos 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 falha aberto — uma falha do Jev deixa o modelo atual no lugar em vez de bloquear a CLI — e cada lançador restaura o padrão anterior da CLI ao sair.

Há 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 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 facilita cada passo posterior porque o agente para 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, o portão pré-ferramenta. Se você continua recebendo "concluído" 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 erram

• "Aponte o Claude Code para o Jev." Não há endpoint compatível. Este é o erro mais comum no conteúdo escrito sobre o Jev esta 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 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 da OpenAI ou da 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 distribui um servidor MCP? Não na sua documentação — MCP não aparece no pacote de docs. 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 do ChatGPT? Para a configuração de roteamento, sim — os lançadores 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ê fica com a CLI simples, sem roteamento.

Preciso de uma chave da TypeSafe? Para qualquer coisa que chame o Jev, sim. Obtenha uma na TypeSafe, ou aponte as ferramentas 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 executa 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? Sim. Chame jev-latest através de POST https://apimaster.ai/v1/systemone com uma chave da APIMaster; custa $0,042 por 1M de tokens de entrada e $0 de saída. Os modelos aos quais um roteador Jev envia trabalho também estão aqui, pelos 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 falha aberto e restaura seu padrão de modelo anterior ao sair. Os hooks são o único lugar onde é preciso ter cuidado, e os melhores documentam seu comportamento de falha aberta explicitamente.

Quanto custa um julgamento do Jev? $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, é toda a conta.

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

Fontes e leitura adicional

• TypeSafe — Referência da API — o formato de requisição POST /v1/systemone, tipos de pergunta e respostas
• TypeSafe — Modelos — aliases, IDs versionados, preço de $42/Btok e limites
• TypeSafe — Skill de agente — o plugin oficial do Claude Code e a rota npx skills, com os comandos de atualização
• TypeSafe — Como construir com a 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 — o portão 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 $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 deste artigo são Claude Code e Codex.