codexplusplus

Codex++ 是面向 OpenAI Codex / ChatGPT 桌面应用的外部启动器与管理工具。它通过 Chromium DevTools Protocol 和本地辅助服务提供供应商切换、协议转换、会话管理与界面增强，不修改官方应用的 app.asar，也不向安装目录写入补丁文件。 安装后有两个入口：Codex++ 静默启动官方桌面应用并加载已保存的供应商配置与增强功能；Codex++ 管理工具用于管理供应商、模型、工具插件、会话、增强功能、脚本、更新和诊断。首次使用建议先打开管理工具确认应用路径和运行状态，再配置供应商与增强功能，最后从 Codex++ 入口启动。Windows 安装包创建桌面和开始菜单快捷方式，macOS DMG 安装 Codex++.app 与管理工具应用。 供应商配置支持官方登录、官方登录混入 API、纯 API、聚合供应商，以及 Responses / Chat Completions 协议、模型测试、模型列表、Provider Doctor、cc-switch 与链接导入。官方登录模式只使用官方账号；官方登录加 API 模式保留官方账号与插件入口，但模型请求始终走兼容 API；纯 API 模式完全使用自定义 Base URL 与 Key；聚合供应商可在多个普通 API 供应商之间路由，支持故障转移、按会话轮转、按请求轮转和权重轮转。Chat Completions 可通过本地代理转换为 Codex 使用的 Responses 协议。 模型与上下文方面，支持每模型上下文窗口、自动压缩阈值、model_catalog_json、通用配置，以及按供应商选择 MCP、Skill 和 Plugin。每模型窗口支持 1M、200K 或纯数字，Codex++ 会生成独立 model_catalog_json。 会话管理支持扫描本地会话、批量删除、Markdown 导出、Token 用量历史、Provider metadata 同步与备份。Codex 增强包括插件市场与模型白名单、会话操作、粘贴修复、中文界面、快速启动、会话宽度与滚动恢复、服务层级控制、Goals、Stepwise、图片覆盖层。开发工作流支持项目移动、Upstream worktree、线程 ID、Zed Remote 项目识别与打开。脚本与维护包括用户脚本安装与启停、应用检测、快捷方式、Watcher、环境冲突、日志诊断、健康检查和 Release 更新。所有界面增强都可以单独关闭，关闭 Codex 增强总开关后仍可作为供应商和启动管理工具使用。 数据位置包括 Codex 配置 ~/.codex/config.toml、登录状态 ~/.codex/auth.json、本地数据库 ~/.codex/sqlite/*.db（旧版回退 state_5.sqlite）、Codex++ 状态与日志 ~/.codex-session-delete/、Provider 同步备份 ~/.codex/backups_state/provider-sync。真实 API Key 只保存在本机。 项目通过 GitHub Release 发布安装包，Windows 生成 NSIS 安装程序，macOS 生成 Intel x64 和 Apple Silicon arm64 两个 DMG。管理工具关于页可检查并启动更新。项目采用 GNU Affero General Public License v3.0，SPDX 标识为 AGPL-3.0-only。Codex++ 依赖官方桌面应用的页面结构、CDP 和本地数据格式，官方应用更新后部分注入功能可能需要跟随适配。