Codex 额度告急？与其干等着重置，不如直接把 DeepSeek V4 Flash、Kimi K3 等国产模型接入进来，多快好省还能续命。

通过 OpenCodex 项目，可以在保留原有 GPT 账号的同时无缝切换多种模型。

OpenCodex 支持 GPT-5.6 系列、DeepSeek V4 Flash、DeepSeek V4 Pro、Kimi K3、Kimi K3-256k、Kimi K2.7-code 等众多模型。配置完成后，模型菜单会多出一长串可选列表。

第一步：安装 OpenCodex

直接让 Codex 帮忙安装：

帮我安装 opencodex 到【你的目录】，安装地址：https://github.com/lidge-jun/opencodex
1. 检查仓库与环境；
2. 安装缺失依赖并启动；
3. 验证运行状态；
4. 逐步指导我完成需要人工参与的配置。

安装完成后，Codex 会自动打开本地仪表盘。

第二步：添加提供方模型

方式一：账号订阅 — Kimi K3

点击左侧栏的提供方，再点击右上角「添加提供方」。

上方点击「账户」，下拉选择对应的账号订阅，点击登录会跳转官网。

登录成功后即可看到配置成功的提示。

方式二：API 配置 — DeepSeek V4

同样点击左侧栏的提供方，再选择「付费」模式，填写 API Key。

⚠️ 关键注意：开 VPN 的情况下必须勾选「允许本地/私有网络」，否则会出现红字报错。

配置成功后，提供方界面会多出对应的模型。

第三步：验收后重启 Codex

配置完成后千万不要直接重启！必须先验收，否则可能出现「重连接 1/5」的报错。

以下是一份完整的验收提示词，直接发给 Codex 执行：

我已在 OpenCodex 仪表盘完成多个 AI 提供方和模型的授权配置。

不要索要或输出任何 Key/Token，不要直接重启 Codex。发现问题可修复，但未经我同意不得重启、恢复备份或停止服务。

1. 备份：备份 ~/.codex/config.toml 和 ~/.opencodex/config.json，带时间戳，不覆盖旧备份。
2. 建立验收清单：读取 OpenCodex 配置，列出所有已启用的 provider 和 model，不验收未配置的。
3. 验证服务：检查 ocx 版本、/healthz、端口 10100、PID 文件和 launchd 状态；lsof 监听 PID 必须与 launchd 服务 PID 一致。
4. 检查代理：用 scutil --proxy 检查代理，确认 NO_PROXY="127.0.0.1,localhost,::1" 已生效；域名解析到 198.18.0.0/15 Fake-IP 的要加排除。
5. 验证提供方：每个 provider 连续 3 次 test，检查认证、DNS、TLS 和网络稳定性。
6. 验证模型：每个模型分别发送普通请求和流式请求，必须拿到 HTTP 200 和 response.completed，不能只看仪表盘显示。
7. 检查适配器：确认每个模型的 adapter；长期无首包时对比 openai-chat 与 openai-responses，按日志判断调整。
8. 验证 Codex 接入：检查路由配置和 opencodex-catalog.json，确认全部模型已同步；可 ocx sync，不要重启。
9. 客户端验收：用 codex CLI 或 App runtime 逐个模型测试，每个都要拿到真实回复和完成事件，测完清理孤儿进程。
10. 回退方案：保留配置备份，给出恢复命令和当前 PID，未经同意不执行回退。
11. 汇报：表格列出每个 provider/model 的认证、连通、普通响应、流式响应、adapter 和客户端验收结果；任何一项失败先修复。

全部通过后，我用 ⌘Q 退出重开 Codex，重新检查服务和模型目录，每个模型新建对话测试；全部能正常输出、无重连接/401/502/无首包，才算完成。

验收全部通过后重启 Codex，模型列表就会多出所有接入的模型。

测试各模型是否能正常对话：

OpenCodex 工作原理

OpenCodex 的本质是在本机启动一个代理（默认端口 10100），拦截 Codex 发出的请求并转发到配置好的模型厂商：

Codex → 本机 10100 代理 → Kimi / DeepSeek / Gemini / Grok / …

所以登录的还是原来的 ChatGPT 账号，但模型菜单里会多了选项。

三种运行方式

• 临时测试：ocx start，终端关闭即停止
• 长期使用：ocx service，后台托管、开机自启、崩溃自动拉起
• 偶尔使用：ocx codex-shim install，打开 Codex 时才拉起代理

⚠️ 注意：不要同时运行前台和后台，会端口冲突。

模型筛选与用量监控

在仪表盘左侧「模型」页面可以按提供方筛选，关闭不需要的模型即可。

「用量」页面能看到按模型和提供方分拆的 Token 消耗、请求数和 API 折算价格，方便追踪哪个模型在消耗预算。

如何安全卸载 OpenCodex

OpenCodex 安装后会修改 Codex 配置文件指向 localhost:10100，卸载时必须按顺序操作，否则会出现无限重连接。

以下是安全卸载提示词：

我的目标是【暂时停用 / 彻底卸载】OpenCodex，并安全恢复原生 Codex。

不要索要或输出任何 Key、Token 或凭证。不要立刻停止代理或删除 npm 包，当前对话可能正在通过 OpenCodex 运行。

1. 检查当前状态：确认 OpenCodex 版本、10100 监听 PID，以及 ~/.codex/config.toml 是否仍指向 localhost:10100。
2. 备份配置：分别备份 ~/.codex/config.toml 和 ~/.opencodex/config.json，带时间戳，不覆盖旧备份。
3. 确认回退来源：找到 OpenCodex 接管前的 Codex 原始配置备份；没有可靠备份就停止操作并告诉我。
4. 报告执行方案：说明准备恢复哪个配置、停止哪些服务，此阶段不要真正执行。
5. 等我回复「确认执行」后再动手。
6. 受控执行：暂时停用走 ocx stop；彻底卸载先 ocx uninstall，确认恢复后再 npm uninstall -g @bitkyc08/opencodex，不能反过来。
7. 失败立即用备份恢复 ~/.codex/config.toml，不要删除任何配置文件。
8. 重启验收：⌘Q 退出重开 Codex，确认不再指向 10100、原生模型正常回复、没有重连接。

已知问题

• OpenCodex 会劫持 Codex 的所有请求，包括 GPT Live 语音功能，开启时语音功能会返回 404
• 切换模型后历史会话可能「消失」，实际是按 provider 分组显示，旧对话仍在本地

总结

OpenCodex 解决了「不退 GPT 订阅也能切模型」的痛点。额度紧时切 DeepSeek，前端任务交给 Kimi，重置后再切回 GPT，会话里模型可以随意切换搭配使用。通过一个项目，就能把市面上所有主流模型接入 Codex，大幅提升使用效率。

GitHub 项目地址：https://github.com/lidge-jun/opencodex