OpenCodex v2.37.0 Windows 桌面端

OpenCodex v2.37.0（Windows 桌面端）

上游大版本同步（v2.31.0 → v2.36.0，764 个提交）+ fork 专项修复。建议所有用户升级。

• 桌面安装包：OpenCodex-Setup-2.37.0-x64.exe
• 适用平台：Windows 10（64 位）及以上
• 已安装旧版的用户：应用内「检查更新」会直接提供本版本

本次核心：修复「个别任务一直思考」

• 坏账号快速避开：ChatGPT 桌面端里个别任务反复卡住的一类根因是账号池中存在无工作区授权的账号（403 拒绝）。此前这类账号要连续失败 3 次才会被切换，期间新任务持续落到它头上。现在首次拒绝即软回避 10 分钟（重复拒绝自动续期，授权修复后首次成功自动恢复），已有会话也会改绑健康账号。
• combo 零输出流故障转移（上游 lidge-jun#2449）：上游流式返回零输出时自动切换到下一个可用目标，不再干等。
• 瞬态重试共享总预算（上游 lidge-jun#2981/lidge-jun#2998）：上游 5xx 的重试链有了总时长预算，长等待不再无限化。

上游 v2.32 ~ v2.36 主要更新

• 普通池 401 改为刷新重放而非直接隔离（lidge-jun#2889）；路由跳过失败的配额候选
• Anthropic 配额窗口账号池路由；grok-4.20-multi-agent 上 Responses 通道
• Ollama 原生 /api/chat 传输（ollama-cloud）；远程 Codex 客户端 GET /v1/catalog
• 智谱 BigModel 列表保留 fork 国内端点定制（glm-5-turbo / glm-5v-turbo / glm-4.7-flashx）并与上游 glm-5.3 合流
• GUI：模型别名管理、新模型策略开关等大量桌面改进

升级说明

• 从 v2.31.0 及以下直接安装即可，配置与账号数据自动保留
• 内置运行时 Bun 1.4.0；localhost/127.0.0.1 环回流量不经过任何代理，无需全局代理

校验

SHA-256: E730017777350982397282DCC7EC557756A23BC920EF4C302DF2DCC194F4BFB9
安装包: OpenCodex-Setup-2.37.0-x64.exe (125,702,326 字节)
内置运行时: Bun 1.4.0

OpenCodex v2.31.0 Build 4 Windows 桌面端

OpenCodex v2.31.0 Build 4（Windows 桌面端）

同版本构建更新（version 2.31.0 / build revision 4）。本构建包含 Build 2/3 的全部修复，并新增更新检查的限流回退机制。

• 桌面安装包：OpenCodex-Setup-2.31.0-x64.exe
• 适用平台：Windows 10（64 位）及以上
• SHA-256：见下方校验段
• 已安装 Build 1/2/3 的用户：应用内更新检查会直接提供本构建（同版本 build revision 升级）

Build 4 核心改进：更新检查不再被 API 限流卡死

此前桌面端的更新检查只走匿名 GitHub API（60 次/小时/IP）。使用共享代理出口的网络（常见于企业/代理环境）配额极易被同 IP 的其他流量打满，导致「无法从 GitHub 读取最新桌面版发布」且无从排查。

Build 4 起，API 被限流时自动回退到 GitHub 网页重定向路径（不占 API 配额）解析最新版本，并以 HEAD 请求验证安装包存在。实测在 API 配额完全耗尽（0/60）的网络下，更新检查仍能正确解析出最新构建。

相对 Build 1 的累计修复

BigModel（智谱按量付费）registry 定制恢复

• 默认模型 glm-4.6 → glm-5.3；模型列表恢复 glm-5-turbo、glm-5v-turbo（视觉）、glm-4.7-flashx 并保留上游 glm-5.3
• 控制台入口恢复新版 bigmodel.cn/apikey/platform；显式声明 5.x 系列 1M / turbo 系列 200k 上下文窗口

GUI 修复

• Provider 工作台：修复 v2.22.0 以来默认 Provider 星标重复渲染；悬停删除采用上游 v2.31 自洽设计；补回筛选/排序/模型展开按钮的悬停反馈

防线恢复

• ocx init 注入健康门：代理未运行时不注入 Codex 路由，避免死路由
• WebSocket turn 取消链释放（多线程并发卡死修复链的最后一环）

