Jev 接入 Claude Code、Codex 保姆级教程
接入课 · 从拿 key、curl 测试,到在 Claude Code / Codex 里装官方 Skill 并实测。来自 @xmglab(小码哥)。(基础概念见第 01 课《Jev 决策层完全指南》)
开篇:Jev 已向所有人开放
作者 @xmglab(小码哥)开篇就讲了个"离谱"的消息:2026-09-20 起,Jev 向所有人开放,不用再排 waitlist,注册就能直接用。
他的核心观点:Jev 最有意思的是"完全不同的使用方式"——不生成内容,专做判断/分析/决策;而最佳玩法不是单独用,是配合 Claude Code、Codex 这类 Coding Agent:"Claude Code / Codex 负责干活,Jev 负责判断"——官方已提供现成 Skill,装好直接在 Agent 里调用,不用自己封装 API。
(Jev 是什么、三种原语、价格、状态设计这些基础概念,本课一句话带过——详见第 01 课《Jev 决策层完全指南》;本课只讲透接入细节。)
第一步:注册拿 key
去 console.typesafe.ai 注册即用;API key 创建页:https://console.typesafe.ai/keys。
作者提醒:在本地设 TYPESAFE_API_KEY 环境变量,避免把 key 写进代码或聊天记录里泄露。
开放初期的福利数字(原文):新用户送 5 美元额度(官方称约跑 1.2 亿 token),暂时找不到充值入口——先到先得的体验期。
价格表述(原文):比其他模型便宜 40~400 倍,输出侧免费。
第二步: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 目录。
实测:两个小案例 + 自动安装提示词
案例 ① 买不买 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 就是把导航员请上车,两条命令的事。
术语翻卡:点卡片看解释
自测一下:点问题展开参考答案
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 只是给出了判断。