Codex++（CodexPlusPlus）：OpenAI Codex/ChatGPT 桌面应用的外部启动器与增强管理工具

Codex++ 是一个面向 OpenAI Codex / ChatGPT 桌面应用的外部启动器与管理工具。它通过 Chromium DevTools Protocol 和本地辅助服务提供供应商切换、协议转换、会话管理与界面增强，不修改官方应用的 app.asar，也不向安装目录写入补丁文件。

项目采用 GNU Affero General Public License v3.0（AGPL-3.0-only）开源，许可证只覆盖 CodexPlusPlus 自身代码，不授予 OpenAI、ChatGPT、Codex 的商标、应用资源或其他第三方内容的权利。修改并分发本项目，或通过网络提供修改后的版本时，需要按 AGPLv3 提供对应源代码。

核心能力包括：供应商配置（官方登录、官方登录混入 API、纯 API、聚合供应商；Responses / Chat Completions；模型测试、模型列表、Provider Doctor、cc-switch 与链接导入）；模型与上下文（每模型上下文窗口、自动压缩阈值、model_catalog_json、通用配置，以及按供应商选择 MCP、Skill 和 Plugin）；会话管理（扫描本地会话、批量删除、Markdown 导出、Token 用量历史、Provider metadata 同步与备份）；Codex 增强（插件市场与模型白名单、会话操作、粘贴修复、中文界面、快速启动、会话宽度与滚动恢复、服务层级控制、Goals、Stepwise、图片覆盖层）；开发工作流（项目移动、Upstream worktree、线程 ID、Zed Remote 项目识别与打开）；脚本与维护（用户脚本安装与启停、应用检测、快捷方式、Watcher、环境冲突、日志诊断、健康检查和 Release 更新）。

所有界面增强都可以单独关闭。关闭“Codex 增强”总开关后，Codex++ 仍可作为供应商和启动管理工具使用。

供应商模式方面，Codex++ 将官方登录、混入 API 和纯 API 分开保存和切换。官方登录只使用 ChatGPT / Codex 官方账号，会清理自定义 provider 和 API Key，保留官方登录状态；官方登录 + API 保留官方账号与插件入口，模型请求始终走兼容 API，不消耗官方额度，也不是官方优先回落，API Key 写入 provider bearer token，不写入纯 API 的 auth.

json；纯 API 不依赖官方账号，完全使用自定义 Base URL / Key，独立保存 config.toml 与 API Key，不混入官方认证；聚合供应商在多个普通 API 供应商之间路由，支持故障转移、按会话轮转、按请求轮转和权重轮转。每个供应商可配置 Responses 或 Chat Completions 协议、模型列表、测试模型、User-Agent、上下文窗口、自动压缩阈值，以及该供应商启用的 MCP Server、Skill 和 Plugin。

Chat Completions 可通过本地代理转换为 Codex 使用的 Responses 协议。每模型窗口支持 1M、200K 或纯数字。切换供应商时会先保存当前配置，再写入目标配置。

数据位置方面，Codex 配置为 ~/.codex/config.toml，Codex 登录状态为 ~/.codex/auth.json，Codex 本地数据库优先读取 ~/.codex/sqlite/*.db，旧版回退到 ~/.codex/state_5.sqlite，Codex++ 状态与日志位于 ~/.codex-session-delete/，Provider 同步备份位于 ~/.codex/backups_state/provider-sync。真实 API Key 只保存在本机，请勿放入日志、截图或 issue。

兼容性方面，Codex++ 依赖官方桌面应用的页面结构、CDP 和本地数据格式。官方应用更新后，部分注入功能可能需要跟随适配；修改供应商配置或本地会话数据前应保留备份。项目通过 GitHub Release 发布安装包，Windows 会生成 NSIS 安装程序，macOS 会生成 Intel x64 和 Apple Silicon arm64 两个 DMG；管理工具的“关于”页可以检查并启动更新。

— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。