Codex++

第三方工具。给 Codex 桌面端做供应商切换与界面增强的图形管理器。

先弄清三个东西的区别

名称	谁做的	是什么
Codex CLI	OpenAI 官方	命令行工具
Codex 桌面端	OpenAI 官方	图形应用（codex app）
Codex++	第三方	给上面的桌面端换供应商、加增强功能的启动器

第一步：安装

从它的 GitHub Releases 下载对应系统的安装包：

系统	文件
Windows	CodexPlusPlus-*-windows-x64-setup.exe
macOS（Intel）	CodexPlusPlus-*-macos-x64.dmg
macOS（Apple 芯片）	CodexPlusPlus-*-macos-arm64.dmg

前置条件：本机要已经装好官方的 Codex / ChatGPT 桌面应用。 Codex++ 是启动器，它需要官方应用才能工作。

两个入口

入口	作用
Codex++ 管理工具	配置供应商、模型、插件、会话、增强功能
Codex++	按已保存的供应商配置启动官方桌面应用

必须从 Codex++ 入口启动。 直接打开官方应用不会加载你的配置。

第二步：把本站加成供应商

打开管理工具，进「供应商配置」， 点「添加供应商」。

按下表填写：

字段	值
模式	纯 API（不用官方账号，完全走本站）
Base URL	https://api.juheai.shop/v1
API Key	sk-你的密钥
协议	Responses（Codex 原生协议）
模型	你分组里实际开放的模型名

关于「模式」该怎么选

Codex++ 有四种供应商模式，本站场景下的区别是：

模式	说明	适合本站吗
官方登录	只用 ChatGPT / Codex 官方账号，不接第三方 API	❌ 与本站无关
官方登录 + API	保留官方登录状态，但模型请求始终走你配的 API	⭕ 想保留插件入口时选它
纯 API	不依赖官方账号，完全用自定义 Base URL / Key	✅ 推荐
聚合供应商	在多个 API 供应商之间做故障转移与轮转	⭕ 配了多个中转商时才需要

协议选哪个：Responses 还是 Chat Completions

本站两种都支持，但优先选 Responses —— 这是 Codex 的原生协议，功能最完整。 Chat Completions 由 Codex++ 在本地转成 Responses， 多一层转换，出问题时更难排查。

增强选项：选「完整增强」

Codex++ 在「Codex 增强」页提供两套预设， 纯 API 模式选「完整增强」：

配完先做模型测试

保存后用供应商详情里的模型测试（或 Provider Doctor）。 这是 Codex++ 自带的连通性检查，能在启动应用前发现 协议、Base URL、Key 或模型名哪里不对 —— 比启动后看报错省事得多。

数据位置

Codex++ 改的是 Codex 自己的配置（~/.codex/config.toml 等）， 切换供应商时会先备份当前配置到 ~/.codex/backups_state/provider-sync。 Codex++ 自己的状态与日志在 ~/.codex-session-delete/。

这里的 ~/.codex 指的是 Codex 主目录 —— 如果设置了 CODEX_HOME 环境变量就以它为准， 否则是用户目录下的 .codex。

排查

Codex++ 的菜单没出现

• 确认是从 Codex++ 入口启动的，不是直接开官方应用
• 到管理工具的「安装维护」和「关于」页检查应用路径与启动状态

切换供应商后请求失败

• 先在供应商详情里跑模型测试或 Provider Doctor
• 逐项核对：协议（Responses）、Base URL（带 /v1）、 Key、测试模型名
• 不要手工复制两种模式之间的 auth.json —— 「纯 API」与「官方混入」的认证保存位置不同

报 401 Unauthorized

• 确认密钥填在 API Key 字段
• 确认 Base URL 是 https://api.juheai.shop/v1（带 /v1）
• 密钥是否已被删除或额度耗尽，去网站「API 密钥」页确认

报模型不存在 / model_not_found

模型名不对，或你的分组没有开放该模型。到「可用渠道」页面按分组查实际可用的 模型名，逐字复制。

和 Codex CLI 会打架吗

它们改同一份配置（~/.codex/config.toml）。 Codex++ 面板上有个「启用供应商配置切换」开关，关闭后 它不会在手动切换时写入 config.toml / auth.json —— 想自己管配置就关掉它。

Codex++ 是第三方项目，与本站在同一台机器上并存但无关联： github.com/BigPizzaV3/CodexPlusPlus。 本页截图取自其仓库文档。