Jak używać Jev w Claude Code i Codex

Dlaczego Jev nie może być modelem

Claude Code rozmawia z Anthropic Messages API. Codex rozmawia z OpenAI Responses API. Oba pozwolą ci zmienić bazowy URL, ale format transmisji pozostaje ten sam i to jest cały problem: kształt żądania Jev to state plus mapa typowanych questions, a odpowiedź to typowane answers z prawdopodobieństwami dla każdej opcji. Nie ma wiadomości asystenta do wyrenderowania, strumienia tokenów do wypisania, wywołania narzędzia do sparsowania.

TypeSafe dokumentuje dokładnie jeden endpoint ewaluacji, POST /v1/systemone, plus GET /v1/models do listowania aliasów, które twoje konto może wysłać w polu model. jev-latest jest domyślny; wersjonowane identyfikatory, takie jak jev-1.13.0, są akceptowane niezależnie od tego, czy pojawiają się na liście. Nic w dokumentacji nie opisuje powierzchni zgodnej z OpenAI ani Anthropic.

To nie jest luka, której TypeSafe zapomniał wypełnić. Jev jest celowo modelem decyzyjnym: zwraca odpowiedź w schemacie, który zdefiniowałeś, i nie pobiera opłaty za wyjście, bo nie ma wyjścia. CLI do kodowania to program przeciwnego rodzaju — istnieje po to, by pisać tekst. Więc użyteczne pytanie nie brzmi „czy Jev może być modelem", ale „które decyzje wewnątrz agenta powinien przejąć Jev", i są cztery miejsca, w których ta odpowiedź pasuje.

Ścieżka 1: oficjalny skill agenta

To jedyna oficjalnie wspierana integracja, pochodzi od TypeSafe i jest tą, którą należy zainstalować najpierw, bo nie może niczego zepsuć: uczy agenta, nie przechwytuje go.

Claude Code, jako wtyczka:

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

Następnie wywołaj ją bezpośrednio przez /typesafe:typesafe-ai lub po prostu nazwij ją w prompcie — „użyj skilla TypeSafe". Aby zaktualizować:

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

Zrestartuj Claude Code lub uruchom /reload-plugins. Automatyczne aktualizacje można włączyć z /plugin → Marketplaces → typesafe-ai.

Codex i wszystko inne, przez instalator skills:

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

Pyta, do którego agenta zainstalować. Możesz też wkleić własny prompt TypeSafe do agenta i pozwolić mu wykonać instalację, albo ręcznie skopiować katalog skills/typesafe-ai do folderu skills twojego agenta. Repozytorium jest na licencji MIT, manifest wtyczki to typesafe v0.5.7, a sam skill to pojedynczy plik Markdown plus materiały referencyjne.

Warto wiedzieć, co ten skill faktycznie zmienia, bo to nie są tylko ciekawostki o API. Zawiera trzy typy pytań, sposób budowania state, czym jest pewność w przeciwieństwie do prawdopodobieństwa, wzorce architektoniczne oraz tabelę wskazującą właściwą stronę dokumentacji dla każdego zadania — w tym trik, że dodanie .md do dowolnego URL-a dokumentacji zwraca Markdown. Dokumentacja TypeSafe jest jednoznaczna co do trybu błędu, który koryguje: „agenci kodujący wpadają w nawyk jednego pytania na wywołanie częściej niż ludzie". Skill mówi agentowi, by umieszczał wiele pytań w jednym wywołaniu, w tym spekulatywnych, których odpowiedzi mają znaczenie tylko dla niektórych danych wejściowych, i pozwolił twojemu kodowi zdecydować, których odpowiedzi użyć. Ten wzorzec jest powodem, dla którego liczby się zgadzają — własny przykład RODO TypeSafe grupuje 13 pytań w jedno wywołanie i podaje to jako 12,2× taniej i 10,0× szybciej w indeksie cookbooka, 11,5× taniej i 9,6× szybciej w przewodniku budowania, bez zmiany odpowiedzi. Dwie nieco różne liczby dla tego samego testu; traktuj obie jako własny pomiar dostawcy.

