Як використовувати Jev у Claude Code та Codex

Чому Jev не може бути моделлю

Claude Code спілкується з Anthropic Messages API. Codex спілкується з OpenAI Responses API. Обидва дозволять вам змінити base URL, але формат передачі залишається тим самим, і в цьому вся проблема: форма запиту Jev — це state плюс мапа типізованих questions, а його відповідь — це типізовані answers з ймовірностями для кожного варіанта. Немає повідомлення асистента для відображення, немає потоку токенів для друку, немає виклику інструмента для парсингу.

TypeSafe документує рівно один endpoint оцінювання, POST /v1/systemone, плюс GET /v1/models для переліку аліасів, які ваш акаунт може надсилати в полі model. jev-latest — це типовий; версіоновані ID, як-от jev-1.13.0, приймаються незалежно від того, чи з'являються вони в списку. Ніщо в документації не описує поверхню, сумісну з OpenAI або Anthropic.

Це не прогалина, яку TypeSafe забув заповнити. Jev — це модель ухвалення рішень навмисно: він повертає відповідь у межах схеми, яку ви визначили, і не стягує нічого за вивід, бо виводу немає. Кодинговий CLI — це протилежний тип програми: він існує, щоб писати текст. Тож корисне питання не "чи може Jev бути моделлю", а "які рішення всередині агента має ухвалювати Jev", і є чотири місця, де ця відповідь підходить.

Шлях 1: офіційний агентський скіл

Це єдина офіційно підтримувана інтеграція, вона постачається від TypeSafe, і її варто встановити першою, бо вона нічого не може зламати: вона навчає агента, а не перехоплює його.

Claude Code, як плагін:

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

Потім викликайте його напряму через /typesafe:typesafe-ai або просто назвіть його в промпті — "use the TypeSafe skill". Щоб оновити:

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

Перезапустіть Claude Code або виконайте /reload-plugins. Автоматичні оновлення можна увімкнути з /plugin → Marketplaces → typesafe-ai.

Codex і все інше, через інсталятор скілів:

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

Він запитає, в якого агента встановлювати. Ви також можете вставити власний промпт TypeSafe в агента й дозволити йому виконати встановлення, або скопіювати каталог skills/typesafe-ai у теку скілів вашого агента вручну. Репозиторій ліцензовано за MIT, маніфест плагіна — typesafe v0.5.7, а сам скіл — це один Markdown-файл плюс посилання.

Варто знати, що саме змінює скіл, бо це не просто дрібниці про API. Він містить три типи питань, як побудувати state, що означає впевненість на противагу ймовірності, архітектурні патерни та таблицю, що вказує на потрібну сторінку документації для кожного завдання — включно з трюком, що додавання .md до будь-якого URL документації повертає Markdown. Документація TypeSafe прямо вказує на режим відмови, який він виправляє: "кодингові агенти частіше за людей потрапляють у звичку ставити одне питання на виклик". Скіл каже агенту складати багато питань в один виклик, включно зі спекулятивними, чиї відповіді важливі лише для деяких входів, і дозволяти вашому коду вирішувати, які відповіді використовувати. Саме цей патерн змушує числа сходитися — власний приклад TypeSafe щодо GDPR об'єднує 13 питань в один виклик і повідомляє про це як на 12.2× дешевше та 10.0× швидше в індексі кукбука, на 11.5× дешевше та 9.6× швидше в посібнику зі створення, без зміни відповідей. Дві трохи різні цифри для одного й того самого тесту; вважайте обидві власним вимірюванням постачальника.

Одне обмеження, яке варто врахувати: стан і кожне питання в запиті мають спільний бюджет приблизно 32,000 токенів, близько 150,000 символів англійської.

Шлях 2: поставте Jev на межах

Саме тут зосереджена більшість реального використання, і це повністю робота спільноти. Патерн скрізь однаковий: CLI не змінюється, змінюється хук або проксі, і Jev ухвалює одне обмежене судження в момент, коли мовна модель інакше витратила б токени й секунди.

