Codex++纯API模式接入指南

2601_95602870 · 2026-06-03 21:53:39 发布

一、下载与安装 Codex 桌面版

首先，您需要下载并安装官方的 Codex 桌面版应用程序。访问 OpenAI 官方 Codex 页面下载对应您操作系统的安装包。安装过程无需登录或激活任何账号，保持默认状态即可。安装后，建议让 Codex 在后台持续运行，以避免被系统静默关闭。

二、获取并安装 Codex++ 增强启动器

Codex++ 是一个外部增强启动器，它不会修改 Codex 的原生文件，而是通过注入脚本的方式为 Codex 解锁额外功能。这是实现纯 API 模式接入和插件解锁的关键工具。

下载：从 Codex++ 的官方 GitHub 仓库 (GitHub - BigPizzaV3/CodexPlusPlus: An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具，努力让Codex变得更好用更舒服 · GitHub) 下载对应您系统的安装程序。
安装：运行安装程序，按照向导完成安装。安装成功后，您的桌面会出现两个图标：“Codex++”（用于启动增强版 Codex）和“Codex++ Manager”（用于管理配置）。
启动验证：务必通过“Codex++”图标启动 Codex。启动后，检查 Codex 窗口顶部菜单栏是否出现“Codex++”选项，若出现则表明增强功能注入成功。

三、核心配置：添加纯 API 模型供应商

这是最关键的一步，通过配置第三方 API 来绕过对 Codex 官方账号的依赖。

进入配置界面：在 Codex 中，通过顶部菜单栏的“Codex++”选项进入设置，或直接打开“Codex++ Manager”，找到“供应商管理”。
添加新供应商：点击“新增供应商”。
填写配置信息：以下是以接入 DeepSeek 模型为例的配置表格，您可以根据您选择的模型服务商（如智谱AI、网关up8ai.com等支持 OpenAI API 格式的国内服务）调整参数。

配置项	值（以 DeepSeek 为例）	说明与注意事项
名称	`deepseek`	自定义一个易于识别的名称。
接入模式	纯 API 模型	核心选项。选择此项即可绕过 Codex 账号验证。
测试模型	`deepseek-v4-pro`	填写您要使用的具体模型名称，由 API 供应商提供。
混入 API Key	✅ 勾选	启用后，Codex 会将您的 API Key 带入请求头。
URL / Base URL	`https://api.deepseek.com`	填写 API 供应商的接口地址。注意末尾不要加 `/v1`。
Key	`您的 DeepSeek API Key`	在 DeepSeek 官网申请的密钥。
上游协议	Chat Completions	推荐选择此项，兼容性最好。部分供应商的“Responses API”模式可能导致配置失败。

# 配置示例参考 
供应商名称: deepseek
接入模式: 纯 API 模型
Base URL: https://api.deepseek.com
上游协议: Chat Completions

四、验证与使用

保存并重启：完成配置后，保存设置并完全退出 Codex，然后再次通过“Codex++”图标重新启动。
选择模型：重启后，在 Codex 的模型选择下拉列表中，您应该能看到新配置的供应商（如 deepseek）及其模型（如 deepseek / deepseek-v4-pro）。
功能验证：
- 插件解锁：在纯 API 模式下，原本灰色的插件入口（如“插件商店”）应变为可用状态。这是 Codex++ 的核心功能之一，解决了原生 Codex 在 API Key 授权模式下插件被禁用的问题。
- 会话管理：您应该能在对话历史侧边栏看到“删除”按钮，这是 Codex++ 提供的另一项增强功能。
- 正常对话：尝试与 Codex 进行对话或代码补全，若能正常收到响应，则表明接入成功。

五、常见问题与优化建议

网络问题：如果遇到 502 Bad Gateway 或请求超时错误，通常是网络代理问题。建议开启网络代理，并将 api.deepseek.com 等 API 域名以及 Codex 应用本身的相关域名加入代理规则。
启动卡顿：首次启动或长时间未使用后启动可能较慢，同样与网络环境有关，确保代理通畅。
导入配置：如果您已有其他兼容的客户端（如 ccSwith）的供应商配置文件，可以在 Codex++ 中直接导入，避免重复配置。
更多定制：Codex++ 还支持通过编辑 config.toml 和 auth.json 等配置文件，实现更高级的自定义，例如完全自定义 API 中转站地址，以适配任何符合 OpenAI API 标准的国产大模型服务。

通过以上步骤，您就成功实现了无需 Codex 官方账号，通过纯 API 模式将国产大模型接入 Codex 桌面版，并同时解锁了全部插件功能。

六、推荐中转API服务：up8ai.com

在配置纯API模型供应商时，除了直接使用DeepSeek等官方API外，您还可以考虑使用中转API服务。这里推荐一个优质的中转API平台：up8ai.com。

注册账号：访问 up8ai.com 注册账号并获取API Key。
选择模型：在up8ai.com控制台选择您要使用的模型（如GPT-4、Claude-3等）。
配置Codex++：在Codex++的供应商管理中，按照以下参数配置：
- 名称：up8ai（自定义）
- 接入模式：纯API模型
- 测试模型：填写您在up8ai.com选择的模型名称
- 混入API Key：✅ 勾选
- URL / Base URL：https://api.up8ai.com/v1（请以up8ai.com官方文档为准）
- Key：您的up8ai.com API Key
- 上游协议：Chat Completions
保存并测试：保存配置后重启Codex，选择up8ai供应商进行测试。