Codex++纯API模式接入指南
首先,您需要下载并安装官方的 Codex 桌面版应用程序。访问下载对应您操作系统的安装包。安装过程无需登录或激活任何账号,保持默认状态即可。安装后,建议让 Codex 在后台持续运行,以避免被系统静默关闭。Codex++ 是一个外部增强启动器,它不会修改 Codex 的原生文件,而是通过注入脚本的方式为 Codex 解锁额外功能。这是实现纯 API 模式接入和插件解锁的关键工具。这是最关键的一步,
一、下载与安装 Codex 桌面版
首先,您需要下载并安装官方的 Codex 桌面版应用程序。访问 OpenAI 官方 Codex 页面 下载对应您操作系统的安装包。安装过程无需登录或激活任何账号,保持默认状态即可。安装后,建议让 Codex 在后台持续运行,以避免被系统静默关闭 。
二、获取并安装 Codex++ 增强启动器
Codex++ 是一个外部增强启动器,它不会修改 Codex 的原生文件,而是通过注入脚本的方式为 Codex 解锁额外功能。这是实现纯 API 模式接入和插件解锁的关键工具 。
- 下载:从 Codex++ 的官方 GitHub 仓库 (https://github.com/BigPizzaV3/CodexPlusPlus) 下载对应您系统的安装程序。
- 安装:运行安装程序,按照向导完成安装。安装成功后,您的桌面会出现两个图标:“Codex++”(用于启动增强版 Codex)和“Codex++ Manager”(用于管理配置)。
- 启动验证:务必通过“Codex++”图标启动 Codex。启动后,检查 Codex 窗口顶部菜单栏是否出现“Codex++”选项,若出现则表明增强功能注入成功 。
三、核心配置:添加纯 API 模型供应商
这是最关键的一步,通过配置第三方 API 来绕过对 Codex 官方账号的依赖。
- 进入配置界面:在 Codex 中,通过顶部菜单栏的“Codex++”选项进入设置,或直接打开“Codex++ Manager”,找到“供应商管理”。
- 添加新供应商:点击“新增供应商”。
- 填写配置信息:以下是以接入 DeepSeek 模型为例的配置表格,您可以根据您选择的模型服务商(如智谱AI、月之暗面等支持 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 桌面版,并同时解锁了全部插件功能。
参考来源
- Codex桌面版 + DeepSeek纯API接入教程|无需Codex账号,支持国内模型
- Codex桌面版 + DeepSeek纯API接入教程|无需Codex账号,支持国内模型
- [Codex++ 的教程|Codex增强版下载与使用指南 Codex插件解锁、Codex API中转、Codex会话删除、Codex增强工具](https://blog.csdn.net/visual studio code/article/details/161262799)
- Codex使用API Key授权无法使用插件?
- 保姆级教程,通过GACCode在国内使用Claudecode、Codex!
- Codex 接入自定义大模型终极教程:插件解锁、会话管理、国产模型一键搞定
openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目,面向数字基础设施四大核心场景(服务器、云计算、边缘计算、嵌入式),全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构
更多推荐
所有评论(0)