Jeden limit, który trzeba uwzględnić w planach: stan i każde pytanie w żądaniu dzielą budżet około 32 000 tokenów, czyli około 150 000 znaków angielskiego tekstu.

Ścieżka 2: umieść Jev na granicach

Tu dzieje się większość rzeczywistego użycia i to wszystko jest praca społeczności. Wzorzec jest wszędzie taki sam: CLI nie jest modyfikowane, modyfikowany jest hak lub proxy, a Jev dokonuje jednego ograniczonego osądu w momencie, w którym model językowy w przeciwnym razie zużyłby tokeny i sekundy.

Gdzie siedzi	Projekt	★	Agenci
Kompakcja sesji	tamaratran/fast-jev-compaction	4 697	Wtyczka Claude Code; zastępuje podsumowanie kompakcji osądami zachowaj/odrzuć dla każdego elementu
Kompakcja sesji	leonaaardob/fast-dev-compaction	3	Wtyczka Codex, port tego samego pomysłu
Wyjście terminala	tamaratran/jev-pruner	122	Claude Code; przycina długie wyjście Bash, zanim zobaczy je model
Proxy kontekstu	compozy/yoshi	18	Claude Code, Codex; Jev ocenia, która historia jest wciąż potrzebna
Brama przed narzędziem	shiftynick/jev-axi	17	Claude Code, Codex; ocenia każde polecenie powłoki pod kątem destrukcyjności, eksfiltracji, RCE i osłabienia bezpieczeństwa, zanim zostanie uruchomione
Brama przed narzędziem	leepokai/jev-guard	12	Claude Code, Codex, Pi, ACP
Hak zatrzymania	valentynkit/jev-belay	13	Claude Code; czyta transkrypt, zanim zaufa twierdzeniu „gotowe"
Ponad workerami Codex	thruwire/foreman	418	Codex; Jev ocenia, czy implementacja jest kompletna, a jej testy wystarczające
Most MCP i ACP	tacticocc/Jevbridge	26	Codex, Claude, Grok, OpenCode
Pakiet wtyczek	shitianfang/jev-use	9	Claude Code, Codex, Pi; instaluje haki, skill routingu i bramę PreToolUse jednym poleceniem
Akcje pulpitu	yikangy873-gif/jev-desktop	31	Codex Computer Use; wybiera spośród akcji pulpitu zamiast pytać model językowy na każdym kroku

Dwa z nich warto przeczytać, zanim cokolwiek zainstalujesz. jev-axi publikuje własny oznaczony zbiór 44 wywołań narzędzi — z których 24 muszą zostać zablokowane lub eskalowane, w tym te zaciemnione base64 — i podaje 44 z 44 zdecydowanych zgodnie z oznaczeniem; dokumentuje też uczciwą granicę, czyli że gdy hak nie może odczytać transkryptu agenta, nic nie robi. jev-belay pokazuje kontrolę kosztów, która sprawia, że cała ta kategoria działa: zużywa jedno wywołanie Jev z czterema pytaniami, i to tylko wtedy, gdy pliki się zmieniły bez przechodzącego sprawdzenia od tego czasu, i zawodzi otwarcie przy każdym błędzie.

Dwie uwagi, o których warto pamiętać. Te repozytoria mają kilka dni — większość powstała między 17 a 20 września 2026 — więc liczby gwiazdek powyżej to uwaga, nie dojrzałość, a poza fast-jev-compaction to małe projekty. Polecenia instalacji różnią się między projektami; przeczytaj README, zamiast zakładać, że polecenie w stylu skilla zadziała.

Punkt wejścia w jednym poleceniu, jeśli chcesz pakiet, a nie pojedynczy hak:

