← 返回学习中心 · Skills 与决策OiOi Academy
JEV 决策模型 · 04

Jev 接入 Claude Code、Codex 保姆级教程

接入课 · 从拿 key、curl 测试,到在 Claude Code / Codex 里装官方 Skill 并实测。来自 @xmglab(小码哥)。(基础概念见第 01 课《Jev 决策层完全指南》)

原作者 @xmglab(小码哥) 来源 X 发布 2026-09-21
🧭

开篇:Jev 已向所有人开放

作者 @xmglab(小码哥)开篇就讲了个"离谱"的消息:2026-09-20 起,Jev 向所有人开放,不用再排 waitlist,注册就能直接用。

他的核心观点:Jev 最有意思的是"完全不同的使用方式"——不生成内容,专做判断/分析/决策;而最佳玩法不是单独用,是配合 Claude Code、Codex 这类 Coding Agent:"Claude Code / Codex 负责干活,Jev 负责判断"——官方已提供现成 Skill,装好直接在 Agent 里调用,不用自己封装 API。

(Jev 是什么、三种原语、价格、状态设计这些基础概念,本课一句话带过——详见第 01 课《Jev 决策层完全指南》;本课只讲透接入细节。)

记住:一句话结论:Jev 开放注册即用;最佳姿势是 Coding Agent 干活 + Jev 做判断,官方 Skill 装好即用。
🔑

第一步:注册拿 key

去 console.typesafe.ai 注册即用;API key 创建页:https://console.typesafe.ai/keys。

作者提醒:在本地设 TYPESAFE_API_KEY 环境变量,避免把 key 写进代码或聊天记录里泄露。

开放初期的福利数字(原文):新用户送 5 美元额度(官方称约跑 1.2 亿 token),暂时找不到充值入口——先到先得的体验期。

价格表述(原文):比其他模型便宜 40~400 倍,输出侧免费。

原文配图:Jev 控制台与 key 创建页(来自 j04)
原文配图:Jev 控制台与 key 创建页(来自 j04)
🧪

第二步:curl 一把梭测试

不用装任何 SDK,一条 curl 直接打到单端点 POST https://api.typesafe.ai/v1/systemone(原文完整命令,heredoc 传 JSON):

curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "state": "我的 Claude 账号被封号了…",
  "model": "jev-latest",
  "questions": {
    "紧急程度": {
      "type": "noul",
      "instructions": "这个问题和登录有关系吗?"
    }
  }
}
EOF

注意 questions 里用的是 noul 类型(yes/no 判断题)——"这个问题和登录有关系吗",返回 [0,1] 的概率。通了,就说明 key 和链路都没问题。

高中生类比
curl 测试像去餐馆先要一小碟试吃:不用办卡(装 SDK)、不用点满汉全席,一小口就知道这家店合不合口味、钥匙对不对路。
🔌

第三步:装官方 Skill(两条命令)

官方 Skill 仓库:https://github.com/typesafe-ai/skills——提供 API 完整上下文:三种问题类型、架构模式、组织评估最佳实践。

Claude Code(两行命令):

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

触发方式:跟 Claude Code 说"使用 TypeSafe 技能…",或直接用斜杠命令 /typesafe:typesafe-ai。

更新 Skill:claude plugin marketplace update typesafe-ai / claude plugin update typesafe@typesafe-ai,然后重启或 /reload-plugins;也可在 /plugin → Marketplaces → typesafe-ai 里开自动更新。

Codex / 其他工具(一行命令,默认覆盖 Codex、Cursor、Gemini CLI、OpenCode 等,可自定义):

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

更新用 npx skills update(skills.sh 安装的),或手动替换 skill 目录。

原文配图:Skill 安装与触发方式(来自 j04)
原文配图:Skill 安装与触发方式(来自 j04)
记住:装完不用自己封装 API——在 Agent 里一句话或一个斜杠命令就能让 Jev 做判断。
🚀

实测:两个小案例 + 自动安装提示词

案例 ① 买不买 Mac mini?作者在 Claude Code 里输入:/typesafe:typesafe-ai Mac mini 我有必要买吗?请直接给判断——12 秒出结果,结论"现在不该买"。

案例 ② 分析项目代码:让 Jev"判断有哪些可替代复杂的逻辑或弱代码"——输出多了一栏 TypeSafe,逐行标注代码删除 / 保留 / 抽公共组件。作者强调:"TypeSafe 只是给出了判断"——改代码的活还是 Coding Agent 的。

跨 Agent 自动安装提示词模板(原文提供,发给任意支持 Skills 的 Coding Agent,它按当前环境自动选安装方式;内含 SKILL.md 原始链接):

安装 TypeSafe 技能。如果你在 Claude Code 中,请运行 claude plugin marketplace add typesafe-ai/skills,然后运行 claude plugin install typesafe@typesafe-ai。如果你在其他 Coding Agent 中,请运行 npx skills add typesafe-ai/skills --skill typesafe-ai 并选择你的 Coding Agent。请使用其中一种安装方式。你可以直接阅读该技能的说明文档:https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md(原始版本:https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md)。之后在开发此项目时即可使用 TypeSafe 技能。

作者预告下期:真实项目、代码重构、复杂技术决策中的"神级应用场景"。

高中生类比
整个接入流程像给汽车装个副驾驶:Claude Code 是握方向盘的司机(写代码、改文件),Jev 是旁边那个只动嘴的导航员——"前面路口该左转""这段路现在别超车"。装 Skill 就是把导航员请上车,两条命令的事。
词

术语翻卡:点卡片看解释

waitlist
waitlist
排队等候名单;Jev 在 2026-09-20 之前需要排队,之后注册即用。
Skill
Skill
官方技能包:把 Jev 的 API 上下文、问题类型与最佳实践打包,装进 Coding Agent 即用。
marketplace
marketplace
Claude Code 的插件市场;用 claude plugin marketplace add 添加 TypeSafe 官方源。
斜杠命令
slash command
/typesafe:typesafe-ai:在 Claude Code 里直接触发 Jev 技能做判断的命令。
npx skills
npx skills
skills.sh 的安装方式:一行 npx skills add 给 Codex、Cursor、Gemini CLI、OpenCode 等装 Skill。
测

自测一下:点问题展开参考答案

2026-09-20 起向所有人开放,不用排 waitlist;新用户送 5 美元额度(官方称约跑 1.2 亿 token),暂时找不到充值入口。

claude plugin marketplace add typesafe-ai/skills 和 claude plugin install typesafe@typesafe-ai;触发方式是说"使用 TypeSafe 技能…"或用斜杠命令 /typesafe:typesafe-ai。

用的是 noul 类型("这个问题和登录有关系吗?"),返回 [0,1] 区间的单个概率——这是 yes/no 判断题的标准用法。

输入"/typesafe:typesafe-ai Mac mini 我有必要买吗?请直接给判断",12 秒出结果,结论"现在不该买";说明分工是 Coding Agent 负责干活、Jev 负责判断——TypeSafe 只是给出了判断。