先交代一下背景我身边有不少朋友听说 Codex 能在终端里直接读代码、改代码、跑测试兴冲冲装好之后打开全是英文界面。倒不是说完全看不懂但是效率低——一个选项要心里翻译一遍遇到排版密集的错误提示更是头疼。所以从两个月前开始我就在琢磨怎么给 Codex 配一套靠谱的中文界面。这篇就把我现在实际在用的 Codex 汉化包下载、安装、导入流程整理出来包括中文版设置的具体步骤。如果你刚装好 Codex想切到中文界面但又担心改坏原有功能这篇文章应该能帮你少走不少弯路。1. 动手汉化前先把 Codex 的“三种形态”和汉化边界搞清楚1.1 CLI、IDE 扩展、网页端汉化难度完全不一样现在的 Codex 不再只是那个自动写代码的模型而是 OpenAI 推出的命令行 AI 编程代理工具。常见的使用形态有三种很多人以为汉化包都是同一个套路实际上差别很大。第一种是Codex CLI在终端里运行的交互式工具启动后是一个带面板、快捷键、彩色输出的 TUI 界面。所有界面文本都编译在程序资源里汉化通常靠替换内置语言资源或者让它加载外部的翻译 JSON 文件。第二种是VS Code 扩展Codex IDE extension安装后在编辑器侧边栏和右键菜单里出现。它本质上是基于 TypeScript/JavaScript 写的前端插件汉化包一般要处理扩展安装目录下的 dist 文件。第三种是网页版 / ChatGPT 客户端里的 Codex它跟着浏览器或客户端的语言设置走你只需要把系统语言或浏览器语言切成简体中文通常不需要额外装汉化包。所以如果你只是在网上搜“Codex 汉化包”很容易下载到不匹配的文件。确定自己用的是哪种形态再选对应的汉化方案这是第一件要做的事。1.2 汉化包不等于破解包它只改显示文本我在不少交流群里看到有人把汉化包和“破解”“绕过授权”混为一谈这里先澄清一下Codex CLI 本身是开源项目社区做汉化包只是把原本的英文 UI 文案替换成中文属于本地化改造不涉及授权绕过也不会让没有订阅的账号白嫖功能。汉化包的核心内容一般是以下几样一份或多份翻译后的语言资源文件常见为 JSON 格式记录英文原文与中文译文的映射。针对 CLI 可执行文件或扩展 JS 文件的补丁脚本。安装说明和版本对应表。明白了这一点你就知道汉化包“导入”的本质是把你的 Codex 界面语言资源从默认英文切换成汉化包提供的中文内容。所以你不需要对整个工具做任何危险操作很多步骤都是可以回退的。1.3 正式操作前五分钟的环境检查开始之前我建议先把基础环境确认一遍避免下文操作到一半发现 Codex 本身没装好结果还以为是汉化包的问题。检查 Node.js 和 npm 版本node -v npm -v检查 Codex 是否已经安装及其版本codex --version如果没安装先通过官方 npm 包安装npm install -g openai/codex安装后第一次使用要完成账号登录官方支持 ChatGPT 账号登录或 API Key 方式codex login登录成功后再执行codex就能进入主界面。走到这一步时先别急着汉化花两分钟确认原版能正常启动、能发起一次简单对话。很多汉化后出现的“启动失败”问题其实是原版环境本身就不干净。2. 汉化包怎么找、怎么判断版本对不对下载前如何自保2.1 我推荐优先逛的三个渠道找 Codex 汉化包千万不要直接去搜索引擎点那些写着“一键汉化版”“永久汉化”的推广页里面混着来路不明的可执行文件风险很高。我一般按下面的优先级找官方 GitHub 仓库的 Releases 页Codex 是开源项目很多社区贡献者会把汉化资源打包发布在相关仓库的 Releases 里。直接搜codex 汉化、codex zh_CN、codex language pack这类关键词。GitHub Discussions 和社区讨论区有时候维护者还没发正式 Release但已经有人在讨论区贴出了汉化文件链接这可以作为候补渠道。可信的个人技术博客一些作者会写完整的 Codex 汉化教程并在文末附上自己打包的资源。下载后我仍然会执行下面的验证步骤。这里有个小技巧在 GitHub 搜索时把筛选条件切换成“最近更新时间”排序优先看三个月内有更新的仓库。汉化包这种资源跟 Codex 主版本绑定很紧一个半年没更新的汉化包很可能已经失效了。2.2 版本匹配是汉化成功的一半你拿到的汉化包必须和本机 Codex 版本匹配。比如本机codex --version显示0.42.0那汉化包最好明确说明支持0.42.x而不是写着“支持所有版本”。汉化包的翻译要和界面字符串一一对应如果 Codex 升级后新增了按钮、改了菜单名称旧汉化包就会出现漏翻、错位甚至直接无法加载。版本匹配度可以参考下面这张表Codex 版本汉化包建议可能遇到的问题旧版本0.20 以下找对应的历史汉化包界面差异大不建议用新版汉化包硬套当前稳定版本找最新 Release看适配版本号基本正常刚发布的预发布版本等一周左右再汉化新版本字符串变动频繁汉化容易失效查看汉化包适配版本的方法很简单解压后先看 README 里写的“Supported versions”再对照压缩包文件名里的版本号。没有写明版本的汉化包即使功能看起来简单我也建议换一个。2.3 拿到压缩包后先别解压运行先做四件事下载文件之后、运行安装脚本之前我会花几分钟做安全检查这已经成了习惯。第一核对哈希值。如果作者在发布页同时给出了 SHA256 值就在终端里算一下看是否一致。macOS/Linux 用shasum -a 256 codex-zh_CN-xxx.zipWindows PowerShell 用Get-FileHash .\codex-zh_CN-xxx.zip -Algorithm SHA256第二解压后先看文件结构。一个正常的汉化包通常长这样codex-zh_CN-0.1.0/ ├─ README.md ├─ install.sh # 给 macOS/Linux 用的安装脚本 ├─ install.ps1 # 给 Windows 用的安装脚本 ├─ locales/ │ └─ zh_CN.json # 中文语言资源 └─ patches/ └─ codex.patch # 补丁文件如果解压出来只有一个.exe或者一个.dll而且没有说明文件我基本不会继续用。第三用文本编辑器扫一眼安装脚本。重点看它往哪些路径写文件、有没有curl额外下载、有没有要求管理员权限。看不懂的脚本内容宁可不用也不要盲跑。第四临时先杀毒扫一遍。就算文件来自 GitHub我也建议右键扫描一次再操作。3. CLI 版汉化包安装从备份到导入语言资源的完整流程3.1 定位 Codex 的安装目录和配置目录CLI 汉化第一步是找到两个目录安装目录和配置目录。安装目录里是 Codex 的程序本体配置目录里是config.toml、auth.json这些用户文件。查看 Codex 可执行文件的实际位置which codex # macOS/Linux type codex # Windows在 cmd 里 where codex如果你的 Codex 是 npm 全局安装的可以用下面的命令看全局包根目录npm root -g常见路径参考Windows%APPDATA%\npm\node_modules\openai\codexmacOS/Linux系统级/usr/local/lib/node_modules/openai/codexmacOS/Linuxnvm 用户~/.nvm/versions/node/v20.x.x/lib/node_modules/openai/codex配置目录固定是~/.codex这个目录里的文件很关键auth.json是你的登录凭据config.toml是全局配置。汉化过程一般不需要动auth.json也最好别去手改它否则可能把登录状态弄坏。3.2 把 zh_CN 语言资源放进 Codex 能读到的地方目前最常见的汉化包形态就是带一个zh_CN.json语言资源文件。导入方法可以总结为三步。第一步在配置目录下创建locales目录mkdir -p ~/.codex/locales第二步把汉化包里的zh_CN.json复制进去cp ./codex-zh_CN-0.1.0/locales/zh_CN.json ~/.codex/locales/Windows PowerShell 对应New-Item -ItemType Directory -Force -Path $HOME\.codex\locales Copy-Item .\codex-zh_CN-0.1.0\locales\zh_CN.json $HOME\.codex\locales\第三步在~/.codex/config.toml里告诉 Codex 使用中文语言。用任意文本编辑器打开配置文件加入或修改一行language zh_CN保存后完全退出 Codex 进程再重新运行codex。正常情况下主界面、快捷键提示、状态栏信息就都会切换成中文。如果在旧版本 Codex 上语言资源加载不生效可以尝试设置环境变量export CODEX_LANGzh_CNWindows 用户可以在 PowerShell 里临时设置$env:CODEX_LANGzh_CN然后用codex启动验证。3.3 补丁型汉化包的安装与回滚思路有些汉化包不是语言资源文件而是一份.patch补丁要求你把补丁打进源码或二进制。这种情况我会更谨慎但也不是不能用。假设汉化包提供了codex.patch并且本机环境有git一种工作流是把 Codex 源码克隆到本地把补丁应用到源码然后重新构建git clone https://github.com/openai/codex.git cd codex git checkout 你本机的版本号 git apply /path/to/codex.patch npm install npm run build不过这种方案需要完整的编译工具链不适合大多数人。我在实际使用中更推荐一个折中思路先看补丁内容。如果补丁只是改了显示字符串、快捷键帮助文本那风险相对低如果补丁动了网络请求、鉴权逻辑、文件读写路径那就直接放弃换一个纯粹的汉化资源包。回滚思路反而是我最看重的。不管用哪种方式汉化操作前先备份配置目录cp -r ~/.codex ~/.codex.backup-$(date %Y%m%d)Windows 可以直接复制整个.codex文件夹到旁边。真出了问题删掉改过的目录把备份改回去就恢复原样了。4. VS Code 扩展汉化包导入比 CLI 更讲究“打包”4.1 找到扩展目录并做好备份在 VS Code 里使用 Codex 扩展的人不少因为可以在编辑器里直接选中代码、让 AI 解释或修改。它的汉化导入方式和 CLI 完全是两码事。先打开 VS Code 的扩展目录Windows%USERPROFILE%\.vscode\extensionsmacOS/Linux~/.vscode/extensions在里面找到名字类似openai-codex-x.x.x的目录。如果你装了多个版本建议在 VS Code 扩展面板里看启用的是哪个版本对应目录就是当前生效的那个。找到之后先复制一份完整备份。直接替换扩展源码是有风险的VS Code 会对扩展做完整性校验改完如果出现“扩展已损坏”或“无法加载扩展”的提示备份就能救命。cp -r ~/.vscode/extensions/openai-codex-0.30.0 ~/.vscode/extensions/openai-codex-0.30.0.bak4.2 两种导入方式直接替换与重新打包 vsix第一种方式比较直接把汉化包提供的翻译文件放进去同时修改扩展里的语言映射文件。具体操作要看汉化包的文件结构。有些汉化包会提供一个dist/extension.js替换文件让你直接覆盖同名文件。覆盖后重启 VS Code在命令面板执行Developer: Reload Window让扩展重新加载。如果扩展正常显示中文那说明汉化包只做了界面文本的本土化可以继续用。但我不太推荐这种方式原因稍后细说。第二种方式更“学院派”也是我实际遇到问题后的首选把汉化内容打回成一个完整的.vsix安装包再重新安装。基本流程是在扩展目录里应用汉化补丁或替换语言资源。安装 VS Code 扩展打包工具npm install -g vscode/vsce在扩展目录里执行打包cd ~/.vscode/extensions/openai-codex-0.30.0 vsce package卸载原扩展安装新打包的 vsixcode --uninstall-extension openai.codex code --install-extension openai-codex-0.30.0.vsix --force4.3 为什么我建议学会重新打包而不是直接改文件直接替换dist/extension.js最大的问题在于VS Code 扩展一旦被检测到内容与安装记录不一致轻则提示“扩展可能已损坏”重则直接禁用扩展并让你重新安装。到时候你汉化没实现反而连扩展都打不开。重新打包成 vsix 的好处是让 VS Code 认为这是一个正常安装的扩展版本完整性校验能通过而且以后卸载也干净。代价是打包过程比复制文件多花两三分钟但稳定性高很多。另外要注意打包前扩展目录下的package.json不要乱改版本号否则 VS Code 可能因为版本冲突拒绝安装。汉化包如果提供了自己的 package 资源优先用它的没有的话保持原样最安全。5. 中文版设置之后的验收动作乱码、缓存和版本锁定5.1 重启清缓存别在旧进程上验证导入汉化包以后很多人会在已经打开的终端窗口里直接执行codex发现界面还是英文就以为汉化包没用。大多数情况下不是因为没导入成功而是因为旧进程还在或者终端环境变量没重载。正确做法是先把 Codex 相关进程全部退出。macOS/Linux 下pkill -f codexWindows 下taskkill /F /IM codex.exe同时关闭终端窗口再重开让环境变量重新读取。这样再执行codex看到中文的概率会大很多。5.2 终端乱码九成是字体和编码的问题中文设置生效后又会出现一个新问题界面确实是中文了但很多汉字显示成方块或者问号。这个跟汉化包没关系是终端字体和编码没跟上。我的建议是把终端字体换成明确支持中文等宽字形的字体比如“更纱黑体 SC”“Saroma Mono SC”“JetBrains Mono”加上中文字体回退。Windows Terminal 里可以在设置里直接把字体改为“更纱黑体 SC”macOS 的 Terminal.app 则在“描述文件-字体”里改。编码方面Windows 命令行容易踩坑可以临时切到 UTF-8chcp 65001PowerShell 用户在运行 Codex 前执行[Console]::OutputEncoding [System.Text.Encoding]::UTF8macOS 和 Linux 终端一般默认 UTF-8遇到乱码先检查 locale 设置locale如果LANG不是zh_CN.UTF-8或类似值可以在 shell 配置文件里加一句export LANGen_US.UTF-8终端的渲染需要 Unicode语言资源才能正常显示。5.3 升级 Codex 后汉化消失版本锁定的具体做法汉化包失效最常见的原因就是升级。如果你使用 npm 全局安装 Codex哪天看到提示有新版顺手执行了npm update -g openai/codex汉化文件极有可能被覆盖或与新版不兼容。我个人养成一个习惯**汉化稳定之后不主动升级 Codex除非新版有必须使用的功能。**如果确实要升级先升级再下载对应版本的新汉化包重新走一遍导入流程。如果想锁定在特定版本用 npm 指定版本号安装npm install -g openai/codex0.42.0这样后续即使执行npm update也只更新指定版本范围内允许的小版本。如果担心误触全局升级也可以把手动升级放在一个明确的时间点每次升级前后各做一次配置目录备份cp -r ~/.codex ~/.codex.before-upgrade升级后再复制一份~/.codex.after-upgrade。出问题时对比两个目录很快就能定位是哪个资源被改掉了。6. 汉化完成后我觉得值得一并调整的几个细节6.1 在 config.toml 里把语言写死避免环境变量失效环境变量CODEX_LANG虽然方便但有个问题它只在当前终端会话里生效换一个终端、重启电脑后就可能丢失。当你确认zh_CN.json语言资源能正常加载后我建议把语言配置写进~/.codex/config.toml而不是依赖环境变量。一个参考配置# ~/.codex/config.toml language zh_CN theme dark这样每次启动 Codex 都会固定读取中文配置。同样地如果你之前在命令行里设置过CODEX_LANG记得把它从 shell 配置里删掉否则两边如有冲突反而会出现加载异常。6.2 给终端命令加一个顺手的别名汉化之后命令行的提示和帮助信息都会变成中文但命令本身仍然是codex。如果你同时装了其他 AI 工具担心输错可以加个顺手的别名。macOS/Linux 在~/.zshrc或~/.bashrc里加alias cxcodexWindows PowerShell 里可以定义函数Set-Alias -Name cx -Value codex之后直接在终端输入cx就能启动中文版 Codex。这种小习惯在实际使用中提升很明显尤其是经常在两个项目目录间切换、频繁启动工具的时候。6.3 验证一个真实小任务确认关键提示已经中文化汉化是否真正生效不是看启动横幅变中文就够了。我会用一个真实小任务来验收让 Codex 读取当前项目的 README然后让它解释某个文件的功能。重点看三处对话输入框下方的功能提示是否中文。过程中出现的快捷键帮助面板是否中文。报错和确认提示是否不再是满屏英文。如果这三处都是中文说明汉化包覆盖了核心用户路径。如果发现某个角落还是英文再回去看汉化包说明看它声明覆盖的范围是什么。有些汉化包只做了主要界面没有覆盖所有错误分支这并不代表安装失败只是覆盖范围有限。最后说一下我的习惯每次拿到新汉化包我先在虚拟环境或临时目录里试一遍确认没问题再动真实配置文件。每次升级 Codex 前把~/.codex整个目录备份一次跑一遍codex --version和一次简短对话确认汉化没坏后再进项目干活。这个习惯帮我少踩了很多坑也让我在分享汉化经验的时候心里有底。