开源项目
BigPizzaV3/CodexPlusPlus avatar
BigPizzaV3/CodexPlusPlus

Codex++ 评测:不改 app.asar 的 Codex 桌面端增强工具

CodexApp的增强工具,努力让Codex更好用、更舒适一个CodexApp的增强工具,努力让Codex网格更好用更舒适。

30,983 个 Star1,976 个 ForkRustAGPL-3.0
GitHub

秒懂

它是什么?
Codex++ 是一个面向 OpenAI Codex 和 ChatGPT 桌面应用的外部启动器与管理工具,通过 CDP 和本地辅助服务实现供应商切换、协议转换与会话管理。它不修改官方应用文件,但依赖频繁更新和第三方中转服务。
适合谁用?
Codex++ 适合那些已经使用 Codex 或 ChatGPT 桌面版,并且需要切换第三方 API 供应商或调整模型上下文的用户。它不适合对官方应用改动零容忍的人,也不适合希望长期稳定、不愿频繁跟随上游更新的团队。
能商用吗?
可以,但条件严格。AGPL-3.0 是网络 copyleft 许可证:如果别人通过网络使用你修改过的版本(例如作为托管服务),你必须以同一许可证向他们提供源代码。
还在维护吗?
在维护。仓库最近一次提交在 1 天前。
用什么语言写的?
主要是 Rust(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。

开源项目深度解析

它解决什么问题

OpenAI 的 Codex 桌面应用默认只走官方登录和官方 API,用户想换用第三方模型供应商时,通常需要修改安装目录里的 app.asar,或者依赖社区脚本频繁调整配置。Codex++ 把这一层抽离出来,做成一个外部启动器。它不碰官方应用的安装文件,而是通过 Chromium DevTools Protocol 和本地辅助服务来接管启动和通信。面向的人群很明确:用 Codex 或 ChatGPT 桌面版,同时想接入聚合供应商、自建网关或不同模型协议的开发者。对于只想用官方服务的用户,这个工具没有意义。

工作机制:CDP 与本地服务

根据 README 的描述,Codex++ 的核心是外部启动器,它启动官方桌面应用,并通过 Chromium DevTools Protocol 与应用的渲染进程通信。CDP 是 Chrome 远程调试协议,Codex 桌面应用基于 Electron,所以可以用它来注入脚本、监听网络请求或改写前端的 API 端点。同时,本地辅助服务负责供应商配置、模型列表和协议转换。协议转换指的是把 Responses API 的请求转成 Chat Completions 格式,或者反过来,这样用户可以在同一个界面里使用不同协议的供应商。这个设计避免了修改 app.asar,但也意味着每次官方应用更新,CDP 的接口可能变化,Codex++ 需要跟着适配。

安装与两个入口

安装从 GitHub Releases 下载安装包。Windows 有 exe 安装程序,macOS 分 Intel 和 Apple Silicon 两种 dmg。安装后有两个入口:Codex++ 负责静默启动官方应用并加载配置,Codex++ 管理工具负责管理供应商、模型、工具插件、会话、增强功能、脚本、更新和诊断。首次使用建议先打开管理工具,确认应用路径和运行状态,再配置供应商和增强功能。这个流程说明配置不是自动的,用户需要手动指定官方应用的安装路径,并且要先验证运行状态。对于不熟悉命令行或配置文件的用户,这个管理工具降低了门槛,但两个入口的区分可能让新用户困惑。

功能清单与上下文管理

功能表列出了供应商配置、模型与上下文、会话管理、增强功能等模块。供应商配置支持官方登录、官方登录混入 API、纯 API 和聚合供应商,协议支持 Responses 和 Chat Completions。模型与上下文部分提到每模型上下文窗口、自动压缩阈值和 model_catalog。这些功能意味着用户可以为不同模型设置不同的上下文长度,超过阈值时自动压缩对话历史。对于使用长上下文模型的用户,这个功能实用,但也依赖 Codex++ 对模型元数据的维护。README 中功能表被截断,会话管理和增强功能的具体细节没有展开,只能确认这些模块存在。

更新节奏与维护成本

仓库的最近发布记录显示 v1.2.56、v1.2.55 和 v1.2.54 分别发布于三天内的不同日期。这种几乎每天一个补丁的节奏,说明项目处于快速迭代期,也暗示上游 Codex 应用的变动频繁。对用户来说,这意味着需要频繁更新 Codex++ 才能保持兼容。AGPL-3.0 许可证要求修改后的衍生作品开源,如果你只是使用,不修改,影响不大;但如果你想集成到商业产品里,AGPL 的传染性需要评估。另外,README 中大量篇幅是赞助商广告,包括 API 中转服务商,这虽然不直接影响功能,但表明项目的商业模式依赖第三方供应商的推广,用户需要留意这些推荐是否影响功能设计的客观性。

局限性与适用边界

最明显的限制是它依赖 CDP,而 CDP 是调试协议,不是稳定的公开 API。官方应用一旦改变内部结构,Codex++ 可能失效。另一个问题是,协议转换并不保证所有模型都能完整支持 Responses 或 Chat Completions 的全部特性,比如工具调用、流式输出或图像输入,不同供应商的实现差异可能导致部分功能不可用。还有一个实际风险:如果官方应用检测到 CDP 调试连接,可能触发安全机制或服务条款问题。对于企业用户,使用第三方中转服务还涉及数据合规风险。如果你的需求只是简单的 API Key 切换,直接修改环境变量或使用官方支持的配置可能更简单,没必要引入一个额外启动器。

替代方案:cc-switch 与官方配置

README 中提到了 cc-switch 和链接导入,说明 Codex++ 支持从 cc-switch 导入配置。cc-switch 是一个独立的配置切换工具,通常通过修改配置文件或环境变量来切换 Codex 的 API 供应商,不涉及 CDP 或界面增强。它的思路更轻量,只解决供应商切换,不碰协议转换和会话管理。如果你只需要在不同中转服务之间切换,cc-switch 可能更稳定,因为它不依赖 CDP,但它的功能范围也更窄。Codex++ 的差异化在于把协议转换、上下文压缩和会话管理集成到一个图形界面里,适合需要这些高级功能的用户,但代价是更复杂的架构和更高的更新频率。

结论:谁该用,谁不该用

Codex++ 适合那些已经使用 Codex 桌面版,并且愿意接受频繁更新来换取供应商灵活性和界面增强的开发者。它不适合追求最小依赖的用户,也不适合对官方应用稳定性有严格要求的生产环境。采用前先验证三个点:你的官方应用版本与 Codex++ 的兼容性,第三方供应商是否支持你需要的协议,以及 AGPL-3.0 在你所在组织的使用方式是否可接受。这个项目的价值在于它把多个增强功能集中到一个工具里,但它的更新节奏和赞助商生态决定了它不是那种可以安装后长期不管的工具。

编辑结论

Codex++ 适合那些已经使用 Codex 或 ChatGPT 桌面版,并且需要切换第三方 API 供应商或调整模型上下文的用户。它不适合对官方应用改动零容忍的人,也不适合希望长期稳定、不愿频繁跟随上游更新的团队。采用前应先验证三件事:官方桌面应用的版本是否与当前 Codex++ 版本兼容,你计划使用的第三方供应商是否支持 Responses 或 Chat Completions 协议,以及 AGPL-3.0 对你所在组织的使用方式是否可接受。最终判断:Codex++ 是一个功能集中但更新节奏极快的工具,其价值取决于你能否接受它每两天一次的版本迭代。

官方来源

  1. Official README
  2. Project repository
  3. Release notes
社区笔记

社区笔记