npx -y jev-use install    # podłącza Claude Code, Codex i Pi, cokolwiek znajdzie
npx -y jev-use doctor     # sprawdza okablowanie

jev-use czyta swój klucz z TYPESAFE_API_KEY, OPENROUTER_API_KEY lub AI_GATEWAY_API_KEY, a JEV_BACKEND=mock daje ci próbę na sucho bez klucza, która utrzymuje każdy osąd lokalnie. Jego opublikowane dema warto przeczytać ze względu na kształt korzyści: przebieg kompakcji kontekstu, który ocenił 200 wiadomości w 7 wywołaniach i zmniejszył okno zapełnione w 94% do 44%, oraz brama poleceń powłoki, która odrzuciła niebezpieczne polecenia w około 230 ms przy zerowej liczbie tokenów modelu językowego.

Ścieżka 3: narzędzia MCP

Jeśli chcesz, by Jev był dostępny dla modelu jako wywoływalne narzędzie, a nie jako hak, MCP jest przenośną ścieżką — i jest wyłącznie społecznościowa. Własna dokumentacja TypeSafe nigdy nie wspomina MCP, więc nie ma serwera pierwszej strony do zainstalowania.

Claude Code:

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

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

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

Ten serwer (npm @jkudish/jev-mcp 0.5.0) udostępnia dziesięć narzędzi — jev_verify, jev_screen, jev_find, jev_rerank, jev_classify, jev_decide, jev_compare, jev_extract, jev_review i jev_gate — a jego README podaje około 150 do 500 ms na osąd przy ułamku centa. Kluczowy punkt projektowy to ten, który ma tu znaczenie: to tanie mechaniczne sprawdzenia, które agent pomija, bo model frontier jest zbyt wolny, by uruchamiać je na każdej stronie, twierdzeniu czy liście kandydatów.

Istnieją alternatywy, jeśli chcesz inny kształt: itsmostafa/typesafe-mcp (★128) to serwer i CLI w Go, a Jevbridge mówi w MCP przez stdio z klonu źródłowego, co widać w jego przykładzie dla Codex:

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

Jedno ostrzeżenie dotyczące nazewnictwa: w tej przestrzeni są teraz dwa niepowiązane pakiety npm, @jkudish/jev-mcp i niezakresowy jev-mcp opublikowany z innego repozytorium. Przypnij nazwę z zakresem w swojej konfiguracji, żeby przyszły npx nie rozwiązał się do niewłaściwego.

Ścieżka 4: routing modeli na turę

To najbardziej widoczne użycie Jev w agencie kodującym i jest sprytne: Jev sam niczego nie odpowiada, wybiera, który model powinien. Jedno wywołanie Jev na świeżą turę użytkownika wybiera poziom, a CLI działa dokładnie jak wcześniej.

npm install -g jev-router
echo "JEV_API_KEY=..." > ~/.jev-router.env
jev-claude      # Claude Code, z wybranym Jev Router w /model
jev-codex       # Codex, z wybranym tymczasowym providerem Jev Router

Wymaga Node.js 20.12+ i co najmniej jednego z dwóch CLI. Twoje istniejące claude login lub codex login pozostaje nietknięte — lokalne proxy przekazuje własne nagłówki autoryzacji CLI bez ich czytania, przechowywania czy modyfikowania, i nie jest zaangażowany żaden klucz API Anthropic ani OpenAI. Claude Code jest przekierowywany przez ANTHROPIC_BASE_URL; Codex dostaje tymczasowego niestandardowego providera z requires_openai_auth=true. W obu Jev Router pojawia się w wyborze modelu: wybranie konkretnego modelu wstrzymuje routing, wybranie Jev Router wznawia go. Wywołania narzędzi, uprawnienia, sesje, /compact i /resume zachowują się jak zawsze, bo wciąż należą do CLI.

Tabela poziomów to część, która powinna zainteresować każdego kupującego dostęp do API:

Poziom	Domyślny Claude Code	Domyślny 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

