2026最新Codex国内新手使用教程:从安装到配置,零基础一步步教会你

不用懂编程，跟着教程操作，也能完成安装、模型配置和首次使用。

最近，越来越多人开始使用 AI 辅助编程工具。

以前想开发一个网站、制作一个小工具，可能需要学习大量编程知识。现在，借助 AI 编程助手，只需要用自然语言描述需求，就能让 AI 帮助编写代码、修改文件，甚至完成一些复杂的开发任务。

今天要介绍的，就是一款 AI 编程工具——Codex。

不过，不少新手第一次接触 Codex 时，往往会遇到几个问题：

• 安装包在哪里下载？
• 安装完成后为什么无法正常启动？
• 没有编程基础，应该如何配置？
• DeepSeek API Key 是什么？在哪里获取？
• 如何通过 Codex++ 管理工具接入 DeepSeek？
• 配置完成后，怎样确认可以正常使用？

这篇教程会按照实际操作顺序，从软件下载、API 获取、管理工具配置，一直讲到首次启动和测试。

即使你之前完全没有接触过 AI 编程，也可以跟着步骤逐项操作。

需要提前说明的是：本文介绍的是通过第三方 Codex++ 管理工具配置 DeepSeek 模型的使用方案，并不代表能够绕过 Codex 官方账户的身份验证要求。不同软件版本的兼容情况可能有所不同。

正式安装之前，我们先把需要使用的软件和资料准备好。

整个操作主要涉及三个部分。

1. Codex 客户端

Codex 是一款 AI 编程工具，可以辅助用户完成代码编写、项目开发、代码修改等任务。

对于普通用户来说，可以把它理解为：

一个能够帮助你完成编程任务的 AI 助手。

例如，你可以让它：

• 制作一个简单的个人网页。
• 开发一个日常使用的小工具。
• 修改已有项目中的代码。
• 检查程序运行时出现的错误。
• 根据文字需求生成程序。
• 帮助理解陌生的代码文件。

当然，AI 并不能保证每次生成的代码都正确，实际开发中仍然需要进行测试和检查。

1. Codex++ 管理工具

本教程使用 Codex++ 管理工具进行模型配置。

它的主要作用，是帮助用户管理第三方模型供应商及相关 API 参数。

简单理解：

Codex 是使用界面，Codex++ 用于管理相关模型配置。

需要注意，Codex++ 属于第三方工具，并非 Codex 官方提供的标准配置方式。

安装前应确认软件来源可信，避免使用被修改或捆绑其他程序的安装包。

1. DeepSeek API

本教程使用 DeepSeek 提供的大模型 API 服务。

很多新手看到 API 这个词可能会觉得复杂。

其实可以这样理解：

API 就像一个连接通道，让软件能够调用 AI 模型的能力。

而 API Key 则相当于这个连接通道的专用密钥。

当软件需要调用模型时，会使用 API Key 进行身份验证和计费。

因此，我们需要提前获取 DeepSeek API Key。

第一步：下载软件安装包

本教程需要准备以下三个安装文件。

其中，WebView2 Runtime 主要用于解决部分 Windows 软件无法正常显示界面的问题。

安装包下载地址

• ●夸克网盘：
• ●https://pan.quark.cn/s/805e7f8b9c97

第二步：安装 Codex

下载完成后，找到 Codex 安装程序。

双击打开安装文件。

如果系统弹出安装确认窗口，先核对软件名称、发布者及安装来源。

确认无误后，再继续操作。

• ●一般安装流程如下：
• ●第1步： 双击安装程序。
• ●第2步： 阅读安装提示。
• ●第3步： 选择安装位置。
• ●第4步： 根据安装向导继续操作。
• ●第5步： 等待安装完成。

如果没有特殊需求，可以使用默认安装路径。

这里有一个需要特别注意，安装完成后先不要启动 Codex。

接下来，我们需要安装 Codex++ 管理工具，并完成模型供应商配置。

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

找到下载好的 Codex++ 安装程序。

双击打开。

根据安装向导完成安装。

安装结束后，可以在电脑桌面或开始菜单中查找 Codex++。

打开软件，检查是否能够正常进入管理界面。

如果可以正常打开，就说明管理工具的基础安装已经完成。

如果启动过程中出现报错，可以参考下面的方法处理。

部分 Windows 用户第一次启动相关软件时，可能会看到类似错误提示：

翻译过来就是：

系统没有找到 WebView2 运行环境。

出现这个问题，并不一定意味着软件安装失败。

有可能只是电脑缺少必要的运行组件。

• ●第1步： 找到前面准备的 WebView2 Runtime 安装程序。
• ●第2步： 双击运行安装程序。
• ●第3步： 按照系统提示完成安装。
• ●第4步： 安装完成后，关闭之前出现报错的软件。
• ●第5步： 重新打开 Codex++。