其他（Build 1 基线）

内置运行时 Bun 1.4.0 stable；GLM Coding Plan 额度支持；web_search 真实执行器（xai/Gemini/Exa）；视觉描述器路由化；ZCode 集成客户端等上游 v2.23.0 ~ v2.31.0 全部演进。本系列构建已通过完整 Cross-platform CI（Linux/macOS/Windows + GUI gates）验证。

校验

SHA-256: 0D5E810F571A89471547714A729097490A1325F7496B5F4F55A7DB355B679D03
内置运行时: Bun 1.4.0

OpenCodex v2.31.0 Build 3 Windows 桌面端

OpenCodex v2.31.0 Build 3（Windows 桌面端）

同版本构建更新（version 2.31.0 / build revision 3）。Build 2 修复 CI 首轮暴露的回归；Build 3 补齐第二轮 CI 修复（Provider 工作台视觉/交互、init 死路由防线），并通过完整 Cross-platform CI 全绿。

• 桌面安装包：OpenCodex-Setup-2.31.0-x64.exe
• 适用平台：Windows 10（64 位）及以上
• 已安装 Build 1/2 的用户：应用内更新检查会直接提供本构建（同版本 build revision 升级）

Build 2 修复内容

BigModel（智谱按量付费）registry 定制恢复

v2.22.0 同步时误将本 fork 对 BigModel 注册表条目的定制随上游版本一并丢弃，Build 2 恢复并与上游 v2.31 融合：

• 默认模型 glm-4.6 → glm-5.3（fork 一直以来的意图：默认取最新 GLM）；
• 模型列表恢复 glm-5-turbo、glm-5v-turbo（视觉）、glm-4.7-flashx，并保留上游新增的 glm-5.3；
• 控制台入口恢复新版 bigmodel.cn/apikey/platform；
• 显式声明 5.x 系列 1M / turbo 系列 200k 上下文窗口与 glm-5v-turbo 视觉输入。

GUI 键盘导航恢复

上游重设计 section-tabs 与组合工作台标签页时丢失了方向键 / Home / End 遍历，Build 2 接回共享 roving 键盘助手（方向键在标签组内移动焦点）。

其他

• sidebar GitHub star 指向本 fork 仓库（契约测试同步修正）；
• DeepSeek 模型分类期望与上游 v2.31 registry 对齐（含 deepseek-chat/reasoner 兼容别名）；
• 法语本地化细节修正。

Build 1 主要内容（未变更，见上一 Release）

内置运行时升级 Bun 1.4.0 stable；GLM Coding Plan 额度支持；web_search 真实执行器（xai/Gemini/Exa）；视觉描述器路由化；ZCode 集成客户端；Cursor 加权凭据路由等上游 v2.23.0 ~ v2.31.0 全部演进。

校验

SHA-256: 26D968CF7BBF7A0E7682BD6718935963A0EC1EC87DF372DB6DC930A421FC38DA
内置运行时: Bun 1.4.0

Build 3 增量修复（相对 Build 2）

• Provider 工作台：采纳上游 v2.31 自洽的悬停删除设计，修复 v2.22.0 以来默认 Provider 星标重复渲染的问题；补回筛选/排序/模型展开按钮的悬停反馈
• ocx init 恢复注入健康门：代理未运行时不注入 Codex 路由，避免死路由（桌面端关闭后 Codex 死路由问题的最后一块防线）
• 本构建已通过完整 Cross-platform CI（Linux/macOS/Windows + GUI gates）验证

OpenCodex v2.31.0 Build 2 Windows 桌面端

OpenCodex v2.31.0 Build 2（Windows 桌面端）

同版本构建更新（version 2.31.0 / build revision 2）。本构建修复 CI 全矩阵首次真实运行暴露的回归与契约漂移，覆盖 Build 1 的全部内容。

• 桌面安装包：OpenCodex-Setup-2.31.0-x64.exe
• 适用平台：Windows 10（64 位）及以上
• 已安装 Build 1 的用户：应用内更新检查会直接提供本构建（同版本 build revision 升级）

Build 2 修复内容

BigModel（智谱按量付费）registry 定制恢复

