Codex × ChatGPT · JEV Switch

English | 简体中文

ChatGPT 负责思考，Codex 负责干活，Jev 决定什么时候该谁上。

智能切换设计文档 · 安全模型

本项目是 codex-with-chatgpt（C2C）的分支。C2C 让网页版 ChatGPT 通过一条只读 MCP 连接读取本地仓库，负责规划和审查，Codex 负责执行。

在这个基础上，JEV Switch 加了智能切换：用 TypeSafe 的 Jev 模型加上一套确定性规则，按任务自动判断：

1. 什么时候切到网页版 ChatGPT：先让它出方案；Codex 卡住时请它找根因；改动有风险时请它复核。

2. 什么时候切回 Codex：小改动 Codex 直接做；ChatGPT 说 DONE、只剩几处小修改时，Codex 直接改完收尾，不再来回确认。

智能切换默认关闭。不开启时，行为与原版 C2C 完全一致。

为什么需要它

原版 C2C 的切换完全靠手动：你得说「使用 Codex with ChatGPT 完成 XXX」才会去找 ChatGPT。进入协作后，每一轮都要把结果发回 ChatGPT 复核，直到它说 DONE。

但每一次来回都有成本：

• 你要多等 1–3 分钟；

• Codex 要花 token 驱动内置浏览器、每 20–30 秒检查一次页面；

• 纯机械的小改动（改个颜色、重命名）交给 ChatGPT 规划，反而更贵、更慢。

反过来，Codex 在同一个问题上反复失败时，原版不会主动去问 ChatGPT。

JEV Switch 的原则是：只有省下的思考比一次来回更值钱时，才把工作交给 ChatGPT。

Related MCP server: codex-from-chatgpt

它在哪些时机做判断

几条硬性原则（都由代码保证，并有测试覆盖）：

• 能不能跳过复核，永远不由 Jev 决定。 Jev 的回答只能让系统更谨慎，不能让它更松。

• Jev 不可用时（没配 key、网络被拦、超时），行为退回原版：不会自动升级，也不会跳过复核。

• 你说了算。 「别找 ChatGPT」「让 ChatGPT 来规划」随时生效。

• 不来回反复。 每个任务最多自动切到 ChatGPT 一次。

• 永远不卡住任务。 每个决策命令都返回合法 JSON，退出码为 0。intake 调用 Jev 的时间上限是 3 秒。

实测效果

2026-09-24 用 jev-1.13.0 在线评测，共 152 个样本，73% 为中文或中英混合：

单题准确率比路由一致率低，比如 goal_is_clear 只有 65.8%。这是预期内的：路由把多个概率加权合并后再和阈值比较，单题判错多数时候不会改变最终走哪条路。另外，评测样本是本项目自己编写并标注的，真实效果以你实际使用为准。可以用 c2c route feedback 纠正、用 c2c route stats 观察。

快速开始

需要：macOS 或 Windows、Node.js ≥ 20、git、Codex 桌面版、ChatGPT Plus/Pro 账号。智能切换另需一个 TypeSafe API key。

1. 安装（把这段话交给 Codex）

请帮我完整安装并配置 JEV Switch（Codex with ChatGPT 的分支），全程自动：

1. 环境自检：需要 git 和 Node.js ≥ 20，缺什么就自动安装
  （macOS 用 Homebrew，Windows 用 winget），同时安装 cloudflared。
2. 下载：把 https://github.com/FlyPig23/Codex_ChatGPT_JEV_Switch 克隆到
   ~/Codex_ChatGPT_JEV_Switch（已存在就 git pull 更新）。
3. 构建：在该目录里执行 corepack pnpm install 和 corepack pnpm build。
4. 安装 Skill：把仓库里的 skill/SKILL.md 复制到
   ~/.codex/skills/codex-with-chatgpt/SKILL.md，并把文件中
   "The codex-with-chatgpt checkout lives at:" 那一行的路径改成实际克隆路径。
   如果之前装过原版 codex-with-chatgpt，用这个版本覆盖它，不要两个同时装。
5. 首次配置：按 SKILL.md 里的 first-time setup 流程执行
  （运行 c2c setup，用内置浏览器打开 ChatGPT 配置连接器并输入配对码）。
   全程只用内置浏览器，禁止打开任何第三方浏览器。
6. 只有遇到需要我登录（ChatGPT / Cloudflare）、验证码或两步验证时才叫我，
   而且一次只告诉我一个动作。