如果仍然出现相同错误，可以尝试重新启动电脑。

需要注意的是，WebView2 只能解决与该运行环境有关的问题。

如果软件无法启动是由系统版本不兼容、安装包损坏或其他原因造成的，安装 WebView2 并不能保证解决。

软件安装完成后，接下来进入最重要的环节之一：

获取 DeepSeek API Key。

这是后面配置模型时需要使用的关键信息。

第一步：进入 DeepSeek 开放平台

打开浏览器，访问 DeepSeek 开放平台：

https://platform.deepseek.com/

进入页面后，按照平台提示完成登录。

如果还没有账号，需要先根据页面要求完成注册。

登录成功后，就可以进入平台管理界面。

第二步：找到 API Keys

进入 DeepSeek 平台后，找到左侧菜单中的：

API Keys

点击进入。

这里主要用于管理当前账号已经创建的 API 密钥。

如果之前没有创建过，页面中的密钥列表可能为空。

如果已经创建过，则可能显示已有密钥的名称、创建时间等信息。

第三步：创建 API Key

在 API Keys 页面中，找到：

创建 API Key

点击按钮。

系统会弹出创建窗口。

通常需要填写一个名称，方便自己识别这个密钥的用途。

Codex-DeepSeek

或者：

My-Codex

名称只是为了方便管理，不会直接影响模型能力。

填写完成后，点击创建。

系统会生成一串 API Key。

这串字符就是后面配置时需要使用的密钥。

第四步：立即复制并保存 API Key

这里需要特别注意。

API Key 通常只会在创建时完整显示一次。

如果关闭创建窗口后没有保存，可能无法再次查看完整内容，只能重新创建新的密钥。

因此，建议在创建成功后立即复制。

可以将密钥暂时保存到可靠的密码管理工具中。

不要将 API Key：

• 发布到公众号或社交平台。
• 放进公开分享的截图。
• 直接发送给陌生人。
• 写进公开的代码仓库。
• 保存在任何人都能访问的共享文档中。

因为 API Key 与模型调用权限和费用有关。

如果密钥泄露，其他人可能使用你的账户额度调用模型。

记住：API Key 相当于一把数字钥匙，必须妥善保管。

完成 API Key 创建后，还需要了解另一个参数：

Base URL。

这个名称看起来比较专业，但理解起来并不困难。

可以把 API Key 理解为身份凭证。

那么 Base URL 就是软件连接模型服务时使用的接口地址。

软件需要知道：

应该把模型请求发送到哪里，这就是 Base URL 的作用。

DeepSeek Base URL 为：

"https://api.deepseek.com"

在后面的管理工具配置中，需要将它填写到对应位置。

新手容易混淆的两个参数

API Key：用于验证调用者身份。

Base URL：用于指定模型接口服务地址。

二者作用不同，不能相互替代。

另外，某些第三方工具可能要求填写带有特定路径的接口地址。

如果配置后出现连接错误，应以当前使用工具的接口格式要求和 DeepSeek 官方文档为准。

API Key 创建完成后，还需要检查账户是否有可用余额。

因为通过 API 调用模型，通常需要根据实际使用量支付费用。

这与直接使用普通聊天网页并不完全相同。

第一步：进入充值页面

回到 DeepSeek 开放平台。

找到左侧菜单中的：

充值

点击进入。

页面会显示充值金额及支付方式等信息。

第二步：选择充值金额

原教程展示了不同金额的充值选项。

如果只是第一次学习使用，建议先根据实际需要选择较小的充值金额。

不需要一开始就充值很多。

因为新手初期主要是测试连接、熟悉界面和体验基础功能。

等确认整个配置流程能够正常运行后，再决定是否增加预算。

第三步：完成支付

选择金额后，按照页面提示选择支付方式。

确认支付信息无误，再完成支付。

支付成功后，可以返回账户余额页面，检查余额是否更新。

如果余额没有立即显示，可以稍等片刻后刷新页面。

关于 API 费用，需要了解什么？

API 通常根据模型调用量计费。

例如：

你让 AI 回答一个简单问题，消耗的资源通常比较少。

如果让 AI 阅读大量代码、分析整个项目或者连续修改多个文件，可能消耗更多资源。

实际费用取决于模型、输入输出内容及平台计费规则。

建议新手先进行少量测试，避免在不了解计费方式的情况下持续运行大量任务。

前面的准备工作完成后，现在进入整个教程的核心环节。

我们需要把 DeepSeek API 信息填写到 Codex++ 管理工具中。

这样，管理工具才能尝试通过对应接口调用模型。

请注意：以下步骤依据原资料中的 Codex++ 界面整理。第三方工具升级后，按钮名称和具体位置可能发生变化。

