Cách dùng Jev trong Claude Code và Codex

Vì sao Jev không thể là model

Claude Code nói chuyện với Anthropic Messages API. Codex nói chuyện với OpenAI Responses API. Cả hai đều cho phép bạn đổi base URL, nhưng định dạng truyền tải vẫn giữ nguyên, và đó chính là toàn bộ vấn đề: dạng request của Jev là một state cộng với một map các questions có kiểu, và phản hồi của nó là các answers có kiểu kèm xác suất cho từng lựa chọn. Không có message của assistant để render, không có luồng token để in, không có tool call để phân tích.

TypeSafe tài liệu hóa đúng một endpoint đánh giá, POST /v1/systemone, cộng với GET /v1/models để liệt kê các alias mà tài khoản của bạn có thể gửi trong trường model. jev-latest là mặc định; các ID có phiên bản như jev-1.13.0 được chấp nhận dù có xuất hiện trong danh sách hay không. Không có gì trong tài liệu mô tả một bề mặt tương thích OpenAI hay Anthropic.

Đó không phải là lỗ hổng mà TypeSafe quên lấp. Jev là một decision model một cách có chủ đích: nó trả về câu trả lời trong một schema bạn đã định nghĩa, và nó không tính phí output vì không có output. Một CLI lập trình là loại chương trình ngược lại — nó tồn tại để viết văn bản. Vậy nên câu hỏi hữu ích không phải là "Jev có thể là model không", mà là "những quyết định nào bên trong agent nên do Jev đảm nhiệm", và có bốn chỗ mà câu trả lời đó phù hợp.

Hướng 1: agent skill chính thức

Đây là tích hợp chính thức duy nhất được hỗ trợ, nó do TypeSafe phát hành, và là thứ nên cài đầu tiên vì nó không thể làm hỏng gì: nó dạy agent, chứ không chặn agent.

Claude Code, dưới dạng plugin:

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

Sau đó gọi trực tiếp bằng /typesafe:typesafe-ai, hoặc chỉ cần nêu tên trong prompt — "use the TypeSafe skill". Để cập nhật:

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

Khởi động lại Claude Code hoặc chạy /reload-plugins. Có thể bật cập nhật tự động từ /plugin → Marketplaces → typesafe-ai.

Codex và mọi thứ khác, thông qua trình cài đặt skills:

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

Nó sẽ hỏi cài vào agent nào. Bạn cũng có thể dán prompt của chính TypeSafe vào agent và để nó tự cài đặt, hoặc sao chép thư mục skills/typesafe-ai vào thư mục skills của agent bằng tay. Repository có giấy phép MIT, manifest plugin là typesafe v0.5.7, và bản thân skill chỉ là một file Markdown cộng với các tài liệu tham chiếu.

Điều mà skill thực sự thay đổi đáng để biết, vì nó không chỉ là kiến thức vặt về API. Nó mang theo ba loại câu hỏi, cách xây dựng state, ý nghĩa của confidence so với probability, các mẫu kiến trúc, và một bảng chỉ đến trang tài liệu đúng cho từng tác vụ — bao gồm mẹo rằng thêm .md vào bất kỳ URL tài liệu nào sẽ trả về Markdown. Tài liệu của TypeSafe nói rõ về chế độ thất bại mà nó đang sửa chữa: "coding agents rơi vào thói quen hỏi một câu mỗi lần gọi nhiều hơn con người." Skill bảo agent đặt nhiều câu hỏi trong một lần gọi, kể cả những câu mang tính phỏng đoán mà câu trả lời chỉ quan trọng với một số đầu vào, và để code của bạn quyết định dùng câu trả lời nào. Mẫu đó chính là lý do các con số hợp lý — ví dụ GDPR của chính TypeSafe gộp 13 câu hỏi vào một lần gọi và báo cáo rằng nó rẻ hơn 12,2× và nhanh hơn 10,0× trong mục lục cookbook, rẻ hơn 11,5× và nhanh hơn 9,6× trong hướng dẫn xây dựng, mà không thay đổi câu trả lời. Hai con số hơi khác nhau cho cùng một bài kiểm tra; hãy coi cả hai là đo lường của chính nhà cung cấp.