v2.22.0 同步时误将本 fork 对 BigModel 注册表条目的定制随上游版本一并丢弃，Build 2 恢复并与上游 v2.31 融合：

• 默认模型 glm-4.6 → glm-5.3（fork 一直以来的意图：默认取最新 GLM）；
• 模型列表恢复 glm-5-turbo、glm-5v-turbo（视觉）、glm-4.7-flashx，并保留上游新增的 glm-5.3；
• 控制台入口恢复新版 bigmodel.cn/apikey/platform；
• 显式声明 5.x 系列 1M / turbo 系列 200k 上下文窗口与 glm-5v-turbo 视觉输入。

GUI 键盘导航恢复

上游重设计 section-tabs 与组合工作台标签页时丢失了方向键 / Home / End 遍历，Build 2 接回共享 roving 键盘助手（方向键在标签组内移动焦点）。

其他

• sidebar GitHub star 指向本 fork 仓库（契约测试同步修正）；
• DeepSeek 模型分类期望与上游 v2.31 registry 对齐（含 deepseek-chat/reasoner 兼容别名）；
• 法语本地化细节修正。

Build 1 主要内容（未变更，见上一 Release）

内置运行时升级 Bun 1.4.0 stable；GLM Coding Plan 额度支持；web_search 真实执行器（xai/Gemini/Exa）；视觉描述器路由化；ZCode 集成客户端；Cursor 加权凭据路由等上游 v2.23.0 ~ v2.31.0 全部演进。

校验

SHA-256: 545A8A593E8E8D0FFC96460C4861FF70C51E8663A44BCB27D3677E76B2B31D9C
内置运行时: Bun 1.4.0

OpenCodex v2.31.0 Windows 桌面端

OpenCodex v2.31.0（Windows 桌面端）

OpenCodex 是一个通用 LLM provider 代理，可让任意大模型接入 Codex CLI / App / SDK 与 Claude Code。本版本对齐上游 opencodex v2.31.0，相比上一发行版 v2.22.0 同步了上游 10 个版本（v2.23.0 ~ v2.31.0、1127 个提交）。

• 桌面安装包：OpenCodex-Setup-2.31.0-x64.exe
• 适用平台：Windows 10（64 位）及以上
• SHA-256：495CBACCBBE9B3F14B1AA19EFB4E692276910CF770B115E455BD271B6536EBBC

亮点：运行时升级到 Bun 1.4.0 stable

• 内置 Bun 运行时从 1.3.14 升级到 1.4.0 stable，修复了 1.3.x 在 Windows 长时间运行下的内崩问题（internal assertion），长时间多任务会话更稳定。

同步上游 v2.22.0 → v2.31.0 主要内容

模型与 Provider

• GLM Coding Plan 额度支持（z.ai / bigmodel.cn）；
• Cursor 适配器：加权凭据路由（冷却故障转移）、HTTP/1.1 兼容传输、Opus Fast 家族、原生 SelectedImage 视觉；
• xai：Grok Responses 通道 GUI 开关、API-key 通道 Priority Processing；
• Ox Alpha（1M 多模态）与 DeepSeek 视觉预览加入目录。

搜索与视觉

• web_search 真实执行器：xai（含 opt-in x_search）、Gemini（Antigravity CCA 传输）、Exa 三条非 LLM 搜索通道；
• 视觉描述器路由化：routed describer 后端 + GUI/CLI 呈现。

客户端与集成

• 新增 ZCode 集成客户端（provider.opencodex 托管配置）与 Prime Agent 导出；
• ocx sync 现在会更新所有已启用的客户端集成；
• 修复「Codex App 重写 config.toml 后移除注入路由」。

Windows 稳定性

• Codex 桌面端完整重启助手；log-guard Windows 路径修复；Clash fake-IP DNS 答案走配置代理。

桌面端专属（本 fork 保留）

• 桌面宿主代理启停控制、固定端口（默认 10100）与端口迁移持久化；
• 桌面安装包同版本构建更新机制（build revision 升级）；
• WebSocket turn 取消链释放修复继续保留（上游仍未修复）。

升级说明

直接运行安装包覆盖安装即可，配置与用户数据保留。已安装 v2.22.0 的桌面端也可通过应用内更新检查直接升级。

校验

SHA-256: 495CBACCBBE9B3F14B1AA19EFB4E692276910CF770B115E455BD271B6536EBBC
大小:   125,466,280 字节

