zc-codex-ccswitch

官方桌面 App 已验证兼容桥接

2026-11-16 的重大突破。结论先行:官方 ChatGPT 桌面 App(内含 Codex 桌面端) 原生读取 ~/.codex/config.toml,本项目的桥接无需任何改造即被官方 App 直接使用。

⚠️ 2026-11-17 起仓库主线是 CodexBridge.exe + 官方 App(可汉化)/ Codex CLI。 文中提到的 CC GUI 属于已移除的旧三件套路线,仅作历史记录;新机器不要安装 CC GUI。

结论

验证点 结果
官方 App 显示 provider Bridge (api2codex)(config.toml 的 name)
默认模型 hy4flash-free(config.toml 的 model),对话成功
模型目录 走 model_catalog_json(29 个模型:7863 原名 + 7864 前缀)
历史会话 与 CLI / CC GUI 三端共享(同一 ~/.codex 会话存储)
是否必须 CC GUI 否——桥接让官方 App 也成为可用桌面端

安装方式

codex app

CLI 检测到桌面 App 缺失时输出:

Desktop app not found; opening Windows installer...
After installing the Desktop app, open workspace <你的工作区>.

随后弹出 Microsoft Store 安装器并自动开始下载(无需点击确认):

安装完成后可用 codex app 启动,或从开始菜单启动 ChatGPT/Codex。

原理

官方桌面 App 与 Codex CLI 同源:都读取 ~/.codex/config.toml,都通过 model_provider 指向的上游发送 Responses 请求。本项目桥接恰好提供标准 Responses 端点(http://127.0.0.1:8787/v1),因此:

官方桌面 App  ─┐
CC GUI         ├─→  api2codex 桥接 (:8787)  →  网关 7863 / 7864
Codex CLI      ┘        Responses ↔ Chat + 提示词中性化

三个客户端共用一份 config.toml、一份会话存储、一份模型目录。

已知限制

Computer use 被禁用(与桥接无关)

App 设置里的 Computer use(让 ChatGPT 驱动本机应用,如 Google Chrome)显示:

Disabled by your organization or unavailable in your region

这是 OpenAI 云端功能的区域/账号限制——官方 App 的 ChatGPT 部分需要 OpenAI 账号体系,该功能按区域灰度。Codex 本地功能(桥接对话、工作区、会话)完全不受影响。

其他观察

界面中文化(已实现 ✅)

要自己动手?直接看 官方桌面App汉化-SOP.md —— 逐步可执行,补丁脚本和翻译表都在仓库 codex-zh/(AI 接手照做即可)。 本节只讲原理与踩坑。

官方 App 自带 Language 设置(Settings → General → Language,可选简体中文), 但仅改设置不够:Codex 业务界面的文案在 app.asar 前端里,而官方把整套中文 翻译(39772 条)打包成了 未接线的消息 chunk(async/1561.*.js)——语言 开关 enable_i18n 由 Statsig 远程控制(Layer 72216192),默认关闭且离线环境 拿不到配置,导致翻译资源加载不到、界面回退英文。

汉化方案(已实测成功;2026-11-17 复核修正):

  1. 复制 Store 版到可写副本(~/.codex/codex-localized/app,不动 WindowsApps)
  2. 只改 1 处 bool:webview/assets/async/907538.*.js 里 get("enable_i18n",!1) → !0(另一处 184348.*.js 本来就是 !0)。 可用仓库 codex-zh/patch.py(默认只改这一处,幂等)或手动改。 enable_i18n=true 后官方前端自动加载 locales/zh-CN.json(chunk 1561, 39772 条),界面全中文——不需要批量替换 defaultMessage。

    复核证据:已汉化成品里 “New chat”(id=chatgptConversations.customGpt.newChat) 等核心文案的 defaultMessage 仍是英文,界面却显示中文,说明中文来自 chunk 按 id 匹配,而非默认文案。早期误做的 5793 条 defaultMessage 替换是冗余的。

  3. 等长原位补丁:直接在 app.asar 里改那 1 字节,并在 header 内等长更新该文件的 integrity.hash 与受影响 4MB 分块 hash(header 长度/文件偏移不变,无需解包/重打包)
  4. 离线重算 SHA256(新 header JSON),等长写回 exe 内嵌 integrity 清单(exe 资源段 [{"file":"resources\app.asar","alg":"SHA256","value":"..."}])
  5. 以 --lang=zh-CN 启动 → 菜单(文件/编辑/视图/帮助)、侧栏(新对话/定时任务/ 插件/项目/最近)、主界面(我们要构建什么?)、底部(选择项目/完全访问) 全部中文

exe 完整性校验的机制(踩坑记录):

Computer use 为什么是灰的(不破解)

App 内 Computer use(让 ChatGPT 驱动本机应用,如 Chrome)显示 Disabled by your organization or unavailable in your region。

这是 OpenAI 服务端的区域/账号灰度,不做客户端破解,三个理由:

  1. 这类功能开关通常在服务端二次校验——客户端强开大概率被服务端拒绝,白做
  2. 绕过 OpenAI 的区域访问控制违反其服务条款
  3. 有现成的合法替代

替代方案(本机已具备):

需求 用什么
操控本机应用(GUI 自动化) CC GUI 自带的 computer-use 驱动(ccgui-computer-use.exe)
浏览器自动化 ZCode 的 browser-use;Codex CLI 的 browser_use 特性也是 stable
网关对话 官方 App / CC GUI / CLI 三端走同一桥接

另外,7864 网关实测没有 11128 渠道指纹校验,是更干净的上游。

与 CC GUI 的取舍

  官方桌面 App CC GUI
Codex 功能深度 ✅ 官方一等公民,随 CLI 同步 需等第三方适配
多引擎(Claude/Gemini…) ❌ 仅 Codex ✅
中文界面 ❌ ✅
供应商/渠道管理 UI ❌ 需手写配置 ✅ WebUI
网关兼容 ✅(经桥接) ✅(经桥接)
Computer use ❌ 区域禁用 —(无此功能)

建议(2026-11-17 更新):主用官方 App + 汉化副本(官方一等公民 + 全中文界面, 管理 UI 由 CodexBridge.exe 的 WebUI 承担)。CC GUI 已随旧三件套路线移除,上表仅作历史对比。 官方 App 与 CLI 共享同一桥接与会话,可随时切换。