想知道 codex怎么改成中文,第一步是分清你要改的是哪一层:界面上的菜单按钮、终端里的提示文字、它给出的回答,这三层各走各的开关。桌面端和编辑器里的扩展都留了正式的语言设置项,命令行版本的终端界面没有给这一项。回答语言则统一由 AGENTS.md 决定。这篇把入口、写法和排查顺序一次说清。
codex怎么改成中文:先分清你要改的是哪一层
搜这个词的人,脑子里想的其实不是同一件事。有人嫌侧边栏的按钮全是英文看着费劲,有人是终端里冒出来的提示读不懂,还有人只是想让它别再用英文写回复。三件事的解决办法完全不同,混着找就会一直在错的地方翻设置。
改了界面语言不等于回答也变了。这两层互不干涉:界面语言管的是软件外壳上的文字,回答语言取决于模型收到的指令。你把外壳改成中文,它照样可能整篇英文回你;反过来,你让它在英文界面下说中文,也完全做得到。
| | |
|---|
| | |
| 编辑器设置中的 chatgpt.localeOverride | |
| | |
| | |
桌面端与 IDE 扩展的语言开关在哪
桌面客户端走设置。打开方式是从应用菜单进,macOS 上也可以按 Command 加逗号,Windows 上按 Ctrl 加逗号。设置里有一栏 Language,标注的是「Language for the app UI」,默认值是 Auto Detect,也就是跟着系统环境自己判断,旁边给了一批可选语言。
这一栏改完,变的是外壳上的文字:菜单项、按钮名、设置面板里的选项。它不会告诉模型说什么话。能选哪些语言随版本走,以设置面板里当下显示为准。
编辑器里的扩展是另一条路。打开编辑器的设置界面,搜 @ext:openai.chatgpt,就能定位到 Codex 相关的那批设置项,其中 chatgpt.localeOverride 就是管语言的。官方对它的描述大意是:设置 Codex 界面的首选语言,留空则自动检测。想要中文就填上对应的语言,想回到跟随系统就把值清空。
除了一条条搜,也可以点 Codex 侧边栏上的齿轮图标,进 Codex Settings,那里同样能到设置界面,还能直接打开当前的配置文件。
终端里的 CLI 为什么改不动界面文字
命令行版本的定制清单在官方文档的 CLI customization 那一页,能改的东西都列在那儿:主题用斜杠命令 theme 挑,选好之后存进配置文件里的 tui.theme,也可以把自己做的配色文件放进主目录的主题目录再去选。补全脚本用 completion 子命令生成,支持 Bash、zsh、fish 和 PowerShell,装进 shell 配置里生效,官方还提醒过 zsh 上如果报 compdef 找不到,得先跑一次 autoload 把补全系统初始化好。写长提示时按 Ctrl 加 G,会调起环境变量里指定的外部编辑器。
界面这一侧的交互斜杠命令包括 theme、keymap、statusline、title、vim、raw,另有一条 personality 用来改回答风格。整份清单没有语言这一项。
所以不是你没找到地方。终端里那块启动画面、模型那一行的提示、斜杠命令的列表、审批时的询问,在这一层确实没有做成可选语言。想让它跟你说中文,只能往下走到回答那一层。
让回答固定说中文:AGENTS.md 怎么写
回答语言走的是项目指令文件 AGENTS.md。最省事的位置是 Codex 的主目录,默认是用户主目录下的 .codex,如果你改过 CODEX_HOME 这个环境变量,就以你设的那个路径为准。在主目录里建一份 AGENTS.md,写一句要求用简体中文回复,之后每个项目、每次会话都会带上这句话。
文档里就是这么建议的:用全局文件来塑造 Codex 跟你沟通的方式,比如审阅的口吻、详尽程度、各项默认值。语言偏好放这里正合适。
不想到处生效,就放进具体的仓库根目录,让它跟着代码一起提交,团队里每个人打开这个仓库都继承同一套要求。只想临时改一次,直接在对话里说一句请用中文回答就行,按官方的说明,你在对话里明确提的要求优先级高于任何文件。
懒得从空白写,可以在想放文件的那个目录里执行 init 这条斜杠命令,它会先生成一份带骨架的 AGENTS.md,你再往里补自己的要求。生成的内容偏通用,最好按自己项目的构建方式改一遍再用。
AGENTS.md 的查找顺序与覆盖规则
指令分两层来找。全局层先在你的 Codex 主目录里看有没有 AGENTS.override.md,有就直接用;没有再看 AGENTS.md。这一层只取第一个非空的文件,不会把两份拼起来。
项目层从项目根开始,一路往下走到你当前所在的目录,默认把带 .git 的那个目录认作根。路径上每一层目录都依次检查 AGENTS.override.md、AGENTS.md,再是配置里额外指定的备用文件名,每个目录最多取一份。要是压根找不到项目根,就只查当前这一个目录。
合并的办法是从根往下依次拼接,中间用空行隔开。因为靠近你当前目录的那些文件排在后面,一旦和上面的说法冲突,后者说了算。空文件会被跳过,拼到 32 KiB 就不再往下读了,这个上限来自配置项 project_doc_max_bytes 的默认值。
这套合并结果每次运行算一回,交互界面里通常是每次启动会话时算一次。改完文件,正在进行的这个会话不会回头重读,得重新开一次。
| | |
|---|
| | |
| | |
| | |
| | |
某个子目录里的 AGENTS.override.md | | |
改完没变化时的排查顺序
界面和回答是两套开关,改一边不动另一边属于正常,不是失灵。确认没跨层之后,再看三件事:文件放的位置对不对、有没有被更近的一份盖掉、当前会话是不是还没重新构建指令。
最后检查一下是不是把编辑器设置和配置文件搞混了。命令行和编辑器共用同一套配置层,取值顺序从高到低是命令行参数、项目下的配置、用 profile 参数指定的那份文件、用户主目录的配置、云端下发的默认值、系统级配置,最后是内置默认。但扩展自身那批界面相关的键不在这套配置层里,它们归编辑器的设置系统管。另外把某个项目标成不信任时,项目下那一层配置会被直接跳过,此时只有全局的规矩还在生效。
| | |
|---|
| | 去主目录确认 AGENTS.md 里有没有写语言要求 |
| | |
| | |
| | 在新的工作目录下看看有没有别的 AGENTS.md |
| | |
| | |
| | |
| | |
改中文前的注意事项
界面语言和回答语言是两件事,改完一层别指望另一层跟着变化。
以 chatgpt. 开头的键只认编辑器的设置系统,写进配置文件不会生效。
指令链在会话启动时构建一次,改完文件要重新开一次会话才会带上。
全局文件跟着本机环境走,换机器就没了。团队共用要放进仓库并提交。
在仓库里提语言要求前先跟团队对齐,中英文夹杂的注释和提交记录很难长期维护。
想调整哪里算项目根目录,改的是配置项 project_root_markers,它默认认 .git,设成空数组就只认当前目录。
临时用的 override 文件用完就删,留着容易变成两套长期打架的说法。
让它讲中文不等于让它把所有东西都翻成中文。变量名、依赖名、命令参数建议保持原样。
界面能选哪些语言跟版本有关,以设置面板里当下实际列出的项为准。
中文设置常见问题
问:codex怎么改成中文最简单的一步?
答:只想要界面看得懂,去桌面端设置里改 Language,或在扩展里改那一项。只想要回答听得懂,在主目录的 AGENTS.md 里写一句用中文回复。两件事不在一个地方。
问:命令行出来的界面能改成中文吗?
答:官方给命令行版本的定制项里没有语言这一项,能改的是主题、补全、长提示编辑器这些。想要中文输出,用 AGENTS.md 去管回答语言。
问:为什么我改了设置,回答还是全英文?
答:设置管的是软件外壳上的字,回答语言由模型收到的指令决定。先在主目录那份文件里写清要求,再重开一次会话。
问:chatgpt.localeOverride 这一项到底填什么?
答:留空表示跟随环境自动判断,填上就用你指定的那种。具体能填哪些值,看编辑器里这一项给出的候选项,不同版本显示的可能不一样。
问:AGENTS.md 放在哪里最合适?
答:属于你个人的习惯放主目录,所有项目都吃得到。属于团队约定的放仓库根目录,跟着代码提交,谁打开这个仓库都一样。
问:项目里已经有这个文件了,我还能加自己的吗?
答:能。你那份放主目录作为全局层,两边会拼到一起。位置离你当前目录更近的那份优先级更高。
问:为什么改完这个文件,正在聊的窗口没变化?
答:合并结果在会话启动时算一次,已经开着的会话不会回头重读。退出去重新进一次就好。
问:会不会连代码里的命名也被改成中文?
答:语言要求描述的是表达方式。别顺手要求它把标识符也翻过来,命名规范照旧,改动前照例看一遍差异。
问:用中文提需求,国产框架和中文报错它看得懂吗?
答:看得懂,但类名、依赖名、参数这些照原样贴过去最稳,翻译一圈反而容易偏。遇到报错整段贴给它,比自己概括准确。
把 codex怎么改成中文 拆成动作其实只有两步:界面那层去桌面端设置或编辑器里的 chatgpt.localeOverride,回答那层写进 AGENTS.md。codex怎么改成中文 真正花时间的是判层,动手那几步本身没什么难度。