跳转至

Codex / Codex++

日常使用的核心入口是 Codex++。OpenAI 官方 Windows 客户端只需要先准备好，后续 YNumerics 的 Base URL、个人 Key、协议、模型切换和启动主要在 Codex++ 中完成。

1. 准备 OpenAI 官方 Windows 客户端

有两种方式，按你的 Windows 环境选择其一即可。

方式 A：Microsoft Store 可用

这是优先推荐的官方路径：

  1. 打开 Microsoft Store；
  2. 搜索并安装 OpenAI 官方发布的 ChatGPT Windows 客户端；
  3. 安装后正常启动一次，确认客户端能够打开；
  4. 退出客户端，继续安装和配置 Codex++。

这里不需要在官方客户端里反复配置模型。后续主要从 Codex++ 启动和切换 YNumerics 供应商。

方式 B：没有 Microsoft Store，或 Store 安装不可用

可以使用 Windows 安装包镜像：

https://github.com/Wangnov/codex-app-mirror

镜像是第三方分发渠道；条件允许时建议核验包来源、数字签名或校验值。

下载后：

  1. 打开资源管理器的 “查看 → 显示 → 文件扩展名”，确保能看到真实后缀；
  2. 将下载得到的安装包文件后缀改为 .zip；
  3. 解压该 ZIP；
  4. 在解压目录中找到：
.\app\ChatGPT.exe
  1. 双击 ChatGPT.exe，它就是这一方式下的客户端入口；
  2. 确认能正常打开后，再进入 Codex++ 配置。

Note

这种方式的目的只是把 Windows 客户端准备好。日常 YNumerics 使用不需要每次手动进入解压目录折腾配置，后续主要从 Codex++ 管理供应商并启动客户端。

2. 安装 Codex++

下载：

https://github.com/BigPizzaV3/CodexPlusPlus/releases/latest

安装/解压完成后启动 Codex++ 管理工具。第一次使用建议先确认它能够识别前面准备好的 ChatGPT/Codex 客户端。

3. 在 Codex++ 新建 YNumerics 供应商

进入：

Codex++ 管理工具 → 供应商配置 → 添加供应商

建议先创建一个用于 Agent 的供应商，例如 YNumerics 或 YNumerics Agent。

3.1 基础信息

按下面填写：

字段 推荐值
供应商名称 YNumerics
接入模式 纯 API
Base URL https://api.ynumerics.top/v1
Key 你自己的 YNumerics API Key
上游协议 Responses API（用于 Codex / Agent）
User-Agent 留空

一定使用自己的 YNumerics Key

不要填写管理员上游 Key，也不要共享同学的 Key。Key 泄露后应在主站撤销并重新生成。

3.2 从上游获取模型

基础信息保存/填写正确后，在 Codex++ 的模型区域点击：

“从上游获取模型”

正常情况下会从 YNumerics 同步当前模型列表。后续平台增减模型时，重新点击这个按钮即可同步最新列表。

同步后你会看到类似：

  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna
  • gpt-5.5
  • gpt-5.4-mini
  • codex-auto-review
  • gpt-image-2
  • deepseek-v4-pro
  • deepseek-v4-flash

3.3 选择 Agent 模型

用于 Codex / Agent 时，选择支持 Agent 的模型，例如：

  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna
  • gpt-5.5
  • gpt-5.4-mini
  • deepseek-v4-flash

codex-auto-review 用于代码审查相关场景；gpt-image-2 是图像模型。

不要把 deepseek-v4-pro 作为 Codex Agent 模型。 它走 Chat Completions，在本平台按 Chat only 使用，只适合普通聊天，不能用于 Agent / 文件工具 / 子代理工作流。

3.4 上下文窗口与其他选项

  • 若 Codex++ 能从上游/预设得到上下文信息，优先沿用；
  • deepseek-v4-flash 在当前配置中可按 1M 上下文窗口使用；
  • 不要为了“看起来更大”而随意把所有模型统一改成同一个上下文值；
  • Sub2API 倍率查询属于可选辅助功能，不影响基础接入是否成功。

4. 保存、启用并从 Codex++ 启动

完成供应商配置后：

  1. 点击 保存；
  2. 将 YNumerics 设为当前/启用供应商；
  3. 在 Codex++ 中选择要使用的模型；
  4. 从 Codex++ 启动 ChatGPT/Codex 客户端；
  5. 打开后确认模型显示已经切换到所选的 YNumerics 模型。

如果仍显示官方默认模型：

  1. 完全退出 ChatGPT/Codex 客户端；
  2. 完全退出 Codex++；
  3. 重新打开 Codex++；
  4. 确认 YNumerics 供应商处于启用状态；
  5. 再从 Codex++ 启动客户端。

5. 如果只想使用 Chat Completions

deepseek-v4-pro 属于 Chat Completions / Chat only。如果需要在支持普通聊天的客户端或接口里使用它，可以单独建立 Chat Completions 配置。

但要记住：

Chat Completions = Chat only；不能用于 Codex Agent。

因此，不要为了使用 Pro 而把 Codex Agent 供应商从 Responses API 改成 Chat Completions。

6. 首次功能检查

先创建：

D:\codex-test\hello.txt

内容：

hello

然后在 Codex 中发送：

读取 D:\codex-test 的 hello.txt，然后创建 result.txt，
内容为 YNumerics Codex tool call OK。不要修改其他文件。

正确结果：

  • 能读取 hello.txt；
  • 能创建 result.txt；
  • result.txt 内容正确；
  • 没有修改无关文件。

如果模型只能正常聊天，却无法执行这个文件操作，优先检查是不是误用了 Chat Completions / Chat-only 模型。

7. Codex++ 常见问题

“从上游获取模型”失败

依次检查：

  1. 接入模式是不是 纯 API；
  2. Base URL 是否为 https://api.ynumerics.top/v1；
  3. Key 是否为当前有效的个人 YNumerics Key；
  4. Key 是否存在复制时多了空格/换行；
  5. 当前账号是否有有效订阅/额度；
  6. 保存供应商后重新点击 “从上游获取模型”。

修复配置后重新执行 “从上游获取模型”。

401 API_KEY_REQUIRED

Codex++ 没有正确把 Key 带入请求。检查供应商是否是 纯 API、Key 是否已保存。

401 INVALID_API_KEY

Key 填错、已撤销，或者 Codex++ 仍缓存旧 Key。重新复制当前个人 Key，保存供应商后重启。

403 INSUFFICIENT_BALANCE

当前账号没有可用订阅/预算。登录 https://api.ynumerics.top 检查额度，必要时联系管理员。

能聊天但不能 Agent

首先检查协议/模型。如果使用的是 Chat Completions 或 deepseek-v4-pro，这是预期现象：它是 Chat only，不能用于 Codex Agent。切回 Responses API，并选择 Agent 模型。

模型切换后没有生效

彻底退出 Codex++ 和 ChatGPT/Codex，再从 Codex++ 冷启动。