搜索“Codex 中文”时,先别急着找汉化包。你很可能在问三件不同的事,而它们的做法完全不同:
| 你真正想解决的事 | 最直接的做法 | 要不要改配置 |
| 用中文给 Codex 下任务 | 直接用中文写清任务 | 不要 |
| 让 Codex 默认用中文回复 | 在提示里说明,或写入 `AGENTS.md` | 可选 |
| 把菜单、按钮、CLI 交互改成中文 | 先区分 ChatGPT 界面与 Codex CLI;CLI 目前没有本文可推荐的官方汉化配置 | 不建议装第三方修改包 |
如果你的目标只是“能用中文写需求、读懂结果”,前两项就够了。若你在设置过程中真正卡住的是 [API Key、Provider、Base URL 或模型选择],请直接看本文的“API / Provider 问题”一节:那不是汉化问题,应该按接入配置处理。
1. 想用中文给 Codex 下任务:直接输入中文即可
Codex 的提示本质上是任务说明。官方提示指南建议把结果、上下文、输出形式和边界说清楚;它不要求使用固定语法或英文提示词。[OpenAI 的提示指南]也把“说明你需要的结果”和“补充会改变结果的上下文”列为核心做法。
因此,直接用中文写任务即可。比起把一句中文硬翻成英文,更重要的是把范围说完整:
目标:解释这个项目怎样启动。
范围:只读取 README.md 和 package.json,不修改文件。
输出:用简体中文给出最短启动步骤,并列出需要的环境变量。
边界:命令、文件名、配置键和报错原文保持原样;不确定的地方明确说明。
这段提示同时解决了任务、范围和输出语言。代码世界里的专有内容则保持英文:`package.json`、`model_provider`、命令行参数、错误码和日志原文都不要翻译。这样你仍能按原样搜索报错,或对照官方文档排查。
怎么确认设置成功
让 Codex 做一件只读的小事,例如“用中文概述当前项目的目录结构,不要修改文件”。如果结果的解释是中文、代码与路径仍是原样,就达到了这个目标。
2. 想让 Codex 默认中文回复:写明回复语言
中文输入不等于中文输出。虽然直接用中文提问通常足够,但复杂任务、代码审查和后续追问中,最好把回复语言单独写出来。
只对当前任务生效
在任务末尾加一行即可:
请全程使用简体中文解释;代码、命令、文件路径、配置键和报错原文保留原文。
这适合偶尔需要中文说明的场景。它不影响其他项目,也不需要改本地文件。
对每个项目长期生效:在项目的 `AGENTS.md` 写规则
如果你希望某个仓库中的 Codex 一直用中文沟通,把下面内容加入项目根目录的 `AGENTS.md`。已有该文件时,请追加到现有规则中,不要覆盖团队原有要求。
Language
- 默认使用简体中文回复。
- 代码、命令、文件路径、配置键、API 名称和报错原文保持原样。
- 需要解释英文技术术语时,先给中文含义,再保留英文术语。
OpenAI 文档说明,Codex 会在开始工作前读取 `AGENTS.md`;它还会把全局和项目目录中的规则按层级合并,离当前目录更近的规则优先。[查看 `AGENTS.md` 官方说明]。
如果你希望所有项目都默认中文,可在 `~/.codex/AGENTS.md` 中放同样的规则。文档把这里定义为全局指导文件;项目中的 `AGENTS.md` 可以再覆盖它。
写了规则,为什么还是英文?
先检查这三件事:
1. 新开一次 Codex 会话。官方说明指出,指令链在一次运行开始时构建;已经在运行的会话不会自动重新读取刚修改的文件。
2. 确认文件名是 `AGENTS.md`,并且位于你启动 Codex 的项目路径或其父目录中。
3. 检查更近目录或 `AGENTS.override.md` 是否写了相反的语言要求。官方的加载顺序是 `AGENTS.override.md` 优先于同目录的 `AGENTS.md`。
不要为了让回复变中文去修改模型、[API 地址]或环境变量。那是另外一类配置问题。
## 当“Codex 中文”问题其实是 [API / Provider]问题
很多人搜“Codex 中文”,前半程想解决的是看得懂、能用中文沟通;装好后才发现自己真正卡在 [API Key 放哪里、Provider 怎么选、Base URL 应该填什么],或者想在不同模型之间切换。这时继续找汉化教程没有帮助,因为语言设置不会让一个 Endpoint 生效,也不会替你管理多个模型的接入。
中文回复设置完成后,[API Key、Provider 和 Base URL]仍需单独配置。对于需要通过第三方 API 接入 Codex 的读者,[AI Code With]提供对应的配置方法;它处理接入问题,而不是把 Codex CLI 翻译成中文。可按下面的情况选择下一步:
| 你遇到的情况 | 应该做什么 |
| 只想用中文描述任务、读中文解释 | 按本文前两节设置提示或 `AGENTS.md` |
| 想把 ChatGPT 产品界面改成中文 | 到产品的语言设置中处理 |
| 已经在配置 [Key、Provider、Base URL],或需要统一接入多个模型 | 进入 [AI Code With]的 Codex 接入指南 |
如果你已经走到第三种情况,下一步不要再改语言规则。直接查看 [Codex 接 AI Code With 的配置方法],按其中针对 Codex 的接入步骤配置,再用一次小任务验证连接是否成功。这样用户从“中文能不能用”自然过渡到“怎么稳定接入并管理模型”,而不是在多个英文配置页之间反复猜字段含义。
3. 想把界面汉化:先确认你用的是哪一个界面
“界面汉化”与提示语言没有关系。你在 `AGENTS.md` 里写“请用中文”,只能影响 Codex 的文字回复,不能把终端菜单翻译成中文。
ChatGPT 网页或桌面端:从语言设置处理
如果你使用的是 ChatGPT 的网页或桌面端界面,OpenAI 帮助中心给出的路径是:个人资料 → **Settings** → **General** → **Language**,再选择偏好的语言。[语言设置官方说明]。
这解决的是产品界面的显示语言。它不等于终端里的 Codex CLI,也不决定 Codex 对你的回复使用什么语言;回复语言仍应按上一节的提示或 `AGENTS.md` 处理。
Codex CLI:不要把“没有汉化命令”误当成故障
截至本文核对时,Codex CLI 官方文档列出了安装、命令与配置入口,但没有提供一个把 CLI 菜单整体切换为中文的 `language` 配置项或官方语言包。[查看 Codex CLI 官方文档]。
所以本文不提供“复制一条命令就能汉化 CLI”的做法。设置 `LANG`、替换资源文件或安装来历不明的脚本,也不应被当成官方支持的 Codex 本地化方案。对 CLI 用户而言,更实用的组合是:保留官方界面与命令原文,让任务、解释和项目规则使用中文。
何时应避开第三方汉化工具
第三方工具可能改写安装目录、启动脚本或资源文件。安装前至少确认:
- 维护者与代码来源是否可核验;
- 是否明确支持你正在用的 Codex 版本;
- 安装脚本会写入哪些目录,以及如何恢复原状;
- 是否索要 [API Key]、`auth.json`、完整 `config.toml` 或关闭系统安全设置。
一旦工具要求上传凭证或完整配置,先停止安装。语言包不应该成为交出密钥的理由。
适合中文用户的一套稳妥配置
如果你想少折腾,可以按下面顺序完成:
1. 先直接用中文完成一条只读任务,确认自己需要的是中文输入还是中文解释。
2. 需要稳定中文回复时,在项目 `AGENTS.md` 加入语言规则,并新开会话验证。
3. 使用 ChatGPT 网页或桌面端时,再到语言设置选择中文;不要期待这一步翻译 CLI。
4. 一旦进入 [API Key、Provider、Base URL、模型选择或网络连通性],查看 [Codex 接 AI Code With 的配置方法]。不要再把接入故障当成中文设置的问题。
这样做的好处很简单:中文用在最需要理解的地方,命令和技术标识保留可检索的原文,升级 Codex 时也不会被第三方汉化补丁卡住。
常见问题
Codex 能不能理解中文需求?
可以直接用中文说明任务。把目标、范围、输出和边界写清,比先把需求翻译成英文更有帮助。涉及代码和配置时,保留技术标识原文。
怎样让每次回复都用中文?
临时任务就在提示末尾要求“使用简体中文回复”;长期规则则写进 `AGENTS.md`。修改后从新会话开始验证。
有没有官方 Codex CLI 汉化包?
本文核对的官方 CLI 文档没有给出语言包或 CLI 全局中文开关,因此不把第三方汉化工具作为推荐路径。产品界面语言和 CLI 语言是两件事。
资料来源
- [OpenAI:Prompting]
- [OpenAI:Custom instructions with AGENTS.md]
- [OpenAI:Codex CLI]
- [OpenAI Help Center:How to change your language setting in ChatGPT]
- [AI Code With 中文站]

