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 na tym polega 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, nie ma strumienia tokenów do wypisania, nie ma 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 modelem decyzyjnym celowo: zwraca odpowiedź w schemacie, który zdefiniowałeś, i nie pobiera opłaty za wyjście, bo wyjścia nie ma. 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", lecz „które decyzje wewnątrz agenta powinien przejąć Jev", a są cztery miejsca, w których ta odpowiedź pasuje.

Ścieżka 1: oficjalny skill agenta

To jedyna oficjalnie wspierana integracja, dostarcza ją TypeSafe, i to ją 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 albo 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ć w /plugin → Marketplaces → typesafe-ai.

Codex i wszystko inne, przez instalator skills:

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

Zapyta, do którego agenta zainstalować. Możesz też wkleić własny prompt TypeSafe do agenta i pozwolić mu przeprowadzić instalację albo skopiować katalog skills/typesafe-ai do folderu skills swojego agenta ręcznie. 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, co oznacza 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 pytania spekulatywne, których odpowiedzi mają znaczenie tylko dla niektórych danych wejściowych, i pozwalał 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 w odpowiedziach. 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 praca społeczności. Wzorzec jest wszędzie taki sam: CLI nie jest modyfikowane, modyfikowany jest hook lub proxy, a Jev dokonuje jednego ograniczonego osądu w momencie, w którym model językowy w innym wypadku 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 jeszcze 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
Hook 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 hooki, 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, że 44 z 44 zostały rozstrzygnięte zgodnie z oznaczeniem; dokumentuje też uczciwą granicę, czyli to, że gdy hook 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, a przy każdym błędzie zawodzi w trybie otwartym.

Dwie zastrzeżenia, które warto zapamię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 jednym poleceniem, jeśli chcesz pakiet, a nie pojedynczy hook:

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 próbę na sucho bez klucza, która utrzymuje każdy osąd lokalnie. Warto przeczytać jego opublikowane dema ze względu na kształt zysków: przebieg kompakcji kontekstu, który ocenił 200 wiadomości w 7 wywołaniach i zredukował 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 hook, 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 first-party 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 ze sklonowanego źródła, 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 oraz bez zakresu jev-mcp opublikowany z innego repozytorium. Przypnij nazwę z zakresem w swojej konfiguracji, żeby przyszłe npx nie rozwiązało się do niewłaściwego.

Ścieżka 4: routing modeli na poziomie tury

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 Jev Router wybranym w /model
jev-codex       # Codex, z tymczasowym providerem Jev Router wybranym

Wymaga Node.js 20.12+ i co najmniej jednego z tych 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, a żaden klucz API Anthropic ani OpenAI nie jest zaangażowany. 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 nadal 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 z 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ą: jawne żą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 nad pamięcią podręczną 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 w trybie otwartym — 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 również CLI Grok i opencode. Jego README podaje polecenie npm, które nie zostało 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 hook 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 ciągle dostajesz „gotowe" przy niedokończonej pracy — hook zatrzymania.
3. Routing, tylko jeśli czujesz się już swobodnie z proxy przed swoim CLI. To najbardziej dźwigniowa i najbardziej inwazyjna z czterech ścieżek.
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 bierze się z równoległych pytań nad jednym wspólnym stanem. Zadawanie jednego pytania na żądanie wyrzuca większość przewagi i cały argument o opóźnieniu.
• „Pewność to dokładność". Pewność Jev jest skalibrowana, co jest inną i bardziej użyteczną właściwością: 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. Serwery społecznościowe istnieją, a najkompletniejszy 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 z routingiem tak — launchery ponownie używają logowania, które 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 skieruj 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 hooki odpalają się tam, gdzie oczekujesz.

Czy Jev jest dostępny na APIMaster? Tak. Wywołaj jev-latest przez POST https://apimaster.ai/v1/systemone z kluczem APIMaster; kosztuje $0,042 za 1M tokenów wejściowych i $0 za wyjście. Modele, do których router Jev kieruje pracę, też tu są, 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 w trybie otwartym i przywraca poprzedni domyślny model przy wyjściu. Hooki to jedyne miejsce, gdzie trzeba uważać, a te lepsze jawnie dokumentują swoje zachowanie w trybie otwartym.

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

Którą ścieżkę wybrać dla zespołu? Skill dla wszystkich, jeden hook 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 — Modele — aliasy, wersjonowane identyfikatory, cena $42/Btok i limity
• TypeSafe — Skill agenta — oficjalna wtyczka Claude Code i ścieżka npx skills, z poleceniami aktualizacji
• TypeSafe — Jak budować z 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 skieruj klienta zgodnego z OpenAI lub Anthropic na https://apimaster.ai/v1. Poradniki konfiguracji dla obu CLI z tego artykułu to Claude Code i Codex.