给大家分享一款在GitHub爆火的Codex增强神器——Codex++
An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具,努力让Codex变得更好用更舒服
作为一名深度使用Codex桌面端的开发者,我踩过官方版的所有痛点,直到遇到它,体验直接拉满!全文干货满满,建议点赞+收藏,避免后续找不到~
Codex本身是OpenAI推出的优质AI编程助手,界面简洁干净,功能强大,但实际长期使用下来,真的有不少“反人类”设计,越用越闹心。
就拿最基础的会话管理来说,想删掉没用的测试会话,翻遍所有菜单,从头到尾只有「归档」选项,根本没有删除按钮。我反复确认了好几遍,真的不是我漏看,官方就是没做这个功能。
这种产品决策特别“OpenAI式”——核心功能做得光鲜亮丽,但用户体验细节完全不上心。更关键的是,国内用户还面临一个专属难题:用API Key登录时,插件入口直接灰掉禁用,点击就提示“请登录ChatGPT”,完全没法用插件功能。
最近偶然发现一款国内开发者开源的宝藏工具——Codex++,专门解决Codex官方版的所有痛点!亲测一周,每一个功能都精准踩在刚需上,体验直接“封神”,下面带大家深度拆解!
Codex 桌面端简介
先简单说说Codex桌面端的背景:OpenAI在2025年正式推出Codex桌面端,它是Codex CLI的图形化版本,底层基于Electron开发,内置多Agent协作能力。
相比纯命令行工具,它新增了可视化会话管理、项目上下文绑定、插件扩展等实用功能,初衷是降低AI编程的使用门槛。
但作为常年在Claude Code和Codex CLI之间切换的开发者,我对桌面端的要求很简单:稳定够用、别添堵。而Codex App最大的问题,就是完全面向国外用户设计,会话删除、API路由自定义这类国内用户高频刚需,根本不在官方优先级里。
Codex++ 是面向 OpenAI Codex / ChatGPT 桌面应用的外部启动器与管理工具。它通过 Chromium DevTools Protocol 和本地辅助服务提供供应商切换、协议转换、会话管理与界面增强,不修改官方应用的 app.asar,也不向安装目录写入补丁文件。
从 GitHub Releases 下载最新版安装包:
Windows:
CodexPlusPlus-*-windows-x64-setup.exemacOS Intel:
CodexPlusPlus-*-macos-x64.dmgmacOS Apple Silicon:
CodexPlusPlus-*-macos-arm64.dmg
安装后会有两个入口:
Codex++:静默启动官方桌面应用,并加载已保存的供应商配置与增强功能。Codex++ 管理工具:管理供应商、模型、工具插件、会话、增强功能、脚本、更新和诊断。
首次使用建议先打开管理工具,确认应用路径和运行状态,再配置供应商与增强功能,最后从 Codex++ 入口启动。Windows 安装包会创建桌面和开始菜单快捷方式;macOS DMG 会安装 /Applications/Codex++.app 和 /Applications/Codex++ 管理工具.app。
当前功能
| 模块 | 功能 |
|---|---|
| 供应商配置 | 官方登录、官方登录混入 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 界面增强
会话删除、批量删除、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.tomlCodex 登录状态:
~/.codex/auth.jsonCodex 本地数据库:优先读取
~/.codex/sqlite/*.db,旧版回退到~/.codex/state_5.sqliteCodex++ 状态与日志:
~/.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 可能拦截,出现“已损坏,无法打开”的提示:
如果遇到该提示,可以在终端执行下面两条命令,解除苹果系统的安全隔离限制:
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 打包
官方版Codex,到底缺了什么?
用API Key登录Codex后,很快就会遇到3个致命卡点,单个看不算大问题,叠加起来直接劝退日常使用:
1. 插件入口被强制锁定
原生界面的插件功能,仅支持ChatGPT账号登录态使用,API Key模式下直接禁用,按钮全程灰色,完全无法点击。
2. 会话无法彻底删除
会话列表只有「归档」选项,没有真正的删除按钮。项目一多、测试会话堆积,列表越来越杂乱,想清理都没辙,强迫症完全忍不了!
3. API路由无法灵活自定义
想把模型请求转到自己的兼容中转接口?官方完全不支持可视化配置,只能手动修改配置文件,而且重启App后大概率恢复默认,每次都要重新改,麻烦到崩溃!
Codex++ 是什么?
Codex++ 是国内开发者开源的Codex App专用外部增强工具,后端基于Rust开发,管理面板用Tauri搭建,完美兼容Windows、macOS(Intel+Apple Silicon双架构)。
开源地址:https://github.com/BigPizzaV3/CodexPlusPlus
它的设计理念特别友好:零侵入改造Codex本体——不修改Codex安装目录、不篡改app.asar文件、不往系统写入DLL,全程安全可审计。
核心原理超简单:通过自研启动器(launcher)启动Codex,利用Chromium DevTools Protocol(CDP),在渲染进程中注入增强脚本,相当于在Codex运行后,帮我们“补上”所有刚需功能。
核心功能介绍
安装Codex++后,从专属入口启动Codex,顶部菜单栏会新增「Codex++」选项,可查看后端运行状态、打开设置面板,所有增强功能都能一键开关。
1. 解锁插件 + 一键删除会话
直接解决两大核心痛点:
API Key模式下,插件入口强制解锁,和ChatGPT登录态无差别使用;
会话列表鼠标悬停,自动显示删除按钮,一键清理无用会话,列表瞬间清爽!
2. Markdown会话导出
支持将任意会话内容一键导出为Markdown格式,不管是整理学习笔记、备份重要对话,还是归档项目记录,都超级方便,再也不用手动复制粘贴!
3. Timeline历史回溯
新增类似版本控制的Timeline视图,完整记录会话的每一步历史状态。面对长周期、复杂任务的上下文时,随时回溯关键节点,排查问题、复盘思路超高效!
4. 项目目录一键迁移
支持直接在工具内移动Codex项目目录,不用手动修改配置文件、复制文件夹,拖拽式操作,跨目录迁移项目零成本!
5. 自定义用户脚本
兼容Tampermonkey脚本逻辑,支持自定义脚本自动注入。熟悉前端的开发者,可自由修改界面样式、新增专属功能,自由度拉满!
6. 供应商同步
切换模型供应商(官方ChatGPT/自定义中转)后,历史会话完全保留、正常查看,不会因登录态变更丢失数据,切换服务无负担!
7. Zed远程开发集成
适配Zed编辑器远程开发场景,自动识别SSH远程上下文,支持直接从Codex打开远程文件到Zed,小众但刚需,远程开发党狂喜!
杀手锏:中转注入
前面的功能是“修bug”,中转注入才是Codex++的核心王牌,完美解决国内用户自定义API路由的刚需!
痛点场景
已用ChatGPT账号登录Codex,但想让模型请求走自己的中转API接口(而非OpenAI默认路由),官方流程必须手动修改~/.codex/config.toml,切换账号还会被覆盖,极其繁琐。
Codex++解决方案
管理工具内置「中转注入」可视化页面,三步搞定,无需手动改文件:
工具自动检测ChatGPT登录态;
填写中转配置(Base URL+API Key),支持多方案保存;
选中配置一键应用,从Codex++入口启动即可。
自动写入配置示例:
model_provider = "CodexPlusPlus"
[model_providers.CodexPlusPlus]
name = "CodexPlusPlus"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://example.com/v1"
experimental_bearer_token = "sk-..."支持多中转方案随时切换、一键清除恢复官方配置,频繁对比不同API服务的开发者,效率直接翻倍!
安装上手,极简流程
1. 下载安装包
直接去项目GitHub Releases页面,下载对应平台的安装包:
Windows:
CodexPlusPlus-*-windows-x64-setup.exemacOS Intel:
CodexPlusPlus-*-macos-x64.dmgmacOS Apple Silicon:
CodexPlusPlus-*-macos-arm64.dmg
2. 启动使用
安装后生成两个入口:
Codex++:日常使用入口,静默启动、不弹窗,直接拉起Codex并注入增强功能;
Codex++管理工具:配置入口,中转设置、脚本管理、更新检查全在这里。
3. macOS常见问题解决
安装后提示“无法打开或已损坏”:因安装包暂未通过Apple公证,Gatekeeper会拦截。前往「系统设置-隐私与安全性」,手动允许打开即可;全程开源可审计,源码透明,安全放心!
项目技术栈,简洁高效
仓库结构清晰,技术选型务实,兼顾性能与可维护性:
apps/
codex-plus-launcher/ # 静默启动入口
codex-plus-manager/ # Tauri管理工具(React前端)
assets/
inject/
renderer-inject.js # Codex渲染端注入脚本
crates/
codex-plus-core/ # 启动、注入、配置、更新核心逻辑
codex-plus-data/ # 会话数据、导出、Provider同步
scripts/
installer/
windows/CodexPlusPlus.nsi # Windows安装包配置
macos/package-dmg.sh # macOS打包脚本后端:纯Rust开发,启动极速、无Python环境依赖、性能稳定;
管理工具:Tauri 2.x + React + Vite,轻量不臃肿,支持深浅色模式切换;
打包:Windows用NSIS、macOS分架构打包,覆盖全主流平台。
总结
Codex++ 是典型的“开发者受不了痛点,自己动手造神器”的开源项目——官方不给删除按钮,就自己开发;插件被锁,就解锁;不支持中转,就写注入逻辑。
全程开源透明、零侵入改造、可审计安全,没有任何“黑魔法”;Codex官方更新后,作者会快速适配脚本,风险极低。
如果你是Codex桌面端用户,强烈建议安装——功能不多,但每一个都精准解决刚需,用一次就回不去!
odexPlusPlus
本文链接:https://www.kinber.cn/post/6721.html 转载需授权!
推荐本站淘宝优惠价购买喜欢的宝贝:







支付宝微信扫一扫,打赏作者吧~
