Codex++ 接入
Codex++ 是面向 OpenAI Codex 桌面应用的第三方启动器与管理工具，可在图形界面中管理兼容 API 供应商。本页使用“纯 API”模式接入 NaNLab API，不需要 OpenAI 官方账号。
准备工作
- 在 NaNLab API 控制台创建 API Key，并确认 Key 所属分组可调用 Codex 模型。
- 从 Codex++ Releases下载适合当前系统的安装包。
- 安装后先打开“Codex++ 管理工具”，确认它已识别 Codex 桌面应用。
第三方工具
Codex++ 不是 OpenAI 或 Sub2API 官方组件。请从项目 GitHub Releases 下载，并自行评估第三方工具读取本机 Codex 配置和 API Key 的风险。
添加 NaNLab 供应商
在“供应商配置”中新增供应商，选择“纯 API”，然后填写：
| 项目 | 填写内容 |
|---|---|
| 供应商名称 | NaNLab API |
| API 协议 | Responses |
| Base URL | https://sub.nanlabapi.top/v1 |
| API Key | sk-YOUR_NANLAB_API_KEY |
| 模型 | YOUR_OPENAI_MODEL_ID |
| 测试模型 | 与上面相同的可用模型 ID |
模型名必须来自当前实例的模型列表，不要直接照抄教程中的占位符。Base URL 末尾只保留一个 /v1。
测试并启用
- 在供应商详情中运行“模型测试”或“Provider Doctor”。
- 测试成功后保存并切换到
NaNLab API。 - 完全退出正在运行的 Codex 桌面应用。
- 从
Codex++入口重新启动，而不是直接打开官方 Codex 应用。 - 新建会话并发送一条简短消息，再到 NaNLab 控制台检查请求日志和用量。
如果已经登录官方账号并希望保留插件入口，也可以选择“官方登录 + API”。该模式下模型请求仍始终走 NaNLab API，并不是官方额度不足后才回退到 API。
常见问题
401：检查是否粘贴了完整的 NaNLab API Key，且没有多余空格。403：Key 所属分组没有目标模型权限，或余额、订阅额度不可用。404：检查协议是否为Responses，Base URL 是否为https://sub.nanlabapi.top/v1。- 模型测试失败：从控制台复制当前 Key 可见的准确模型 ID，再同时更新“模型”和“测试模型”。
- 切换后仍走旧供应商：退出 Codex 桌面应用，并从
Codex++入口重新启动。
密钥安全
不要把真实 Key 放入截图、日志、Issue 或公开仓库。若怀疑泄露，请立即在 NaNLab 控制台删除旧 Key 并创建新 Key。