Một giới hạn cần lường trước: state và mọi câu hỏi trong một request chia sẻ ngân sách khoảng 32.000 token, tương đương khoảng 150.000 ký tự tiếng Anh.

Hướng 2: đặt Jev ở các ranh giới

Đây là nơi phần lớn việc sử dụng thực tế diễn ra, và tất cả đều là công việc cộng đồng. Mẫu giống nhau ở mọi nơi: CLI không bị sửa đổi, một hook hoặc proxy thì có, và Jev đưa ra một phán đoán có giới hạn tại thời điểm mà nếu không thì một language model sẽ tiêu tốn token và giây.

Vị trí	Dự án	★	Agent
Compaction phiên	tamaratran/fast-jev-compaction	4.697	Plugin Claude Code; thay thế bản tóm tắt compaction bằng các phán đoán giữ/bỏ theo từng mục
Compaction phiên	leonaaardob/fast-dev-compaction	3	Plugin Codex, một bản chuyển thể của cùng ý tưởng
Output terminal	tamaratran/jev-pruner	122	Claude Code; cắt bớt output Bash dài trước khi model thấy
Proxy ngữ cảnh	compozy/yoshi	18	Claude Code, Codex; Jev phán đoán lịch sử nào vẫn còn cần thiết
Cổng trước công cụ	shiftynick/jev-axi	17	Claude Code, Codex; chấm điểm từng lệnh shell theo mức độ phá hoại, rò rỉ dữ liệu, RCE và làm suy yếu bảo mật trước khi nó chạy
Cổng trước công cụ	leepokai/jev-guard	12	Claude Code, Codex, Pi, ACP
Hook dừng	valentynkit/jev-belay	13	Claude Code; đọc transcript trước khi tin vào một tuyên bố "done"
Trên các worker Codex	thruwire/foreman	418	Codex; Jev phán đoán liệu một triển khai đã hoàn tất và các test đã đủ chưa
Cầu nối MCP và ACP	tacticocc/Jevbridge	26	Codex, Claude, Grok, OpenCode
Gói plugin	shitianfang/jev-use	9	Claude Code, Codex, Pi; cài hook, một skill định tuyến và cổng PreToolUse trong một lệnh
Hành động desktop	yikangy873-gif/jev-desktop	31	Codex Computer Use; chọn trong các hành động desktop thay vì hỏi language model từng bước

Hai trong số này đáng đọc trước khi bạn cài bất cứ thứ gì. jev-axi công bố bộ dữ liệu gán nhãn của riêng nó gồm 44 lệnh gọi công cụ — 24 trong đó phải bị chặn hoặc leo thang, bao gồm cả những lệnh bị làm mờ bằng base64 — và báo cáo 44 trên 44 được quyết định đúng như gán nhãn; nó cũng ghi lại ranh giới trung thực, đó là khi hook không đọc được transcript của agent thì nó không làm gì. jev-belay cho thấy cách kiểm soát chi phí khiến cả hạng mục này vận hành được: nó tiêu một lệnh gọi Jev bốn câu hỏi, và chỉ khi có file thay đổi mà không có kiểm tra nào đạt kể từ đó, và nó fail open với mọi lỗi.

Hai lưu ý bạn nên ghi nhớ. Các repository này mới chỉ vài ngày tuổi — hầu hết được tạo từ ngày 17 đến ngày 20 tháng 9, 2026 — nên số star ở trên là sự chú ý, không phải độ chín, và ngoại trừ fast-jev-compaction, chúng là những dự án nhỏ. Và lệnh cài đặt khác nhau theo từng dự án; hãy đọc README thay vì giả định lệnh kiểu skill hoạt động.

