Codex Desktop DeepSeek 设置:无需 Codex 账号的纯 API 配置

想把 Codex Desktop 连接到 DeepSeek 或其他国内模型?本指南涵盖 Codex++ 安装、纯 API 提供商设置、Chat Completions 协议选择、Base URL 和 API Key 配置,以及 502、404 和卡在 Logo 页面等问题的排查。

发布于 2026年7月5日generalGEO 评分: 709 次阅读
Codex 桌面版Codex++DeepSeek APICodex DeepSeek 设置纯 API 模型聊天补全基础 URLAPI 密钥国内 AI 编程模型
一张 4:3 白色背景手绘封面,展示从 Codex 应用通过 Codex++ 启动器,以纯 API 方式连接到 DeepSeek API 的流程。

开篇:为什么使用这种配置?

许多开发者想尝试 Codex Desktop 的编码助手体验,但会被账号要求、网络访问、API 配置或插件入口限制所阻碍。源文章中描述的配置方式是:安装 Codex Desktop,通过第三方 Codex++ 增强启动器启动 Codex,然后通过纯 API 模式连接 DeepSeek。

核心思路并不是解锁隐藏的模型能力,而是将 Codex 桌面体验与第三方 API 模型连接起来。配置完成后,你可以在 Codex 中使用 DeepSeek 等国产模型,并获得代码补全、对话式编程和 Agent 风格的交互体验。

需要明确的是:Codex++ 是一个第三方工具。它通过外部启动器启动 Codex,并向渲染进程注入增强脚本。它不是 OpenAI 官方 Codex 产品的一部分。使用前,请评估其安全性、兼容性和维护风险。

1. 下载并安装 Codex Desktop

第一步是安装 Codex Desktop。访问 OpenAI Codex 官方页面,并下载适用于你操作系统的桌面安装程序。

  • 官方入口:Codex | OpenAI

  • 安装后,先保持默认状态。

  • 之后,Codex++ 通常会自动检测本地 Codex 信息,因此你通常不需要手动编辑原 Codex 安装目录。

安装后,建议让 Codex 在后台保持运行,以免系统在不提示的情况下将其关闭,从而影响 Codex++ 的检测或启动。

2. 安装 Codex++ 增强启动器

Codex++ 是 Codex App 的外部增强启动器。它不会直接修改原始 Codex 安装文件,而是通过外部启动器启动 Codex,并将增强脚本注入到渲染器进程中。

其主要功能包括:

  • 解锁插件入口:允许插件在 API Key 模式下正常工作。

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

  • 适配 API 模式:使插件功能在纯 API 模式下更加完整。

下载入口:

按系统选择对应版本:

系统

推荐安装程序

Windows

CodexPlusPlus-*-windows-x64-setup.exe

macOS Intel

对应的 Intel 软件包

macOS Apple Silicon

对应的 Apple Silicon 软件包

安装完成后,桌面上通常会出现两个条目:

图标

用途

Codex++

Codex 的日常启动入口,带增强注入

Codex++ 管理器

管理提供商、模型和增强设置

日常使用时,请通过 Codex++ 启动 Codex,而不是直接打开原始 Codex 程序。否则,增强功能将不会生效。

验证方法很简单:通过 Codex++ 启动 Codex 后,如果顶部菜单栏显示 Codex++ 选项,通常表示注入已成功。

3. 配置提供商:纯 API 模式是关键

此设置的核心是通过纯 API 模式连接 DeepSeek 或其他国内/第三方模型 API,避免依赖官方 Codex 账户。

进入配置页面:

  1. 打开 Codex++。

  2. 前往设置。

  3. 找到提供商管理。

然后点击添加提供商,并输入一个易于识别的名称,例如 deepseek

关键配置字段:

字段

推荐值 / 描述

访问模式

纯 API 模型,无需官方 Codex 账号

测试模型

输入提供商的模型名称,例如 deepseek-v4-pro

混入 API Key

建议启用

URL / 基础 URL

根据提供商文档填写,例如 https://api.deepseek.com

密钥

你的有效 API Key

上游协议

为了更好的兼容性,优先使用 Chat Completions

并非每个模型都支持 Responses API。如果你的模型支持 Responses API,你可以测试其 Agent 能力。如果不确定,请从 Chat Completions 开始,以降低兼容性风险。

4. DeepSeek 配置示例

以 DeepSeek 为例,源文章提供了以下经过测试的配置:

Name       : deepseek
Access mode: 纯 API
Test model : deepseek-v4-pro
Base URL   : https://api.deepseek.com
Key        : 你的 API 密钥
Protocol   : Chat Completions

最容易出错的字段是 Base URL、模型名称和协议。

  • 不要凭记忆输入 Base URL;尽可能从官方文档中复制。

  • 模型名称必须与提供商控制台或文档完全一致,包括大小写和连字符。

  • 如果 DeepSeek 当前使用的是兼容 Chat Completions 的接口,不要误选 Responses API。

保存配置后,通过 Codex++ 重启 Codex。

5. 验证设置是否生效

重启 Codex 后,模型选择列表应显示你添加的提供商和模型,例如:

deepseek / deepseek-v4-pro

你还可以检查以下信号:

  • Codex 窗口顶部菜单是否显示 Codex++。

  • 插件入口是否已解锁。

  • deepseek 是否出现在模型列表中。

  • 简单的编码任务是否返回正常的补全或聊天输出。

如果这些都能正常工作,那么 Codex Desktop、Codex++ 和 DeepSeek API 之间的链路就已连接。

6. 速度优化和代理建议

