BigPizzaV3/CodexPlusPlus · 上手攻略

仓库：BigPizzaV3/CodexPlusPlus
链接：https://github.com/BigPizzaV3/CodexPlusPlus
分类：engineering · trending · experimental
作者：Jay
更新：2026-07-06

这是什么

Codex++ 是 Codex App（OpenAI 的 AI 编程工具）的外部增强启动器，用 Rust + Tauri 写的。它不碰 Codex 原装 .app 文件，而是用 Chromium DevTools Protocol（CDP）在启动时往 Codex 页面注入增强脚本，实现两大核心功能：

中转注入：把模型请求从官方 API 路由到第三方兼容 API（如 JOJO Code、AIGoCode 等国内中转站），同时保留官方 ChatGPT 登录态和插件能力。
传统增强：解锁插件市场、删除会话、Markdown 导出、项目移动、粘贴修复（从 Word 黏贴只留纯文本）等易用性改进。

本质上，它是 Codex 和国内中转服务商之间的"透明桥梁"，同时顺手修了几个 Codex 原生 UI 上的痛点（插件市场屏蔽、会话无法删除等）。

解决什么问题

用国内中转 API 访问 Claude/GPT 模型有两个常见障碍：1）需要绕开官方登录（直接填 API Key 模式），导致插件市场不可用；2）切换回官方时配置繁琐。Codex++ 的"中转注入"模式用官方登录态接管账号/插件层，用自定义 Base URL + Bearer Token 接管模型请求层，两者互不干扰。

Codex 原生 UI 的其他痛点：无法删除会话、插件市场强制要求 ChatGPT Plus 登录、富文本粘贴被误判为附件——这些问题 Codex++ 都修了。

快速安装

下载安装包

从 GitHub Releases 下载对应平台的最新版本：

平台	安装包
Windows	`CodexPlusPlus-*-windows-x64-setup.exe`（NSIS 安装程序）
macOS Intel	`CodexPlusPlus-*-macos-x64.dmg`
macOS Apple Silicon	`CodexPlusPlus-*-macos-arm64.dmg`

⚠️ 当前安装包未签名，macOS Gatekeeper 会报"已损坏"。执行以下命令解除安全限制后再打开： bash sudo xattr -rd com.apple.quarantine "/Applications/Codex++ 管理工具.app" sudo xattr -rd com.apple.quarantine "/Applications/Codex++.app"

安装后会看到两个入口： - Codex++：静默启动器，不弹界面，直接启动 Codex 并注入增强 - Codex++ 管理工具：Tauri 控制面板，主界面在这里配置

Windows 安装包会自动创建桌面和开始菜单快捷方式。

核心功能与配置

功能一：中转注入（推荐场景：已登录官方 ChatGPT 账号）

这是 Codex++ 最有价值的场景。操作步骤：

Step 1. 确认 Codex 已检测到 ChatGPT 登录状态（插件入口可用）。

Step 2. 打开管理工具 → 中转注入 页面，添加中转配置（Base URL + API Key）。支持的供应商包括 JOJO Code、AIGoCode、APIKEY.FUN、RunAPI 等主流中转站（只要接口协议与 Codex 兼容即可）。

Step 3. 选中当前配置，点击应用中转注入，然后启动 Codex++。

注入后 ~/.codex/config.toml 会写入类似配置：

model_provider = "CodexPlusPlus"

[model_providers.CodexPlusPlus]
name = "CodexPlusPlus"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://your-proxy.example.com/v1"
experimental_bearer_token = "sk-..."

Step 4. 需要切回官方时，点击"清除 API 模式"即可移除注入配置，恢复官方 ChatGPT 登录态。

⚠️ 清除前建议备份 ~/.codex/config.toml，便于手动回滚。

功能二：传统增强

默认开启（可在管理工具中关闭），包括：

功能	说明
插件市场解锁	API Key 登录模式下插件入口不可用的问题修复
会话删除	悬停会话卡片出现删除按钮（原版没有）
Markdown 导出	导出对话为 `.md` 文件
项目移动	批量移动 Codex 项目目录
粘贴修复	从 Word 等富文本来源粘贴只保留纯文本，默认关闭，需手动开启