Điểm vào một lệnh, nếu bạn muốn cả gói thay vì một hook đơn lẻ:

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

jev-use đọc key từ TYPESAFE_API_KEY, OPENROUTER_API_KEY hoặc AI_GATEWAY_API_KEY, và JEV_BACKEND=mock cho bạn một lần chạy thử không cần key, giữ mọi phán đoán ở cục bộ. Các demo được công bố của nó đáng đọc để thấy hình dạng của các thắng lợi: một lần chạy compaction ngữ cảnh phán đoán 200 message trong 7 lần gọi và đưa cửa sổ đầy 94% xuống còn 44%, và một cổng lệnh shell từ chối các lệnh nguy hiểm trong khoảng 230 ms với không token language model nào.

Hướng 3: công cụ MCP

Nếu bạn muốn Jev sẵn có cho model như một công cụ có thể gọi thay vì một hook, MCP là hướng di động — và nó chỉ có từ cộng đồng. Tài liệu của chính TypeSafe không bao giờ nhắc đến MCP, nên không có server chính hãng nào để cài.

Claude Code:

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

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

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

Server đó (npm @jkudish/jev-mcp 0.5.0) cung cấp mười công cụ — jev_verify, jev_screen, jev_find, jev_rerank, jev_classify, jev_decide, jev_compare, jev_extract, jev_review và jev_gate — và README của nó dẫn khoảng 150 đến 500 ms mỗi phán đoán với chi phí chỉ một phần nhỏ của một xu. Điểm thiết kế chính là điều quan trọng ở đây: đây là những kiểm tra máy móc rẻ tiền mà agent bỏ qua vì một frontier model quá chậm để chạy chúng trên mọi trang, tuyên bố hay danh sách ứng viên.

Có các lựa chọn thay thế nếu bạn muốn một hình dạng khác: itsmostafa/typesafe-mcp (★128) là một server và CLI viết bằng Go, và Jevbridge nói MCP qua stdio từ một bản clone mã nguồn, đó là cách ví dụ Codex của nó được viết:

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

Một cảnh báo về tên gọi: hiện có hai gói npm không liên quan trong không gian này, @jkudish/jev-mcp và một gói jev-mcp không có scope được phát hành từ một repository khác. Hãy ghim tên có scope trong cấu hình để một lệnh npx trong tương lai không phân giải nhầm sang gói sai.

Hướng 4: định tuyến model theo từng lượt

Đây là cách dùng Jev phổ biến nhất trong một coding agent, và nó khéo léo: Jev không tự trả lời gì cả, nó chọn model nào nên trả lời. Một lệnh gọi Jev mỗi lượt người dùng mới chọn một bậc, và CLI chạy y như trước.

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

Yêu cầu Node.js 20.12+ và ít nhất một trong hai CLI. claude login hoặc codex login hiện có của bạn không bị đụng đến — proxy loopback chuyển tiếp các header authorization của chính CLI mà không đọc, lưu hay sửa đổi chúng, và không có API key Anthropic hay OpenAI nào liên quan. Claude Code được chuyển hướng qua ANTHROPIC_BASE_URL; Codex nhận một provider tùy chỉnh tạm thời với requires_openai_auth=true. Ở cả hai, Jev Router xuất hiện trong trình chọn model: chọn một model cụ thể sẽ tạm dừng định tuyến, chọn Jev Router sẽ tiếp tục. Các tool call, quyền, phiên, /compact và /resume hoạt động như mọi khi, vì chúng vẫn là của chính CLI.

Bảng bậc là phần đáng quan tâm với bất kỳ ai mua quyền truy cập API:

Bậc	Mặc định Claude Code	Mặc định Codex
Fast	Haiku	gpt-5.6-luna
Balanced	Sonnet	gpt-5.6-terra
Strong	Opus	gpt-5.6-sol
Long	Fable (tùy chọn bật)	gpt-6-astra

