CodexPlusPlus README

The project's README from github.com/BigPizzaV3/CodexPlusPlus. As one markdown file: README.md.

Codex++

Codex++ 图标

中文 | English

Release Stars License Rust Tauri

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

快速使用

从 GitHub Releases 下载最新版安装包：

安装后会有两个入口：

首次使用建议先打开管理工具，确认应用路径和运行状态，再配置供应商与增强功能，最后从 Codex++ 入口启动。Windows 安装包会创建桌面和开始菜单快捷方式；macOS DMG 会安装 /Applications/Codex++.app 和 /Applications/Codex++ 管理工具.app。

赞助商

JOJO Code

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
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 赞助了本项目！APIKEY.FUN 是一家致力于提供开放、稳定、高性价比的全球主流大模型的 AI 中转站。平台支持 Claude、OpenAI、Gemini 等热门模型的 API 中转服务，价格低至官方原价的 7%。通过专属链接注册 APIKEY，可享受最高充值永久 95 折优惠。
RunAPI RunAPI
RunAPI 是高效稳定的 API OpenRouter 平替平台，一个 API Key 即可访问 OpenAI、Claude、Gemini、DeepSeek、Grok 等 150+ 主流模型，低至 1 折，极其稳定，可以无缝兼容 Claude Code、OpenClaw 等工具。
quya.org 云桥 quya.org 云桥｜一站式 AI 中转平台
quya.org 云桥（原 0029.org）是一个集成 Claude Code、Codex 以及 Gemini 最新模型的一站式中转平台，为你提供稳定、高效且高性价比的 AI 中转服务。本站提供灵活的包月套餐/按量计费计划，国内直连，无需魔法，极速响应。支持个人和企业接入，价格最低为官方 0.12 折。
EveryAPI EveryAPI
EveryAPI 自带桌面客户端，可为 Claude Code、Codex、Cursor 等 20 多款 AI 工具自动完成配置。一把密钥即可调用 Claude、GPT、DeepSeek、GLM、MiniMax、Kimi、豆包等模型，并支持自建节点直连和渠道供货。通过专属链接注册即送 14 元额度，首充额外赠送 20%；付款时使用优惠码 codexplusplus 再享长期 8 折。
屹芸科技 屹芸科技
屹芸科技旗下拥有九五云商发卡网、屹芸付支付系统等面向 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。
二狗 API 二狗 API
二狗，稳如老狗的 AI API 中转站。全站 0.1x~0.2x 超低倍率，提供 Claude/GPT/Gemini 等多个国内外 100% 纯血大模型接口，顶级 IPLC 线路 + 住宅双 ISP 冗余，确保全国范围稳定低延迟访问。欢迎各位开发者、工作室注册使用。
百可为AI 百可为AI
百可为AI 是面向开发者、团队和 AI 工具用户的一站式大模型 API 服务平台，支持 Claude、OpenAI、Gemini、Codex 等主流模型能力接入。平台提供稳定中转、灵活计费、用量统计、余额管理和多场景 API 调用能力，适合 Claude Code、Codex、AI 生图、自动化脚本和各类智能应用长期使用。新用户注册可领取免费额度，开发者可快速接入、即开即用，让 AI 能力更稳定、更高效、更省心。
deepkey deepkey｜API KEY
感谢 deepkey 赞助本项目！deepkey 起初只是连接顶级算力的上游供应商，凭借稳定低价的接口被学生群体发现并口口相传。随着开发者与学子的涌入，这里不再只是 API 的搬运工，而是共同探讨提示词工程、分享创新应用的温暖社区。从工具到伙伴，deepkey 见证了无数灵感的诞生与落地。通过此链接注册进入群聊，可享受福利并与小伙伴们一起探讨。
API Mart API Mart
感谢 API Mart 赞助了本项目！API Mart 是专注 AI 图片和视频生成的低价 API 平台，GPT-Image-2 低至每张 0.006 美元，1 美元可生成 160 多张图片。图片、视频使用一套异步 API，提交任务获取 ID 后可通过轮询或回调取得结果；支持数万张批量任务，切换模型无需改代码。按量付费、无月费，通过此链接注册即可使用。
FennoAI 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++ 交流 3 群（QQ群：619480492），反馈问题、交流使用体验或提出新功能建议。点击链接加入群聊。

