Codex++ 使用指南

什么是 Codex++？¶

Codex++ 是一个面向 OpenAI Codex 桌面版的外部增强启动器，由 Rust + Tauri 构建。它不修改 Codex 的原始安装文件，而是通过运行时注入增强脚本的方式，为 Codex 桌面版添加一系列官方版本缺失的功能。

简单来说：安装 Codex++ 后，通过它的入口启动 Codex，就能解锁插件、删除会话、接入自定义 API 模型等一系列实用功能。

GitHub 星标 20k+，是目前最流行的 Codex 第三方增强工具。

为什么你需要 Codex++？¶

官方 Codex 桌面版有三个让人头疼的问题：

1️⃣ API Key 登录 → 插件入口被锁

用 API Key 登录时，插件按钮是灰色的，完全无法使用。对于很多用 API Key 的开发者来说，这个限制非常不友好。

2️⃣ 会话无法删除

官方只提供「归档」功能，没有真正的删除按钮。测试会话一多，列表越来越乱。

3️⃣ API 路由不灵活

如果想使用中转 API 或自定义模型，需要手改配置文件，而且还有被覆盖的风险。

这些问题单独看都不大，但日常使用会持续消耗耐心。Codex++ 正是为了解决这些痛点而生。

下载与安装¶

支持三大平台：

Windows：CodexPlusPlus-*-windows-x64-setup.exe
macOS Intel：CodexPlusPlus-*-macos-x64.dmg
macOS Apple Silicon：CodexPlusPlus-*-macos-arm64.dmg

下载地址：

GitHub Releases：https://github.com/BigPizzaV3/CodexPlusPlus/releases
国内镜像：https://pan.quark.cn/s/9fed9c3dfbee

安装完成后，桌面上会出现两个入口：

程序	作用
Codex++	日常启动 Codex（自动注入增强功能）
Codex++ Manager	管理配置、供应商、脚本等

⚠️ 关键点：日常使用必须通过 Codex++ 图标启动 Codex，直接打开原程序增强功能不会生效！

核心功能一览¶

1. 解锁插件 + 删除会话¶

最直观的体验提升——插件入口恢复可用，鼠标悬停会话列表时显示删除按钮。

2. Markdown 导出¶

支持将对话导出为 Markdown 格式，方便知识整理、项目记录和技术笔记归档。

3. Timeline 历史视图¶

类似版本回溯，查看会话历史状态，适合长上下文任务。

4. 项目移动¶

在 Codex 内直接移动项目目录，无需手改配置文件。

5. 用户脚本系统¶

类似 Tampermonkey，可以自定义脚本扩展 UI、功能和自动化操作，扩展空间非常大。

6. Provider 同步¶

切换 API 服务后，旧会话不会消失，登录态变化不影响历史记录。

7. Zed 编辑器集成¶

支持识别远程 SSH 环境，从 Codex 直接打开远程文件到 Zed，适合远程开发场景。

🔌 核心功能讲解：API 中转注入¶

这是 Codex++ 最核心的能力，特别适合想用国内模型或自定义 API 的开发者。

使用场景¶

你已经登录了 ChatGPT 账号，但希望模型请求走自定义 API（比如 DeepSeek、国内模型）。

官方方案需要手改配置文件 ❌，Codex++ 方案只需几步：

操作步骤¶

第一步：打开 Codex++ Manager → 设置 → 供应商管理

第二步：点击 新增供应商，填写配置：

配置项	推荐值
接入模式	纯 API 模型（无需 Codex 账号）
测试模型	如 `deepseek-v4-pro`
混入 API Key	✅ 勾选
Base URL	如 `https://api.deepseek.com`
Key	你的 API Key
上游协议	优先 Chat Completions（兼容性更好）

第三步：保存并通过 Codex++ 重启 Codex

配置会自动写入 Codex 的 ~/.codex/config.toml，重启后在模型选择列表中就能看到你新配置的供应商了。

DeepSeek 配置示例¶

经过实测可用的配置参考：

名称：deepseek
接入模式：纯 API
测试模型：deepseek-v4-pro
Base URL：https://api.deepseek.com
上游协议：Chat Completions

⚠️ 注意：并非所有模型都支持 Responses API，如果 Agent 能力异常，优先换用 Chat Completions 协议。

⚡ 使用建议与常见问题¶

网络加速¶

初次启动或调用模型时可能会稍微慢一些，建议开启代理并将 api.deepseek.com 及 Codex 相关域名加入代理规则。实测发现如果一直不开代理，Codex 可能卡在 Logo 界面无法进入。

macOS 提示损坏¶

如果 macOS 提示「应用无法打开或已损坏」：前往系统设置 → 隐私与安全 → 允许打开即可。这是未经过 Apple 公证导致的正常现象。

验证安装成功¶

通过 Codex++ 启动 Codex 后，顶部菜单栏如果出现 Codex++ 选项，说明注入成功。

技术原理¶

Codex++ 基于 Chromium DevTools Protocol（CDP）工作：

启动 Codex 并开启调试端口
连接 CDP
注入 renderer-inject.js 增强脚本
在运行时动态为 Codex「装上插件」

关键点在于：不修改 Codex 安装目录、不修改 app.asar、不写系统 DLL。这意味着 Codex 更新后增强功能基本不受影响。

总结¶

Codex++ 是一款干净、高效的 Codex 桌面版增强工具，安装后日常只需要：

通过 Codex++ 启动 Codex → 在 Manager 里配好 API 供应商 → 直接使用

如果你受够了官方版本的种种限制，这款工具值得一试。

📬 联系作者¶

如有问题或建议，欢迎添加微信：ysf99918

相关链接：

GitHub：https://github.com/BigPizzaV3/CodexPlusPlus
最新版下载：https://github.com/BigPizzaV3/CodexPlusPlus/releases