系统设置

需要调整实例设置或排查 Codex、Grok 或 Claude 版本兼容问题时，再查这篇。首次接入可以保留默认设置，先完成第一次使用。

版本选择

平台所有者进入「管理 → 系统设置」，可选择「时区」「Codex 客户端版本」「Grok 客户端版本」或「Claude 客户端版本」。这些设置作用于整个实例；其他工作空间管理员和成员不能修改。个人主题、语言和密码仍在「偏好设置」中。

软件更新

进入「系统设置 → 软件更新」（/admin/settings/updates），查看当前构建、最新官方正式版、版本说明和更新任务状态。SubLane 软件更新与下方供应商客户端版本设置分别管理；检查版本不会自动安装。页面与接口均仅允许平台所有者访问。

启用宿主机更新进程后，可选择已检查的目标版本，确认已导出并验证当前备份，再安装更新。页面显示排队和执行状态，服务重启期间自动重连；仅在宿主机就绪检查完成且服务版本匹配后显示成功。失败与中断会保留提示。安装为可选功能，仅支持脚本管理的 Linux 正式版部署，不会自动降级已迁移的数据库。

接口为 GET /api/settings/updates、POST /api/settings/updates/check（空 JSON），以及 POST /api/settings/updates/install（version 和 backup_confirmed: true）。安装请求写入审计；成功排队返回 202，已有任务返回 409。写操作执行同源校验。

实例时区

默认时区为 UTC。输入 Asia/Shanghai 等 IANA 时区名称并保存后，整个实例的页面时间会按该时区显示。每条用量分配可自行选择每日重置的时分，或每月重置的日期和时分；默认每日午夜、每月 1 日午夜。余额会显示准确的下次重置时间；夏令时按时区规则处理。分钟请求限制仍使用固定的 60 秒窗口。

修改立即生效。系统按请求开始时间重新归入新时区的当前额度窗口，不会因为改时区而把已用量直接清零。此前安排的下一周期配置保留原定生效时刻。运行统计的每日汇总和小时活动图继续按 UTC 分组，并保留 UTC 标注。时区保存在 settings['instance.time_zone']，修改会写入审计记录。

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

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

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

Codex 版本设置示例（检查时间为演示数据）：

自动同步

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

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

Grok 客户端版本

平台所有者进入「管理 → 系统设置 → Grok 客户端版本」（/admin/settings/grok）。Grok 与 Codex 分别保存配置，共用版本优先级、手动锁定、每 6 小时自动检查、失败保留、检查冷却和退出等待机制。Grok 内置默认版本为 1.0.50。

检查读取官方 @xai-official/grok npm 软件包的 latest 稳定版标签，排除 alpha 标签和预发布版本号。响应上限为 64 KiB，超时为 30 秒，拒绝重定向。不会发送订阅凭据，也不会下载或安装 CLI 二进制、更新 SDK 依赖。

Grok 订阅推理与额度查询共用当前生效版本，统一设置 x-grok-client-version 和对应的 User-Agent。旧客户端版本可能被推理接口以 HTTP 426 拒绝，即使模型发现或额度查询仍能成功。无法访问 npm 时会保留上次成功版本；网络恢复后可「立即检查」，也可手动指定已验证的稳定版。后续自动检查不会覆盖手动锁定。

Codex 与 Grok 的配置和检查结果分别保存在 settings['codex.version'] 与 settings['grok.version']。现有 Codex 配置保持原存储键，无需新增数据库表或迁移。配置和对应审计记录在同一事务中提交，保存成功后才发布生效版本。

Claude 客户端版本

「Claude 客户端版本」位于 /admin/settings/claude，分别保存自己的配置，同样支持手动锁定、每 6 小时检查、失败保留、检查冷却和重启恢复。内置版本为 2.1.287。

检查读取官方 @anthropic-ai/claude-code npm 软件包的 stable 标签。latest 和 next 可能更新，但 stable 不可用时不会自动改用它们。响应上限为 64 KiB，超时为 30 秒，不会安装可执行文件。

每次推理捕获一个版本快照，由公开 SDK 用该版本的不可变配置生成 User-Agent、正文中的计费 cc_version 和 CCH 签名。版本更新只影响新请求，正在执行的请求保留原版本；模型发现和额度查询也使用当前客户端标识。SDK 凭据存储保持为空，版本引导所用的临时监听器会立即关闭。

Opus 5.5 与 Sonnet 5.5 使用受支持的 adaptive thinking 和 effort 配置，Chat Completions 与 Responses 保留明确的输出 Token 上限。OpenAI reasoning_effort: none 在 Opus 5.5 上映射为 low effort，模型仍会思考；在 Sonnet 5.5 上映射为 between_tools，不进行前置思考。模型不支持的原生手动思考预算和强制工具选择会在访问上游前被拒绝。原生 adaptive 请求保留显示设置。自动同步更新版本元数据，未来的协议变化仍可能需要适配代码。

配置保存在 settings['claude.version']，与 Codex、Grok 分开，无需新增表或迁移。保存配置和审计记录在同一事务中提交，成功后才发布生效版本。

生效范围

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

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

Prometheus 指标

配置独立随机的 SUBLANE_METRICS_TOKEN（32–128 个可见 ASCII 字符）后启用 /metrics。抓取端须发送 Authorization: Bearer <token>；浏览器会话、网关密钥和 URL 查询参数不能认证该接口。不配置时返回 404。

指标包含进程级固定结果分类请求计数、耗时和已观测首输出直方图、推理租约并发及排队长度，未知延迟不计样本。计数跨工作空间运行时回收保留，进程重启后归零；未建立网关观察的匿名入口请求不计入。抓取只读内存，不查询数据库或调用供应商，不含模型、成员、账号名称、正文或秘密。演示模式不启用指标。