按页面顺序安装两个客户端,再在 Codex++ 里完成接口配置;每一步都可以勾选记录。
Codex + Codex++ 新手配置教程

10 分钟成功使用 Codex

先安装 Codex,再安装 Codex++。打开 Codex++ 添加供应商,选择“纯 API”,填入配套接口的 Base URL 和 Key,获取模型后就能开始使用。

重要:Codex 和 Codex++ 是两个软件,两个都要安装。Codex++ 负责添加供应商、填写配置、获取模型和选择 GPT / DeepSeek。
本教程配套接口 API

注册后在后台创建令牌,复制 Base URL 和 Key,回到 Codex++ 添加供应商即可。当前活动价约为官方价格的 5 折,模型、额度和计费信息以后台实际显示为准。

⌘看懂课程代码
⚙排查 Python / Java / C++ 报错
▣辅助课程项目与实验
✓解释陌生代码和文件结构
按这个顺序做,不会漏步骤已完成 0 / 8
i

先看懂两个软件:Codex 是基础客户端;Codex++ 是配置供应商和选择模型的操作界面。后面的 Base URL、Key 和模型,都填在 Codex++ 里。

1

先安装 Codex

Windows 用户直接使用官方微软离线包;Mac 用户按芯片选择版本。

Mac 用户

Mac 用户先在下面选择自己的芯片版本,安装 Codex 后再继续安装 Codex++。

↓查看 Mac 版本

本页已同步微软官方当前最新版;截至 2026 年 9 月 27 日,x64 包版本为 26.924.2738.0。普通个人电脑可直接双击 `.msix` 安装;企业或批量离线部署还要配合旁边的授权文件和管理员部署命令。安装包打不开时,先确认系统为 Windows 10 / 11,并使用系统的“应用安装程序”打开。安装 Codex 后不要停,继续完成第 2 步。

2

继续安装 Codex++

Codex++ 不能漏装,后面的供应商配置都在这里完成。

Windows(v1.3.0)

双击安装包,按提示完成安装。该版本为 Codex++ 官方上游最新稳定版。

↓下载 Codex++ Windows
如果出现“Windows 已保护你的电脑”

这是 Microsoft Defender SmartScreen 对未建立信誉或未签名应用的提示。确认安装包来自本教程下载入口后,点击“更多信息”→“仍要运行”。如果看不到“仍要运行”,右键安装包 →“属性”→勾选“解除锁定”→“应用”,再重新打开。

Codex 安装视频封面
想看完整安装演示,可以播放下面的视频。

安装视频演示

视频不会自动播放,点击播放后查看安装和配置顺序。

建议先完成 Codex 和 Codex++ 的安装,再开始配置接口。
3

注册配套接口,创建 Key

打开配套接口后台,先创建一个 API 密钥。

注册配套接口 API

注册后进入 API 密钥页面,创建令牌。当前活动价约为官方价格的 5 折,具体以后台显示为准。

↗打开配套接口后台
1点击“创建密钥”

在 API 密钥页面右上角找到创建入口。

2选择可用分组

按需要选择 GPT 或 DeepSeek 对应分组。

3点击“创建”

创建后记得及时复制 Key。

配套接口后台 API 密钥页面
先看右上角:点击“创建密钥”。
配套接口后台创建 API 密钥
进入弹窗后,选择需要的分组,再点击右下角“创建”。

Key 通常只在创建后显示一次。先复制并粘贴到 Codex++,确认配置完成后再关闭页面。

4

打开 Codex++,点击“添加供应商”

启动 Codex++,进入左侧“供应商配置”,点击页面上的“添加供应商”。

Codex++ 供应商配置页面点击添加供应商
重点看:右上方的“添加供应商”按钮。
5

接入模式选择“纯 API”

创建供应商后,先把接入模式改成“纯 API”。

这一步不要选错

本教程通过配套接口连接模型,所以接入模式选择“纯 API”。

Codex++ 供应商配置选择纯 API 并填写 Base URL 和 Key
重点看:接入模式选择“纯 API”,下面再填写 Base URL 和 Key。
6

填写 Base URL 和 Key,获取模型

把后台复制的内容粘贴到 Codex++ 对应输入框。

① ②看这里 → 贴这里

后台和 Codex++ 只是叫法不同:API 端点就是 Base URL,API 密钥就是 Key。

后台① API 端点复制
Codex++① Base URL粘贴到这里
后台② API 密钥复制
Codex++② Key粘贴到这里