7. 完成后给我看 ✓ 清单，并确认文件读取测试通过。

完成后你会看到：

Codex with ChatGPT

✓ 当前项目已识别
✓ Workspace Bridge 已启动
✓ 安全连接已建立
✓ ChatGPT 已连接
✓ 文件读取测试通过

Ready.

之后说「使用 Codex with ChatGPT，帮我实现 XXX」，就走原版的 ChatGPT 规划流程。

2. 开启智能切换（配置 Jev key）

Key 只在你自己的终端里输入，不经过聊天，Codex 也看不到它。

1. 在 TypeSafe 控制台 创建一个 API key。

2. 打开 macOS「终端」或 iTerm。不要用 Codex 里内置的终端：那里带有 CODEX_SANDBOX 等环境变量，setup 会拒绝运行。

3. 运行：

   node ~/Codex_ChatGPT_JEV_Switch/bin/c2c.js route setup

   它会依次：

   • 说明哪些内容会发给 TypeSafe，然后问 同意并启用智能切换？[y/N]，输入 y；

   • 让你粘贴 key，输入时不显示。建议直接粘贴，不用环境变量：Codex 桌面版不一定能读到你 shell 里的环境变量；

   • 实际调用一次 Jev，显示 ✓ 或 ✗；

   • 保存 key，开启智能切换；

   • 问要不要安装 c2c-router 技能，回车即安装。

4. 验证：

   node ~/Codex_ChatGPT_JEV_Switch/bin/c2c.js route status --probe --json

   看到 "enabled": true 和 "jev": "reachable" 就配好了。输出里只显示 key 指纹的前 8 位。

5. 重开一个 Codex 会话，新技能就会生效。之后正常提需求即可，不用再说「使用 Codex with ChatGPT」。

Key 保存在 ~/Library/Application Support/codex-with-chatgpt-keys/（Windows 为 %LOCALAPPDATA%\codex-with-chatgpt-keys），目录权限 0700、文件 0600，位于 Codex 沙箱可写目录之外。换 key 或关闭：route setup --remove，再重新 setup。

日常使用：你可以这么说

路由第一次说话时会附一句提示：「我会按任务自动决定是否请 ChatGPT 参与；随时可以说「这次别找 ChatGPT」或「让 ChatGPT 来规划」。」

哪些内容会发给 TypeSafe

只有你运行过 route setup 之后才会发送。只发往固定地址 https://api.typesafe.ai，默认模型 jev-1.13.0（可用 route prefs set --model 固定到其他版本）。

发送前会做这些处理：去掉代码块；脱敏各类 API key、JWT、URL 里的密码、密码：… / password=… 形式的值、命令行里的凭据、邮箱、公网 IP、高熵字符串以及你的 TypeSafe key；截断长度；按每个时机的严格 schema 校验。

以下情况不会调用 Jev：

• 需求里提到「保密 / 不要上传 / confidential」，这时也不会自动找 ChatGPT；

• 文本里含私钥；

• 命中了确定性规则，不需要问 Jev。

本地决策日志只记录数字和枚举，不记录任何原文。

TypeSafe 声明不会用输入数据训练模型，但保存期限没有固定时长，零数据保留只对企业客户提供。某个仓库的内容如果不能给第三方处理，请对它运行 c2c route disable -w <仓库>。详见 docs/security.md。

命令速查

下面的 c2c 指 node ~/Codex_ChatGPT_JEV_Switch/bin/c2c.js。

intake、failure、review-gate、reply、pin、message 这几个决策命令由 Codex 通过技能调用，一般不用手动运行。加 --explain 可以看每一步的信号、概率和阈值；加 --dry-run 可以看将要发送的内容，但不实际发送。完整说明见 docs/routing.md。

评测与调参

# 离线：只检查确定性规则和策略回放，不联网，也不需要 key
node bin/c2c.js route eval

# 在线：真实调用 Jev，约 150 次，费用约 $0.01；保存答案供之后离线回放
node bin/c2c.js route eval --live --save-answers ~/jev-answers.json

# 只改了阈值或策略（没改问题）时，用保存的答案离线验证，不花钱
node bin/c2c.js route eval --replay ~/jev-answers.json

• 阈值在 src/router/policy.ts 的 THRESHOLDS 里，按 economy / balanced / speed 三种偏好分别设置。

• Jev 的问题定义在 src/router/questions.ts。

• 样本在 src/router/fixtures/。

调整策略后，用下面的命令重新生成样本的期望结果：

