🧭 核心功能与定位

CodexPlusPlus(简称 Codex++)是一个不修改官方应用核心文件的增强层,其核心价值在于:

  • 供应商灵活切换:支持在官方登录、官方登录混入 API、纯 API 和聚合供应商模式间切换,方便使用不同模型提供商。
  • 会话管理增强:支持扫描、批量删除、导出会话(Markdown),查看 Token 用量历史。
  • 界面与功能增强:提供插件市场、中文界面、会话宽度/滚动恢复、快速启动、Goals 和 Stepwise 建议等功能。
  • 独立管理工具:通过图形化界面管理所有增强功能、脚本和配置。

📦 安装与部署

1. 获取安装包

从项目的 GitHub Releases 页面 下载对应系统的最新版本:

  • WindowsCodexPlusPlus-*-windows-x64-setup.exe
  • macOS IntelCodexPlusPlus-*-macos-x64.dmg
  • macOS Apple SiliconCodexPlusPlus-*-macos-arm64.dmg

2. 安装

  • Windows:运行安装程序,会创建桌面和开始菜单快捷方式。
  • macOS:挂载 DMG 文件,将 Codex++.appCodex++ 管理工具.app 拖入 /Applications 文件夹。

macOS 安全提示:由于安装包未签名,首次打开可能会被 macOS 拦截(提示“已损坏”)。在终端执行以下命令解除隔离:

1
2
sudo xattr -rd com.apple.quarantine /Applications/Codex++\ 管理工具.app
sudo xattr -rd com.apple.quarantine /Applications/Codex++.app

3. 首次启动配置

安装后有两个入口:

  • Codex++:静默启动官方 Codex 应用,并加载已保存的增强功能。
  • Codex++ 管理工具:用于配置供应商、模型、工具插件、增强功能、脚本和诊断。

建议工作流

  1. 打开 Codex++ 管理工具
  2. 在“供应商”中配置你需要的 API 提供商(如官方、JOJO Code、APIKEY.FUN 等),填写 Base URL、API Key 和模型列表。
  3. 在“增强功能”中按需开启或关闭各项界面增强(如中文界面、会话管理)。
  4. 保存配置后,关闭管理工具,通过 Codex++ 入口启动官方应用。

⚙️ 核心功能详解

1. 供应商模式

管理工具中可配置四种模式:

  • 官方登录:仅使用官方 Codex/ChatGPT 账号。
  • 官方登录 + API:保留官方界面,但模型请求走自定义 API(适合使用中转服务)。
  • 纯 API:完全基于自定义 API,不依赖官方账号。
  • 聚合供应商:在多个 API 供应商之间自动路由(支持故障转移、轮询等策略)。
    每个供应商可独立配置协议(Responses/Chat Completions)、模型列表、上下文窗口大小和 MCP/Skill/Plugin 启用情况。

2. Codex 界面增强

可在管理工具中独立开关的增强功能包括:

  • 会话管理:在界面中增加删除、批量删除、导出会话为 Markdown 的功能。
  • 插件市场:解锁插件市场、自动展开插件列表。
  • 中文界面:强制将界面语言切换为中文。
  • 启动加速:快速启动、原生菜单本地化。
  • 实用工具:富文本粘贴转纯文本、会话宽度调整、滚动位置恢复、服务层级切换。
  • Goals & Stepwise:提供目标管理和逐步建议功能。

3. 脚本与维护

管理工具还提供:

  • 用户脚本:安装和启停自定义脚本。
  • 健康检查与诊断:查看日志、诊断环境冲突。
  • 自动更新:管理工具的“关于”页可检查并启动更新。

❓ 常见问题

  • Codex++ 菜单没出现? 确认是从 Codex++ 入口启动,而非直接打开官方应用。在管理工具的“安装维护”和“关于”中检查应用路径和启动状态。
  • 切换供应商后请求失败? 在供应商详情中运行“模型测试”或“Provider Doctor”,检查 Base URL、API Key 和协议是否匹配。
  • 数据存在哪里? Codex 配置在 ~/.codex/,Codex++ 状态在 ~/.codex-session-delete/
  • Windows 上安装后无法运行? 确保已安装最新 Visual C++ Redistributable。

总结

CodexPlusPlus 为希望扩展 Codex 官方应用功能或使用第三方 API 的用户提供了一个强大的外部管理工具。部署非常直接(下载安装包即可),配置主要通过其图形化的“管理工具”完成。它的核心价值在于将供应商切换、会话管理和多种界面增强集成到一个可控的界面中,并且不修改官方应用的核心文件,降低了更新带来的兼容性风险。由于项目采用 AGPL-3.0 许可证,请注意其开源条款。项目有多个赞助商提供 API 中转服务,可根据需要选择。