
Gitee(国内推荐):https://gitee.com/zhenglei410/codex-i18n-cache-seeder
GitHub(镜像):https://github.com/zhenglei410/codex-i18n-cache-seeder
MIT 开源 · 无需安装 · 一行命令即用 · Codex 桌面版(Windows)
一、问题:明明装了中文包,Codex 界面还是英文
Codex 桌面版(Microsoft Store / MSIX 那个 OpenAI.Codex)其实内置了简体中文语言资源,很多人却卡在英文界面上出不来。你可能也试过在配置文件里写 localeOverride = "zh-CN",重启、重装、清缓存一顿操作,界面纹丝不动。
这不是你配置错了,而是 Codex 的界面语言开关根本不在你本地配置文件里——它由远程实验配置平台 Statsig 的一个 Layer 控制。远程没生效、或者客户端缓存键变了,界面就回退英文。最近 Gitee 上一位开发者(郑磊)开源了一个小工具 codex-i18n-cache-seeder,把「让 Codex 正确读到中文开关」这件事做成了一条命令,Windows 一行 PowerShell 就能搞定。
这篇不讲空话,从原理到命令到排错,把它讲透。
二、先搞清楚:中文开关到底藏在哪
理解原理,你才知道这条命令在干什么、出问题怎么排查。
Codex 桌面包里带着简体中文资源,但界面是否启用中文,由一个叫 Statsig Layer 72216192 的 enable_i18n 开关控制。Statsig 是很多大厂在用的功能开关 / A/B 实验平台,Codex 用它来灰度控制各种功能。这个开关的值会缓存在客户端本地,客户端通过一个「缓存键」(cache key)去索引缓存里的评估结果。
问题就出在这个缓存键上——它是动态的,跟当前登录用户上下文绑定:
client.dataAdapter._getCacheKey(context.user)
当出现下面几种情况,界面就会回退英文:
- 远程 Statsig 配置不可用(网络问题、区域问题),客户端没拿到
enable_i18n = true; - 客户端缓存键变了(比如账号切换、Codex 更新),原来的中文缓存「对不上号」;
- 机器上残留旧账号留下的缓存键,工具只改了旧键,看似成功其实是「假成功」;
- 配置文件里
localeOverride写得再对,客户端没加载到中文缓存也白搭。
所以真正要做的是:算出「当前这一刻、当前这个用户」的真实缓存键,把中文评估结果写进这个键对应的缓存里。这正是 codex-i18n-cache-seeder 干的事。
三、一行命令修复(Windows)
操作前先保存手头工作——命令会强制关闭当前 Codex 进程并重启。
关键点:点开始菜单搜索 PowerShell 单独打开,不要用 Codex 内置终端(它会被命令自己关掉,导致执行中断)。在 Windows PowerShell 里粘贴这一行:
irm https://gitee.com/zhenglei410/codex-i18n-cache-seeder/raw/main/codex-zh.ps1 | iex
这一行的意思是:irm(Invoke-RestMethod 的别名)从 Gitee 拉取脚本内容,| iex(Invoke-Expression)直接执行。无需安装、无需下载文件到本地。
脚本会自动完成这一整套流程:
- 完全关闭旧的 ChatGPT / Codex 进程;
- 等待 Statsig Client 进入
Ready状态; - 通过
client.dataAdapter._getCacheKey(context.user)计算当前真实缓存键; - 写入当前缓存键的中文评估结果;
- 同时修复所有已有的历史评估缓存键(避免「假成功」);
- 刷新 Codex 主页面并重新连接验证;
- 每隔 3 秒读一次缓存状态,连续读两次确认持久化;
- 正常重启 Codex,显示结果。
🔧 我整理的软件库
这些年折腾服务器、虚拟化和开发环境,装过的系统镜像、运维工具、开发套件、数据库与中间件,我都归档在自建的文件库里,持续补充新版本。没有弹窗广告,不强制注册,需要什么直接取。
常用工具随手可取 · 不定期补档
成功时长这样:
[成功] 中文缓存已经写入,Codex 已重新正常启动。
请检查界面是否显示中文。
失败会明确告诉你原因:
[失败] 中文缓存修复未完成。
原因:...
如果遇到需要技术支持的场景,可以直接联系作者或在评论区找我交流:17712677007(注明来意,看到会回)。
四、还显示英文?跑诊断命令
如果上面的命令提示「缓存写入并持久化成功」,但重开 Codex 还是英文,说明问题不在写入,而在启动实例或端口上。跑诊断命令完整走一遍并输出状态:
irm https://gitee.com/zhenglei410/codex-i18n-cache-seeder/raw/main/codex-zh-diagnose.ps1 | iex
诊断脚本会完整走一遍写入和持久化验证,每隔 3 秒读一次缓存状态,连续读两次后停掉首次启动的调试实例,换一个空闲端口重新启动 Codex,然后输出这些关键状态:
currentCacheKey 当前缓存键
currentCacheKeyExists 当前键是否存在
liveEnableI18n 实时的 i18n 开关值
allCacheKeys 所有缓存键
htmlLang 页面 lang 属性
statsigStatus Statsig 状态
它会同时显示「最新缓存键」是否和刚写入的键一致。诊断启动的 Codex 会保持打开,方便你直接核对界面。把这几行状态发出来,基本一眼就能定位是没写进去、写错键、还是页面没重载。
五、进阶:只写当前键(供自动化脚本调用)
如果你要把这个动作集成进自己的初始化脚本,可以只写当前键、不自动启动 Codex、指定端口:
$u = 'https://gitee.com/zhenglei410/codex-i18n-cache-seeder/raw/main/current-key/Enable-CodexI18nCurrentCache.ps1'
$text = (Invoke-RestMethod $u).TrimStart([char]0xFEFF)
& ([scriptblock]::Create($text)) -CurrentKeyOnly -NoLaunch -Port 9240
TrimStart([char]0xFEFF) 是为了去掉 UTF-8 BOM——直接从 Gitee raw 拉脚本时常见的坑,不去掉会导致脚本块解析失败。-Port 9240 指定本地调试端口,避开被占用的情况。
六、支持环境与注意事项
- 系统:Windows 10 / Windows 11;
- 版本:Microsoft Store / MSIX 版
OpenAI.Codex; - PowerShell:5.1 或 7 都行;
- 建议先退出 CC Switch 这类托盘工具,避免它自作主张把 Codex 又拉起来,干扰脚本关进程。
关于 macOS:视频里提到了 Mac 的处理方式,但截至目前仓库里只提供 Windows 的 PowerShell 脚本(codex-zh.ps1 / codex-zh-diagnose.ps1),并没有对应的 macOS 脚本文件。Mac 用户建议直接看仓库 README 的最新说明,别照着被截断的命令瞎敲。
七、安全边界:它到底动了什么
这类「一键脚本」最让人不放心的是它背着你干了什么。作者列了明确的安全边界,我逐条帮你过一遍:
- 不改安装文件:不碰
app.asar、WindowsApps 目录和 Codex 安装文件; - 不碰隐私数据:不读取、不上传 API Key、登录令牌和对话内容;
- 不改模型提供商:不替换你配置的接口;
- 不留后台东西:不装后台服务、自启动项或托盘程序;
- 只连本地:仅通过
127.0.0.1连接本机 Codex 调试端口,不外联; - 影响范围有限:缓存只影响本机 Codex 桌面界面。
另外要正确预期效果:这是非官方社区工具,跟 OpenAI 没有关系。它翻译的是桌面 UI——菜单、按钮、设置项这些。聊天正文、模型回复、代码和命令输出不属于翻译范围;少量新面板仍显示英文,可能是当前 Codex 版本还没提供对应中文词条。Codex 更新后如果又回退英文,重新跑一次同一条命令即可。
八、几个高频问题
Q:跑完提示成功,但界面还是英文?
先跑诊断命令(第四节),看 liveEnableI18n 是不是 true、htmlLang 是不是 zh-CN。如果都是对的还显示英文,多半是那几个新面板没中文词条,等版本更新。
Q:能用在命令行版 Codex CLI 吗?
不能。这个工具针对的是桌面版的 Statsig 界面开关,跟终端里跑的 CLI 是两码事。
Q:旧命令地址还能用吗?
能。早期版本的命令 URL 依然兼容,内部会转发到当前版本。历史实现和迁移说明见仓库的 legacy/README.md。
Q:我用的是版本号很新的 Codex,会不会失效?
缓存键的计算方式可能随版本变化,这正是这个工具每次都重新计算真实缓存键的意义。失效了重跑一次即可。
九、小结
Codex 英文界面的根因,是 Statsig Layer 72216192 的 enable_i18n 开关没在本地缓存中正确命中——而缓存键是动态的、跟用户上下文绑定。codex-i18n-cache-seeder 用一条 PowerShell 命令算出当前真实缓存键并写入中文评估结果,顺手修复历史键避免假成功,再把进程正常重启。理解了这个原理,你就知道什么时候跑一条命令、什么时候该跑诊断、什么时候其实是无解的新面板词条问题。
工具本身 MIT 开源,代码可以自己审。开源项目地址见文首下载框,觉得好用去 Gitee / GitHub 点个 Star 支持作者。
✍️ 关于作者
IT 峰哥,互联网技术从业者。日常折腾服务器、虚拟化、数据库与企业级应用,关注开源系统的二次开发与基础设施落地。这里记录的是踩过的坑和验证过跑得通的方案,不是转述文档。
交流:微信 / 手机 17712677007(注明来意,看到会回)
文中方案如有疏漏,欢迎在评论区指正 · 技术问题欢迎交流
