Como usar o Jev no Claude Code: primeiro passo a passo para a tarefa inicial

Fala aí, beleza? A TypeSafe AI soltou o Jev e a primeira coisa que assusta é que ele não conversa com você

não tem stream de texto, não tem resposta em markdown, não tem "claro, vou te ajudar com isso"

O que ele devolve é uma resposta tipada, dentro de um schema definido por quem chama, com probabilidade e confiança do lado

É o que eles chamam de modelo "System One": um modelo de decisão, não de papo

E aí vem a parte prática que interessa pra gente: a TypeSafe mantém uma skill oficial pra agentes de código no repositório typesafe-ai/skills, com instalação documentada pro Claude Code

Ou seja, o caminho mais curto entre "li a notícia" e "rodei aqui" passa pelo terminal mesmo

Bora?

O que precisa existir antes de começar

Antes de sair copiando comando, checklist do que tem que estar de pé:

• Conta na TypeSafe e uma chave de API, criada no console em console.typesafe.ai > API Keys > criar chave
• A chave salva na variável de ambiente TYPESAFE_API_KEY, porque a autenticação da API é por Bearer token lido dali
• Claude Code instalado e funcionando no terminal
• O runtime do SDK que você vai usar no projeto: Python 3.10 ou superior pro typesafe-sdk, ou Node.js 20 ou superior pro @typesafe-ai/sdk

A autenticação é simples de entender: toda chamada vai com o header assim

Authorization: Bearer $TYPESAFE_API_KEY

Se você já mexeu com qualquer API de LLM, é o mesmo desenho de sempre, nada exótico aqui

O teste inicial custa quanto?

Bem pouco, e a razão é justamente o modelo não gerar texto

No preço listado, a entrada sai por US$ 0,042 por 1 milhão de tokens de entrada e a saída fica em US$ 0,00, porque não existe stream de saída pra cobrar

A versão listada publicamente é a Jev 1.13, e o cliente oficial chama jev-latest por padrão

Um pré-requisito que não depende de você: acesso

Essa parte é importante e muita gente vai bater nela antes de qualquer comando

A TypeSafe abriu o acesso pra todos, sem waitlist, em 20/09/2026, com um crédito inicial anunciado de US$ 5

Só que em 22/09/2026 eles pausaram temporariamente os novos cadastros por excesso de demanda, mantendo as contas já existentes funcionando, e disseram estar trabalhando pra reabrir

O comunicado mais recente que eu encontrei é esse, o da pausa

Então: se você já tem conta, segue o baile; se não tem, o passo 1 pode simplesmente não estar disponível agora, e não é erro seu 🙂

Também não tenho como afirmar se aquele crédito de US$ 5 continua valendo pra contas novas depois da pausa, isso não apareceu em comunicado oficial

Passo a passo: instalar a skill do Jev no Claude Code e rodar a primeira tarefa

1. Crie a chave no console e exporte a variável de ambiente

export TYPESAFE_API_KEY="sua-chave-aqui"

O erro comum deste passo: exportar a chave numa aba do terminal e abrir o Claude Code em outra, ou colar a chave direto dentro do código do projeto

O SDK espera ler de TYPESAFE_API_KEY, e chave hardcoded é pedido de encrenca no primeiro commit

2. Adicione o marketplace da TypeSafe no Claude Code

claude plugin marketplace add typesafe-ai/skills

O erro comum aqui: achar que adicionar o marketplace já instalou a skill

Não instalou, isso só registra a fonte dos plugins

3. Instale o plugin

claude plugin install typesafe@typesafe-ai

Repare no formato plugin@marketplace: o nome do plugin é typesafe e o marketplace é typesafe-ai

O erro comum: trocar a ordem ou inventar o nome, tipo typesafe-ai@typesafe

4. Invoque a skill explicitamente dentro do Claude Code

/typesafe:typesafe-ai

E o que essa skill entrega pro agente? Contexto sobre a API da TypeSafe: os três tipos de pergunta, como montar o state, a diferença entre confiança e probabilidade, padrões de arquitetura e uma tabela apontando qual página da documentação atende cada tarefa

