Codex++

August 24, 2026 · View on GitHub

Codex++ 图标

中文 | English

Release Stars License Rust Tauri

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
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
百可为AI 百可为AI
百可为AI 是面向开发者、团队和 AI 工具用户的一站式大模型 API 服务平台,支持 Claude、OpenAI、Gemini、Codex 等主流模型能力接入。平台提供稳定中转、灵活计费、用量统计、余额管理和多场景 API 调用能力,适合 Claude Code、Codex、AI 生图、自动化脚本和各类智能应用长期使用。新用户注册可领取免费额度,开发者可快速接入、即开即用,让 AI 能力更稳定、更高效、更省心。
deepkey deepkey|API KEY
感谢 deepkey 赞助本项目!deepkey 起初只是连接顶级算力的上游供应商,凭借稳定低价的接口被学生群体发现并口口相传。随着开发者与学子的涌入,这里不再只是 API 的搬运工,而是共同探讨提示词工程、分享创新应用的温暖社区。从工具到伙伴,deepkey 见证了无数灵感的诞生与落地。通过此链接注册进入群聊,可享受福利并与小伙伴们一起探讨。

交流与支持

欢迎加入 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保留官方账号与插件入口,模型请求走兼容 APIAPI 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 协议。

每模型窗口支持 1M200K 或纯数字。Codex++ 会生成独立 model_catalog_json,让 Codex 按当前模型使用对应窗口。

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

Codex 界面增强

  • 会话删除、批量删除、Markdown 导出和项目移动。
  • 插件市场解锁、插件自动展开和模型白名单处理。
  • 富文本粘贴转纯文本、强制中文、启动加速和原生菜单本地化。
  • 会话宽度、滚动位置恢复、线程 ID、服务层级切换和 Goals。
  • Stepwise 下一步建议,可单独配置 API、模型、建议数量与超时。
  • Upstream worktree、Zed Remote、自定义图片覆盖层和用户脚本。

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

自动更新与安装包

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

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

数据位置

  • 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

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