第一步：打开 Codex++

回到电脑桌面。

找到 Codex++ 管理工具。

双击打开。

进入软件后，找到与供应商管理有关的功能区域。

原教程中使用的入口是：

供应商配置

点击进入。

第二步：添加模型供应商

进入供应商配置页面后，找到添加供应商的按钮。

点击添加。

系统会显示供应商配置表单。

这里需要填写模型供应商的基本信息。

例如：

供应商名称、接口地址、API Key 等。

第三步：填写供应商名称

供应商名称可以自定义。

例如：

DeepSeek

或者：

DeepSeek-Codex

这个名称主要用于方便自己区分不同模型供应商。

如果以后还要配置其他模型，也可以通过名称快速识别。

第四步：选择 API 类型

在供应商配置表单中，找到 API 类型选项。

按照原教程的配置方式，选择与 DeepSeek 接口兼容的 API 类型。

需要注意：

API 类型必须与实际接口协议匹配。

不能仅凭供应商名称随意选择。

如果当前 Codex++ 版本提供 OpenAI 兼容接口选项，可以结合该工具的说明检查是否适用于当前 DeepSeek 接口。

如果软件版本与原教程不同，应优先参考当前版本的配置说明。

第五步：填写 Base URL

找到 Base URL 输入框。

• ●将前面准备好的接口地址填写进去：
• ●"https://api.deepseek.com"
• ●填写时注意：

不要添加多余的空格。

不要漏掉必要的字符。

如果软件要求使用特定格式，应以软件当前版本的说明为准。

第六步：填写 API Key

找到 API Key 输入框。

把前面创建并保存的 DeepSeek API Key 粘贴进去。

建议直接复制粘贴，不要手动逐个输入。

因为 API Key 通常由较长的字符组成。

如果输入错误，可能导致身份验证失败。

填写完成后，可以检查密钥前后是否存在多余空格。

注意：不要把真实 API Key 截图发送给其他人。

第七步：检查模型配置

完成接口信息填写后，还需要确认模型配置是否正确。

原资料的最终界面中展示了两个模型名称：

• deepseek-flash
• deepseek-v4-pro

这些是原资料截图中显示的模型标识。

它们不应被直接视为 DeepSeek 当前官方 API 一定支持的模型 ID。

实际配置时，必须使用当前接口明确支持的模型标识。

如果填写了不存在的模型名称，即使 API Key 和 Base URL 都正确，也可能出现调用失败。

第八步：保存配置

确认所有信息填写完成后，找到保存或确认按钮。

点击保存。

如果软件提供连接测试功能，可以先进行测试。

检查是否出现认证失败、接口无法访问或模型不存在等错误。

只有连接测试正常，才能进一步确认配置是否有效。

完成供应商配置后，按照原教程中的操作流程，需要重新启动相关服务。

在 Codex++ 管理工具中，找到：

重启

点击后，等待软件完成重启流程。

原教程显示，执行重启操作后，Codex 会自动启动。

但这一行为可能受到软件版本、安装路径以及系统环境影响。

如果没有自动启动，可以检查 Codex++ 是否提供手动启动入口。

如果前面的步骤顺利完成，现在应该已经可以看到 Codex 的主界面。

对于第一次使用的朋友来说，不需要急着开发复杂项目。

建议先熟悉三个地方。

1. 新聊天

用于创建新的任务会话。

例如：

让 AI 解释代码。

让 AI 帮助设计一个简单网页。

让 AI 分析项目文件。

1. 项目区域

用于管理和打开相关项目。

如果你已经有一个代码项目，可以根据软件提供的功能选择项目目录。

如果还没有项目，也可以从简单任务开始学习。

1. 模型选择

原教程的截图中，模型选择区域位于输入框附近。

点击后，可以看到已经配置的模型选项。

选择需要使用的模型。

需要注意，模型出现在列表中，只代表界面识别到了相关配置。

是否真正能够使用，还需要通过实际请求进行验证。

很多新手安装好软件以后，第一反应就是：

接下来该输入什么？

这里提供三个比较简单的测试任务。

它们不需要你提前掌握编程知识。

测试一：让 AI 解释一段代码

可以输入：

「请用普通人能够理解的语言，解释 Python 中的变量、函数和循环分别是什么，并给出简单示例。」

这个任务主要用于检查：

模型是否能够正常接收请求并返回回答。

如果可以正常生成内容，说明基础对话功能可能已经连接成功。

测试二：让 AI 生成一个简单网页

可以输入：

「请帮我制作一个简单的个人介绍网页，使用 HTML 和 CSS，整体风格简洁清爽，包含个人介绍、兴趣爱好和联系方式三个部分。」