不要交叉填写:端点对应 Base URL,密钥对应 Key。

本教程配套接口服务

在后台创建令牌,复制 Base URL 和 Key,回到 Codex++ 添加供应商即可。模型、额度和计费信息以后台实际显示为准。

↗注册配套接口 API
在配套接口后台复制在 Codex++ 粘贴到
① API 端点(也叫 Base URL)Base URL 输入框
② API 密钥(也叫 API Key)Key 输入框
可用模型点击“从上游获取”后选择

不要自己添加或删除 `/v1`,以后台复制出来的端点为准。

① 端点 / Base URL
https://example.com/v1

示例地址,仅用于看格式;实际内容请从后台复制。

② API Key
sk-xxxxxx

示例 Key,不要直接使用;实际内容请从后台复制。

配套接口后台复制端点和 API Key 的位置
重点看:① 上方复制端点,粘贴到 Base URL;② 密钥列表复制 API Key,粘贴到 Key。示例中的 Key 已打码。
填好后,点击“从上游获取”

不要先猜模型名称。Base URL 和 Key 填好后,点击“从上游获取”,等待模型列表出现。

Codex++ 点击从上游获取模型
重点看:模型列表右侧的“从上游获取”按钮。
7

选择模型,保存并设为当前

从获取到的模型列表中选择可用模型,完成后保存并设为当前。

GPT

模型列表里出现 GPT 模型时,直接选择需要的模型。

以“从上游获取”返回的列表为准

DeepSeek

模型列表里出现 DeepSeek 时,选择对应的模型即可,不需要重新安装软件。

deepseek-chat / deepseek-reasoner
最后两个按钮不要漏

选择模型后点击“保存”,再点击“设为当前”。完成后回到 Codex++ 主界面开始使用。

模型列表里没有 DeepSeek,怎么办?

先确认配套接口后台的分组和模型渠道已经提供 DeepSeek,再回到供应商配置里重新点击“从上游获取”。最终以实际返回的模型列表为准。

8

测试第一个任务

配置完成后,不要停在设置页面,马上跑一个简单任务。

在 Codex++ 中输入:帮我写一个 Python 的 Hello World,并解释每一行代码。

能返回文字和代码,就说明 Codex++ 已经通过配套接口完成配置,可以继续用于课程代码、报错排查和项目辅助。

常见错误怎么处理?
提示先检查什么
401重新复制 Key,检查有没有多余空格。
404以后台复制的 Base URL 为准,不要手动改 `/v1`。
model not found重新点击“从上游获取”,确认模型在列表中。
429检查额度或稍后重试,也可以换一个可用模型。
timeout先用 GPT 模型测试,再检查 DeepSeek 的可用状态。
协议不支持检查上游协议选择,并确认配套接口是否提供对应适配。

Mac 用户:安装和首次打开

Mac 用户也要先装 Codex,再装 Codex++。M 系列选择 ARM64,老款 Intel 选择 Intel。

第一次打开 Mac 应用时被拦截,怎么处理?
  1. 先把 Codex 拖到 Applications,再把 Codex++ 拖到 Applications。
  2. 分别第一次打开 Codex 和 Codex++,如果系统提示无法验证开发者,进入“系统设置 → 隐私与安全性”,点击“仍要打开”。
  3. 如果仍然打不开,先截取系统提示联系 Leo3y19,不要随意删除应用或修改系统设置。
仍提示应用已损坏时,再查看终端处理方法

先确认应用来自本教程对应下载入口,再打开“终端”,把下面命令中的应用名称替换成实际名称后执行:

xattr -dr com.apple.quarantine "/Applications/Codex.app"
xattr -dr com.apple.quarantine "/Applications/Codex++.app"

执行后重新打开应用;如果应用名称或路径不同,先联系 Leo3y19 远程确认,不要直接猜路径。

有疑问,联系 Leo3y19 远程操作

不会区分 Mac 芯片、找不到 Codex++ 配置入口,或者配置后报错,可以把页面截图发来,按步骤远程协助。

微信联系

微信号:Leo3y19
请先发报错截图和当前步骤,我会告诉你下一步点哪里。

↗下载 ToDesk
本教程说明

页面只负责客户端安装和配置指引。模型、额度和计费信息以配套接口后台实际显示为准。

Codex 打开后不是中文?

进入设置里的“语言”,选择中文即可。

Codex 设置语言为中文
看不清可以点击图片单独打开大图。