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 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ó lời gọi công cụ để parse.

TypeSafe ghi tài liệu đúng một endpoint đánh giá, POST /v1/systemone, cộng thêm 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ù chúng 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ề một câu trả lời nằm trong schema do bạn định nghĩa, và nó không tính phí cho đầu ra vì không có đầu ra. 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 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ỗ phù hợp với câu trả lời đó.

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

Đây là tích hợp chính thức duy nhất, 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 bất cứ thứ 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 skills:

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

Nó sẽ hỏi bạn muốn cài vào agent nào. Bạn cũng có thể dán chính prompt của TypeSafe vào agent và để nó tự thực hiện 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 dùng giấy phép MIT, manifest của 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 thì đáng để biết, vì nó không chỉ là mấy kiến thức vặt về API. Nó mang theo ba kiểu câu hỏi, cách dựng state, ý nghĩa của độ tin cậy so với xác suất, các mẫu kiến trúc, và một bảng chỉ tới đúng trang tài liệu cho từng tác vụ — bao gồm cả 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: "coding agent rơi vào thói quen hỏi mỗi lần một câu nhiều hơn người viết." Skill bảo agent đặt nhiều câu hỏi trong một lời gọi, kể cả những câu mang tính dự phòng mà chỉ có ý nghĩa với một số đầu vào nhất định, rồi để code của bạn quyết định dùng câu trả lời nào. Chính mẫu này 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ời 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à câu trả lời không đổi. Hai con số hơi khác nhau cho cùng một phép thử; 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 tính 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ức khoảng 150.000 ký tự tiếng Anh.

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

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

Nơi nó đứng	Dự án	★	Agent
Nén phiên làm việc	tamaratran/fast-jev-compaction	4.697	Plugin Claude Code; thay bản tóm tắt nén bằng các phán đoán giữ/bỏ theo từng mục
Nén phiên làm việc	leonaaardob/fast-dev-compaction	3	Plugin Codex, một bản chuyển thể cùng ý tưởng
Đầu ra terminal	tamaratran/jev-pruner	122	Claude Code; cắt gọn đầu ra Bash dài trước khi model thấy nó
Proxy ngữ cảnh	compozy/yoshi	18	Claude Code, Codex; Jev phán đoán phần lịch sử nào vẫn cần
Cổng trước công cụ	shiftynick/jev-axi	17	Claude Code, Codex; chấm điểm từng lệnh shell về 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ố "xong"
Trên các worker Codex	thruwire/foreman	418	Codex; Jev phán đoán một triển khai đã hoàn tất chưa và 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 chỉ bằng một lệnh
Hành động desktop	yikangy873-gif/jev-desktop	31	Codex Computer Use; chọn giữa các hành động desktop thay vì hỏi language model từng bước

Có hai dự án 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 riêng gồm 44 lời gọi công cụ — 24 trong đó phải bị chặn hoặc đẩy lên xem xét, bao gồm cả những cái được làm rối bằng base64 — và báo cáo 44/44 được quyết định đúng như gán nhãn; nó cũng ghi rõ giới hạn trung thực, đó là khi hook không đọc được transcript của agent thì nó không làm gì. jev-belay thể hiện cách kiểm soát chi phí làm cho toàn bộ hạng mục này vận hành: nó tiêu đúng một lời gọi Jev gồm 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ó thất bại theo hướng mở với mọi lỗi.

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

Đ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 khóa của nó 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 khóa, giữ mọi phán đoán ở cục bộ. Các demo 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 nén ngữ cảnh phán đoán 200 message trong 7 lời 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ụ gọi được 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 hề nhắc tới MCP, nên không có server chính chủ 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) phơi ra 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 cho 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ế ở đây mới là điều quan trọng: đâ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, mọi tuyên bố hay mọi 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, còn Jevbridge nói MCP qua stdio từ một bản clone 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 thấy rõ 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ời 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

Cần Node.js 20.12+ và ít nhất một trong hai CLI. Lệnh claude login hoặc codex login hiện có của bạn không bị đụng tới — proxy loopback chuyển tiếp chính các header ủy quyền của CLI mà không đọc, lưu hay sửa chúng, và không có khóa API Anthropic hay OpenAI nào tham gia. Claude Code được chuyển hướng qua ANTHROPIC_BASE_URL; Codex nhận một nhà cung cấp 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. Lời gọi công cụ, quyền, phiên, /compact và /resume hành xử như mọi khi, vì chúng vẫn thuộc về CLI.

