Codex++
Codex++ 深度解读：为 Codex App 提供的外部增强启动与管理工具
在日常的 AI 编程工作流中，Codex App 常被用作核心执行环境。然而，随着需求的多样化，单一的安装包往往难以满足对更高效工作流的追求。Codex++ 就是为此而生的外部增强启动器与管理工具。它不会修改 Codex App 的原始安装文件，而是通过一个独立的外部 launcher 启动 Codex，并利用 Chromium DevTools Protocol 注入增强脚本，从而实现功能扩展、工作流中转以及个性化脚本注入等能力。
在本文中，我们将从快速上手、核心特性、常见痛点及解决方案、到中转注入、更新机制与开发说明进行完整解读，帮助你了解 Codex++ 如何成为 Codex App 的强力外部增强层。
快速使用指南
下载与安装
- 访问 GitHub Releases 获取最新版安装包。
- Windows：CodexPlusPlus-*-windows-x64-setup.exe
- macOS Intel：CodexPlusPlus-*-macos-x64.dmg
- macOS Apple Silicon：CodexPlusPlus-*-macos-arm64.dmg
安装后，系统将提供两个入口：
- Codex++：静默启动入口，负责启动 Codex 并注入增强功能，不显示管理界面。
- Codex++ 管理工具：基于 Tauri 的控制面板，负责启动、检查、修复、更新、配置参数、注入中转、管理增强功能及用户脚本。
Windows 安装包会创建桌面和开始菜单快捷方式；macOS DMG 会在 /Applications 下安装 Codex++.app 以及 /Applications/Codex++ 管理工具.app。
若你希望快速了解使用状态与注入情况，可以在管理工具的诊断与日志页面查看。
赞助商与社区支持
Codex++ 的持续发展离不开各方赞助与社区支持。下列是部分赞助商及其作用，感谢他们的慷慨支持与信任：
JOJO Code 官方中转站
介绍：JOJO Code 是 Codex++ 官方中转站，适合日常开发和团队协作场景，提供稳定的 Codex API 接入体验。
Logo：
AIGoCode
介绍：集成 Claude Code、Codex 与 Gemini 的多模型平台，提供高性价比的 AI 编程服务。
链接：https://aigocode.com/invite/CodexPlusPlus
Logo：
PackyCode
介绍：稳定高效的 API 中转服务商，支持 Claude Code、Codex、Gemini 等。
优惠：首次充值可享受折扣优惠。
Logo：
APIKEY.FUN、RunAPI、0029 云桥、RawChat、VisionCoder、AIHub2API、优云智算、Cubence、MaoLao API 等
这些供应商提供从多模型到高缓存命中保障的各类中转与接入方案，帮助用户以更低成本实现稳定的 API 调用与模型访问。
除了上述 sponsor，文档还提供了二维码与图片来帮助你快速了解和参与社区讨论。你也可以通过捐赠支持来帮助社区持续维护与创新。
交流与支持
- Codex++ 交流群（QQ群：1103050832）
- 如果人数已满，可以通过官方文档提供的最新微信群二维码加入交流
- 交流群二维码：见文档图片
若 Codex++ 对你有所帮助，也欢迎通过捐赠表达你的支持。文档中提供了支付宝和微信赞赏二维码图片，便于快速支持。
- 支付宝赞赏码：
- 微信赞赏码：
核心功能综述
Codex++ 提供了一套完善的外部增强与管理能力，核心特性如下：
- Rust 后端与静默 launcher：启动时不依赖额外运行时，运行稳定且高效。
- Tauri + React 管理工具：支持深色/浅色切换，现代化界面体验。
- 外部 CDP 注入：不修改 app.asar，不向 Codex 安装目录写入 DLL。通过 Chromium DevTools Protocol 注入增强脚本。
- 中转注入模式：支持一个或多个中转配置，写入 CodexPlusPlus provider，并可切换回官方 ChatGPT 登录态。
- 传统增强模式：插件入口解锁、强制安装、会话删除、Markdown 导出、项目移动、Timeline 等功能。
- 用户脚本独立管理：启动时可注入自定义脚本，提升定制化能力。
- Provider 同步：启动前同步本地会话元数据，切换供应商后老会话仍可见。
- Zed 打开入口：识别远程 SSH 上下文后，可从 Codex 直接打开对应文件到 Zed Remote Development。
- Upstream worktree 创建：可从 upstream/ 创建新 worktree，创建前会自动 fetch 远端分支，降低冲突风险。
- GitHub Release 自动更新：管理工具和静默启动器都能检测可用更新。
- 跨平台支持：Windows 单实例、无黑框启动、管理员权限清单、系统桌面路径识别；macOS 提供 x64 与 arm64 两个独立分支 DMG，静默入口可隐藏 Dock 图标。
关键点总结
- 外部增强，不侵入原始 Codex App 安装包，确保不会影响官方更新流程。
- 注入机制采用 CDP，确保更高的兼容性与灵活性。
- 提供多种中转方案，帮助把常用的 API 中转服务整合到工作流中。
- 管理工具为协同工作提供可视化控制面板，便于配置、调试与升级。
痛点与解决方案：从插件与会话的实际场景说起
在某些场景下，API Key 模式下的插件入口可能无法正常工作，导致 Codex 原生插件入口提示需要登录 ChatGPT，从而影响插件的功能使用。示例图片显示了 API Key 模式下插件入口不可用的情况。
痛点一：API Key 模式下插件入口不可用
解决方案：Codex++ 启动后会解锁插件入口，并在会话列表悬停时显示删除按钮，方便你清理不需要的会话或重新注入脚本。
配图：痛点示意图
痛点二：Codex 原生会话列表没有真实的删除能力
解决方案：在 Codex++ 的注入环境中，插件入口被解锁，且会话列表上添加删除按钮，提升会话管理效率。
配图：原生会话缺少删除按钮的示意
系统状态与设置
顶部菜单栏会出现 Codex++，你可以查看后端状态并打开设置面板。
配图：后端状态指示灯、设置面板
配套的例子与截图
展示了通过管理工具查看状态、打开设置面板、以及如何进行注入配置的流程，帮助用户快速定位问题与修复路径。
通过这种方式，Codex++ 将插件入口与会话管理的体验提升到一个可控、可观测的层级，显著提升了稳定性与可操作性。
中转注入：把控和灵活的模型请求路径
中转注入是 Codex++ 的重要场景，适用于你已经在 Codex/ChatGPT 中完成官方账号登录，但希望把模型请求转发到自定义兼容 API 的场景。
在管理工具的“中转注入”页面，流程如下：
1) 确认已检测到 ChatGPT 登录状态。 2) 新增一个或多个中转配置，填写 Base URL 与 Key。 3) 选择当前配置并应用中转注入。 4) 启动 Codex++。
Codex++ 会在以下路径写入配置：
- ~/.codex/config.toml 示例配置片段（简化展示）：
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 模式即可移除 OPENAIAPIKEY 相关配置。
设计要点
- 中转注入允许你在保持 Codex 原生登录态的同时，通过自建代理来实现对外部 API 的兼容访问。
- 这为团队协作、自建模型管线和本地化部署提供了更大的灵活性。
- 当需要切回官方登录态时，清除中转配置即可，无缝恢复官方体验。
增强功能：统一开关与灵活组合
在管理工具中，增强功能作为一个全局开关统一管理。默认开启增强注入，开启后 Codex++ 菜单与脚本将注入生效；关闭后将禁用相关注入。
- 若启用中转注入模式，插件入口解锁与强制安装将不再需要，系统界面会提示“中转注入模式下无需开启”。
- 会话删除、导出、移动、Timeline、推荐内容与用户脚本等增强功能仍然可用。
- 这使得你可以按工作流需求灵活组合增强特性，避免在不需要时额外消耗资源或引入潜在冲突。
自动更新与安装包分发
Codex++ 的更新机制紧贴 GitHub Release：
- 安装包以 GitHub Release 的形式分发。Windows 生成 NSIS 安装程序，macOS 生成 Intel x64 与 Apple Silicon arm64 两个版本的 DMG。
- 管理工具的“关于”页可手动检查并启动更新。
- 静默启动器在检测到新版本时，会拉起管理工具并发出更新提示，从而实现无打扰的升级体验。
这一机制确保你始终在最新版本的 Codex++ 上工作，同时保持对 Codex App 更新的独立性与安全性。
数据位置与隐私考量
为了帮助你理解数据流向与本地化存储，以下是 Codex++ 及相关组件的常见数据位置：
- Codex 配置：~/.codex/config.toml
- Codex 登录状态：~/.codex/auth.json
- Codex 本地数据库：~/.codex/state_5.sqlite
- Codex++ 状态与日志：~/.codex-session-delete/
- Provider 同步备份：~/.codex/backups_state/provider-sync
这些路径都在本地系统中保持私有，便于开发者做离线调试、状态恢复与备份管理。
常见问题（FAQ）
Codex++ 菜单没出现
确认你是从 Codex++ 的入口启动；不要直接打开原版 Codex。若仍有问题，可在管理工具的诊断与日志页面查看注入状态。
插件内显示后端连不通
测试接口是否能在浏览器或 PowerShell 中访问：
- 在 PowerShell 中执行 Invoke-RestMethod -Method Post -Uri http://127.0.0.1:57321/backend/status -Body "{}" -ContentType "application/json"
如果接口正常但插件仍超时，可能是 Codex 页面中的 CDP bridge 或脚本缓存问题。尝试重启 Codex++，或在管理工具日志中查看 renderer.script_loaded、bridge.request、bridge.response 等字段。
Upstream worktree 与原生创建的区别
Codex++ 的 Upstream worktree 等价于先更新远端分支，再执行： bash git worktree add -b upstream/
以确保新 worktree 从最新远端分支开始跟踪，降低冲突风险。如无法正确检测，请在 Codex++ 菜单手动填写仓库路径、分支名、worktree 路径、remote 与 base_branch。
macOS 提示无法打开或已损坏
可能是未签名/未公证的分发包导致的 Gatekeeper 拦截。可以在“系统设置 - 隐私与安全性”中允许打开。正式分发建议采用 Apple Developer ID 签名与 notarization。
macOS Intel 能否使用
可以。Release 将提供 macos-x64.dmg 与 macos-arm64.dmg，Intel Mac 下载 x64，Apple Silicon 下载 arm64。
开发者向：开发与构建要点
如果你对 Codex++ 的源码感兴趣，以下是开发与构建的快速指南（摘要）：
前端开发
# 进入前端目录
cd apps/codex-plus-manager
npm install
npm run check
npm run vite:build
后端与 Rust 开发
# Rust 编译与测试
cd ../..
cargo fmt --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
- macOS packaging 脚本
- 以及文档中的链接与配套图片
这套结构确保前端、后端与数据层的职责分离，便于维护与扩展。
友情链接
- LINUX DO，提供额外的资源与文章，帮助你更好地融入 Linux 环境下的 Codex++ 使用。
说明
Codex++ 本质上是一个外部增强工具，不修改 Codex App 的原始文件。Codex App 更新后，如页面结构发生变化，可能需要对注入脚本进行相应更新，以确保兼容性。
快速回顾与展望
Codex++ 以“外部增强、保持原生兼容”为核心设计原则，为 Codex App 提供了更灵活的启动、注入与扩展能力。通过中转注入、插件解锁、会话管理、用户脚本注入、与 Zed Remote Development 的集成等特性，用户可以构建出更高效、可控的工作流，提升开发生产力。
未来若出现 Codex App 更新带来的结构变化，Codex++ 的注入脚本也会相应进行适配与更新。社区的持续反馈将推动新的增强场景与更丰富的中转方案的实现。
文字、截图与图片引用说明
- 文中所引用的图片均来自输入提供的文档图片资源，用于帮助读者更直观地理解配置界面、状态指示、赞助与交流群等场景。
- 相关图片包括 Codex++ 图标、设置面板、后台状态指示、插件入口与删除按钮示意、交流群二维码、赞赏二维码等。
如果你准备尝试 Codex++，请先备份现有的 Codex 环境，并按照快速使用指南中的步骤开始。若在使用过程中遇到问题，欢迎在社区中发起讨论，或通过管理工具的诊断页面获取更多帮助信息。
Codex++ 作为 Codex App 的外部增强启动器与管理工具，旨在让你的 AI 编程和协作流程更加高效、可控与定制化。愿它成为你工作流中值得信赖的新伙伴。
Enjoying this project?
Discover more amazing open-source projects on TechLogHub. We curate the best developer tools and projects.
Repository:https://github.com/BigPizzaV3/CodexPlusPlus
GitHub - BigPizzaV3/CodexPlusPlus: Codex++
Codex++ is an open-source AI assistant that extends the functionality of Codex App via external launchers and management tools....
github - bigpizzav3/codexplusplus