原文指出,首次启动或首次调用模型可能会稍慢,尤其是因为 Codex 在启动期间可能会访问一些相关域名。如果你的网络不稳定,可能会看到应用卡在 logo 页面,或 API 请求失败。

推荐步骤:

  • 启用代理并使用基于规则的代理模式。

api.deepseek.com 添加到代理规则中,或根据你的实际网络情况正确路由。

  • 将 Codex 相关域名添加到代理规则中,以避免资源加载失败。

  • 不要随意将所有 API 域名添加到绕过列表中,因为这可能导致 502、404 或连接失败。

如果你从未启用代理,Codex 可能会一直卡在 logo 页面。这通常不是模型配置错误;它往往是启动资源或网络路径问题。

7. 常见故障排查

问题 1:配置后没有出现模型选项

可能原因:

  • 上游协议错误。

  • 基础 URL 末尾多了 /v1

  • 保存后未重启 Codex。

  • 提供商名称或模型名称输入不规范。

建议修复方法:

  1. 确认已选择 Chat Completions。

  2. 检查基础 URL 是否与官方文档一致。

  3. 通过 Codex++ 保存并重启 Codex。

  4. 重新打开模型选择列表。

问题 2:502 或 404 错误

典型错误包括:

status 502 Bad Gateway
https://api.deepseek.com/ returned 404

常见原因是代理配置问题,不一定是 API Key 错误。请检查你的代理绕过设置,并确认相关域名既没有被错误绕过,也没有被路由到不可用的线路。

问题 3:Codex 卡在 Logo 界面

这通常发生在 Codex 启动期间。Codex 可能需要请求 ChatGPT 或 OpenAI 相关资源,但当前网络无法访问这些资源。

可能的修复方法:

  • 确认代理已启用。

  • 将 Codex 相关域名添加到代理规则中。

  • 关闭应用,并通过 Codex++ 重新启动。

  • 如果仍然卡住,请先检查原版 Codex 应用是否可以正常启动。

问题 4:插件入口未解锁

如果你直接启动原版 Codex 应用,而不是使用 Codex++,增强脚本将不会被注入,因此插件入口不会出现。

修复方法:

  • 关闭 Codex。

  • 使用 Codex++ 桌面图标启动它。

  • 检查 Codex++ 是否出现在顶部菜单栏中。

8. 此设置适合谁?

此设置适用于:

  • 想要尝试 Codex Desktop 但目前没有官方 Codex 账号的用户。

  • 想要将 DeepSeek、Qwen 或其他国内模型接入编码助手的开发者。

  • 想要在使用自定义 API 的同时保留 Codex 桌面交互体验的用户。

  • 教育场景、内部团队实验或个人开发环境。

它可能不适用于:

  • 对第三方注入工具高度敏感的生产环境。

  • 只想使用 OpenAI 官方支持路径的团队。

  • 不想维护代理、API、模型名称或协议设置的用户。

9. 与 We0 AI 内容工作流的关系

这类教程对开发者很有用,但在网站、博客或知识库上发布时,应明确事实边界。Codex++ 是第三方工具,DeepSeek API 模型名称和协议能力可能会随时间变化。因此,不应将某个具体模型 ID、协议支持状态或配置路径表述为永久固定。

如果团队使用 We0 AI 制作展示型网站、案例页面或 SEO/GEO 内容,这类技术教程可以整理成更清晰的结构:使用场景、配置步骤、风险说明和故障排查清单。这有助于搜索用户快速解决问题,同时在版本变化时降低误导他们的风险。

10. 结论

通过结合 Codex Desktop、Codex++ 增强启动器以及 DeepSeek 纯 API 模式,开发者可以尝试将国内模型接入 Codex 桌面体验,而无需依赖官方 Codex 账户。

关键点如下:

  1. 通过 Codex++ 启动 Codex,而不是直接通过原版 Codex 应用启动。

  2. 在提供商管理中,选择纯 API 模式,并正确填写 Base URL、API Key、模型名称和协议。

  3. 如果遇到卡在 logo 屏幕、502、404 或模型缺失,请先检查代理规则、协议选择和 Base URL。

这种设置适用于国内开发者、教育用户,以及希望自定义 AI 编程助手背后后端模型的团队。只要清楚说明账户边界、第三方工具边界和 API 配置边界,它就是扩展 Codex 桌面体验的一条实用途径。

英文常见问题

Codex++ 是 OpenAI 官方工具吗?

不是。Codex++ 是第三方增强启动器。它不是 OpenAI 官方 Codex 产品的一部分。它通过外部启动器启动 Codex,并注入增强脚本。

这种设置真的可以避免需要官方 Codex 账户吗?

源文章的方法是使用 Codex++ 纯 API 模式连接第三方模型,从而避免依赖官方 Codex 账户。实际可用性可能取决于 Codex 版本、Codex++ 版本和本地环境。

DeepSeek 应该使用 Responses API 还是 Chat Completions?

如果你不确定该模型是否支持 Responses API,请优先选择 Chat Completions。源文章也建议为 DeepSeek 兼容性使用 Chat Completions。

Base URL 应该以 /v1 结尾吗?

遵循服务提供商文档。源文章特别指出,在某些配置中额外添加一个 /v1 可能会导致模型缺失或请求失败。

卡在 Codex 标志界面是否意味着模型配置错误?

不一定。这通常是网络或代理规则问题。Codex 在启动期间可能需要访问相关资源,因此请先检查代理设置和域名规则。

相关工具 / 相关工具

相关文章 / 相关文章

来源 / 来源