在使用 OpenAI Codex 时,很多中文开发者最头疼的并不是提示词怎么写,而是那满屏的英文界面。严格来说,Codex 的“界面语言”与“回复语言”是两件事:前者决定按钮和菜单显示什么,后者决定 AI 用哪种语言跟你对话。因此,下面这套方案也按桌面端、命令行和编辑器插件分别处理。
桌面端 Codex:设置开关不够,还有强制手段
Codex Desktop 是大多数人的首选入口。打开主界面后,依次进入 File → Settings → General,找到 Language for the app UI 选项,在下拉框里选择 Chinese (China) 或简体中文。需要注意的是,选完别急着继续操作:必须从 File → Quit 完全退出应用,再重新打开,界面语言才会真正刷新。
这一过程通常需要联网下载语言包。如果你的网络无法访问海外服务,语言包会加载失败,界面会“顽固”地保持英文。换句话说,科学上网既是前提,也是许多中文化问题的根源。
如果你已经正确设置却依然显示英文,问题多半出在服务端开关或本地缓存。可以试试手动修改配置文件:先彻底退出 Codex,编辑 ~/.codex/config.toml(不存在就新建),在顶部加入以下内容:
[general] language = "zh-cn" localeoverride = "zh-cn" enable_i18n = true
保存后,把 ~/.codex/cache、~/.codex/webviewcache 等缓存目录删掉,再重新启动 Codex。如果依然无效,Windows 用户还可以修改本地存储文件:路径通常在 C:\Users\<用户名>\AppData\Roaming\Codex\web\Codex\Default,重点检查 Preferences 和 Local State,把语言偏好改成 zh-CN。这种属于非官方硬改,动文件前务必做好备份。
CLI 与 VS Code:两种轻量中文化思路
如果你主要在终端里用 Codex,方法要简单得多。临时需求可以直接在对话中输入“使用中文回答我”,当前会话会立刻切到中文,但退出后失效。想让所有项目都默认中文,则只需在 ~/.codex/agents.md 中写入 always respond in chinese-simplified。建议用命令一次性完成:
mkdir -p ~/.codex && printf 'always respond in chinese-simplified\n' > ~/.codex/agents.md
如果只想让某个项目用中文,进入项目目录后执行 codex,输入 /init 生成 agents.md,再在文件里补上同样一行,这样全局规则和项目规则可以分别管理。
VS Code 插件的处理方式类似:打开插件设置页,把语言改为“中文(简体)”。日常使用时,直接在侧边面板输入中文指令,插件通常会自动识别并返回中文。这里需要提醒的是,VS Code 的“界面”与“对话”设置其实是分开的,前者影响插件按钮,后者影响模型回复,很多人把两者混为一谈。
常见问题:设置不生效时,按这个顺序排查
综合来看,Codex 中文化失败主要来自四个层面:网络不通导致语言包没下载、配置文件权限或格式错误、缓存残留覆盖了最新设置、以及官方尚未开放某些语言开关。建议排查顺序是:先确认能否稳定访问外网,再检查 config.toml 中是否有语法错误,然后删掉缓存重启,最后才考虑修改本地存储文件等硬改方案。
另外,CLI 端如果加了 agents.md 仍不生效,不妨先执行 codex --version 确认版本,再检查文件是否被正确读取。部分旧版本对中文指令的响应并不稳定,升级到最新版往往比改配置更有效。
总的来说,Codex 目前对中文的友好程度仍有提升空间。桌面端的图形设置适合多数人,CLI 的 agents.md 是自动化玩家的好帮手,VS Code 插件则兼顾交互与效率。对于追求“全中文”的开发者,建议以官方支持优先,硬改方案只作兜底。
