
问题场景:电脑端用了三方 API,手机端 Codex 直接掉线
用过 ChatGPT Codex 的朋友应该都有体会,电脑上装好 codex++,配置好第三方 API 或中转 API 之后,代码补全、Agent 调用确实爽。但只要掏出手机打开官方 ChatGPT,准备远程连接电脑上的 Codex 节点继续写点东西,八成会遇到连接失败的情况。手机端看不到电脑端点亮的 Codex 图标,或者连上了也发不了请求。
这个问题核心在于:官方 ChatGPT 手机端的远程连接走的是 OpenAI 官方认证,而电脑端 codex++ 把 API 请求劫持到了三方。两边的认证体系不一样,除非做一层中间处理,否则手机远控和电脑三方 API 就是互斥的。
这篇文章会帮你理清混合模式的原理,并给出一步步的操作教程,让你在不切换配置的前提下,电脑端继续用三方 API(比如便宜的月付或按量计费中转),手机端照样通过官方 ChatGPT 远程操控 Codex。全程会涉及 codex++、CC Switch(简称 CCS)和代理 TUN 模式的配合。
混合模式到底是什么原理?

要理解混合模式,得先搞清楚 codex++ 是怎么接手 API 的。通常 codex++ 安装后会替换掉 Codex 的默认请求地址,让所有模型对话、Agent 调用都走你填的 Base URL。但手机端远程连接时,ChatGPT 先要跟官方的身份认证服务器握手,验证你账号状态,然后才能建立到电脑的隧道。
如果你直接把 codex++ 的供应商设为三方 API,那么电脑端向 OpenAI 的认证请求也会被转发到三方,三方往往不支持官方认证接口,结果就是手机端认证失败,提示“无法连接到 Codex”或一直在“连接中”。
混合模式的做法是:保留 codex++ 对 OpenAI 官方认证的通道,仅把模型推理请求(比如 gpt-4、o3 等)的 API Key 替换成你自己的三方 Key。具体来说,就是在 codex++ 新建配置时,API Key 类型选择“混入 API Key”,然后填上你的三方 Base URL 和实际 Key。这样认证走官方,数据走三方,两边互不干扰。
准备工作:检查版本和环境

