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 安装器并自动开始下载(无需点击确认):
OpenAI.Codex(x64)C:\Program Files\WindowsApps\OpenAI.Codex_<版本>_x64__2p2nqsd0c76g0\安装完成后可用 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、一份会话存储、一份模型目录。
App 设置里的 Computer use(让 ChatGPT 驱动本机应用,如 Google Chrome)显示:
Disabled by your organization or unavailable in your region
这是 OpenAI 云端功能的区域/账号限制——官方 App 的 ChatGPT 部分需要 OpenAI 账号体系,该功能按区域灰度。Codex 本地功能(桥接对话、工作区、会话)完全不受影响。
~/.codex)model_catalog_json 生效:模型选择器列出 29 个模型(含 7864- 前缀)SANITIZE_PROMPT=1)对官方 App 同样生效——App 发送的提示词同样
会被 7863 的渠道指纹拦截,桥接已统一改写要自己动手?直接看
官方桌面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 复核修正):
~/.codex/codex-localized/app,不动 WindowsApps)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 替换是冗余的。
[{"file":"resources\app.asar","alg":"SHA256","value":"..."}])--lang=zh-CN 启动 → 菜单(文件/编辑/视图/帮助)、侧栏(新对话/定时任务/
插件/项目/最近)、主界面(我们要构建什么?)、底部(选择项目/完全访问)
全部中文exe 完整性校验的机制(踩坑记录):
1c5b4197…,逐文件 hash == SHA256(content))patch_inplace.py 改字节后直接离线重算并写回 exe,无需启动报错回填;
若仍遇 FATAL (expected vs actual),可用 sync_exe_hash.py 把 actual 写回作应急App 内 Computer use(让 ChatGPT 驱动本机应用,如 Chrome)显示
Disabled by your organization or unavailable in your region。
这是 OpenAI 服务端的区域/账号灰度,不做客户端破解,三个理由:
替代方案(本机已具备):
| 需求 | 用什么 |
|---|---|
| 操控本机应用(GUI 自动化) | CC GUI 自带的 computer-use 驱动(ccgui-computer-use.exe) |
| 浏览器自动化 | ZCode 的 browser-use;Codex CLI 的 browser_use 特性也是 stable |
| 网关对话 | 官方 App / CC GUI / CLI 三端走同一桥接 |
另外,7864 网关实测没有 11128 渠道指纹校验,是更干净的上游。
| 官方桌面 App | CC GUI | |
|---|---|---|
| Codex 功能深度 | ✅ 官方一等公民,随 CLI 同步 | 需等第三方适配 |
| 多引擎(Claude/Gemini…) | ❌ 仅 Codex | ✅ |
| 中文界面 | ❌ | ✅ |
| 供应商/渠道管理 UI | ❌ 需手写配置 | ✅ WebUI |
| 网关兼容 | ✅(经桥接) | ✅(经桥接) |
| Computer use | ❌ 区域禁用 | —(无此功能) |
建议(2026-11-17 更新):主用官方 App + 汉化副本(官方一等公民 + 全中文界面, 管理 UI 由 CodexBridge.exe 的 WebUI 承担)。CC GUI 已随旧三件套路线移除,上表仅作历史对比。 官方 App 与 CLI 共享同一桥接与会话,可随时切换。