系统设置

版本选择

管理员进入「管理 → 系统设置 → Codex 客户端版本」。这是实例级设置，与个人主题、语言、密码偏好独立，成员不能访问。

有效版本按以下优先级选择：

1. 手动指定的版本。
2. 上次同步的稳定版本，但不能低于内置默认值。
3. 内置默认版本 0.155.1。

手动版本格式为 major.minor.patch，不带 v 或预发布后缀；允许有意固定旧版本。清空后回到自动选择。页面展示有效版本、来源、最近同步版本和检查时间。

自动同步

默认开启「自动跟随稳定版本」。成功检查后 6 小时再次检查，失败保留上次结果并通常在 15 分钟后重试，也尊重更长的上游限流。关闭后保留已知版本，仍可手动「立即检查」。手动检查完成后至少冷却 60 秒。

检查仅访问官方 openai/codex GitHub 发布元数据，排除草稿与预发布，不发送订阅凭据或 GitHub token。不会下载或安装 Codex 二进制，也不会更新 CLIProxyAPI 依赖。 网络或保存失败时保留原有效版本。

生效范围

Codex 模型发现、配额读取和请求转发使用有效版本。更改版本后，下次读取模型目录或请求会触发重新发现。旧版本发起但尚未完成的发现结果会被丢弃。其他供应商和管理员白名单不受改写。

接口要求管理员会话与写操作同源校验。版本元数据不能证明账号支持该版本的全部模型。备份功能见 备份与恢复。