Codex++ 完整入门：让 Codex 桌面端走 VibeAPI 中转

一、这是什么

Codex++ 是一个面向 Codex 桌面端 App 的外部增强启动器。它不会动你电脑上 Codex 原版安装文件一根毫毛——而是用一个叫 CDP（Chromium DevTools Protocol）的标准调试协议从外部"贴"上去，再往 Codex 的渲染界面里注入一段增强脚本。

装上之后，主要解决三类问题：

• API Key 模式下 Codex 桌面端插件入口被锁死——很多人接了第三方中转之后会发现，Codex 自带的插件菜单变灰、提示"需要登录 ChatGPT"。Codex++ 启动后会把这个入口解锁。
• Codex 原生没有真正的"删除会话"按钮——只有"归档"。Codex++ 在会话列表 hover 时多了一个真删除按钮，外加 Markdown 导出、项目移动、Timeline 时间线等一堆官方没给的能力。
• 最关键的一点（VibeAPI 客户视角）：它提供一个图形化的"中转注入"页，你只要在管理工具里填一次 VibeAPI 的 Base URL 和 Key，Codex 桌面端的所有模型请求就会切到 VibeAPI 上——再也不用手动去改 ~/.codex/config.toml、不用研究 wire_api 是啥意思。

项目仓库：github.com/BigPizzaV3/CodexPlusPlus

这篇教程适合谁

• 已经在用 Codex 桌面端、想接入 VibeAPI 中转的客户
• 在 API Key 模式下被原生限制（插件不可用、菜单灰）折磨过的用户
• 想要"会话删除、批量导出、Timeline"这些原本没有的能力的人

二、它在底层做了什么（原理速览）

不想懂原理也能跟着步骤走完。但如果你担心"这工具会不会偷偷劫持我的请求 / 上传我的代码 / 把电脑搞乱"，这一节告诉你它在底层只做了三件事，每件都是透明、可审计、可撤销的。

1. 它是怎么"接管" Codex 桌面端的

Codex 桌面端 App 本质是一个 Electron 应用（用 Chromium 渲染界面 + Node.js 跑后端的常见桌面应用框架）。

Codex++ 不会把任何文件塞进 Codex 安装目录，也不会修改 app.asar。它做的事只有三步：

1. 用 --remote-debugging-port=9229 这个 Chromium 标准参数启动原版 Codex
2. 通过 CDP（Chromium DevTools Protocol） 连上 9229 端口，拿到 Codex 渲染进程的 WebSocket
3. 往渲染进程注入一段 JS 增强脚本（即源码里的 assets/inject/renderer-inject.js）

2. 中转注入的本质：改一个 toml 文件

很多人以为"中转注入"是某种黑魔法。其实它只改了你电脑上一个文本文件：~/.codex/config.toml。

加进去的内容长这样（源码 crates/codex-plus-core/src/relay_config.rs 里写死了模板）：

model_provider = "CodexPlusPlus"

[model_providers.CodexPlusPlus]
name = "CodexPlusPlus"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://www.vibeapi.cn/v1"
experimental_bearer_token = "sk-..."

逐行翻译给你：

3. 三个本地端口分别在干啥

启动 Codex++ 之后，你电脑上会出现三个本地端口，搞清楚分工以后排查问题不慌：

三、前置准备

开始装 Codex++ 之前先确认这几样东西都齐了：

拿 VibeAPI Key 的步骤（如果还没有）

1. 打开 www.vibeapi.cn，注册 / 登录
2. 进入"控制台"
3. 找到"令牌管理"或"API Key"页
4. 点"新建令牌"，复制 sk-... 开头的字符串保存好（页面关掉就看不到完整 Key 了）

四、下载与安装

1. 下载安装包

打开 Codex++ 的 GitHub Releases 页面：

https://github.com/BigPizzaV3/CodexPlusPlus/releases

在最新版本（页面顶部）的 Assets 区域，根据自己的操作系统选对应安装包：

https://gh-proxy.com/https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v.../CodexPlusPlus-x.x.x-windows-x64-setup.exe

2. Windows 安装