动手之前,确认几项基本条件,否则后面容易卡住:
- 电脑端已经安装 codex++,建议从 GitHub 官方仓库下载最新 release。
- 已经安装 CC Switch(CCS),这是切换供应商配置的工具,新版有混合模式支持。
- 手机端已安装最新版 ChatGPT,并且有 Codex 入口(如果看不到,可能需要更新到最新版本或切换 Apple/Google 账号地区)。
- 已经有三方 API 的 Base URL 和 Key,比如你从某个中转站买的,或者自己用 Docker 搭的代理(可以参考本站的 gemini-web2api 部署到 VPS 完全指南 了解如何在 VPS 上搭建自己的 OpenAI 兼容 API)。
- 代理软件必须支持 TUN 模式(比如 Clash Meta、Surge、Stash 等),因为手机端连接电脑需要局域网或公网可达,TUN 模式可以处理流量的路由。
如果电脑端部署在一些低配 VPS 上,也可以参考 Local Deep Research 可以部署到 VPS 吗?本地 AI 深度研究助手的服务器配置建议 了解 VPS 作为 AI 工具主机的性能要求。
详细配置步骤(清单式)
以下步骤基于 codex++ 和 CCS 最新版,界面可能因版本略有差异,但核心逻辑一致。
第一步:切换 CCS 供应商为“官方”
- 关闭电脑上正在运行的 Codex(注意:不要通过 codex++ 打开 Codex)。
- 打开 CCS(CC Switch),在供应商列表里找到你当前用的 Codex 配置。
- 把供应商从“三方 API”切换回“官方”。这一步是为了让 Codex 的认证回归 OpenAI 原厂。
第二步:打开 codex++ 管理工具并新建配置
- 启动 codex++ 管理工具(通常在系统托盘或桌面快捷方式)。
- 点击“新建配置”,不要直接覆盖原有配置。给新配置起一个容易区分的名字,比如“混入模式-手机远控”。
- 在 API Key 类型处选择“混入 API Key”(Mix-in API Key)。这是核心选项,文档里通常叫“Mix-in mode”。
第三步:填写三方 API 信息
- Base URL 输入你的三方 API 地址(例如
https://api.xxx.com/v1)。 - API Key 输入你的实际 Key。
- 填写模型列表(如果有),或者留空让 codex++ 自动拉取。
- 点击“测试连接”,确认能拉取模型列表后,再点击“保存配置”。
第四步:启用新配置并重启 codex++
- 在 CCS 中,把新建的配置设为当前激活。
- 点击 CCS 里的“重启 codex++”按钮。
- 等待几秒,观察系统托盘图标状态:如果出现一个手机小图标(或者提示“远程连接可用”),说明电脑端已准备好接收手机远控。
第五步:手机端连接
- 确保电脑和手机在同一个局域网,或者手机能通过代理 TUN 模式访问电脑的 IP 和端口(通常是 33333 或 33334)。
- 手机上打开 ChatGPT → 左侧栏点击“更多” → 选择“Codex” → 点击“远程连接”。
- 如果一切正常,会看到电脑端的 codex 节点出现,点击连接即可。
| 配置项 | 传统模式 | 混合模式(本教程) |
|---|---|---|
| API 请求 | 全部走三方 | 认证走官方,推理走三方 |
| 手机远控 | 不可用 | 可用 |
| 电脑端体验 | 完全三方 | 三方(无感知变化) |
| 配置复杂度 | 简单 | 中等(需要额外新建配置) |
代理 TUN 模式为什么必须开启?
很多新手卡在这一步:电脑端 codex++ 起来了,手机端也能搜到节点,但连接时超时。很多时候是因为网络层没通。Codex 远程连接走的端口不一定被代理软件自动放行,所以需要开启 TUN 模式(虚拟网卡模式),让代理接管所有设备流量,包括局域网内的直达连接。
用 Clash 举例:打开 Clash → 设置 → 开启 TUN 模式。如果手机端网络环境比较复杂(比如公司 WiFi 有防火墙),建议手机也开代理,并且节点选择靠近电脑所在地区的低延迟节点。
连接成功之后,手机端代理可以切回规则模式,避免所有流量都走代理影响国内应用使用。
常见失败原因排查
1. 手机端看不到 Codex 入口 检查 ChatGPT 版本;有时需要登录网页版先激活 Codex 功能。
2. 手机端能搜到节点但连不上
- 检查电脑防火墙是否放行了 codex++ 端口(默认 33333/33334)。
- 确认 TUN 模式已开启,并且代理软件没有阻止局域网访问。
- 检查手机和电脑是否在同一子网;如果是公网远程,需要在路由器上做端口转发或使用 frp。
3. 配置保存后模型列表拉取失败
- 检查 Base URL 末尾是否缺了
/v1。 - 确认 API Key 未过期,且三方服务无故障。
- 某些三方 API 限制了模型列表接口,可以手动填写模型名。
4. 手机能连上,但发消息报错
- 说明混合模式配置可能不完整,检查 API Key 处是否确实选了“混入 API Key”。
- 如果用的是老版本 codex++,可能需要升级。
另一种思路:不使用 codex++ 的纯 CCS 混合模式
如果你的 codex++ 版本较老不支持混入模式,也可以直接用 CCS 配置一套“双开”思路:电脑开两个 Codex 窗口,一个绑定官方走手机远控,另一个绑定三方 API 用于日常调用。但管理起来麻烦,不推荐长期使用。还是建议升级 codex++ 并采用上述新建配置的方法。
总结与行动建议
手机远控和第三方 API 并不矛盾,关键是把认证和推理分开。混合模式就是解决这个矛盾的官方路径(由 codex++ 团队实现)。
如果你正在用 codex++ 加三方 API,又想偶尔在手机上远程写代码,可以花 10 分钟按上面的步骤设置一下。新建一个配置不覆盖原来的,随时可以切换回纯三方模式。
目前各三方 API 的价格、稳定性差异较大,文中所用的 Base URL 和 Key 请自行核实可用性。如果你是通过 VPS 自建 API 反代,建议先在本地测试再部署正式环境。
另外,如果你是需要长期稳定运行 AI 编程工具的用户,考虑一台性能可靠的 VPS 作为 Codex 宿主机会比普通 PC 省心不少。可以参考本站的 VPS 选购指南(如 搬瓦工 BandwagonHost 评测 或 Evoxt VPS 评测)挑选适合跑 Codex 的机型。
原创文章,作者:兆润,如若转载,请注明出处:https://vpscn2gia.com/codex-api-mobile-remote-hybrid-guide/
