HQY

×

Codex 增强神器Codex++ 一个CodexApp的增强工具,努力让Codex变得更好用更舒服

hqy hqy 发表于2026-07-22 00:17:15 浏览207 评论0

抢沙发发表评论

给大家分享一款在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.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




当前功能

模块功能
供应商配置官方登录、官方登录混入 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 可能拦截,出现“已损坏,无法打开”的提示:

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

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模式下直接禁用,按钮全程灰色,完全无法点击。


image.png


2. 会话无法彻底删除

会话列表只有「归档」选项,没有真正的删除按钮。项目一多、测试会话堆积,列表越来越杂乱,想清理都没辙,强迫症完全忍不了!


image.png


3. API路由无法灵活自定义

想把模型请求转到自己的兼容中转接口?官方完全不支持可视化配置,只能手动修改配置文件,而且重启App后大概率恢复默认,每次都要重新改,麻烦到崩溃!

Codex++ 是什么?

Codex++ 是国内开发者开源的Codex App专用外部增强工具,后端基于Rust开发,管理面板用Tauri搭建,完美兼容Windows、macOS(Intel+Apple Silicon双架构)。

开源地址:https://github.com/BigPizzaV3/CodexPlusPlus


image.png


它的设计理念特别友好:零侵入改造Codex本体——不修改Codex安装目录、不篡改app.asar文件、不往系统写入DLL,全程安全可审计。

核心原理超简单:通过自研启动器(launcher)启动Codex,利用Chromium DevTools Protocol(CDP),在渲染进程中注入增强脚本,相当于在Codex运行后,帮我们“补上”所有刚需功能。

核心功能介绍

安装Codex++后,从专属入口启动Codex,顶部菜单栏会新增「Codex++」选项,可查看后端运行状态、打开设置面板,所有增强功能都能一键开关。


image.png


1. 解锁插件 + 一键删除会话

直接解决两大核心痛点:

  • API Key模式下,插件入口强制解锁,和ChatGPT登录态无差别使用;

  • 会话列表鼠标悬停,自动显示删除按钮,一键清理无用会话,列表瞬间清爽!


image.png


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++解决方案

管理工具内置「中转注入」可视化页面,三步搞定,无需手动改文件

  1. 工具自动检测ChatGPT登录态;

  2. 填写中转配置(Base URL+API Key),支持多方案保存;

  3. 选中配置一键应用,从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.exe

  • macOS Intel:CodexPlusPlus-*-macos-x64.dmg

  • macOS 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桌面端用户,强烈建议安装——功能不多,但每一个都精准解决刚需,用一次就回不去!





打赏

本文链接:https://www.kinber.cn/post/6721.html 转载需授权!

分享到:


推荐本站淘宝优惠价购买喜欢的宝贝:

image.png

 您阅读本篇文章共花了: 

群贤毕至

访客