系統設定
管理實例的 Codex、Grok 與 Claude 客戶端版本策略。
需要調整實例設置或排查 Codex、Grok 或 Claude 版本兼容問題時，再查這篇。首次接入可以保留默認設置，先完成第一次使用。
版本選擇
平台擁有者進入「管理 → 系統設定」，可選擇「時區」“Codex 使用者端版本”“Grok 客戶端版本”或“Claude 使用者端版本”。這些設定作用於整個實例；其他工作空間管理員和成員不能修改。個人主題、語言和密碼仍在「偏好設定」中。
實例時區
預設時區為 UTC。輸入 Asia/Shanghai 等 IANA 時區名稱並儲存後，整個實例的頁面時間會依該時區顯示。每個用量分配可自行選擇每日重設的時分，或每月重設的日期和時分；預設為每日午夜、每月 1 日午夜。餘額會顯示準確的下次重置時間；夏令時按時區規則處理。分鐘請求限制仍使用固定的 60 秒視窗。
修改立即生效。系統會依照請求開始時間重新歸入新時區的目前額度窗口，不會因為改時區而把已用量直接清除。先前安排的下一週期配置保留原定生效時刻。運行統計的每日總和和小時活動圖繼續按 UTC 分組，並保留 UTC 標註。時區保存在 settings['instance.time_zone']，修改會寫入審計記錄。
有效版本按以下優先級選擇：
- 手動指定的版本。
- 上次同步的穩定版本，但不能低於內建預設值。
- 內建預設版本
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 模型發現、配額讀取和請求轉送使用有效版本。更改版本後，下次讀取模型目錄或請求會觸發重新發現。舊版發起但尚未完成的發現結果會被丟棄。其他供應商和管理員白名單不受改寫。
| 介面 | 用途 |
|---|---|
GET /api/settings/timezone | 讀取實例時區 |
PATCH /api/settings/timezone | 提交 IANA time_zone |
GET /api/settings/codex | 讀取配置與同步狀態 |
PATCH /api/settings/codex | 提交 manual_version 與 auto_sync |
POST /api/settings/codex/sync | 空 JSON 請求體，立即檢查 |
GET /api/settings/grok | 讀取 Grok 設定與同步狀態 |
PATCH /api/settings/grok | 提交 manual_version 與 auto_sync |
POST /api/settings/grok/sync | 空 JSON 請求體，檢查官方 npm 穩定版 |
GET /api/settings/claude | 讀取 Claude 設定與同步狀態 |
PATCH /api/settings/claude | 提交 manual_version 與 auto_sync |
POST /api/settings/claude/sync | 空 JSON 請求體，檢查官方 npm stable 頻道 |
介面要求平台擁有者會話與寫入操作同源校驗。版本元資料無法證明帳號支援該版本的全部模型。備份功能見 備份與復原。
Prometheus 指標
設定獨立隨機的 SUBLANE_METRICS_TOKEN（32–128 個可見 ASCII 字元）以啟用 /metrics。擷取端須傳送 Authorization: Bearer <token>；瀏覽器工作階段、閘道金鑰與 URL 參數無法驗證此介面。未設定時回傳 404。
提供程序級固定結果分類計數、耗時和已觀察首輸出直方圖、推理租約與佇列長度。未知延遲不列入樣本；計數跨工作空間執行階段回收保留，程序重啟時歸零。未建立閘道觀察的匿名請求不列入。擷取僅讀取記憶體，不執行 SQL 或供應商 IO，不含名稱、內容或秘密。展示模式不啟用指標。