如果当前工具支持文件创建，并且你已经授权了合适的工作目录，就可以进一步观察它是否能够生成网页文件。

需要注意：

AI 生成代码，并不意味着代码已经成功运行。

还需要通过浏览器或相应开发环境进行检查。

测试三：让 AI 制作一个待办事项工具

可以输入：

「请帮我制作一个简单的待办事项网页工具，支持添加任务、标记完成和删除任务。界面简洁，适合普通用户使用。」

这是一个比较适合新手的入门项目。

功能不复杂，但能够帮助你理解 AI 辅助开发的大致过程。

你可以观察 AI 如何：

理解需求、规划功能、生成代码、修改问题。

如果生成的工具可以正常运行，说明你已经完成了一次基础的 AI 编程实践。

问题一：安装完成后，软件打不开

首先检查是否出现 WebView2 相关报错。

如果提示缺少运行环境，可以按照前面的步骤安装 WebView2 Runtime。

如果没有相关报错，则需要进一步检查系统兼容性、安装包完整性和软件日志。

问题二：API Key 创建后找不到了

如果创建时没有保存完整密钥，通常需要重新创建。

建议将不再使用的旧密钥撤销，避免产生不必要的安全风险。

新建后及时妥善保存。

问题三：提示 API Key 无效

可以依次检查：

① API Key 是否复制完整。

② 密钥前后是否存在空格。

③ 密钥是否已经被撤销。

④ 是否使用了正确的供应商接口。

⑤ 当前账户是否具备相应的调用权限。

如果仍然无法解决，可以重新创建一个密钥进行测试。

问题四：配置完成后，模型没有响应

这类问题可能涉及多个原因。

例如：

接口地址填写错误。

API 类型不匹配。

模型名称不正确。

账户余额不足。

第三方管理工具不兼容。

或者当前网络无法正常访问对应服务。

建议优先检查 API Key、Base URL、模型 ID 和软件报错信息。

不要在没有确认原因的情况下反复修改多个参数，否则会增加排查难度。

问题五：为什么充值后还是无法使用？

充值只是确保账户具备可用余额。

它并不代表整个配置流程已经完成。

模型是否能够正常调用，还取决于：

接口配置、密钥权限、模型可用性以及第三方工具兼容情况。

因此，建议完成充值后，先进行一次简单的 API 连接测试。

问题六：Codex++ 和 Codex 是同一个软件吗？

不是。

本文中的 Codex++ 是第三方管理工具。

Codex 则是 AI 编程工具。

二者不能直接等同。

此外，通过第三方工具接入 DeepSeek，也不意味着获得了 Codex 官方账户的全部功能或权限。

问题七：完全不会编程，可以使用吗？

可以从简单任务开始学习。

但需要明确一点：

AI 可以降低编程门槛，却不能完全消除软件开发中的技术问题。

如果只是制作简单网页、理解代码或尝试小工具，入门难度相对较低。

如果需要开发正式上线的软件，仍然要考虑功能测试、数据安全、部署维护等问题。

建议先从小项目开始，不要第一次使用就尝试开发非常复杂的系统。

到这里，整个教程的主要操作已经完成。

最后建议按照下面的清单检查一遍。

已经获取并检查所需安装程序。

已经完成安装。

可以正常打开管理界面。

可以正常登录开放平台。

已经成功创建，并安全保存。

账户具有可用余额或其他有效调用额度。

已经按照实际接口要求填写配置。

能够通过真实请求获得模型响应。

如果以上步骤都已完成，并且实际测试正常，说明当前环境已经具备基础使用条件。

如果某一步没有成功，建议回到对应章节检查，不必从头重新安装所有软件。

写在最后

对于第一次接触 AI 编程工具的人来说，真正困难的地方，往往不是让 AI 写代码，而是前期的软件安装和环境配置。

尤其是 API Key、Base URL、模型供应商这些概念，第一次接触时难免觉得陌生。

但只要理解它们各自的作用，整个流程就会清晰很多。

回顾一下，本文主要完成了四件事：

第一，准备并安装相关软件。

第二，创建 DeepSeek API Key，并了解 API 计费方式。

第三，通过 Codex++ 管理工具配置模型供应商。

第四，启动软件并进行基础功能测试。

需要再次提醒：本文采用的是第三方工具配置方案，具体功能取决于软件版本和接口兼容性。它不能保证跳过官方手机号验证，也不应被视为官方身份验证的替代方法。

对于普通新手来说，完成安装只是第一步。

真正有价值的，是学会把自己的需求准确地告诉 AI，再通过测试和修改，让 AI 帮助完成实际任务。

从一个简单网页开始，到制作自己的日常小工具，再到尝试开发完整项目，都可以循序渐进。

不需要一开始就懂很多编程知识，先完成第一个能正常运行的小作品，就是很好的开始。