一、下载与安装 Codex 桌面版

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

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

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

  1. 下载:从 Codex++ 的官方 GitHub 仓库 (https://github.com/BigPizzaV3/CodexPlusPlus) 下载对应您系统的安装程序。
  2. 安装:运行安装程序,按照向导完成安装。安装成功后,您的桌面会出现两个图标:“Codex++”(用于启动增强版 Codex)和“Codex++ Manager”(用于管理配置)。
  3. 启动验证务必通过“Codex++”图标启动 Codex。启动后,检查 Codex 窗口顶部菜单栏是否出现“Codex++”选项,若出现则表明增强功能注入成功 。

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

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

  1. 进入配置界面:在 Codex 中,通过顶部菜单栏的“Codex++”选项进入设置,或直接打开“Codex++ Manager”,找到“供应商管理”。
  2. 添加新供应商:点击“新增供应商”。
  3. 填写配置信息:以下是以接入 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

四、验证与使用

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

五、常见问题与优化建议

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

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


参考来源

 

Logo

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目,面向数字基础设施四大核心场景(服务器、云计算、边缘计算、嵌入式),全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