Bảng bậc là phần nên khiến bất kỳ ai mua quyền truy cập API quan tâm:

Bậc	Mặc định Claude Code	Mặc định Codex
Nhanh	Haiku	gpt-5.6-luna
Cân bằng	Sonnet	gpt-5.6-terra
Mạnh	Opus	gpt-5.6-sol
Dài	Fable (tự chọn)	gpt-6-astra

Mọi model trong bảng đó đều đang được giảm giá 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 phần định tuyến ở đây và trả trực tiếp cho TypeSafe nửa 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ỏ vào catalog của chúng tôi, và toàn bộ ý nghĩa của mẫu này là phần lớn lượt đều rơi vào bậc rẻ.

Chính sách ở đây 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; độ tin cậy thấp không bao giờ hạ bậc và giới hạn việc nâng bậc ở bậc cân bằng; các cuộc trò chuyện lớn từ chối những lần hạ bậc gây lãng phí công việc prompt-cache nhiều hơn mức tiết kiệm được; một bậc không khả dụng sẽ được bước lên thay vì âm thầm chọn thứ yếu hơn; và bậc dài vẫn tắt trừ khi bạn đặt JEV_ALLOW_FABLE=1. Định tuyến thất bại theo hướng mở — 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 phục hồi 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, vào 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ó làm mọi bước sau dễ hơn vì agent ngừng hỏi mỗi lần một câu.
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 nén. Nếu bạn lo về các lệnh shell, chọn cổng trước công cụ. Nếu bạn cứ nhận "xong" với công việc còn dang dở, chọn hook dừng.
3. Định tuyến, chỉ khi bạn đã thấy thoải mái với một proxy phía trước CLI. Đây là hướng đòn bẩy cao nhất và cũng xâm nhập sâu nhất trong bốn hướng.
4. Giữ số học, ngày tháng và việc đếm trong code của chính bạn. Jev ghi rõ những thứ đó là không đáng tin, và điều này 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ỗi lần gọi hỏi một câu." 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 dùng chung. Hỏi mỗi request một câu là vứt đi phần lớn lợi thế và toàn bộ lập luận về độ trễ.
• "Độ tin cậy là độ chính xác." Độ tin cậy của Jev đã được hiệu chỉnh, 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 nên đẩy lên xem xét. Chúng tôi đã đi qua các con số hiệu chỉnh đã 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 với 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? Theo tài liệu thì không. Tài liệu tham chiếu API liệt kê endpoint đánh giá và GET /v1/models, và không có gì khác.

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

Skill chính thức cài chính xác những gì? Trong Claude Code, một plugin tên typesafe từ marketplace typesafe-ai, 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 gói đăng ký Claude hay ChatGPT không? Với thiết lập định tuyến thì có — các trình khởi chạy dùng lại đăng nhập mà CLI đã có, nên gói Pro, Max, ChatGPT hay SuperGrok hoạt động nguyên trạng. Không có khóa Jev thì bạn có CLI thuần không định tuyến.

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

Tôi có thể thử mà không cần khóa 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 nào, đủ để xem các hook có kích hoạt đúng nơi bạn mong đợi không.

Jev có trên APIMaster không? Có. Gọi jev-latest qua POST https://apimaster.ai/v1/systemone bằng khóa APIMaster; chi phí $0.042 cho mỗi 1M token đầu vào và $0 đầu ra. Các model mà một router Jev gửi việc tới cũng ở đây, với mức giá nêu trên.

Liệu 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 thất bại theo hướng mở và phục hồi 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 thất bại theo hướng mở của chúng.

Một phán đoán Jev tốn bao nhiêu? $42 cho mỗi tỷ token đầu vào, không tính phí đầu ra, vì không có đầu ra. 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 một 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 tất cả 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 — Tài liệu tham chiếu API — dạng request POST /v1/systemone, các kiểu 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 dự phòng, ngân sách request 32.000 token và so sánh gộp lô
• typesafe-ai/skills — mã nguồn của skill, MIT
• gargpratyush/jev-router — proxy định tuyến, bảng bậc và các ghi chú tương thích
• jkudish/jev-mcp — bộ công cụ MCP
• shiftynick/jev-axi — cổng trước công cụ và 44 ca đã gán nhãn của nó
• tamaratran/fast-jev-compaction — plugin nén

Số sao 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 năm 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 tín dụng trả theo mức dùng từ $1, tạo khóa 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.