双击 .exe 安装程序，一路下一步即可。装完后桌面和开始菜单会出现两个图标——这是最容易搞混的地方，先看清楚：

3. macOS 安装

双击下载好的 .dmg，按提示把里面的两个 app 拖进 Applications：

• Codex++.app — 静默启动入口（启动后不显示 Dock 图标）
• Codex++ 管理工具.app — 管理控制面板

首次打开会被 macOS Gatekeeper 拦截，提示 "无法打开，因为无法验证开发者" 或 "已损坏"。解决步骤：

系统设置 → 隐私与安全性
→ 滚到最底部，看到刚刚被拦截的 Codex++ 条目
→ 点"仍要打开"

两个 app 都要分别走一次这个流程，后面再开就不会再提示了。

4. 装完确认

无论 Win 还是 macOS，安装完先只打开"管理工具"（不要先点静默入口），看到管理面板左侧菜单有"中转注入"、"增强功能"、"诊断"等条目，就说明装好了。下一章开始正式配置。

五、完成首次登录

第三章里提到过：中转注入前必须先用官方 ChatGPT 账号在原版 Codex 里登录一次——免费账号也行。这节展开讲。已经登录过的可以直接跳到第六章。

1. 为啥必须先登录

Codex 桌面端启动时会做三件事：

1. 检查本地是否有有效的 ChatGPT 登录态（保存在 ~/.codex/auth.json）
2. 如果没登录态，直接卡死在登录页——连读 config.toml 的机会都没有
3. 有登录态后，才会读 ~/.codex/config.toml 决定请求往哪发

所以中转注入的本质是"账号占位 + 请求改向"的组合：ChatGPT 账号是门票，VibeAPI 是真正的供应商，二者各管一边。

2. 登录步骤

打开原版 Codex（不是 Codex++ 静默入口，也不是管理工具）：

1. 启动后看到登录页面，点 "Sign in with ChatGPT"
2. 系统会自动打开默认浏览器，跳到 ChatGPT 登录页
3. 输入 ChatGPT 账号密码（没账号可以现注册一个免费的）
4. 授权后浏览器会跳回，提示已成功登录 Codex 桌面端
5. 回到 Codex 桌面端，能看到欢迎页 / 会话列表，登录就完成了

3. 确认登录成功

最直接的办法是看这个文件存不存在：

文件存在且不是空的，说明登录态已经写盘。完整退出 Codex 桌面端（macOS 还要点菜单栏 Codex → 退出，不只是关窗口），下一节就用 Codex++ 启动了。

六、配置 VibeAPI 中转注入（核心步骤）

到这一步前你应该已经：

• ✅ 装好原版 Codex 桌面端，用免费 ChatGPT 账号登录过一次
• ✅ 装好 Codex++（两个图标都在）
• ✅ 拿到了 VibeAPI 的 API Key（sk-...）

接下来就是把 VibeAPI 中转配进 Codex++，4 步搞定。注意：从这一步起就不要打开原版 Codex 了，统一通过 Codex++ 启动。

1打开管理工具，确认登录态

双击 "Codex++ 管理工具" 图标（不是静默入口"Codex++"）。

打开后会看到 Tauri 控制面板，左侧是菜单栏：

• 首页 / 状态
• 中转注入 ← 这一节用到
• 增强功能
• 用户脚本
• 诊断
• 关于

首页应该显示"已检测到 ChatGPT 登录"。如果没检测到，说明上一节登录步骤没做完，回到第五章。

验证生效

最后一项是最权威的验证——如果 VibeAPI 控制台能看到刚才那次对话的 token 使用记录，证明请求确实走的 VibeAPI 中转。

七、增强功能一览

Codex++ 注入的增强能力，中转注入跑通后自动全部生效。下面是一张总览表 + 几个最常用的展开介绍。

全部增强能力一览

几个最常用的展开

顶部菜单 + 后端状态指示

Codex 窗口顶部出现 Codex++ 菜单后，右上角会有一颗小指示灯：

• 🟢 绿 = 注入成功、后端通畅
• 🔴 红 = 后端没起来或注入失败 → 去第九章 FAQ