Codex++ 微信群二维码

Telegram 频道：https://t.me/CodexPlusPlus

友情链接：LINUX DO

当前功能

模块 功能
供应商配置 官方登录、官方登录混入 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++ 会生成独立 model_catalog_json，让 Codex 按当前模型使用对应窗口。

切换供应商时会先保存当前配置，再写入目标配置。真实 API Key 只保存在本机，请勿放入日志、截图或 issue。

Codex 界面增强

依赖注入脚本的设置通常需要保存后重新启动 Codex++ 才会生效。

自动更新与安装包

Codex++ 通过 GitHub Release 发布安装包。Windows 会生成 NSIS 安装程序，macOS 会生成 Intel x64 和 Apple Silicon arm64 两个 DMG。

管理工具的“关于”页可以检查并启动更新。静默启动器发现新版本时会拉起管理工具并进入更新提示。

数据位置

常见问题

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 可能拦截，出现“已损坏，无法打开”的提示：

macOS 提示 Codex++ 管理工具已损坏

如果遇到该提示，可以在终端执行下面两条命令，解除苹果系统的安全隔离限制：

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 和本地数据格式。官方应用更新后，部分注入功能可能需要跟随适配；修改供应商配置或本地会话数据前应保留备份。

CodexPlusPlus (BigPizzaV3/CodexPlusPlus)

Searching Database…

32.3K ·GitHub
CodexPlusPlus
What is this?Codex++ is an external launcher and management tool for the OpenAI Codex/ChatGPT desktop app, adding provider switching, protocol conversion, session management and UI enhancements on top of it.
Does this replace the Codex app, or just wrap around it?It wraps the official app rather than replacing it: the Codex++ entry point silently launches the official Codex/ChatGPT desktop app and loads your saved provider configs and enhancements, while a separate management tool configures everything.
How do I install and start using it?Download the installer for your OS from GitHub Releases (Windows NSIS .exe, or macOS .dmg for Intel/Apple Silicon), open the management tool first to set up providers and enhancements, then launch through the Codex++ entry point.
Do I need the official Codex/ChatGPT desktop app installed first?Yes, Codex++ is an external controller for the official desktop app and reads/writes its config and session files directly under ~/.codex/.
What happens when the official Codex app updates?Because Codex++ depends on the official app's page structure, CDP hooks, and local data format, injected features can break after an official update and may need re-adapting.
Does it work on Intel Macs, or only Apple Silicon?Both — releases ship a separate macos-x64.dmg for Intel Macs and macos-arm64.dmg for Apple Silicon.
What are the different provider modes for?Codex++ keeps official login, official-login-plus-API (mixed), pure API, and an aggregated-provider mode saved separately; the aggregated mode adds failover plus per-session, per-request, and weighted rotation across multiple API providers.
My macOS build says the app is damaged, what do I do?The unsigned/unnotarized installer can trigger a macOS Gatekeeper 'damaged, can't be opened' warning; running the two terminal commands given in the README to clear the quarantine attribute fixes it.
What UI enhancements does it add to Codex?Features include batch session deletion with Markdown export, plugin market unlocking, forced Chinese UI, rich-text-to-plain paste fixes, session width/scroll restoration, service-tier switching, and Stepwise next-step suggestions — all toggleable individually.
What are similar projects?disktree, floral-notepaper, WindInput, msime-windows, codenotch, AstrBot, Codex-X, xsime
Which topics is it in?installer, gpt, macos-app, chatgpt, windows-app, apple-silicon, agpl, customization, proxy, utility, plugin, openai
Creator
BigPizzaV3
Size
58.9 MB
Stars
32.3K
Updated
CommitOct 16Releasev1.9.0Oct 14
Age
5mo
Commits · 90 Days