给 Codex 桌面应用加一层供应商与增强管理（Codex++）

官方 Codex 桌面端的模型请求、认证方式和界面结构都固定在安装包里。想换成第三方中转站的 Key，想在几个供应商之间来回切，想给会话加导出或者把界面改成中文，通常得去动 app.asar 这类文件。官方一升级，改动就失效，严重的时候应用直接起不来。

Codex++ 是 Codex / ChatGPT 桌面应用的外部启动器与管理工具，用 Rust 与 Tauri 写成，输入供应商配置与会话数据，输出可切换的模型供应商与增强后的 Codex 界面。

它在官方应用外面套一层：不修改官方应用的 app.asar，也不向安装目录写入补丁文件，接入方式是通过 Chromium DevTools Protocol 和本地辅助服务。典型场景是手上有几个 API 中转站，想在 Codex 里按任务换模型；或者只想用官方账号登录，但希望界面更顺手。管理工具负责配置，Codex++ 入口负责按已保存的配置启动官方应用，是两个独立程序。

第一次用它需要知道的事

Codex++ 以 AGPL-3.0 许可证开源，主要语言是 Rust，占 50.2%，其余为 JavaScript 32.9%、TypeScript 11.1%。仓库 BigPizzaV3/CodexPlusPlus 目前 31870 star、2034 fork、751 个开放 Issue，创建于 2026-05-06，最近一次提交在 2026-10-07。

• 先装官方 Codex / ChatGPT 桌面应用。Codex++ 是外部启动器，本身不提供模型能力，官方应用不在，它无从接管。
• 要自备凭据：纯 API 模式需要自己的 Base URL 与 API Key；官方登录模式需要 ChatGPT / Codex 官方账号。
• 安装包按平台区分。Windows 是 CodexPlusPlus-*-windows-x64-setup.exe；macOS 从 v1.5.4 起改为 universal 通用包，一个 DMG 同时支持 Intel 与 Apple Silicon，装上后自动以原生架构运行。v1.5.4 之前是 CodexPlusPlus-*-macos-x64.dmg 与 CodexPlusPlus-*-macos-arm64.dmg 分架构包。
• macOS 包从 v1.5.3 起用 Developer ID 正式签名并提交 Apple 公证，票据装订进 DMG，双击即可打开。此前的 ad-hoc 签名版本会被 Gatekeeper 拦下，报「已损坏，无法打开」或者「无法验证开发者」。
• 微信连接功能要你填 Codex CLI 路径，路径不对会直接报错。安装包体积和系统版本下限，仓库里没有说明。

最短上手路径

1. 从 GitHub Releases 下载对应平台的安装包，仓库没有提供命令行安装方式，只有图形安装包。
2. 安装后会出现两个入口：Codex++ 与 Codex++ 管理工具。Windows 会创建桌面和开始菜单快捷方式，macOS 装到 /Applications/Codex++.app 与 /Applications/Codex++ 管理工具.app。
3. 先打开 Codex++ 管理工具，确认官方应用路径和运行状态。
4. 在管理工具里配好供应商，四种模式任选其一，配置分开保存、随时切换。
5. 按需打开界面增强项，然后从 Codex++ 入口启动，官方应用会带着已保存的供应商配置和增强功能起来。
6. 不想用增强功能时，关掉「Codex 增强」总开关，Codex++ 仍可作为供应商与启动管理工具使用。

它实际上能做哪些事

供应商与协议路由

• 四种供应商模式：官方登录 只使用官方账号；官方登录 + API 保留官方账号与插件入口，模型请求始终走兼容 API，不消耗官方额度；纯 API 完全使用自定义 Base URL 与 Key，独立保存 config.toml 与 API Key；聚合供应商 在多个普通 API 供应商之间路由。
• 每个供应商可选 Responses 或 Chat Completions 协议；聚合模式支持故障转移、按会话轮转、按请求轮转和权重轮转。
• 配套的模型测试、模型列表、Provider Doctor，以及 cc-switch 配置与链接导入。

会话、模型与微信连接

• 会话管理：扫描本地会话、批量删除、Markdown 导出、Token 用量历史，以及 Provider metadata 的同步与备份。
• 模型与上下文控制：为每个模型设置上下文窗口和自动压缩阈值，通过 model_catalog_json 引入模型元数据，也可以从 models.json 导入，并按供应商选择 MCP、Skill 与 Plugin。
• 微信连接：用个人微信扫码连接本机 Codex 会话，每个微信联系人映射到独立会话，可配置允许的微信用户名单。

界面增强与维护工具