Mọi model trong bảng đó đều đang được bán trên APIMaster hôm nay với mức giá trong phần trả lời nhanh, từ khoảng 89% đến khoảng 96% thấp hơn giá niêm yết. Mua nửa được định tuyến ở đây và trả trực tiếp cho TypeSafe phần phán đoán là phiên bản rẻ nhất của thiết lập này mà chúng tôi thấy — các mặc định của chính router trỏ đến catalog của chúng tôi, và toàn bộ điểm của mẫu này là hầu hết các lượt đều rơi vào bậc rẻ.

Chính sách cẩn thận hơn "chọn cái rẻ nhất", và các chi tiết là lý do nó không chống lại bạn: một yêu cầu rõ ràng như "use opus" sẽ thắng; confidence thấp không bao giờ hạ bậc và giới hạn nâng bậc ở bậc balanced; các cuộc hội thoại lớn từ chối hạ bậc khi việc đó sẽ lãng phí nhiều công việc prompt-cache hơn mức tiết kiệm được; một bậc không khả dụng sẽ bước lên trên thay vì âm thầm chọn thứ yếu hơn; và bậc long vẫn tắt trừ khi bạn đặt JEV_ALLOW_FABLE=1. Định tuyến là fail-open — một lỗi Jev để nguyên model hiện tại thay vì chặn CLI — và mỗi trình khởi chạy khôi phục mặc định trước đó của CLI khi thoát.

Có một dự án anh em cùng tên cũng bao phủ Grok CLI và opencode. README của nó đưa ra một lệnh npm chưa được phát hành, nên hãy dùng bản clone repository nếu bạn cần hai agent đó.

Nên cài gì trước

1. Skill, trong agent bạn dùng nhiều nhất. Nó là MIT, nó không thay đổi hành vi nào bạn không yêu cầu, và nó khiến mọi bước sau dễ hơn vì agent ngừng hỏi một câu mỗi lần gọi.
2. Một hook ranh giới, chọn theo thứ làm bạn khó chịu. Nếu các phiên dài trở nên tốn kém, chọn compaction. Nếu bạn lo lắng về các lệnh shell, chọn cổng trước công cụ. Nếu bạn cứ nhận "done" cho công việc chưa xong, chọn hook dừng.
3. Định tuyến, chỉ khi bạn đã thoải mái với một proxy trước CLI của mình. Đây là hướng có đòn bẩy cao nhất và xâm nhập nhiều nhất trong bốn hướng.
4. Giữ số học, ngày tháng và đếm trong code của chính bạn. Jev tài liệu hóa những việc đó là không đáng tin, và điều tương tự cũng đúng với các model ở trên.

Ba điều người ta hiểu sai

• "Trỏ Claude Code vào Jev." Không có endpoint tương thích. Đây là lỗi phổ biến nhất trong các nội dung viết về Jev tuần này.
• "Một câu hỏi mỗi lần gọi." Tính kinh tế của một decision model đến từ các câu hỏi song song trên một state chung. Hỏi một câu mỗi request ném đi phần lớn lợi thế và toàn bộ lập luận về độ trễ.
• "Confidence là độ chính xác." Confidence của Jev được hiệu chỉnh, đó là một thuộc tính khác và hữu ích hơn: nó cho bạn biết câu trả lời nào cần leo thang. Chúng tôi đã đi qua các con số hiệu chỉnh được công bố trong Jev vs LLMs.

FAQ

Tôi có thể dùng Jev làm model trong Claude Code hay Codex không? Không. Jev trả về các quyết định có kiểu và không sinh văn bản, và API của nó là POST /v1/systemone không có bề mặt dạng OpenAI hay Anthropic. Hãy dùng nó như một lớp phán đoán, không phải như assistant.

Jev có endpoint tương thích OpenAI không? Không như được tài liệu hóa. Tham chiếu API liệt kê endpoint đánh giá và GET /v1/models, và không gì khác.

TypeSafe có phát hành MCP server không? Không trong tài liệu của nó — MCP hoàn toàn không xuất hiện trong gói tài liệu. Các server cộng đồng có tồn tại, và cái đầy đủ nhất là @jkudish/jev-mcp.