⚠️ 粘贴修复在管理工具中勾选后，需点"保存增强设置"按钮，再重启 Codex++ 才生效。

功能三：Stepwise 下一步建议

在 Codex 对话页显示可拖动浮层，基于对话内容生成后续操作建议（需配置独立的 Base URL + API Key + 模型）。

功能四：其他工具

上下文窗口按模型配置：在管理工具"模型列表"按模型名设置独立上下文大小（如 gpt-5.5: 1000000）。
Git upstream worktree 创建：从最新远端分支创建 worktree，避免从陈旧本地 HEAD 派生。
GitHub Release 自动更新：管理工具和静默启动器均检测更新。
Provider 同步：切换供应商后旧会话 metadata 仍可见。
Zed 打开入口：SSH 远程场景下可直接用 Zed 打开对应文件。

典型适用场景

用国内中转 API 访问 Claude 4.8/Opus：官方官方价格高，国内中转站（7-8 折）更划算，同时保留官方登录态和插件能力。
Codex 插件市场解锁：API Key 模式用户的刚需功能。
管理多个中转配置：在多个中转供应商之间快速切换比对手。
Codex 会话管理：删除不需要的会话、Markdown 导出备份。
国内网络直连：中转注入后网络访问比直连官方更稳定。

坑与注意

中转注入前先做最小认证测试：在 Codex++ 外先手动测试 Base URL 是否可连通、所选模型是否正常返回。推荐用 curl 测试： bash curl -X POST https://your-proxy.example.com/v1/models \ -H "Authorization: Bearer sk-..." \ -H "Content-Type: application/json"
清除 API 模式前先备份配置：~/.codex/config.toml 是 Codex 全局配置，操作前备份避免回滚困难。
插件市场解锁仅适用于官方登录态：如果你纯粹用 API Key 模式（无 ChatGPT 登录），插件市场解锁本身也无效。
推荐内容来自远程广告列表：管理工具中"推荐内容"功能请求 raw.githubusercontent.com 和 cdn.jsdelivr.net 上的广告 JSON 文件，如果网络访问这些域名受限，不影响核心功能但可能加载慢。
Codex App 大版本更新后注入脚本可能失效：因为注入脚本依赖 Codex 页面 DOM 结构，Codex 更新改版后注入脚本需要跟着更新，此时等待作者发新版即可。
Windows 环境下建议使用诊断工具：管理工具"诊断"页面和日志页面可以查看 renderer.script_loaded、bridge.request、bridge.response 等状态信息，有助于排查插件超时问题。
分布式中转供应商质量参差不齐：Codex++ 支持任何兼容 Responses API 的中转站，但不同中转站的稳定性、模型版本、限流策略差异很大，选供应商时多看评价。
macOS 需注意架构匹配：Apple Silicon Mac 必须下载 *-macos-arm64.dmg，Intel Mac 下载 *-macos-x64.dmg。

与同类对比

项目	定位	中转支持	插件解锁	UI 增强	生态
Codex++	Codex 增强 launcher	✅ 多中转配置	✅	✅ 导出/删除/粘贴	小众但活跃
Claude Code 官方	OpenAI 官方编程 agent	❌	❌	❌	官方
Continue（VS Code/JetBrains）	通用 AI 编程助手	✅	❌	❌	大生态
Codex Proxy 项目	单一中转配置工具	✅	❌	❌	较简单
Catppuccin/Custom Codex 启动器	主题/外观定制	❌	❌	✅ 主题	装饰向

结论：Codex++ 是目前唯一一个同时解决中转注入 + 插件市场解锁 + 会话管理的 Codex 增强工具。如果你用 Codex + 国内中转 API，它几乎是必装的。如果你是原生官方用户，不需要它。

一句话推荐结论

Codex++ 是国内 Codex 用户的首选伴侣——中转 API + 插件解锁 + 会话管理三合一，用国内中转省钱同时保留官方体验；但本质是外部注入工具，Codex 更新后需要等作者适配新版。