Codex接入DeepSeek国产大模型：零基础配置完整指南

文章正文

OpenAI 的 Codex 是目前最受关注的 AI 编程智能体工具之一。作为背景，有必要先理解它的定位：Codex 基于 GPT-4 系列模型，专为代码生成与编程辅助设计，支持在独立的沙盒环境中自主执行多步骤编程任务——包括读写文件、运行测试、调试代码等，是 AI Agent（智能体）范式的典型实现。它并非单纯的代码补全工具，而是能够理解任务目标、规划执行步骤、自主完成复杂工程任务的「编程助手」。然而，这款工具对国内用户设置了不小的门槛——默认需要 ChatGPT Plus 账号才能登录。对于大多数没有海外账号、缺乏对应网络环境的开发者而言，这几乎是一道难以跨越的壁垒。

好消息是，通过第三方管理工具，我们完全可以绕开 ChatGPT 登录限制，把 DeepSeek、豆包等国产大模型作为 Codex 的底座来驱动运行。本文基于实战教程，梳理出一套从零安装到成功接入 DeepSeek 的完整配置流程。

两条使用路径：先想清楚走哪条

动手之前，先明确自己属于哪类用户——这直接决定后续操作的复杂程度。

路径一：拥有 ChatGPT Plus 账号。 如果你在海外、有可用的网络环境并持有 ChatGPT Plus 会员，直接下载 Codex、用 ChatGPT 账号登录即可，无需任何额外配置，是最省事的方案。

路径二：使用国产大模型替代。 这也是本文的重点。绝大多数国内用户没有 Plus 账号，也不具备稳定访问 OpenAI 的网络条件。此时可借助 Codex++ 管理工具，将 DeepSeek 或豆包等国产模型接入 Codex，让它以国产模型为底座运行。

需要说明的是，Codex++ 这类第三方工具并不修改 Codex 的核心功能，它只是改变了登录方式，让你可以用 API Key 而非 ChatGPT 账号完成接入——理解这一点，对把握整个方案至关重要。现代 AI 编程工具普遍采用「前端交互层 + 底层推理模型」的分离架构：Codex 作为前端工具负责任务管理、界面交互和代码执行沙盒等工程化能力；真正的语言理解与代码生成由底层大模型承担。这种架构允许开发者按需替换推理后端，Codex++ 的价值正在于将这种「可替换底层」的能力暴露给了普通用户。

第一步：安装 Codex 主程序

无论走哪条路径，首先都要在电脑上安装好 Codex 本体。

Windows 系统上，最简单的方式是打开「开始」菜单，搜索并进入应用商店，搜索 Codex，找到对应应用后点击「免费下载」。Mac 用户操作方式类似，同样通过应用商店搜索安装。整个过程和安装普通软件没有区别，没有技术门槛。

安装完成后有一个关键注意事项：千万不要直接打开 Codex！ 直接启动会默认要求使用 ChatGPT Plus 账号登录，而这正是国内用户所没有的。正确做法是先安装管理工具，再通过管理工具来启动 Codex。

第二步：安装 Codex++ 管理工具

下载好 Codex 主程序后，接下来安装 Codex++ 管理工具。该工具通常可从其 GitHub 仓库的 Release 页面获取最新版本。若国内网络无法访问 GitHub，可使用教程提供的现成安装包（区分 Windows 版和 Mac 版）。

安装同样是「下一步」到底的默认流程。完成后，系统里通常会出现三个相关程序：

• Codex（主程序）
• Codex++ 管理工具
• Codex++

这里最容易踩坑：要选择「Codex++ 管理工具」，不要选错。打开后界面功能较多，但我们只需用到「模型供应商配置」这一项，其余功能一概不用管。

第三步：配置 DeepSeek 供应商

这是整个流程的核心环节。在 Codex++ 管理工具左侧点击「模型供应商」，初始状态下只有一个默认项，我们需要手动添加国产大模型。

填写供应商基本信息

点击「添加供应商」后，依次填写以下内容：

1. 名称：随意命名，例如「我的 DeepSeek」，仅供自己区分用。
2. 接入模式：必须选择「纯 API」。我们通过 API 接口接入，而非账号登录方式，选错会导致后续无法正常工作。
3. Base URL：填写 DeepSeek 官方接口地址 api.deepseek.com。建议直接复制粘贴，避免手动输入出错。