Każdy model w tej tabeli jest dziś w promocji na APIMaster w cenach z szybkiej odpowiedzi, od około 89% do około 96% poniżej ceny katalogowej. Kupowanie trasowanej połowy tutaj i płacenie TypeSafe bezpośrednio za połowę osądzającą to najtańsza wersja tej konfiguracji, jaką widzimy — własne domyślne ustawienia routera wskazują na nasz katalog, a cały sens tego wzorca polega na tym, że większość tur trafia na tani poziom.

Polityka jest ostrożniejsza niż „wybierz najtańszy", a szczegóły są powodem, dla którego nie walczy z tobą: wyraźne żądanie, takie jak „użyj opus", wygrywa; niska pewność nigdy nie obniża poziomu i ogranicza podwyższenia do poziomu balanced; duże rozmowy odmawiają obniżeń, które zmarnowałyby więcej pracy na pamięci podręcznej promptu, niż oszczędzają; niedostępny poziom przechodzi w górę, zamiast po cichu wybierać coś słabszego; a poziom long pozostaje wyłączony, chyba że ustawisz JEV_ALLOW_FABLE=1. Routing zawodzi otwarcie — awaria Jev pozostawia bieżący model na miejscu, zamiast blokować CLI — a każdy launcher przywraca poprzedni domyślny model CLI przy wyjściu.

Istnieje projekt siostrzany o tej samej nazwie, który obejmuje też Grok CLI i opencode. Jego README podaje polecenie npm, które nie jest jeszcze opublikowane, więc użyj klonu repozytorium, jeśli potrzebujesz tych dwóch agentów.

Co zainstalować najpierw

1. Skill, w agencie, którego używasz najczęściej. Jest na MIT, nie zmienia żadnego zachowania, o które nie prosiłeś, i ułatwia każdy późniejszy krok, bo agent przestaje zadawać jedno pytanie na wywołanie.
2. Jeden hak brzegowy, wybrany według tego, co ci przeszkadza. Jeśli długie sesje stają się drogie, kompakcja. Jeśli denerwują cię polecenia powłoki, brama przed narzędziem. Jeśli wciąż dostajesz „gotowe" przy niedokończonej pracy, hak zatrzymania.
3. Routing, tylko jeśli czujesz się już komfortowo z proxy przed swoim CLI. To najbardziej dźwigniowa i najbardziej inwazyjna z czterech.
4. Trzymaj arytmetykę, daty i liczenie we własnym kodzie. Jev dokumentuje je jako zawodne i to samo dotyczy modeli powyżej.

Trzy rzeczy, które ludzie robią źle

• „Wskaż Claude Code na Jev". Nie ma zgodnego endpointu. To pojedynczy najczęstszy błąd w treściach pisanych o Jev w tym tygodniu.
• „Jedno pytanie na wywołanie". Ekonomia modelu decyzyjnego pochodzi z równoległych pytań nad jednym wspólnym stanem. Zadawanie jednego pytania na żądanie wyrzuca większość korzyści i cały argument o opóźnieniu.
• „Pewność to dokładność". Pewność Jev jest skalibrowana, co jest właściwością inną i bardziej użyteczną: mówi ci, które odpowiedzi eskalować. Opublikowane liczby kalibracji omówiliśmy w Jev vs LLM.

FAQ

Czy mogę użyć Jev jako modelu w Claude Code lub Codex? Nie. Jev zwraca typowane decyzje i nie generuje tekstu, a jego API to POST /v1/systemone bez powierzchni w kształcie OpenAI ani Anthropic. Używaj go jako warstwy osądu, nie jako asystenta.

Czy Jev ma endpoint zgodny z OpenAI? Nie według dokumentacji. Referencja API wymienia endpoint ewaluacji i GET /v1/models i nic więcej.

Czy TypeSafe dostarcza serwer MCP? Nie w swojej dokumentacji — MCP nie pojawia się w pakiecie dokumentacji w ogóle. Istnieją serwery społecznościowe, a najbardziej kompletny to @jkudish/jev-mcp.

