在 Codex 中手动安装并使用 Jev（TypeSafe）：完整配置教程

01Jev 是什么

Jev 不会替换 Codex 当前用于聊天和写代码的主模型。它是 TypeSafe 的结构化判断模型，适合在 Codex 实现功能时处理三类事情：

• 固定候选项中的选择（choice）；
• 带等级的评分或排序（score）；
• 某条件是否成立（noul）。

例如「这条用户反馈属于哪种已定义问题类型？」适合交给 Jev；「给整个项目重写代码」则不适合交给 Jev。

02前提与申请 Key

前提

• 已安装 Codex，并能打开其集成终端或 Windows PowerShell。
• 已安装 Node.js 和 npx：在 PowerShell 执行 npx --version 能看到版本号即可。
• 已在 TypeSafe Console 创建一个新的 API Key。

Key 在哪里申请、长什么样

1. 打开 TypeSafe Console 的 Keys 页面，登录或注册 TypeSafe 账号。
2. 点击创建 API Key，复制新生成的 Key 并保存在自己的密码管理器中。
3. 它是一段较长的随机密钥文本，不是 Codex 登录账号，也不是 OpenAI 的 API Key。当前常见格式以 apikey_ 开头，由两段随机十六进制字符组成：

apikey_0123456789abcdef0123456789abcdef_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

上面是虚构示例，不能使用。常见长度约为 104 个字符：apikey_（7 个字符）+ 第一段 32 个字符 + 下划线 + 第二段 64 个字符。直接完整复制 TypeSafe Console 创建的值即可，不要手动修改或拼接；如果未来控制台生成的格式不同，以控制台实际值为准。

Key 通常只会在创建时完整显示一次。不要把它粘贴到 Codex 聊天、微信、截图或 Git 仓库；如果已经泄露，直接在 Keys 页面撤销或轮换。

03第一步：安装 TypeSafe skill

在 PowerShell 或 Codex 的终端中执行：

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

安装程序询问目标 agent 时选择 Codex。此命令默认按当前项目安装 skill；只想为当前项目启用时，这是推荐方式。

如需为当前 Windows 用户的所有 Codex 项目安装，可使用全局安装：

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

04第二步：写入 TYPESAFE_API_KEY

下面三种方式任选一种。设置完成后都要完全重启 Codex。

方法 A：Windows 设置界面（最简单）

1. 按 Win 键，搜索并打开「编辑账户的环境变量」。
2. 在「用户变量」区域点击「新建」。
3. 变量名填写 TYPESAFE_API_KEY。
4. 变量值粘贴从 TypeSafe Console 创建的新 Key。
5. 连续点击「确定」保存。

方法 B：PowerShell

把 粘贴新Key到这里 替换为刚创建的新 Key：

[Environment]::SetEnvironmentVariable(
  'TYPESAFE_API_KEY',
  '粘贴新Key到这里',
 'User'
)

这会把 Key 保存到当前 Windows 用户的环境变量中，而不是项目文件、Git 仓库或系统级环境变量。

方法 C：批处理文件

新建一个临时文本文件，改名为 set-typesafe-key.bat，写入下面一行；将占位内容替换为新 Key 后双击运行：

setx TYPESAFE_API_KEY "粘贴新Key到这里"

看到「成功」后，删除这个 .bat 文件，因为它里面含有明文 Key。不要把该文件放进项目目录或提交到 Git。

可用以下命令检查变量是否已经写入；它只显示是否存在，不回显 Key：

if ([string]::IsNullOrWhiteSpace([Environment]::GetEnvironmentVariable('TYPESAFE_API_KEY', 'User'))) {
  '未找到 TYPESAFE_API_KEY'
} else {
  'TYPESAFE_API_KEY 已为当前用户保存'
}

不要把 GetEnvironmentVariable(...) 的实际返回值复制到聊天或日志中。

05第三步：完全重启 Codex

关闭所有 Codex 窗口和相关终端后，再重新打开 Codex。已启动的 Codex 进程不会自动获得刚写入的用户环境变量。

06第四步：在 Codex 中调用 TypeSafe skill

重新打开 Codex 后，直接输入明确请求，例如：

使用 TypeSafe skill，检查这个项目哪些固定判断适合交给 Jev。
先只推荐，不安装依赖，也不修改代码。

当你希望 Codex 用 Key 发起小规模试验时，可以输入：

使用 TypeSafe skill，并使用已配置的 TYPESAFE_API_KEY，
为这个项目挑选一个适合 Jev 的固定判断场景。
先用不含真实用户数据的测试状态验证，再只给出结果和建议，不改代码。

提到「使用 TypeSafe skill」可以明确要求 Codex 载入该 skill。实际做项目功能时，应让 Codex 将 API Key 保留在本机环境，且先审阅要发送给 Jev 的 state，不要把不必要的私密项目内容或密钥放进去。

07验收方式

完成上述步骤后，以下现象分别证明不同层次的状态：

08常见问题

Codex 没有使用 skill

在请求里明确写「使用 TypeSafe skill」。确认安装时选择的是 Codex，并完全重启 Codex。若依旧未加载，可重新运行同一种安装方式更新 skill：

npx skills update

npx 找不到

安装或修复 Node.js 的 LTS 版本，重新打开 PowerShell 后运行 npx --version 再试。

Jev 提示 API Key 无效或无权限

在 TypeSafe Console 检查 Key 是否有效、是否已被撤销以及账户权限。不要把 Key 粘贴进对话请求；只更新本机的 TYPESAFE_API_KEY 后重启 Codex。

Key 写入后仍失败

先确认已完全退出并重新打开 Codex。若变量是由其他终端或远程会话设置的，确保启动 Codex 的 Windows 用户与写入变量的用户相同。

09更新卸载与官方资料

• 用 npx skills 安装的 skill：运行 npx skills update 更新。
• 要撤销当前用户的 Key：在 PowerShell 中执行：

[Environment]::SetEnvironmentVariable('TYPESAFE_API_KEY', $null, 'User')

删除 Key 后同样要重启 Codex。

官方资料：

• TypeSafe Agent skill
• TypeSafe API
• Jev 与 Coding Agents
• OpenAI Skills documentation