OpenCodex v2.22.0 Windows 桌面端

OpenCodex v2.22.0（Windows 桌面端）

OpenCodex 是一个通用 LLM provider 代理，可让任意大模型接入 Codex CLI / App / SDK 与 Claude Code。本版本是面向 Windows 桌面端的发行版，版本号与上游 opencodex v2.22.0 完全对齐。相比上一发行版 v2.10.0，同步了上游 18 个正式版本（v2.10.1 ~ v2.22.0）的全部演进，并保留了 Windows 桌面应用、安装器与自动更新能力。

• 桌面安装包：OpenCodex-Setup-2.22.0-x64.exe
• 适用平台：Windows 10（64 位）及以上
• SHA-256：FD8D79CD17CB738A56822F1FC5A942E8D26E3730A330555FB2855C9BDBBF169F

重要修复：多线程并发卡死（503 active turns capacity reached）

修复 v2.10.0 及更早版本中「一个 Codex 线程正在运行时，另一个线程持续被 503 拒绝并反复重连」的问题。根因是 WebSocket turn 的取消链不释放旧租约，多 agent 并发下僵尸 turn 累积直至占满准入上限。本版本：

• 上游 v2.22 完整的 turn 准入体系（HTTP/WS/fallback 全路径租约保护，上限 256）；
• 保留并适配了本 fork 的 WebSocket 取消链释放修复，旧 turn 被新请求覆盖时正确释放租约；
• 即使出现进程卡死，侧边栏新增「重新加载 Codex 模型列表」一键恢复，Windows 上具备真正有效的 app-server 终止路径，无需重启代理。

同步上游 v2.10.0 → v2.22.0 主要内容

模型与 Provider

• GLM-5.3 全面上架（Z.AI、BigModel、OpenRouter、火山引擎、阿里 Token 等 20+ provider），三档 effort（low/high/max）；
• grok-4.6、Gemini 3.7 Flash、DeepSeek V4 Pro GA、Daybreak 别名模型；
• 新 provider 预置：Nous Portal（OAuth）、Novita AI、Featherless、Chutes。

代理核心

• provider 请求 pacing 控制，pacing 过载映射为可重试 429；
• 空补全守护（同 turn 自动重试一次）、中断流修复、terminal-less 流修复；
• SSE 帧缓冲上限与翻译层内存预算，半截帧不再无限拼接；
• store:false 默认修正、浏览器 SDK CORS 头放行、每自定义模型 reasoning effort。

GUI 控制台

• 侧边栏操作区：停止代理 + 重新加载 Codex 模型列表；模型页显示 Codex 目录陈旧状态；
• 每账号用量、每模型成本覆盖、Command Code 5h/周额度探测；
• API Keys 归因用量、账户定向选择器（Account Picker）、完整法语本地化。

实验室（Compatibility Lab，opt-in）

• CL-01 ~ CL-10：协议一致性测试、不可变证据账本（SQLite）、有界线上路由探测、兼容矩阵 UI、公共证据信任核心——路由兼容性验证体系。默认关闭，不影响单 provider 基本使用。

桌面端专属（本 fork 保留）

• 桌面宿主代理启停控制（侧边栏状态按钮，外部 CLI 接管时自动停用）；
• 固定端口（默认 10100）与端口迁移持久化；
• 桌面安装包同版本构建更新机制（build revision 升级，从本仓库 Release 拉取安装器）；
• 安装器：桌面/开始菜单快捷方式、Program Files 默认目录、卸载保留用户数据。

升级说明

直接运行安装包覆盖安装即可，配置与用户数据保留。已安装 v2.10.0 的桌面端也可通过应用内更新检查直接升级到本版本。

校验

SHA-256: FD8D79CD17CB738A56822F1FC5A942E8D26E3730A330555FB2855C9BDBBF169F
大小:   121,354,017 字节

OpenCodex v2.10.0 Windows 桌面端

OpenCodex v2.10.0（Windows 桌面端）

OpenCodex 是一个通用 LLM provider 代理，可让任意大模型接入 Codex CLI / App / SDK 与 Claude Code。本版本是面向 Windows 桌面端的发行版，版本号与上游 opencodex v2.10.0 完全对齐，在同步上游运行时、管理 API、GUI 与测试更新的同时，完整保留了 Windows 桌面应用、安装器与自动更新能力。