Skill chính thức cài đặt chính xác những gì? Trong Claude Code, một plugin tên typesafe từ marketplace typesafe-ai, được gọi bằng /typesafe:typesafe-ai. Ở mọi nơi khác, một thư mục skill mà npx skills add typesafe-ai/skills --skill typesafe-ai đặt vào đúng thư mục cho agent của bạn.

Tôi có còn cần đăng ký Claude hay ChatGPT không? Với thiết lập định tuyến, có — các trình khởi chạy dùng lại đăng nhập mà CLI đã có, nên một đăng ký Pro, Max, ChatGPT hay SuperGrok hoạt động nguyên trạng. Không có key Jev bạn sẽ có CLI thuần không định tuyến.

Tôi có cần key TypeSafe không? Với bất cứ thứ gì gọi Jev, có. Lấy một cái từ TypeSafe, hoặc trỏ công cụ vào OpenRouter hay Vercel AI Gateway, mà jev-use cũng hỗ trợ.

Tôi có thể thử mà không cần key không? JEV_BACKEND=mock trong jev-use chạy mọi phán đoán ở cục bộ mà không gọi nhà cung cấp, đủ để xem liệu các hook có kích hoạt ở nơi bạn mong đợi không.

Jev có sẵn trên APIMaster không? Nó đang trong quá trình onboarding, và trang này sẽ được cập nhật khi tích hợp hoàn tất. Các model mà một Jev router gửi việc đến đã có ở đây, với mức giá ở trên.

Có thứ nào trong số này làm hỏng CLI của tôi không? Skill không thay đổi gì về cách CLI chạy. Proxy định tuyến là fail-open và khôi phục mặc định model trước đó của bạn khi thoát. Hook là chỗ duy nhất cần cẩn thận, và những cái tốt hơn ghi rõ hành vi fail-open của chúng.

Một phán đoán Jev tốn bao nhiêu? $42 mỗi tỷ token đầu vào, không tính phí output, vì không có output. Một quyết định định tuyến mỗi lượt người dùng, hoặc một bộ câu hỏi mỗi lần hook kích hoạt, là toàn bộ hóa đơn.

Tôi nên chọn hướng nào cho một nhóm? Skill cho mọi người, một hook ranh giới cho nỗi đau chung, và định tuyến chỉ ở nơi hóa đơn model đủ lớn để đo lường.

Nguồn và đọc thêm

• TypeSafe — Tham chiếu API — dạng request POST /v1/systemone, các loại câu hỏi và câu trả lời
• TypeSafe — Models — alias, ID có phiên bản, giá $42/Btok và các giới hạn
• TypeSafe — Agent skill — plugin Claude Code chính thức và hướng npx skills, kèm các lệnh cập nhật
• TypeSafe — How to build with TypeSafe — fan-out phỏng đoán, ngân sách request 32.000 token và so sánh gộp lô
• typesafe-ai/skills — mã nguồn skill, MIT
• gargpratyush/jev-router — proxy định tuyến, bảng bậc và ghi chú tương thích của nó
• jkudish/jev-mcp — bộ công cụ MCP
• shiftynick/jev-axi — cổng trước công cụ và 44 ca được gán nhãn của nó
• tamaratran/fast-jev-compaction — plugin compaction

Số star của repository, lệnh cài đặt, phiên bản gói npm và giá route APIMaster đều được kiểm tra ngày 20 tháng 9, 2026. Các dự án cộng đồng trong không gian này thay đổi hằng ngày; hãy kiểm tra repository trước khi cài.

Tạo tài khoản APIMaster, nạp credit trả theo mức dùng từ $1, tạo key trong console, và trỏ một client tương thích OpenAI hoặc Anthropic vào https://apimaster.ai/v1. Hướng dẫn thiết lập cho hai CLI trong bài này là Claude Code và Codex.