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

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

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

TypeSafe документує рівно один ендпоінт оцінювання, 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
Хук зупинки	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 (за бажанням)	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-команд — шлюз перед інструментом. Якщо ви постійно отримуєте "готово" на незавершеній роботі — хук зупинки.
3. Маршрутизація, лише якщо ви вже комфортно почуваєтеся з проксі перед вашим CLI. Це найбільш результативний і найбільш інвазивний із чотирьох.
4. Тримайте арифметику, дати й підрахунок у власному коді. Jev документує їх як ненадійні, і те саме стосується наведених вище моделей.

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

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

FAQ

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

Чи має Jev ендпоінт, сумісний з OpenAI? Не за документацією. Довідник API перелічує ендпоінт оцінювання та 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-latest через POST https://apimaster.ai/v1/systemone з ключем APIMaster; це коштує $0.042 за 1M вхідних токенів і $0 за вихідні. Моделі, яким маршрутизатор Jev передає роботу, також тут, за цінами вище.

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

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

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

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

• TypeSafe — довідник API — форма запиту POST /v1/systemone, типи питань і відповіді
• TypeSafe — Models — псевдоніми, версіоновані ID, ціна $42/Btok і ліміти
• TypeSafe — агентний скіл — офіційний плагін Claude Code і шлях через npx skills, з командами оновлення
• TypeSafe — How to build with TypeSafe — спекулятивне розгалуження, бюджет запиту в 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, додайте кредит з оплатою за фактом використання від $1, створіть ключ у консолі і націльте клієнт, сумісний з OpenAI або Anthropic, на https://apimaster.ai/v1. Посібники з налаштування для двох CLI з цієї статті — Claude Code і Codex.