• 桌面安装包：OpenCodex-Setup-2.10.0-x64.exe
• 适用平台：Windows 10（64 位）及以上
• SHA-256：74197D3E2594651BCCCD461AC2B6D44885E3B7334484D5901E9B500B85E5CE88

更新内容

运行时与内存治理

针对长会话与多任务场景下的常驻内存增长问题，引入上游 2.10 的内存治理框架：

• 应用常驻内存预算框架：为运行时设置常驻内存上限，超出阈值的状态可被治理而非无限堆积。
• 响应状态分级：会话响应状态在超过常驻上限时降级为磁盘外溢存根，而非直接丢失，兼顾稳定性与可恢复性。
• 磁盘外溢落盘：将冷态响应状态写入磁盘，降低长时间运行时的内存占用。
• 服务生命周期修复：服务停止时正确等待清理流程完成，避免残留状态。

管理 API 与可观测性

• 新增管理端内存指标 appOwnedBytes，便于通过管理 API 观察运行时常驻内存占用。
• 同步上游准入控制与翻译层运行预算控制，使中转调度更可控。
• 改进 DeepSeek Responses 协议处理兼容性。

GUI 控制台

• API Keys 工作台新增客户端配置能力，便于按客户端管理与配置接入。
• Provider 工作台新增 Provider 概览视图，并优化详情、设置与导航栏交互。
• 存储工作台调整布局与数据呈现。
• 账号池与自动切换设置得到优化。
• 新增 Pi 等 provider 图标资源。

多语言

控制台界面语言同步更新：简体中文、英语、日语、韩语、德语、俄语。

Windows 桌面端

• 保留完整的 Windows 桌面应用、NSIS 安装器与自动更新能力。
• 保留桌面端同版本更新机制：基于版本与构建修订号进行比较，避免重复或误判更新。
• 在引入上游内存治理的同时，保留 Windows 兼容处理，确保外溢缓存与状态文件清理在 Windows 上以尽力而为方式执行。

安装说明

全新安装

1. 下载 OpenCodex-Setup-2.10.0-x64.exe。
2. 双击运行安装程序，按向导完成安装。
3. 安装完成后，从开始菜单启动 OpenCodex 桌面端。

从旧版本升级

• 应用内自动更新：已安装旧版本的用户，可在桌面端内通过自动更新升级至 v2.10.0。
• 手动覆盖安装：也可直接下载本安装包运行，安装程序将覆盖升级现有版本并保留既有配置。

校验说明

建议在安装前对安装包进行完整性校验。在 PowerShell 中运行：

Get-FileHash .\OpenCodex-Setup-2.10.0-x64.exe -Algorithm SHA256

确认输出的 SHA-256 值为：

74197D3E2594651BCCCD461AC2B6D44885E3B7334484D5901E9B500B85E5CE88

说明

• 本版本桌面安装包于本地构建环境生成，并随本 Release 一同发布。
• 根包与桌面包版本号均已对齐为 2.10.0，与上游 opencodex v2.10.0 的程序能力范围同步。
• 如遇问题，欢迎在仓库提交 Issue 反馈。

OpenCodex Windows Desktop 2.8.1

OpenCodex Windows Desktop 2.8.1

Highlights

• Windows 桌面端运行方式完善：在 Windows 桌面环境下提供更稳定的本地多 provider 代理体验，继续作为 OpenAI Codex 与 Claude Code 的统一本地入口。
• 资源占用更克制：针对长会话、被中断的请求以及多 agent 并发场景，优化资源回收路径，长时间运行更加平稳。
• 进程生命周期更可控：改进请求取消、优雅关闭与进程回收行为，减少异常退出和残留进程。
• 同版本构建更新：更新器现支持在同一产品版本下按 build revision 严格识别新安装包，并自动下载安装。

Windows Desktop

• 完善并稳定 Windows 桌面端的运行方式，使 OpenCodex 更贴合桌面用户的使用习惯。
• GUI 启动、本地存储、provider 工作区与交互状态管理均做了改进，启动更顺畅、切换更连贯。
• 优化桌面端的请求取消与优雅关闭流程，避免因异常退出或强制结束导致的进程残留。

