跳转至

Codex / Codex++

日常使用的主要入口是 Codex++。OpenAI Windows 客户端只需要安装/准备好一次，之后 YNumerics 的 Base URL、Key、模型同步、模型切换和启动主要在 Codex++ 中完成。

1. 准备 OpenAI Windows 客户端

按你的 Windows 环境选择一种方式即可。

方式 A：Microsoft Store 可用

优先使用官方安装路径：

  1. 打开 Microsoft Store；
  2. 搜索并安装 OpenAI 官方 Windows 客户端；
  3. 安装完成后正常启动一次，确认程序能打开；
  4. 退出客户端，然后继续安装 Codex++。

这里不需要额外配置 YNumerics。后续主要在 Codex++ 中完成。

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

使用 Windows 安装包镜像：

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

下载后：

  1. 在资源管理器开启 “查看 → 显示 → 文件扩展名”；
  2. 将下载得到的安装包后缀改成 .zip；
  3. 解压 ZIP；
  4. 进入解压目录；
  5. 运行：
.\app\ChatGPT.exe

这就是客户端入口。确认能够正常打开后即可继续配置 Codex++。

2. 安装 Codex++

下载：

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

安装或解压后启动 Codex++ 管理工具。YNumerics 的主要配置都在这里完成。

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

进入：

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

建议创建一个供应商，例如 YNumerics。

3.1 基础信息

填写：

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

一个用户可以有多把 YNumerics API Key。你可以给 Codex++ 单独创建一把 Key，便于以后撤销、统计或更换。

3.2 从上游获取模型

基础信息填写后，在模型区域点击：

“从上游获取模型”

模型列表会从 YNumerics 同步。平台以后新增、下线或调整模型时，再点一次即可刷新列表，不需要手动逐个录入模型名。

更新当前支持的模型列表

点击 “从上游获取模型” 后，列表会更新。例如旧列表未显示 gpt-6-astra，重新获取后即可看到平台当前向你开放的新模型；本次也新增了 deepseek-v4-flash-vision-exp。获取完成后保存供应商，再选择模型。

当前列表包括：

  • gpt-6-astra
  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna
  • codex-auto-review
  • deepseek-v4-pro
  • deepseek-v4-flash
  • deepseek-v4-flash-vision-exp
  • gpt-image-2

当前模型价格可在 模型广场 查看。

3.3 选择 Agent 模型

当前推荐按任务类型选择：

  • gpt-6-astra：新增 GPT / Codex / Agent 模型，刷新模型列表后可选择；
  • gpt-5.6-sol：高难度编码、整体规划、关键决策、最终集成和主代理任务；
  • gpt-5.6-terra：日常编码和一般到中高复杂度 Agent 工作流；
  • gpt-5.6-luna：简单、边界清晰的局部任务、成本敏感任务和并行子代理；
  • deepseek-v4-flash：支持 Codex / Agent，也可处理简单、边界清晰的子代理任务；
  • codex-auto-review：主要用于代码审查；
  • gpt-image-2：用于图像任务，不作为 Codex Agent 主模型。

deepseek-v4-pro 目前已支持 Codex / Agent，不再限制为仅普通聊天。新增的 deepseek-v4-flash-vision-exp 也可从同步后的模型列表中选择，具体能力和档位以当前平台配置为准。

需要比较 Sol / Terra / Luna / DeepSeek 等模型的实际费用时，直接查看模型广场。主代理 + 子代理方案是否划算，应比较完成相同任务的实际总花费，详见高级实践。

3.4 上下文窗口

新增模型以各自配置为准

本节保留原有模型的上下文配置说明，不代表 gpt-6-astra 或 deepseek-v4-flash-vision-exp 使用相同的上下文上限或计费阈值。切换新模型后先检查其模型配置和模型广场，不要直接套用旧值。

当前 Codex 模型目录中，GPT 模型的默认 context_window 为 272000。Codex 默认按 effective_context_window_percent = 95 使用，因此实际有效预算约为 258400。

日常任务保持默认即可。遇到大型代码库、长时间 Agent 任务或需要保留更多历史信息时，当前 YNumerics 配置可在 ~/.codex/config.toml 中手工覆盖为：

model_context_window = 372000

也可以使用 Codex++ 中对应的上下文设置。修改后保存配置，并从 Codex++ 重新启动客户端使其生效。

长上下文成本

272K 是模型目录的配置值，约 258.4K 是默认 95% 后的有效值。手工设置 372K 表示覆盖单次会话上下文容量；当输入超过 272K 时，成本会升高，具体见模型广场。

3.5 并发与子代理

每位成员的总并发上限为 5，同一账号的所有 Key、Codex 主代理和子代理共享。主代理仍在执行时，最多同时运行 4 个子代理请求。

简单、边界清晰的子任务可以使用 gpt-5.6-luna 或 deepseek-v4-flash 子代理。Luna 当前支持 max；DeepSeek Flash 当前最高支持 xhigh，不要给它手写 max。deepseek-v4-pro 目前也已支持 Agent；用于子代理时，以客户端可选模型和工具配置为准。

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

完成配置后：

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

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

  1. 完全退出 OpenAI Windows 客户端；
  2. 完全退出 Codex++；
  3. 重新打开 Codex++；
  4. 确认 YNumerics 供应商已启用；
  5. 再从 Codex++ 启动客户端。

5. DeepSeek Pro 已支持 Agent

deepseek-v4-pro 目前既可用于普通聊天，也可用于 Codex / Agent。

若你之前按旧文档配置为仅聊天，请：

  1. 在 YNumerics 供应商里点击 “从上游获取模型” 并保存；
  2. 选择 deepseek-v4-pro，确认 Agent 协议和工具权限配置正确；
  3. 用下面的最小文件任务检查 Agent 是否正常工作。

因此，Codex Agent 供应商仍使用 Responses API 和支持 Agent 的模型。

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 内容正确；
  • 没有修改无关文件。

如果模型能聊天但不能执行这个文件操作，检查 Agent 协议、文件工具权限、工作目录授权和客户端日志，不要再把 DeepSeek Pro 当作仅聊天模型处理。

7. Codex++ 常见问题

“从上游获取模型”失败

依次检查：

  1. 接入模式是否为 纯 API；
  2. Base URL 是否为 https://api.ynumerics.top/v1；
  3. Key 是否为当前有效的 YNumerics API 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 查看额度；大项目需要重置周额度或申请临时更大额度时，使用本人学邮联系 ynumerics_admin@163.com。是否调整取决于平台当时的总可用额度。

能聊天但不能 Agent

deepseek-v4-pro 目前已支持 Agent。先重新获取模型列表并保存，再检查 Responses API 配置、工具权限和工作目录授权；若仍失败，将脱敏后的错误信息交给管理员检查上游路由。

模型切换后没有生效

彻底退出 Codex++ 和 OpenAI Windows 客户端，再从 Codex++ 冷启动。