Co dokładnie instaluje oficjalny skill? W Claude Code wtyczkę o nazwie typesafe z marketplace typesafe-ai, wywoływaną jako /typesafe:typesafe-ai. Wszędzie indziej katalog skilla, który npx skills add typesafe-ai/skills --skill typesafe-ai umieszcza we właściwym folderze dla twojego agenta.

Czy nadal potrzebuję subskrypcji Claude lub ChatGPT? W konfiguracji routingu tak — launcherowie ponownie używają loginu, który CLI już ma, więc subskrypcja Pro, Max, ChatGPT lub SuperGrok działa bez zmian. Bez klucza Jev dostajesz zwykłe CLI bez routingu.

Czy potrzebuję klucza TypeSafe? Do wszystkiego, co wywołuje Jev, tak. Zdobądź go od TypeSafe albo wskaż narzędzia na OpenRouter lub Vercel AI Gateway, które jev-use również obsługuje.

Czy mogę wypróbować to bez klucza? JEV_BACKEND=mock w jev-use uruchamia każdy osąd lokalnie bez wywołania providera, co wystarczy, by zobaczyć, czy haki odpalają się tam, gdzie oczekujesz.

Czy Jev jest dostępny na APIMaster? Jest w trakcie wdrażania, a ta strona zostanie zaktualizowana, gdy integracja będzie aktywna. Modele, do których router Jev kieruje pracę, są już tutaj, w cenach powyżej.

Czy którakolwiek z tych rzeczy zepsuje moje CLI? Skill nie zmienia niczego w sposobie działania CLI. Proxy routingu zawodzi otwarcie i przywraca poprzedni domyślny model przy wyjściu. Haki to jedyne miejsce, gdzie trzeba uważać, a te lepsze jawnie dokumentują swoje zachowanie przy awarii.

Ile kosztuje osąd Jev? $42 za miliard tokenów wejściowych, bez opłaty za wyjście, bo nie ma wyjścia. Jedna decyzja routingu na turę użytkownika albo jeden zestaw pytań na odpalenie haka to cały rachunek.

Którą ścieżkę wybrać dla zespołu? Skill dla wszystkich, jeden hak brzegowy na wspólny ból i routing tylko tam, gdzie rachunek za modele jest wystarczająco duży, by go mierzyć.

Źródła i dalsza lektura

• TypeSafe — referencja API — kształt żądania POST /v1/systemone, typy pytań i odpowiedzi
• TypeSafe — Models — aliasy, wersjonowane identyfikatory, cennik $42/Btok i limity
• TypeSafe — Agent skill — oficjalna wtyczka Claude Code i ścieżka npx skills, z poleceniami aktualizacji
• TypeSafe — How to build with TypeSafe — spekulatywne rozgałęzianie, budżet żądania 32 000 tokenów i porównanie grupowania
• typesafe-ai/skills — źródło skilla, MIT
• gargpratyush/jev-router — proxy routingu, jego tabela poziomów i uwagi o kompatybilności
• jkudish/jev-mcp — zestaw narzędzi MCP
• shiftynick/jev-axi — brama przed narzędziem i jej 44 oznaczone przypadki
• tamaratran/fast-jev-compaction — wtyczka kompakcji

Gwiazdki repozytoriów, polecenia instalacji, wersje pakietów npm i ceny tras APIMaster zostały sprawdzone 20 września 2026. Projekty społecznościowe w tej przestrzeni zmieniają się codziennie; sprawdź repozytorium przed instalacją.

Załóż konto APIMaster, dodaj kredyt pay-as-you-go od $1, utwórz klucz w konsoli i wskaż klienta zgodnego z OpenAI lub Anthropic na https://apimaster.ai/v1. Przewodniki konfiguracji dla dwóch CLI z tego artykułu to Claude Code i Codex.