node --import tsx scripts/regen-router-fixtures.ts --write

工作原理

用户需求 ─► [c2c-router 技能] ─► c2c route intake ─┬─ Codex 直接做 ──┬─ 失败 ─► route failure ─┬─ 继续修
                                                  │                  │                         ├─ DEBUG ─► ChatGPT 找根因
                                                  │                  │                         └─ 问你
                                                  │                  └─ 收尾 ─► route review-gate ─┬─ 直接结束
                                                  │                                                └─ REVIEW ─► ChatGPT 复核
                                                  ├─ Codex 做完请复核 ─► review-gate ─► REVIEW ─► ChatGPT 复核
                                                  ├─ ChatGPT 先出方案 ─► 原版 C2C 协作流程
                                                  └─ 先问你一句
ChatGPT: DONE + FOLLOWUPS ─► route reply ─┬─ Codex 直接改完收尾（切回 Codex）
                                          └─ 改完再请 ChatGPT 看一眼

• 两个技能：c2c-router（router-skill/SKILL.md，约 80 行）在普通写代码的请求上触发。只有确实要找 ChatGPT 时，才加载完整的 codex-with-chatgpt 技能（skill/SKILL.md），避免每个小改动都读几十 KB 的说明。

• 协议扩展，向后兼容：新增 MODE: REVIEW（Codex 已经做完，请 ChatGPT 复核）和 MODE: DEBUG（Codex 卡住，请 ChatGPT 找根因）两种 INIT，以及 DONE 后可选的 FOLLOWUPS: 段。说明都写在消息正文里，已有的对话无需重新发引导词。详见 docs/protocol.md。

• 原版的数据通路不变：ChatGPT 仍然只通过只读 MCP 读代码，控制消息里从不粘贴文件、diff 或日志。

原版 C2C 的架构（只读 MCP 桥、OAuth 2.1 + 一次性配对码、Cloudflare 隧道）见 docs/architecture.md。

相对原版的其他改进

• 更新检查：跟随本地分支所跟踪的远端分支，fork 也能正确判断是否有新版本。更新时不会再用 git stash 改动你的本地修改。

• c2c record --output-file：拒绝读取敏感文件（.env、~/.ssh 等）和符号链接。

• 共享脱敏器：补充了更多凭据格式，例如 sk-proj-、sk_live_、JWT、URL 中的密码。

• 会话检查点：切换到新任务时不再继承上一个任务的字段。新增 --init-mode、--routed-by、--close-local 三个参数。

从原版迁移 / 同步上游

已经装过原版 codex-with-chatgpt 的：用本仓库的 skill/SKILL.md 覆盖 ~/.codex/skills/codex-with-chatgpt/SKILL.md（把路径那一行改成本仓库的路径），并删掉原版技能的其他副本。本地状态目录两者通用，已连接的 ChatGPT 连接器不需要重建。

同步原版的更新：

git remote add upstream https://github.com/XiaoDuoYa/codex-with-chatgpt.git
git fetch upstream && git merge upstream/main

开发

corepack pnpm install
corepack pnpm build        # 产出 dist/；bin/c2c.js 优先使用 dist/
corepack pnpm test         # vitest：1167 个测试，全程不联网
corepack pnpm typecheck

路由模块在 src/router/：

types.ts       共享类型与枚举          policy.ts     纯函数策略与阈值
questions.ts   Jev 问题定义            signals.ts    确定性信号（正则、错误签名、路径分类、改动统计、连接探测）
outbound.ts    外发脱敏与 schema 校验   jev.ts        固定端点/模型的 TypeSafe 客户端、熔断
messages.ts    next/say 模板、REVIEW/DEBUG INIT    index.ts    各决策点的编排
secrets.ts     key 与同意记录           setup.ts      终端交互式开启
state.ts       单任务路由状态           log.ts        仅数字的决策日志与统计
eval.ts        评测                     fixtures/     评测样本

CLI 入口在 src/cli/route.ts。

文档

智能切换 · 协议 · 安全 · 架构 · 故障排查

致谢与声明

• 基于 XiaoDuoYa/codex-with-chatgpt（MIT）。原版的桥接、OAuth、隧道、技能与协议设计都来自原作者。

• 智能切换使用 TypeSafe 的 Jev 模型和官方 JavaScript SDK。

• 非官方社区项目，与 OpenAI、TypeSafe 均无关联，也未获它们背书。

• 许可证：MIT。