O erro comum deste passo é de expectativa: a skill não é um gerador mágico de schema pronto

Ela dá ao agente o mapa certo pra ele te ajudar a escrever o teu, com a doc certa na mão

5. Instale o SDK no projeto

Em Python:

pip install typesafe-sdk
# ou
uv add typesafe-sdk

Em TypeScript/JavaScript:

npm install @typesafe-ai/sdk

No SDK de Python você tem cliente síncrono e assíncrono, TypeSafeClient e AsyncTypeSafeClient, e o identificador padrão do cliente oficial é jev-latest

O erro comum: runtime velho

Python abaixo de 3.10 e Node abaixo de 20 não atendem o requisito, e o erro que aparece nem sempre grita "tua versão é antiga"

6. Recarregue a skill quando ela atualizar

/reload-plugins

Reiniciar o Claude Code também resolve

E pra não ficar fazendo isso na mão, o auto-update liga em /plugin > Marketplaces > typesafe-ai > Enable auto-update

O erro comum: seguir um trecho antigo de contexto por semanas porque a skill nunca foi recarregada

E se eu não uso Claude Code?

Aí a instalação documentada é por npx, escolhendo o agente:

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

Deixe a TYPESAFE_API_KEY configurada no ambiente antes, você vai precisar dela pra chamar a API de qualquer jeito

E pra escrever o schema exato da tua chamada, o caminho é rodar /typesafe:typesafe-ai e pedir ao agente a página de documentação do tipo de pergunta que você escolheu

Qual tarefa escolher para o teste inicial (e qual evitar)

A API tem três tipos de pergunta, as primitivas, e escolher a certa é metade do trabalho

Tipo de pergunta	O que é	Bom primeiro teste
Choice	escolher uma opção de um conjunto definido	classificar/rotear algo em categorias que já existem no teu sistema
Score	nota contra níveis ordenados e descritos	dar severidade ou prioridade com níveis que você descreve
Noul	probabilidade de a resposta ser sim	um sim/não onde a probabilidade importa mais que a frase

A cobertura do lançamento cita casos de uso que dão uma boa noção do formato: processamento de notas fiscais, atendimento ao cliente, análise de incidentes de segurança e monitoramento de agentes de IA

Repare no padrão: classificação, triagem e scoring dentro do software, não conversa

Minha sugestão pro primeiro teste é pegar algo que já existe no teu projeto e cujo resultado você consegue conferir de olho

Uma regra de negócio que hoje é um if gigante cheio de exceção, ou uma triagem que alguém faz na mão

Assim você compara a saída tipada com o que já sabe ser certo, em vez de ficar admirando um JSON bonito sem gabarito

E o que NÃO testar primeiro: qualquer coisa que espere texto gerado

Resumir, redigir, explicar, comentar código, nada disso é trabalho pro Jev, porque ele não devolve stream de texto

Se você pedir prosa, você pediu a ferramenta errada

Essa lógica de casar a tarefa com a ferramenta certa é a mesma de escolher entre /goal e ultracode no dia a dia: o que muda não é a inteligência, é o tipo de pergunta

Como isso conversa com o gasto do Claude Code no dia a dia

Medir quanto uma tarefa no Claude Code realmente consome muda o jeito que você planeja um teste novo

No vídeo abaixo eu mostro um teste rodando o Claude Code com o Manifest na frente, com três provedores configurados (DeepSeek, GPT e modelos Claude), pra ver cada tarefa cair num modelo diferente conforme a complexidade

Duas tarefas bem simples, listar os projetos em árvore e criar um README com título e duas linhas de descrição, deram 16 mensagens de interação no painel

Custo? Menos de um centavo de dólar, com US$ 4 de economia estimada no painel

Quando eu pedi algo mais complexo, criar uma página com componente, foram 36 mensagens

Mais que o dobro, pra uma tarefa que na cabeça da gente parecia "só um pouco maior"

E por que isso importa pro teu primeiro teste com o Jev?

Porque escopo é o que decide se o experimento é barato ou virou uma tarde inteira queimando token

Uma tarefa pequena e fechada custa quase nada e já responde a pergunta que interessa: o formato tipado serve pro meu caso ou não?

