最近发现了一个很实用的AI编码辅助工具组合:Codex桌面版 + DeepSeek纯API模式
不需要Codex账号,也能实现代码补全、Agent式交互,而且支持国内模型,速度不错。
本文记录完整配置过程,供有需要的朋友参考。

一、下载与安装 Codex 桌面版

  1. 访问官方地址:
    Codex | OpenAI 打造的 AI 编码助手 | OpenAI

  2. 下载对应操作系统的桌面版安装包。

  3. 安装完成后不需要额外登录或激活,直接保持默认状态即可。

  4. 后续使用的 codex++ 插件会自动识别本地Codex信息,无需手动配置。

💡 提示:建议在安装后保持Codex后台运行,避免被系统静默关闭。

二、Codex++ 下载与安装

Codex++ 是一个面向 Codex App 的外部增强启动器,它不修改 Codex 原始安装文件,而是通过外部 launcher 启动 Codex,并向渲染进程注入增强脚本。主要功能包括:

  • 解锁插件入口:让 API Key 模式下也能正常使用插件

  • 支持会话删除:在会话列表中显示删除按钮

  • API 模式适配:让纯 API 模式下插件功能正常工作

下载地址

安装步骤

  1. 下载对应版本

    • Windows:CodexPlusPlus-*-windows-x64-setup.exe 

    • macOS Intel / macOS Apple Silicon

  2. 安装程序:双击运行,按向导完成安装

  3. 安装完成后桌面会出现两个图标

    • Codex++:日常启动 Codex(自动注入增强功能)

    • Codex++ Manager:管理配置

⚠️ 注意:日常使用时需要通过 Codex++ 启动 Codex,而不是直接启动 Codex 原程序,否则增强功能不会生效。

验证安装

安装完成后,通过 Codex++ 启动 Codex,顶部菜单栏会出现 Codex++ 选项,表示注入成功。

三、配置供应商(重要步骤)

这一步是整个方案的核心:
通过“纯API模型”模式,绕过Codex账号限制,直接调用国内/第三方大模型接口。

1. 进入配置界面

  • 打开 Codex++ → 设置 → 供应商管理

2. 添加新供应商

  • 点击 新增供应商

  • 填写一个便于识别的名称,例如:deepseek

3. 关键配置项

配置项 推荐值 / 说明
接入模式 纯 API 模型(无需Codex账号)
测试模型 直接填写供应商提供的模型名,如 deepseek-v4-pro
混入 API Key ✅ 勾选
URL / Base URL 按供应商填写(如 https://api.deepseek.com
Key 你的有效API Key
上游协议 优先使用 Chat Completions(更稳定、兼容性好)

⚠️ 注意:并非所有模型都支持 Responses API
如果你需要更好的Agent能力,可以尝试支持Responses API的模型,否则建议使用 Chat Completions 保证兼容性。

四、配置示例(以 DeepSeek 为例)

以下是经过实测可用的DeepSeek配置:

  • 名称deepseek

  • 接入模式:纯 API

  • 测试模型deepseek-v4-pro

  • Base URLhttps://api.deepseek.com

  • Key:你的API密钥

  • 上游协议Chat Completions
    (DeepSeek当前不支持Responses API)

配置完成后保存并重启Codex(通过 Codex++ 启动)。

五、使用建议与常见问题

✅ 开启速度优化

  • 初次启动或调用模型时可能会稍微慢一点

  • 建议开启VPN,并配置规则代理模式(只代理API相关流量)

  • 加载Codex内部资源时,也建议保持代理畅通

📌 实测发现:如果一直不开代理,Codex 可能卡在 Logo 界面进不去。建议将 api.deepseek.com 和 Codex 相关域名加入代理规则。

✅ 验证是否成功

重启后,在模型选择列表中应该能看到你配置的 deepseek 以及对应的模型选项,例如:

deepseek / deepseek-v4-pro

同时检查:

  • Codex 窗口顶部菜单栏是否有 Codex++ 选项

  • 插件入口是否已解锁(API 模式下原本不可用的插件现在可用了)

如果能正常响应代码补全或对话,说明配置成功。

✅ 额外提示

  • 如果有现成的 ccSwith 配置好的模型供应商文件,可以直接导入,无需重复配置。

  • 如果你需要一些常用国内模型的Base URL或Key配置模板,也可以直接联系我(文章评论区或私信)。

❌ 常见踩坑

问题1:配置后找不到模型选项

  • 检查上游协议是否选择了正确的 Chat Completions

  • 确认 Base URL 末尾没有多余的 /v1

  • 重启 Codex 后再试

问题2:出现 502 / 404 错误

  • 典型错误信息:status 502 Bad Gateway 或 https://api.deepseek.com/ 返回 404 

  • 原因:网络代理配置问题

  • 解决:在代理软件的绕过设置中,移除或正确配置相关域名

问题3:Codex 卡在 Logo 界面

  • 原因:Codex 启动时会请求 ChatGPT 相关域名

  • 解决:确保代理开启,或将 Codex 相关域名加入代理规则

六、总结

通过 Codex桌面版 + Codex++ 增强启动器 + 纯API接入模式,我们可以:

  • 无需Codex官方账号

  • 自由选择国内大模型(如DeepSeek)

  • 保留Codex本身的编码助手体验

  • 解决 API 模式下插件不可用、会话无法删除等痛点

  • 避免海外服务访问受限问题

整个方案适合国内开发者、教育用户、以及对AI编码助手有自定制需求的团队。


如果本文对你有帮助,欢迎点赞、收藏、转发。
遇到问题也可以在评论区留言,我看到会尽量回复。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