Reliability

• 长会话稳定性：优化长会话场景下的资源回收，提升持续运行可靠性。
• 中断请求回收：改进被中断请求后的清理路径，减少异常状态累积。
• 多 agent 场景：在多个 agent 并发工作的场景下更好地回收资源，降低互相影响。
• 回归与稳定性测试：补充覆盖核心路径的回归测试与稳定性验证，巩固已有行为。

Upgrade

• 同版本构建更新：在产品版本号不变的情况下，更新器会依据 build revision 严格判断是否存在新安装包，避免错过增量修复。
• 自动下载安装：检测到新构建后自动下载并安装，升级流程更顺滑。
• 建议通过内置更新器升级；如需手动安装，请从官方 Release 页面获取对应安装包。

感谢社区反馈与贡献，欢迎继续提交 issue 帮助我们改进 OpenCodex。

OpenCodex Windows Desktop v2.8.0

OpenCodex Windows Desktop v2.8.0

本版本为 opencodex（原作者：@claudeebum）的 fork 分支，由 @canyexuanfan 维护，专注于提供开箱即用的 Windows 桌面安装版。原项目与原作者署名在此完整保留，并向上游工作致谢。

This is a fork of opencodex (original author: @claudeebum), maintained by @canyexuanfan, focused on delivering a ready-to-use Windows desktop installer. Full attribution to the original project and author is preserved with gratitude.

---

中文

版本概述

OpenCodex Windows Desktop v2.8.0 基于 opencodex 2.8.0 的 runtime / provider proxy 能力构建，在保留上游核心功能的基础上，提供面向 Windows 用户的一体化桌面安装体验。

主要特性

• Windows 安装向导：使用标准安装流程完成部署。
• 快捷方式集成：安装后提供桌面与开始菜单入口，便于日常启动。
• 内置运行时资源：安装包内置所需运行时资源，减少手动配置。
• 本地代理路由恢复机制：降低代理停止或异常退出后 Codex 继续指向失效本地路由的风险。
• 仅发布安装版：本 Release 不提供 portable / 便携版。

下载

文件名	平台	架构
OpenCodex-Setup-2.8.0-x64.exe	Windows 10 / 11	x64

SHA-256 校验值

1812F1F2F6849868C5E212F5D579ACD500134B7B58725F404CC251F7999FEC27

下载后可用 PowerShell 校验：

Get-FileHash .\OpenCodex-Setup-2.8.0-x64.exe -Algorithm SHA256

致谢

感谢上游项目 opencodex 及原作者 @claudeebum 的工作。本 fork 的核心运行时与 provider proxy 能力源自上游；Windows 桌面封装层用于改善 Windows 用户的安装与启动体验。

反馈

如果遇到安装、快捷方式、启动或代理路由相关问题，请在本仓库提交 Issue，并附上 Windows 版本、安装方式和问题现象。

---

English

Release overview

OpenCodex Windows Desktop v2.8.0 is built on the runtime / provider proxy capabilities of opencodex 2.8.0. It preserves the upstream core functionality while adding an integrated desktop installation experience for Windows users.

Key features

• Windows installer wizard: Deploy through a standard setup flow.
• Shortcut integration: Desktop and Start Menu entries are created for daily use.
• Bundled runtime resources: Required runtime resources are included with the installer to reduce manual setup.
• Local proxy route recovery: Reduces the chance that Codex remains pointed at a dead localhost route after the proxy stops or exits unexpectedly.
• Installer only: No portable build is published in this Release.

Download

File	Platform	Architecture
OpenCodex-Setup-2.8.0-x64.exe	Windows 10 / 11	x64

SHA-256 checksum

1812F1F2F6849868C5E212F5D579ACD500134B7B58725F404CC251F7999FEC27

Verify the download in PowerShell:

Get-FileHash .\OpenCodex-Setup-2.8.0-x64.exe -Algorithm SHA256

Acknowledgements

Thanks to the upstream opencodex project and original author @claudeebum. The core runtime and provider proxy capabilities in this fork come from upstream; the Windows desktop packaging layer is provided to improve installation and launch experience on Windows.

Feedback

If you run into installation, shortcut, startup, or proxy-routing issues, please open an Issue in this repository with your Windows version, installation method, and observed behavior.