Tarefa aberta, daquelas de "refatora esse módulo e já integra o Jev", cobra caro pra te dar uma resposta confusa no fim

No teste do vídeo eu configurei o DeepSeek via API porque esse provider não tem opção de assinatura, e o custo por API me pareceu baixo

Aliás, se você ainda tá decidindo entre DeepSeek ou Claude Code para começar, esse post ajuda a situar antes de montar teu setup

Uma coisa que eu percebi lá e vale aqui também: com várias tools ativas ao mesmo tempo, as confirmações durante o desenvolvimento atrapalham um pouco

No primeiro teste do Jev, mantenha o ambiente enxuto

Conclusão

O critério pro primeiro uso do Jev no Claude Code é simples de decorar: tarefa pequena, tipada e conferível

O caminho é chave no console, TYPESAFE_API_KEY exportada, claude plugin marketplace add typesafe-ai/skills, claude plugin install typesafe@typesafe-ai e /typesafe:typesafe-ai pra trazer o contexto da API pro agente

Depois é escolher entre Choice, Score ou Noul, instalar o SDK e rodar

Próximo passo prático: rode /typesafe:typesafe-ai e peça ao agente a página de documentação do tipo de pergunta que você escolheu, em vez de sair adivinhando o schema

Pra fechar o contexto do estágio do produto: o Jev 1.13 está listado publicamente, entrou em acesso antecipado em 15/09/2026 junto com o anúncio de uma rodada seed de US$ 40 milhões liderada pela DCVC, e a TypeSafe AI foi fundada por Diogo Almeida, ex-OpenAI, que participou da pesquisa de instruction following que levou ao InstructGPT, base do ChatGPT

Só não esqueça da pausa nos novos cadastros desde 22/09/2026, com as contas existentes seguindo normais

É um produto muito novo, e isso significa doc mudando: mantenha o auto-update da skill ligado e desconfie de tutorial (inclusive deste) que envelheceu

Teste com escopo pequeno, confira o resultado de olho, e me conta como foi…

até o próximo post!

Perguntas frequentes

Que tipos de pergunta a API da TypeSafe aceita para o Jev?

São três primitivas: Choice, pra escolher uma opção dentro de um conjunto definido, Score, pra dar uma nota contra níveis ordenados e descritos, e Noul, pra calcular a probabilidade de a resposta ser sim. A skill oficial ajuda o agente a identificar qual das três encaixa na tua tarefa.

Como instalo a skill da TypeSafe se eu não uso o Claude Code?

Fora do Claude Code, a instalação documentada é por npx, escolhendo o agente: npx skills add typesafe-ai/skills --skill typesafe-ai. A skill oficial fica no repositório typesafe-ai/skills, mantido pela própria TypeSafe no GitHub.

Ainda é possível criar uma conta nova no Jev depois da pausa de cadastros?

Em 22/09/2026 a TypeSafe pausou temporariamente os novos cadastros por excesso de demanda, e o comunicado mais recente é justamente esse, da pausa. Contas já existentes seguem funcionando normalmente, mas quem ainda não tem conta pode não conseguir criar uma agora.

Preciso pagar pela resposta que o Jev devolve, já que ele não gera texto?

Não. O preço cobra só a entrada, US$ 0,042 por 1 milhão de tokens, e a saída fica em US$ 0,00 porque não existe stream de texto sendo gerado. É por isso que um teste inicial com poucas mensagens custa bem pouco.

Quais casos de uso fazem sentido pra testar o Jev pela primeira vez?

A cobertura do lançamento citou processamento de notas fiscais, atendimento ao cliente, análise de incidentes de segurança e monitoramento de agentes de IA. São tarefas de classificação, triagem e scoring dentro de software, não conversa aberta com o usuário.

Qual a diferença entre o Jev e um modelo de linguagem que conversa normalmente?

O Jev é o que a TypeSafe chama de modelo ‘System One’: em vez de gerar texto em markdown ou stream de resposta, ele devolve um valor tipado dentro de um schema definido por quem chama, junto com probabilidade e confiança. Ou seja, ele decide, não bate papo.