Де він сидить	Проєкт	★	Агенти
Компакція сесії	tamaratran/fast-jev-compaction	4,697	Плагін Claude Code; замінює підсумок компакції судженнями keep/drop для кожного елемента
Компакція сесії	leonaaardob/fast-dev-compaction	3	Плагін Codex, порт тієї самої ідеї
Вивід термінала	tamaratran/jev-pruner	122	Claude Code; обрізає довгий вивід Bash, перш ніж його побачить модель
Проксі контексту	compozy/yoshi	18	Claude Code, Codex; Jev вирішує, яка історія ще потрібна
Шлюз перед інструментом	shiftynick/jev-axi	17	Claude Code, Codex; оцінює кожну shell-команду на деструктивність, ексфільтрацію, RCE та послаблення безпеки перед запуском
Шлюз перед інструментом	leepokai/jev-guard	12	Claude Code, Codex, Pi, ACP
Stop-хук	valentynkit/jev-belay	13	Claude Code; читає транскрипт, перш ніж довіряти заяві "готово"
Над воркерами Codex	thruwire/foreman	418	Codex; Jev вирішує, чи завершена реалізація і чи достатньо її тестів
Міст MCP і ACP	tacticocc/Jevbridge	26	Codex, Claude, Grok, OpenCode
Набір плагінів	shitianfang/jev-use	9	Claude Code, Codex, Pi; встановлює хуки, скіл маршрутизації та шлюз PreToolUse однією командою
Дії на робочому столі	yikangy873-gif/jev-desktop	31	Codex Computer Use; обирає серед дій на робочому столі замість того, щоб питати мовну модель на кожному кроці

Два з них варто прочитати, перш ніж щось встановлювати. jev-axi публікує власний розмічений набір із 44 викликів інструментів — 24 з яких мають бути заблоковані або ескаловані, включно з обфускованими через base64 — і повідомляє про 44 з 44 вирішених згідно з розміткою; він також документує чесний крайній випадок: коли хук не може прочитати транскрипт агента, він нічого не робить. jev-belay показує контроль витрат, який змушує працювати всю цю категорію: він витрачає один виклик Jev із чотирма питаннями, і лише коли файли змінилися без жодної успішної перевірки відтоді, і він fail-open за будь-якої помилки.

Два застереження, які варто тримати в голові. Ці репозиторії з'явилися днями — більшість створено між 17 і 20 вересня 2026 року — тож зірки вище — це увага, а не зрілість, і, крім fast-jev-compaction, це невеликі проєкти. І команди встановлення різняться залежно від проєкту; читайте README, а не припускайте, що команда у стилі скіла спрацює.

Точка входу однією командою, якщо ви хочете набір, а не один хук:

npx -y jev-use install    # wires Claude Code, Codex and Pi, whichever it finds
npx -y jev-use doctor     # checks the wiring

jev-use читає свій ключ з TYPESAFE_API_KEY, OPENROUTER_API_KEY або AI_GATEWAY_API_KEY, а JEV_BACKEND=mock дає вам сухий прогін без ключа, який тримає кожне судження локально. Його опубліковані демо варті прочитання заради форми виграшів: прогін компакції контексту, який оцінив 200 повідомлень за 7 викликів і знизив вікно, заповнене на 94%, до 44%, та шлюз shell-команд, який відхиляв небезпечні команди приблизно за 230 мс з нульовими токенами мовної моделі.

Шлях 3: MCP-інструменти

Якщо ви хочете, щоб Jev був доступний моделі як викликаний інструмент, а не як хук, MCP — це портативний шлях, і він лише від спільноти. Власна документація TypeSafe взагалі не згадує MCP, тож немає сервера від першої сторони для встановлення.

Claude Code:

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

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

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

Цей сервер (npm @jkudish/jev-mcp 0.5.0) надає десять інструментів — jev_verify, jev_screen, jev_find, jev_rerank, jev_classify, jev_decide, jev_compare, jev_extract, jev_review та jev_gate — і його README цитує приблизно 150 до 500 мс на судження за частку цента. Ключова ідея дизайну — саме та, що тут важлива: це дешеві механічні перевірки, які агент пропускає, бо frontier-модель надто повільна, щоб запускати їх на кожній сторінці, твердженні чи списку кандидатів.

Існують альтернативи, якщо ви хочете іншу форму: itsmostafa/typesafe-mcp (★128) — це сервер і CLI на Go, а Jevbridge говорить MCP через stdio з клону джерела, саме так написано його приклад для Codex:

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

Одне попередження щодо назв: тепер у цьому просторі є два непов'язані npm-пакети, @jkudish/jev-mcp і нескоупований jev-mcp, опублікований з іншого репозиторію. Закріпіть скоуповану назву у своєму конфігу, щоб майбутній npx не розв'язався в неправильний.

