不想装 Python、不想改源码的用户/AI,直接用这个exe即可。想自己改再打包的看文末「从源码打包」。
一个 CodexBridge.exe 同时承担三个角色:
| 角色 | 说明 |
|---|---|
| 托盘 | 右下角图标,绿=桥接运行中、灰=停止;菜单可启动/停止/重启桥接、开关机自启、打开管理界面、退出 |
| 管理 WebUI | http://127.0.0.1:8789/ —— 图形化配置网关地址、API Key、模型、多上游路由 |
桥接 :8787 |
api2codex:把 Codex 的 Responses API 转成网关的 Chat Completions(含 11128 渠道校验的提示词中性化) |
单文件设计:托盘进程用同一个 exe 加 --bridge 参数拉起桥接子进程,因此分发只需一个文件。
CodexBridge.exe,放到任意文件夹(例如 D:\CodexBridge\)。
不要放在 C:\Program Files 等需要管理员权限的目录——它要在同目录写配置。bridge-data\,里面是通用配置模板
(不含任何真实 API Key,需你自己填)。http://127.0.0.1:8787/v1
(按 ../../config/codex-config.toml.template 写 ~/.codex/config.toml)。bridge-data\ 里的文件:
config.json — 供应商/模型配置(WebUI 读写).env — 桥接进程环境变量(上游地址、Key、SANITIZE_PROMPT=1)routes.json — 多上游路由(如 7864- 前缀转发到第二个网关).bridge.pid / *.log — 运行状态与日志托盘菜单勾选「开机自动启动」即可(写 HKCU\...\Run,指向 exe 自身,无需管理员权限)。
cd bridge
build-exe.cmd
脚本会:建独立 venv → 装依赖 + PyInstaller → 按 CodexBridge.spec 打包 → 输出
bridge\exe\CodexBridge.exe。需联网(首次装依赖)、Python 3.10+。
源码入口是 bridge_app.py(统一入口),改造后的 tray.py / webui.py / api2codex.py
通过环境变量 BRIDGE_DATA_DIR 区分「源码目录」和「exe 的 bridge-data 目录」——
源码模式(直接 python bridge_app.py)行为与打包前完全一致。
bridge-data\tray-error.log。多半是端口被占用或配置损坏。bridge-data\webui-tray.log。.env 里 SANITIZE_PROMPT=1。port,或 .env 的 PORT(两者要一致)。spec 里已关闭 UPX 压缩降低误报,
仍报的话可加白名单或从源码打包。