导入到 Codex++

⚠️ 注意 Codex++（CodexPlusPlus）是第三方 Codex 桌面客户端增强工具，不是 OpenAI 官方 Codex。如果你要配置官方 Codex CLI，请查看 导入到 Codex。

Codex++ 通过外部启动器拉起 Codex 桌面客户端并注入增强功能，本身不会修改 Codex 的安装文件。接入 sub2aigc 时，需要在管理工具中添加供应商配置，再通过 Codex++ 入口启动。

前置准备

先进入 sub2aigc 控制台的「API 密钥」页面，创建或选择一个 Codex 专用 Key 并复制备用。不要把完整 Key 发到公开聊天或 issue 中。

下载安装 Codex++

Codex++ 是开源项目，源码托管在 GitHub：BigPizzaV3/CodexPlusPlus。

1. 打开 Releases 页面。
2. 根据操作系统选择安装包：
   • Windows：CodexPlusPlus-*-windows-x64-setup.exe
   • macOS Intel：CodexPlusPlus-*-macos-x64.dmg
   • macOS Apple Silicon：CodexPlusPlus-*-macos-arm64.dmg
3. 按系统正常方式安装。
4. 至少打开一次 Codex++ 管理工具，用于后续配置。

安装后通常会出现两个入口：Codex++ 负责静默启动和注入增强，Codex++ 管理工具 用于管理供应商配置。

添加 sub2aigc 供应商

打开 Codex++ 管理工具，点击左侧的「供应商配置」。确认顶部的「启用供应商配置切换」已勾选，否则配置只会保存，不能写入 Codex。

添加供应商

1. 点击「添加供应商」。
2. 选择「从预设模板创建」。
3. 选择官方模板「OpenAI Official」。
4. 按下表填写：

ℹ️ 说明 表单中的「Codex 目标 / 启用目标功能」对应 Codex 的长期目标模式，与接入 sub2aigc 无关，保持默认即可。

填写完成后，在「模型列表」处点击「从上游获取」，拉取 sub2aigc 提供的模型，再点击「保存」。

测试并启用

1. 回到供应商列表，找到 sub2aigc，点击「测试」。
2. 测试结果出现 HTTP 200，表示配置可用。
3. 点击「使用」，Codex++ 会把当前供应商配置写入 ~/.codex/config.toml。
4. 通过 Codex++ 入口启动，不要使用原版 Codex 入口。
5. 发送一个轻量请求，确认模型可以正常返回。

ℹ️ 说明 Codex++ 写入的 model_provider 是内部标识符，不同版本可能使用 custom 等名称。决定请求是否走 sub2aigc 的是 Base URL 和 API Key，不需要手动修改该标识符。

验证请求走到 sub2aigc

如果使用记录中没有请求，通常说明 Codex 没有切换到 sub2aigc 供应商，或者没有通过 Codex++ 入口启动。

常见问题

相关资源

• 导入到 Codex
• 创建 API Key
• CodexPlusPlus 项目