中文 | English
Codex++ 是面向 Codex App 的外部增强启动器和管理工具。它不修改 Codex App 原始安装文件，而是通过外部 launcher 启动 Codex，并使用 Chromium DevTools Protocol 注入增强脚本。
从 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。
| 🏆 赞助商 🏆 |
|---|
| 👉 JOJO Code｜Codex++ 官方中转站 Codex++ 推荐的官方中转服务，面向日常开发和团队协作场景，提供稳定可用的 Codex API 接入体验，适合快速接入、长期使用和项目级工作流。 |
| 👉 0029云桥｜codex api中转站(gpt5.5 gpt-image-2) 支持个人和企业接入。包月套餐/按量计费，Pro/Plus 号池，全站接口稳定可用，7×24 小时技术支持！ |
| 👉 packycode｜Codex API 中转服务 面向开发者和团队的稳定 API 接入服务，支持 Codex/ChatGPT 生态使用，套餐灵活，适合日常开发、自动化工作流和企业集成。 |
| 👉 RawChat｜Codex 中转站 老牌中转站，支持包月套餐。低倍率调用，高缓存命中，Pro/Plus 号池，全天专人维护。 |
欢迎扫码加入 Codex++ 交流群，反馈问题、交流使用体验或提出新功能建议：
如果 Codex++ 帮到了你，可以请我喝杯咖啡，或者随手赞赏支持一下继续维护。
- Rust 后端和静默 launcher，启动时不依赖 Python 环境。
- Tauri + React 管理工具，支持深色/浅色切换。
- 外部 CDP 注入，不改
app.asar，不向 Codex 安装目录写入 DLL。 - 中转注入模式：支持多个中转配置，写入
CodexPlusPlusprovider，并可切回官方 ChatGPT 登录态。 - 传统增强模式：插件入口解锁、特殊插件强制安装、会话删除、Markdown 导出、项目移动、Timeline 等。
- 用户脚本独立管理，可在启动时注入自定义脚本。
- Provider 同步：启动前同步本地会话 metadata，切换供应商后旧会话仍可见。
- GitHub Release 自动更新，管理工具和静默启动器都会检测可用更新。
- Windows 单实例、无黑框启动、管理员权限清单、系统桌面路径识别。
- macOS x64/arm64 分架构 DMG，静默入口隐藏 Dock 图标。
API Key 登录模式下，Codex 原生插件入口会提示需要登录 ChatGPT，导致插件功能无法正常使用：
Codex 原生会话列表只有归档入口，没有真正的删除按钮：
Codex++ 启动后会解锁插件入口，并在会话列表悬停时显示删除按钮：
顶部菜单栏会出现 Codex++，可以查看后端状态并打开设置面板：
中转注入适合已经在 Codex/ChatGPT 中完成官方账号登录，同时希望把模型请求转到自定义兼容 API 的场景。
在管理工具的“中转注入”页面：
- 确认已经检测到 ChatGPT 登录状态。
- 添加一个或多个中转配置，填写 Base URL 和 Key。
- 选择当前配置并应用中转注入。
- 启动
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 模式即可移除 OPENAI_API_KEY 相关配置并切回官方 ChatGPT 登录模式。
增强功能在管理工具中统一开关。默认开启增强注入；关闭后不会注入 Codex++ 菜单和脚本。
如果启用中转注入模式，插件入口解锁和强制安装不再需要，界面会提示“中转注入模式下无需开启”。会话删除、导出、移动、Timeline、推荐内容和用户脚本等增强仍可继续使用。
推荐内容来自远程广告列表：
https://raw.githubusercontent.com/BigPizzaV3/Ad-List/main/ads.json
https://cdn.jsdelivr.net/gh/BigPizzaV3/Ad-List@main/ads.json
请求时会自动追加 ?v=时间戳 绕开 CDN 旧缓存。推荐内容加载慢不会影响后端连接状态。
Codex++ 通过 GitHub Release 发布安装包。Windows 会生成 NSIS 安装程序，macOS 会生成 Intel x64 和 Apple Silicon arm64 两个 DMG。
管理工具的“关于”页可以检查并启动更新。静默启动器发现新版本时会拉起管理工具并进入更新提示。
- Codex 配置：
~/.codex/config.toml - Codex 登录状态：
~/.codex/auth.json - Codex 本地数据库：
~/.codex/state_5.sqlite - Codex++ 状态与日志：
~/.codex-session-delete/ - Provider 同步备份：
~/.codex/backups_state/provider-sync
确认是从 Codex++ 入口启动，而不是原版 Codex。也可以打开管理工具的“诊断”和“日志”页面查看注入状态。
先在浏览器或 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。
当前安装包未签名/未公证时，macOS Gatekeeper 可能拦截。可以在“系统设置 - 隐私与安全性”中允许打开。正式分发建议配置 Apple Developer ID 签名和 notarization。
可以。Release 会分别提供 macos-x64.dmg 和 macos-arm64.dmg。Intel Mac 下载 x64 包，Apple Silicon 下载 arm64 包。
# 前端检查
cd apps/codex-plus-manager
npm install
npm run check
npm run vite:build
# 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 Windows NSIS 安装包
macos/package-dmg.sh macOS DMG 打包
不建议继续使用旧 Python 入口；仓库中保留的 codex_session_delete/ 主要用于迁移参考和兼容历史代码。
Codex++ 是外部增强工具，不修改 Codex App 原始文件。Codex App 更新后，如果页面结构变化，可能需要更新注入脚本。