真·会话删除

在 Codex 左侧会话列表把鼠标 hover 到任意会话上，会出现一个红色删除按钮。点了之后会话从本地数据库（~/.codex/state_5.sqlite）里彻底清掉，不占空间也不残留。

Markdown 导出

打开任意会话，Codex++ 菜单 → "导出当前会话为 Markdown"——会保存一份完整的 .md 文件（含对话历史、代码块、文件引用），适合归档到笔记软件 / 分享给同事 / 整理学习笔记。

Provider 同步（切供应商不丢会话）

如果你以后换中转商（比如从 VibeAPI 换到别家），Codex++ 切换时会自动把旧 provider 下的会话 metadata 备份到 ~/.codex/backups_state/provider-sync 下，让你切到新 provider 后老会话照样能看到、能继续用。

服务层级配置（高级，可跳过）

管理工具"增强功能"页有个 service-tier 开关，开了之后 Composer（写代码框）顶部会出现一个小 badge，显示当前请求走哪个服务等级（Standard / Priority / Flex）。

对 VibeAPI 客户的意义有限——中转商内部的服务等级由中转决定，这个 badge 显示的是 Codex 客户端期望的等级。如果你不做精细的成本优化，可以关掉这个增强省得界面冗余。

用户脚本（进阶玩家）

管理工具的"用户脚本"页能让你注入自定义 JS——比如某个 UI 微调、某个 DOM 元素隐藏。每次 Codex++ 启动时自动注入。

八、数据位置与切回官方

关键文件位置

Codex++ 不会到处乱写文件。所有相关数据集中在两个目录：

Windows 上 ~ 表示 C:\Users\<你的用户名>\，macOS / Linux 上是你的 home 目录。

切回官方 ChatGPT 登录态

如果你想暂时不走 VibeAPI、回到官方 ChatGPT：

1. 打开 "Codex++ 管理工具"
2. 进 "中转注入" 页
3. 点 "清除 API 模式"（或类似按钮）
4. 管理工具会：
   • 从 ~/.codex/config.toml 中移除 model_provider 和 [model_providers.CodexPlusPlus] 段
   • 清除环境变量里的 OPENAI_API_KEY
5. 关闭管理工具
6. 现在双击 原版 Codex 图标（不是 Codex++）启动——会用 ChatGPT 登录态走官方账号

完全卸载 Codex++

如果你要彻底清理 Codex++：

Windows：

1. 先在管理工具里点"清除 API 模式"，避免 config.toml 里残留中转配置
2. 控制面板 → 程序和功能 → 找到 "Codex++" → 卸载
3. 手动删除 C:\Users\<你>\.codex-plus\（可选，里面是日志和用户脚本）

macOS：

1. 先在管理工具里点"清除 API 模式"
2. 把 /Applications/Codex++.app 和 /Applications/Codex++ 管理工具.app 拖进废纸篓
3. 手动删除 ~/.codex-plus/（可选）

自动更新机制

Codex++ 启动时会后台检查 GitHub Release：

• 管理工具"关于"页可以手动点"检查更新"
• 静默启动器发现新版本时会自动弹起管理工具提示
• 不会强制更新——你点了"稍后"就继续用当前版本

更新只换 Codex++ 自身，不动 Codex App、不动你的会话数据、不动 config.toml。

九、常见问题

Invoke-RestMethod -Method Post -Uri http://127.0.0.1:57321/backend/status -Body "{}" -ContentType "application/json"

系统设置 → 隐私与安全性 → 滚到底部找到 Codex++ 条目 → 点"仍要打开"

十、相关阅读 + 一句话总结

相关链接

• BigPizzaV3/CodexPlusPlus 官方仓库 — 最新版本、变更日志、源码以这里为准
• Codex++ Releases 下载页 — 直接拉最新安装包
• VibeAPI 控制台 — 拿 API Key、查用量
• 在 Claude Code 里直接跑 Codex —— codex-plugin-cc 完整入门 — 站内姊妹篇：如果你同时也用 Claude Code，可以把 Codex 装进 Claude Code 做对抗式 review

一句话总结