CodexPlusPlus 为 OpenAI Codex / ChatGPT 桌面应用设计的增强工具
🧭 核心功能与定位
CodexPlusPlus(简称 Codex++)是一个不修改官方应用核心文件的增强层,其核心价值在于:
- 供应商灵活切换:支持在官方登录、官方登录混入 API、纯 API 和聚合供应商模式间切换,方便使用不同模型提供商。
- 会话管理增强:支持扫描、批量删除、导出会话(Markdown),查看 Token 用量历史。
- 界面与功能增强:提供插件市场、中文界面、会话宽度/滚动恢复、快速启动、Goals 和 Stepwise 建议等功能。
- 独立管理工具:通过图形化界面管理所有增强功能、脚本和配置。
📦 安装与部署
1. 获取安装包
从项目的 GitHub Releases 页面 下载对应系统的最新版本:
- Windows:
CodexPlusPlus-*-windows-x64-setup.exe - macOS Intel:
CodexPlusPlus-*-macos-x64.dmg - macOS Apple Silicon:
CodexPlusPlus-*-macos-arm64.dmg
2. 安装
- Windows:运行安装程序,会创建桌面和开始菜单快捷方式。
- macOS:挂载 DMG 文件,将
Codex++.app和Codex++ 管理工具.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++ 管理工具:用于配置供应商、模型、工具插件、增强功能、脚本和诊断。
建议工作流:
- 打开
Codex++ 管理工具。 - 在“供应商”中配置你需要的 API 提供商(如官方、JOJO Code、APIKEY.FUN 等),填写 Base URL、API Key 和模型列表。
- 在“增强功能”中按需开启或关闭各项界面增强(如中文界面、会话管理)。
- 保存配置后,关闭管理工具,通过
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 中转服务,可根据需要选择。
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 极客的赛博空间 | 专注 AI 与技术分享!
评论