Шлях 4: маршрутизація моделей на кожен хід

Це найпомітніше використання Jev у кодинговому агенті, і воно розумне: Jev сам ні на що не відповідає, він обирає, яка модель має відповідати. Один виклик Jev на кожен новий хід користувача обирає рівень, і CLI працює точно як раніше.

npm install -g jev-router
echo "JEV_API_KEY=..." > ~/.jev-router.env
jev-claude      # Claude Code, with Jev Router selected in /model
jev-codex       # Codex, with a temporary Jev Router provider selected

Потрібен Node.js 20.12+ і принаймні один із двох CLI. Ваш наявний claude login або codex login не чіпається — loopback-проксі пересилає власні заголовки авторизації CLI, не читаючи, не зберігаючи й не змінюючи їх, і жоден API-ключ Anthropic чи OpenAI не задіяний. Claude Code перенаправляється через ANTHROPIC_BASE_URL; Codex отримує тимчасового кастомного провайдера з requires_openai_auth=true. В обох Jev Router з'являється у виборі моделі: вибір конкретної моделі призупиняє маршрутизацію, вибір Jev Router відновлює її. Виклики інструментів, дозволи, сесії, /compact і /resume поводяться як завжди, бо вони все ще належать CLI.

Таблиця рівнів — це те, що має зацікавити кожного, хто купує доступ до API:

Рівень	Типово для Claude Code	Типово для Codex
Fast	Haiku	gpt-5.6-luna
Balanced	Sonnet	gpt-5.6-terra
Strong	Opus	gpt-5.6-sol
Long	Fable (opt-in)	gpt-6-astra

Кожна модель у цій таблиці сьогодні в продажу на APIMaster за цінами зі швидкої відповіді, від приблизно 89% до приблизно 96% нижче за прайс-лист. Купити маршрутизовану половину тут і платити TypeSafe напряму за половину судження — це найдешевша версія цього налаштування, яку ми бачимо — власні типові налаштування роутера вказують на наш каталог, і вся суть патерну в тому, що більшість ходів припадає на дешевий рівень.

Політика обережніша за "вибирай найдешевше", і деталі — причина, чому вона не чинить вам опір: явний запит, як-от "use opus", перемагає; низька впевненість ніколи не знижує рівень і обмежує підвищення рівнем balanced; великі розмови відмовляються від знижень, які змарнували б більше роботи з кешем промптів, ніж заощадили; недоступний рівень крокує вгору, а не обирає мовчки щось слабше; і довгий рівень залишається вимкненим, якщо ви не встановите JEV_ALLOW_FABLE=1. Маршрутизація fail-open — збій Jev залишає поточну модель на місці, а не блокує CLI — і кожен лаунчер відновлює попередню типову модель CLI при виході.

Є супутній проєкт із тією самою назвою, який також покриває Grok CLI та opencode. Його README дає npm-команду, яка ще не опублікована, тож використовуйте клон репозиторію, якщо вам потрібні ці два агенти.

Що встановлювати першим

1. Скіл, у тому агенті, яким ви користуєтеся найбільше. Він під MIT, він не змінює жодної поведінки, якої ви не просили, і він робить кожен наступний крок легшим, бо агент перестає ставити одне питання на виклик.
2. Один граничний хук, обраний за тим, що вас дратує. Якщо довгі сесії стають дорогими — компакція. Якщо ви нервово ставитеся до shell-команд — шлюз перед інструментом. Якщо ви постійно отримуєте "готово" на незавершеній роботі — stop-хук.
3. Маршрутизація, лише якщо ви вже комфортно почуваєтеся з проксі перед вашим CLI. Це найбільш результативний і найбільш інвазивний із чотирьох.
4. Тримайте арифметику, дати й підрахунок у власному коді. Jev документує їх як ненадійні, і те саме стосується моделей вище.

Три речі, у яких люди помиляються

• "Націльте Claude Code на Jev." Сумісного endpoint'а немає. Це найпоширеніша помилка в контенті, написаному про Jev цього тижня.
• "Одне питання на виклик." Економія моделі ухвалення рішень походить від паралельних питань над одним спільним станом. Ставити одне питання на запит відкидає більшість переваги й усю аргументацію щодо затримки.
• "Впевненість — це точність." Впевненість Jev калібрована, що є іншою й кориснішою властивістю: вона каже вам, які відповіді ескалувати. Ми розібрали опубліковані числа калібрування в Jev vs LLMs.