关于 Base URL 的技术背景：它是 API 请求的根地址，所有接口调用都基于此路径展开。值得一提的是，DeepSeek、豆包、通义千问等主流国产大模型均主动兼容了 OpenAI 的 API 协议规范，这意味着只需替换 Base URL 和 API Key，原本为 OpenAI 设计的客户端工具无需任何代码修改即可驱动国产模型——这正是整个方案能够奏效的技术基础。

获取并填入 DeepSeek API Key

API Key 是你 DeepSeek 账号的唯一身份凭证——Codex 正是靠它来确认身份、调用你的 token 额度。从技术原理来看，API Key 本质上是一串绑定到你账号的唯一字符串：每次调用 API 时，服务端通过 Key 识别调用者身份，并从对应账户扣除 Token 消耗量。Token 是大模型处理文本的基本单位，中文约 1.5 个汉字对应 1 个 Token，英文约 4 个字符对应 1 个 Token。DeepSeek 等国产模型的 Token 单价远低于 OpenAI，这也是后文提到「调用成本极低」的技术底层原因。

获取方式：进入 DeepSeek 官网，点击「API 开放平台」，在左侧找到「API keys」菜单，点击「创建」按钮生成新密钥。

极其重要：API Key 创建后只显示一次，关闭窗口后将永久不可见。请务必第一时间复制并保存到安全位置（如本地文档或备忘录），否则只能删除重建。

将复制好的 Key 粘贴到管理工具的对应字段中，协议选项选择 DeepSeek 官方默认协议即可。

拉取模型列表并保存

配置好 URL 和 Key 后，点击「从上游获取」按钮——这一步相当于连通性测试，若能成功抓取到模型列表，说明接口配置无误。

DeepSeek 目前开放的 API 中，推荐选用 Pro 版本（如 DeepSeek V4 Pro），效果更强而价格依然亲民。抓取成功后，无需在此界面选中模型，直接向上找到「保存」按钮点击保存即可。

保存后，供应商列表中会出现刚配置的项目，将鼠标移到右侧点击「使用」，状态显示为「使用中」即代表切换成功。

第四步：DeepSeek 账户充值

配置完成后还有一个前提——账户里需要有余额，否则 API 调用会直接失败。

进入 DeepSeek API 平台充值页面，充值 10 元对于学习用途绰绰有余。DeepSeek 的调用成本极低，即便每天大量使用、同时跑多个任务，每月消费也仅在百元左右。对于普通学习者而言，10 元额度足以覆盖大部分练习场景。

第五步：通过管理工具启动 Codex

所有配置就绪后，回到 Codex++ 管理工具，在右上角找到「重启 Codex++」功能。务必通过管理工具启动 Codex，而非直接打开 Codex 主程序，只有这样才能使修改后的登录方式生效。

点击后，工具会自动启动已安装的 Codex。登录界面会出现两个选项：

• 使用 ChatGPT 登录（国产模型方案下不要选）
• 使用其他方式登录（选这个）

选择「使用其他方式登录」后，将之前保存的 DeepSeek API Key 粘贴进去（界面提示写的是 OpenAI API Key，填 DeepSeek 的即可——这正是因为两者共用同一套 API 协议规范），点击「继续」。首次登录可能需要稍等片刻。

进入主界面后，做最后一步验证：点击右下角的模型选择菜单，确认能否选中刚配置的 DeepSeek 模型。若能选中 DeepSeek V4 Pro，整套配置即全部打通，可以正式投入使用了。

一个值得关注的趋势

Codex 官方团队已发表声明，表示后续将原生支持第三方大模型接入，届时可能不再需要 Codex++ 这类中间工具，直接配置 DeepSeek、豆包等国产模型即可。这一趋势折射出 AI 工具领域更广泛的变化：随着国产大模型普遍兼容 OpenAI API 协议，「工具外壳与推理后端分离」的架构正在成为行业标准，用户对底层模型的自主选择权也将越来越大。

如果这一功能顺利落地，将大幅降低国内开发者使用 Codex 的门槛。但在官方功能上线之前，通过第三方管理工具接入国产模型，仍是目前最可行的方案。

小结

本教程的核心价值不在于「照抄步骤」，而在于理解背后的逻辑：Codex 只是工具外壳，真正干活的是底层大模型。用哪家模型，就给哪家充值、配哪家的 API。

掌握了「拆解登录 → 配置 API → 验证连通」这套方法论，无论 DeepSeek 日后升级新模型，还是想换成豆包、通义千问等其他国产大模型，配置逻辑完全一致，举一反三毫无压力。

核心要点