• 界面增强包含插件市场与模型白名单、会话操作、粘贴修复、中文界面、快速启动、会话宽度与滚动恢复、服务层级控制、Goals、Stepwise、皮肤管理和图片覆盖层，每一项都可以单独关闭。
• 开发工作流方面提供项目移动、Upstream worktree、线程 ID，以及 Zed Remote 项目的识别与打开。
• 脚本与维护方面有用户脚本的安装与启停、应用检测、快捷方式、Watcher、环境冲突检查、日志诊断、健康检查和 Release 更新。

参数速查

• 认证边界：官方登录 会清理自定义 provider 和 API Key，保留官方登录状态；官方登录 + API 把 API Key 写入 provider bearer token，不写进纯 API 的 auth.json；纯 API 的 config.toml 与 Key 独立保存，不混入官方认证。
• 协议字段：每个供应商在 Responses 与 Chat Completions 之间选一个。
• 聚合路由：故障转移、按会话轮转、按请求轮转、权重轮转。
• 上下文：每模型上下文窗口加自动压缩阈值，配合 model_catalog_json 与 models.json 使用。
• 总开关：「Codex 增强」关闭后，供应商与启动管理功能照常。

仓库没有给出这些字段的完整默认值和取值范围，实际填写以管理工具界面里的表单为准。

输出与结果位置

配置结果落在管理工具里。模型测试、Provider Doctor、健康检查、日志诊断、环境冲突和应用检测的结果，都在对应页面里看。会话相关的结果在会话管理里：扫描到的本地会话、批量删除的结果、导出的 Markdown 文件和 Token 用量历史。更新检查在 Release 更新入口，也可以直接去 GitHub Releases 看安装包。

启动后实际产生的就是官方 Codex 桌面应用本身，它会带着已保存的供应商配置和打开了的增强项运行。日志文件的具体存放路径仓库里没有说明，排障时从管理工具的日志诊断入口走。

实际使用中的坑

• 升级到 v1.1.8 后历史对话全部消失、computer use 无法使用，该 Issue 评论 24 条，状态是已解决。
• 用微信消息处理功能发送消息时提示「处理微信消息失败：无法启动 Codex app-server（codex），请检查 Codex CLI 路径」。Windows 11 环境下常见原因是 Codex CLI 路径没填对，Issue 已解决。
• 1.1.9 版本打开插件市场不显示任何插件，即使 Codex 已经是最新版也是如此，该问题当前是待解决状态。
• macOS M1 更新到 1.1.8 后能显示模型，对话却报 unexpected status 502 Bad Gateway，请求打到 http://127.0.0.1:57321/v1/responses，这个 Issue 同样待解决。

还有一类已经解决的报错也出现过：用 API Key 模式配置供应商后，Chrome 插件能够显示和选择，实际调用时却报 unsupported Codex auth method: apikey，在 v1.3.0 上被记录。

替代方案一览

下面这张表把 Codex++ 和两个在自托管与 AI 工具周边方向上被收录的项目放在一起，方便判断选型位置。

这两个项目与本项目解决的问题并不重合，列在这里只作选型参照。Codex++ 的短板在依附关系：它挂在官方 Codex 桌面应用外面，官方改一次界面结构就可能让入口消失，v1.5.0 就修过一次导航栏改版导致的静默失效。你不需要供应商切换和协议转换，只想给编程助手加个桌面装饰，dsh-pet 的介入更浅；你要的是完整的即时通讯能力，HuLa 覆盖的是消息本身。

别踩的合规线

Codex++ 通过 Chromium DevTools Protocol 注入官方桌面应用，还能解锁模型白名单、改写供应商认证信息。这类改动可能触及 OpenAI 的服务条款，账号被限制的风险由使用者自己承担。它适合在自己的设备、自己的账号上管理自己付费的模型服务。

用第三方中转站的 Key 时，等于把凭据交给对方，选服务商之前先确认对方的口碑与隐私政策。微信连接会把本机 Codex 会话接到你的个人微信上，配置允许的微信用户名单要收紧，避免会话内容流到不该看到的人手里。

项目本身以 AGPL-3.0 发布。基于它改代码后对外分发，或者把改过的版本作为网络服务提供给别人用，AGPL 都要求开放对应源码，商用前要评估清楚这一条。

什么时候值得用它

• 你已经在用官方 Codex 桌面端，并且需要在官方账号和几个 API 供应商之间频繁切换。
• 你需要按供应商分别管理 MCP、Skill 与 Plugin，或者给每个模型单独设上下文窗口和压缩阈值。
• 你接受「跟着官方版本升级修修补补」的节奏。仓库最近一次提交在 2026-10-07，v1.5.0 到 v1.5.4 之间连续发了五个版本，维护活跃，但官方改版时入口仍可能短暂失效。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.5 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。