30 秒答案
Codex 中文设置先按入口分流
当前版本出现 Language 时选择中文;保存后完全退出再打开。菜单仍为英文可能是客户端本地化问题。
它是编辑器设置,不写进 config.toml;留空时自动检测编辑器或系统语言。
CLI 可直接中文交互;官方文档未给出与 IDE 相同的中文 UI 开关,不要把第三方补丁当成官方语言包。
已经能登录但不知道怎样开始任务?先完成 Codex 从安装登录到第一个任务,再设置长期语言偏好。
先分清目标
中文界面、中文回答、中文代码不是一回事
| 你想改变什么 | 应该在哪里设置 | 不会自动改变什么 | 验证方式 |
|---|---|---|---|
| App 菜单与设置页 | App 的 Language | CLI TUI、IDE 编辑器 | 重启 App 后查看菜单 |
| IDE 侧边栏界面 | 编辑器的 chatgpt.localeOverride | 桌面 App、CLI | Reload Window 后查看面板 |
| 对话回答 | 当前 Prompt 或 AGENTS.md | 菜单、代码标识符 | 新开任务要求解释错误 |
| 注释、文档、提交信息 | 任务约束与项目规则 | 错误原文、第三方 API | 检查 Diff 和生成文件 |
如果只是希望回答使用中文,根本不需要修改安装文件。直接说“请使用简体中文解释,保留命令、路径和错误原文”通常已经足够。
桌面 App
Codex App 怎么切换中文界面
- 打开 Codex App,进入 Settings。
- 在 General 中寻找 Language 或 “Language for the app UI”。
- 选择简体中文并确认设置已经保存。
- 完全退出 App,再重新打开;不要只关闭当前窗口。
- 分别查看菜单、侧边栏、设置页和聊天内容,记录哪些区域仍是英文。
先确认安装的是当前官方 Codex App,并完成更新。不同版本、平台、账号或功能发布阶段可能看到不同入口;不要从陌生网站下载所谓“带中文语言包的 Codex 安装器”。
OpenAI 官方 Codex 仓库的 issue #19239 记录了一个重要边界:设置可以保存为 localeOverride=zh-CN,App 也能显示“中文(中国)”,但部分可见 UI 仍可能保持英文。出现相同证据时,更接近客户端本地化没有应用,而不是操作步骤错了。
VS Code / Cursor / Windsurf
Codex IDE 扩展中文设置
- 打开编辑器 Settings。
- 搜索
@ext:openai.chatgpt、Codex或chatgpt.localeOverride。 - 在可选语言中选择简体中文;如果希望跟随系统或编辑器语言,保持 Auto/空值。
- 执行 Developer: Reload Window 或完全重启编辑器。
- 如果只有回答变成中文、侧边栏仍英文,确认修改的是 UI locale,而不是只写了中文 Prompt。
OpenAI 当前 IDE 设置文档明确说明,chatgpt.localeOverride 用于设置 Codex UI 的首选语言,留空会自动检测。它属于 chatgpt.* 编辑器设置,不要写进 ~/.codex/config.toml。模型、Sandbox、MCP 等共享行为才由 Codex 设置和 config.toml 管理。
扩展无法加载、一直转圈或设置页不存在时,进入 Codex VS Code 扩展不工作排查,先看 Output、app-server、认证与版本,不要继续反复切换语言。
Codex CLI
Codex CLI 如何一直用中文回答
Codex CLI 可以直接理解中文任务。当前官方 CLI 文档没有提供与 IDE chatgpt.localeOverride 等同的中文 TUI 开关;想改变回答语言,应使用自然语言指令,而不是覆盖已安装的 CLI 文件。
请默认使用简体中文解释。
命令、文件路径、代码标识符、日志和错误原文保持原样。
引用英文错误后,用中文说明原因、证据和下一步。
修改代码前先说明计划;完成后用中文总结 Diff、测试和未验证项。
这个要求既可以放在当前 Prompt,也可以成为个人或项目的 AGENTS.md 规则。对一次性任务优先写在 Prompt;多个仓库都需要时才使用全局规则。
持久语言偏好
用 AGENTS.md 区分个人默认与项目规则
| 位置 | 作用 | 适合写什么 | 注意 |
|---|---|---|---|
~/.codex/AGENTS.md | 个人默认 | 回答语言、解释风格 | 不要塞入某个仓库的命令 |
仓库根 AGENTS.md | 团队项目 | 注释语言、文档语言、测试命令 | 应提交并让团队审查 |
子目录 AGENTS.md | 局部覆盖 | 例如 docs 使用中文、源码注释用英文 | 越接近目标文件越具体 |
# Language
- 默认使用简体中文解释和总结。
- 命令、路径、错误原文、API 名称和代码标识符保持原样。
- 源码注释遵循相邻文件的既有语言,不做机械翻译。
- 面向用户的中文文档使用中文标点,并保留必要英文术语。
完整发现顺序、覆盖规则和 32 KiB 限制见 Codex AGENTS.md 配置指南。如果只想临时改一次回答,别为此建立复杂规则。
中文设置失效
设置中文不生效的 8 步排查
- 确认入口
App、IDE、CLI 的设置不互相同步,先写清当前客户端和平台。
- 区分 UI 与回答
菜单仍英文但对话为中文,是 UI 本地化问题;反过来则是 Prompt/规则问题。
- 确认设置已保存
重新打开设置,查看 Language 或 localeOverride 是否仍为中文。
- 完全重启
退出 App 或 Reload Window,避免只关闭一个聊天窗口。
- 更新官方客户端
先记录版本,再从官方渠道更新;不要叠加来历不明的覆盖包。
- 检查作用域
IDE 设置可能写在 Workspace 或 User 层;AGENTS.md 可能被更近目录覆盖。
- 最小验证
新建空任务,要求中文解释一个简单错误,排除旧会话上下文。
- 保留证据
记录版本、系统、入口、设置值和未翻译区域;设置已保存但 UI 仍英文时对照官方 issue。
| 现象 | 更可能的方向 | 下一步 |
|---|---|---|
| App 设置中文,菜单仍英文 | App 本地化未应用或版本问题 | 重启、更新、记录版本并查官方 issue |
| IDE 找不到 localeOverride | 扩展版本、扩展未加载或设置过滤 | 确认官方扩展并检查 Output |
| 回答偶尔切回英文 | 任务 Prompt 或 AGENTS.md 作用域 | 新会话验证并检查更近规则 |
| 代码标识符被翻译 | 语言约束过度宽泛 | 明确保留标识符、命令和错误原文 |
| 修改 config.toml 后没变化 | 把 IDE UI 设置写错了位置 | 改到编辑器 chatgpt.* 设置 |
第三方工具边界
为什么不建议把“汉化补丁”当第一选择
Google 前排的第三方 Codex CLI 中文工具明确写着为 CLI 0.40.0 设计,并通过脚本注入翻译文件;而本页核对环境的官方 CLI 已是 0.144.1。这不能证明该工具恶意,但足以说明“搜索排名靠前”不等于“兼容当前版本”。
- 覆盖安装文件会随更新失效官方升级可能覆盖补丁,补丁也可能破坏新版本。
- 可执行文件需要独立审计README、Stars 和视频演示不能替代源码、发布签名、哈希与行为检查。
- 注入脚本扩大供应链风险能修改 CLI 的工具也可能接触配置、命令和工作区,应按本地执行软件评估。
- App 与 CLI 不是同一程序针对旧 CLI 的补丁不能解决当前桌面 App 或 IDE 的语言问题。
优先顺序应是:官方 Language / localeOverride → Prompt / AGENTS.md → 更新与官方 issue → 最后才评估经过审计、版本匹配、能恢复原状的第三方工具。不要为了中文菜单交出 API Key、Session、Cookie 或系统管理员权限。
FAQ
Codex 中文设置常见问题
Codex 怎么设置中文?
App 当前版本有 Language 时,在 Settings → General 中选择中文;IDE 扩展在编辑器设置中搜索 chatgpt.localeOverride;CLI 的中文回答用 Prompt 或 AGENTS.md。三种入口不要混用设置。
Codex 设置中文后为什么界面还是英文?
先确认设置保存并完全重启,再区分 App、IDE 和 CLI。OpenAI Codex 官方仓库已有设置显示中文但部分 UI 仍为英文的公开问题;记录版本和未翻译区域,比反复下载语言包更有用。
Codex CLI 可以设置中文界面吗?
当前官方 CLI 文档没有与 IDE localeOverride 相同的中文 UI 开关。CLI 可以直接中文交互,并通过全局或项目 AGENTS.md 让回答默认使用简体中文。
Codex 汉化补丁安全吗?
不能仅凭搜索排名判断。第三方工具可能修改程序文件,且经常只支持特定旧版本。优先使用官方设置;确需使用时,应审计源码、版本、发布物哈希、权限和恢复方法。
怎样让 Codex 中文回答但保留英文错误原文?
明确要求“简体中文解释;命令、路径、代码标识符、日志和错误原文保持原样;引用关键英文错误后给出中文原因和步骤”。
来源、测试环境与利益关系说明
本文根据 2026 年 7 月 21 日默认 Chrome 的 Google 无个性化结果分析,并以 OpenAI Codex IDE settings、AGENTS.md与 openai/codex issue #19239核对。第三方汉化工具的版本说明仅用于风险比较,不构成推荐。
Hi Codex 提供 ChatGPT/Codex 独立人工充值协助,对 Plus/Pro 套餐主题存在商业利益;与 OpenAI、GitHub、Google、知乎、菜鸟教程或第三方汉化项目不存在隶属、代理或官方授权关系。语言设置、版本和客户端 Bug 不能靠充值修复。