Codex++
中文 | English
Codex++ 是面向 OpenAI Codex / ChatGPT 桌面应用的外部启动器与管理工具。它通过 Chromium DevTools Protocol 和本地辅助服务提供供应商切换、协议转换、会话管理与界面增强，不修改官方应用的 app.asar，也不向安装目录写入补丁文件。
快速使用
从 GitHub Releases 下载最新版安装包：
- Windows：
CodexPlusPlus-*-windows-x64-setup.exe - macOS Intel：
CodexPlusPlus-*-macos-x64.dmg - macOS Apple Silicon：
CodexPlusPlus-*-macos-arm64.dmg
安装后会有两个入口：
Codex++：静默启动官方桌面应用，并加载已保存的供应商配置与增强功能。Codex++ 管理工具：管理供应商、模型、工具插件、会话、增强功能、脚本、更新和诊断。
首次使用建议先打开管理工具，确认应用路径和运行状态，再配置供应商与增强功能，最后从 Codex++ 入口启动。Windows 安装包会创建桌面和开始菜单快捷方式；macOS DMG 会安装 /Applications/Codex++.app 和 /Applications/Codex++ 管理工具.app。
赞助商
JOJO Code
JOJO Code 提供稳定、价格合理的 API 中转服务，支持 GPT-5.6 全系列、Fable 5、Sonnet 5、GPT-5.5、GPT-5.4、Claude Opus 4.8、Claude Opus 4.7、gpt-image-2 等模型与图像能力，适合日常开发、团队协作和长期项目工作流。
| 🏆 赞助商 🏆 | 介绍 |
|---|---|
|
|
JOJO Code JOJO Code 提供稳定、价格合理且易于接入的 API 中转服务，支持 GPT-5.6 全系列、Fable 5、Sonnet 5、GPT-5.5、GPT-5.4、Claude Opus 4.8、Claude Opus 4.7、gpt-image-2 等模型与图像能力，适合日常开发、快速配置、团队协作和长期使用。 |
|
APIKEY.FUN 感谢 APIKEY.FUN 赞助了本项目！APIKEY.FUN 是一家致力于提供开放、稳定、高性价比的全球主流大模型的 AI 中转站。平台支持 Claude、OpenAI、Gemini 等热门模型的 API 中转服务，价格低至官方原价的 7%。通过专属链接注册 APIKEY，可享受最高充值永久 95 折优惠。 |
|
GrooRoute｜官方原模型 API GrooRoute 提供 Claude 与 GPT 全系官方原模型，一行配置即可接入 Claude Code、Codex 或直接调用 API，官方承诺不掺假、永久保真。限时注册活动：充值 50 美元赠送 50 美元，通过专属链接注册并完成充值后，联系客服即可获取优惠。官网：grooroute.com。 |
|
屹芸科技 屹芸科技旗下拥有九五云商发卡网、屹芸付支付系统等面向 AI 聚合赛道的收付产品，支持微信、支付宝、银联、云闪付等通道，提供低费率、D1/D0 结算、7×24 小时技术支持和企微客户专属服务群。平台通道费率稳定、结算准时，并提供高强度网站防护，帮助商户稳定开展线上销售。 |
|
火山引擎｜方舟 Agent Plan 感谢火山引擎赞助本项目！方舟 Agent Plan 模型订阅套餐集成了 Doubao-Seed、Doubao-Seedance、Doubao-Seedream 等字节跳动自研 SOTA 级模型，覆盖文本、代码、图像、视频等多模态任务。最新支持 MiniMax-M3、DeepSeek-V4 系列、GLM-5.2、Doubao-Seed-2.0 系列、Kimi-K2.7 等模型，工具不限。超全模态模型与 Harness 升级一步到位，深度支持 Agent 框架与 AI 编程工具。一次订阅，可以为不同任务切换合适的 AI 引擎。方舟 Agent Plan 限时 2.5 折订阅，点击链接抢购，名额有限，先到先得。For developers outside Mainland China, please click here。 |
|
百可为AI 百可为AI 是面向开发者、团队和 AI 工具用户的一站式大模型 API 服务平台，支持 Claude、OpenAI、Gemini、Codex 等主流模型能力接入。平台提供稳定中转、灵活计费、用量统计、余额管理和多场景 API 调用能力，适合 Claude Code、Codex、AI 生图、自动化脚本和各类智能应用长期使用。新用户注册可领取免费额度，开发者可快速接入、即开即用，让 AI 能力更稳定、更高效、更省心。 |
|
API Mart 感谢 API Mart 赞助了本项目！API Mart 是专注 AI 图片和视频生成的低价 API 平台，GPT-Image-2 低至每张 0.006 美元，1 美元可生成 160 多张图片。图片、视频使用一套异步 API，提交任务获取 ID 后可通过轮询或回调取得结果；支持数万张批量任务，切换模型无需改代码。按量付费、无月费，通过此链接注册即可使用。 |
|
FennoAI FennoAI 是一家稳定、高效的 API 中转服务商，目前主要提供 Codex 中转服务，兼容 OpenAI 及 Anthropic 协议，可灵活接入 Codex、Claude Code、OpenCode 等主流编程工具，稳定支撑千亿 Token/日的企业级调用需求，支持国内及海外主体公对公结算、开票。通过专属链接购买订阅，仅需 1.99 美元即可获得价值 50 美元的 Coding Plan 额度；邀请好友购买最高可获得 20% 返佣。 |
|
七牛云 感谢七牛云 AI 赞助本项目！七牛云 AI 是七牛云（02567.HK）旗下企业级大模型 MaaS 平台，可一站式调用全球 150 多个主流模型，兼容全球主流模型厂商协议，覆盖文本、图像、音频、视频、文件处理等全模态能力，服务超过 169 万企业及开发者用户。企业用户可免费领取 1200 万 Token，邀请好友最高可获得百亿 Token。 |
交流与支持
欢迎加入 Codex++ 交流 4 群（QQ群：1127858981），反馈问题、交流使用体验或提出新功能建议。点击链接加入群聊。
Telegram 频道：https://t.me/CodexPlusPlus
友情链接：LINUX DO
当前功能
| 模块 | 功能 |
|---|---|
| 供应商配置 | 官方登录、官方登录混入 API、纯 API、聚合供应商；Grok 供应商管理；Responses / Chat Completions；模型测试、模型列表、Provider Doctor、cc-switch 与链接导入 |
| 模型与上下文 | 每模型上下文窗口、自动压缩阈值、model_catalog_json、模型元数据导入（models.json）、通用配置，以及按供应商选择 MCP、Skill 和 Plugin |
| 会话管理 | 扫描本地会话、批量删除、Markdown 导出、Token 用量历史、Provider metadata 同步与备份 |
| 微信连接 | 个人微信扫码连接本机 Codex 会话，每个微信联系人映射到独立会话，可配置允许的微信用户 |
| 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++ 会生成独立 model_catalog_json，让 Codex 按当前模型使用对应窗口。
切换供应商时会先保存当前配置，再写入目标配置。真实 API Key 只保存在本机，请勿放入日志、截图或 issue。
Codex 界面增强
- 会话删除、批量删除、Markdown 导出和项目移动。
- 插件市场解锁、插件自动展开和模型白名单处理。
- 富文本粘贴转纯文本、强制中文、启动加速和原生菜单本地化。
- 会话宽度、滚动位置恢复、线程 ID、服务层级切换和 Goals。
- Stepwise 下一步建议，可单独配置 API、模型、建议数量与超时。
- 皮肤管理：Dream Skin 社区主题的搜索、预览、安装和换图。
- Upstream worktree、Zed Remote、自定义图片覆盖层和用户脚本。
依赖注入脚本的设置通常需要保存后重新启动 Codex++ 才会生效。
自动更新与安装包
Codex++ 通过 GitHub Release 发布安装包。Windows 会生成 NSIS 安装程序，macOS 会生成 Intel x64 和 Apple Silicon arm64 两个 DMG。
管理工具的“关于”页可以检查并启动更新。静默启动器发现新版本时会拉起管理工具并进入更新提示。
数据位置
以下 ~/.codex 均指 Codex 主目录：设置了 CODEX_HOME 环境变量时以该目录为准，否则为用户目录下的 .codex。
- 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
常见问题
Codex++ 菜单没出现
确认从 Codex++ 入口启动，而不是直接打开官方应用。然后在管理工具的“安装维护”和“关于”页面检查应用路径、启动状态与诊断日志。
切换供应商后请求失败
先在供应商详情中运行模型测试或 Provider Doctor，并确认协议、Base URL、Key 和测试模型匹配。纯 API 与官方混入模式使用不同的认证位置，不要手工复制两种模式的 auth.json。
混入 API Key 模式是“官方优先、额度不足时 API 补偿”吗
不是。官方登录 + API（混入）模式下，模型请求始终走你配置的兼容 API，官方账号只保留登录状态和插件入口，不会先消耗官方额度再回落到 API。需要“一个供应商失败时切到另一个”的行为时，使用聚合供应商：它支持故障转移、按会话轮转、按请求轮转和权重轮转。两种模式的认证保存位置不同，配置前先在供应商详情里用模型测试确认目标 API 可用。
Upstream worktree 和 Codex 原生创建有什么区别
Codex++ 的 Upstream worktree 功能等价于先更新远端分支，再执行：
git worktree add -b <new-branch> <worktree-path> upstream/<base-branch>这样新 worktree 从最新的远端跟踪分支开始，而不是从当前会话所在的本地 HEAD 开始。如果 Codex++ 无法安全识别当前 Codex 版本的原生 worktree 创建表单，请从 Codex++ 菜单中手动填写仓库路径、分支名、worktree 路径、remote 和 base branch。
macOS 提示无法打开或已损坏
当前安装包未签名/未公证时，macOS Gatekeeper 可能拦截，出现“已损坏，无法打开”的提示：
如果遇到该提示，可以在终端执行下面两条命令，解除苹果系统的安全隔离限制：
sudo xattr -rd com.apple.quarantine /Applications/Codex++\ 管理工具.app
sudo xattr -rd com.apple.quarantine /Applications/Codex++.app执行后重新打开 Codex++ 或 Codex++ 管理工具 即可。
macOS Intel 能用吗
可以。Release 会分别提供 macos-x64.dmg 和 macos-arm64.dmg。Intel Mac 下载 x64 包，Apple Silicon 下载 arm64 包。
开发
# 前端检查
cd apps/codex-plus-manager
npm ci
npm run check
npm run vite:build
# Rust 检查
cd ../..
cargo fmt --all -- --check
cargo test
cargo build --release主要结构：
apps/
codex-plus-launcher/ 静默启动入口
codex-plus-manager/ Tauri 管理工具
assets/inject/
renderer-inject.js 注入到 Codex 渲染端的增强脚本
crates/
codex-plus-core/ 启动、注入、配置、更新、安装、桥接等核心逻辑
codex-plus-data/ 会话数据、导出、Provider 同步
scripts/installer/
windows/CodexPlusPlus.nsi Windows NSIS 安装包
macos/package-dmg.sh macOS DMG 打包
开源协议
Copyright (C) 2026 BigPizzaV3
CodexPlusPlus 采用 GNU Affero General Public License v3.0，SPDX 标识为 AGPL-3.0-only。修改并分发本项目，或通过网络提供修改后的版本时，需要按 AGPLv3 提供对应源代码。
许可证只覆盖 CodexPlusPlus 自身代码，不授予 OpenAI、ChatGPT、Codex 的商标、应用资源或其他第三方内容的权利。
兼容性说明
Codex++ 依赖官方桌面应用的页面结构、CDP 和本地数据格式。官方应用更新后，部分注入功能可能需要跟随适配；修改供应商配置或本地会话数据前应保留备份。