FAQ

Чи можу я використовувати Jev як модель у Claude Code чи Codex? Ні. Jev повертає типізовані рішення й не генерує тексту, а його API — це POST /v1/systemone без поверхні у форматі OpenAI чи Anthropic. Використовуйте його як шар суджень, а не як асистента.

Чи має Jev endpoint, сумісний з OpenAI? Як задокументовано — ні. Довідник API перелічує endpoint оцінювання та GET /v1/models, і більше нічого.

Чи постачає TypeSafe MCP-сервер? Не у своїй документації — MCP взагалі не з'являється в наборі документації. Сервери від спільноти існують, і найповніший із них — @jkudish/jev-mcp.

Що саме встановлює офіційний скіл? У Claude Code — плагін із назвою typesafe з маркетплейсу typesafe-ai, який викликається як /typesafe:typesafe-ai. Усюди інде — каталог скіла, який npx skills add typesafe-ai/skills --skill typesafe-ai розміщує в потрібній теці для вашого агента.

Чи все ще потрібна моя підписка Claude чи ChatGPT? Для налаштування маршрутизації — так: лаунчери повторно використовують логін, який CLI вже має, тож підписка Pro, Max, ChatGPT чи SuperGrok працює як є. Без ключа Jev ви отримуєте звичайний CLI без маршрутизації.

Чи потрібен мені ключ TypeSafe? Для всього, що викликає Jev, — так. Отримайте його від TypeSafe або націльте інструменти на OpenRouter чи Vercel AI Gateway, які jev-use також підтримує.

Чи можу я спробувати без ключа? JEV_BACKEND=mock у jev-use виконує кожне судження локально без виклику провайдера, чого достатньо, щоб побачити, чи спрацьовують хуки там, де ви очікуєте.

Чи доступний Jev на APIMaster? Він у процесі онбордингу, і цю сторінку буде оновлено, коли інтеграція запрацює. Моделі, яким роутер Jev передає роботу, вже тут, за цінами вище.

Чи щось із цього зламає мій CLI? Скіл нічого не змінює в тому, як працює CLI. Проксі маршрутизації fail-open і відновлює вашу попередню типову модель при виході. Хуки — єдине місце, де варто бути обережним, і кращі з них явно документують свою fail-open поведінку.

Скільки коштує одне судження Jev? $42 за мільярд вхідних токенів, без плати за вивід, бо виводу немає. Одне рішення про маршрутизацію на хід користувача або один набір питань на спрацювання хука — це весь рахунок.

Який шлях обрати для команди? Скіл для всіх, один граничний хук для спільного болю та маршрутизація лише там, де рахунок за моделі достатньо великий, щоб його вимірювати.

Джерела та подальше читання

• TypeSafe — довідник API — форма запиту POST /v1/systemone, типи питань і відповіді
• TypeSafe — Models — аліаси, версіоновані ID, ціна $42/Btok та ліміти
• TypeSafe — Agent skill — офіційний плагін Claude Code і шлях npx skills, з командами оновлення
• TypeSafe — How to build with TypeSafe — спекулятивний fan-out, бюджет запиту в 32,000 токенів і порівняння батчингу
• typesafe-ai/skills — джерело скіла, MIT
• gargpratyush/jev-router — проксі маршрутизації, його таблиця рівнів і нотатки про сумісність
• jkudish/jev-mcp — набір MCP-інструментів
• shiftynick/jev-axi — шлюз перед інструментом і його 44 розмічені випадки
• tamaratran/fast-jev-compaction — плагін компакції

Зірки репозиторіїв, команди встановлення, версії npm-пакетів і ціни маршрутів APIMaster було перевірено 20 вересня 2026 року. Проєкти спільноти в цьому просторі рухаються щодня; перевірте репозиторій, перш ніж встановлювати.

Створіть акаунт APIMaster, додайте кредит за моделлю pay-as-you-go від $1, створіть ключ у консолі і націльте клієнт, сумісний з OpenAI або Anthropic, на https://apimaster.ai/v1. Посібники з налаштування для двох CLI з цієї статті — Claude Code та Codex.