Claude Code 终于说中文了!claude-code-zh-cn 汉化插件终极入门指南:2314 条翻译一次看懂
Claude Code 终于说中文了!claude-code-zh-cn 汉化插件终极入门指南:2314 条翻译一次看懂
claude-code-zh-cn 是一个为 Claude Code CLI 打造的简体中文本地化插件:一行命令安装后,终端界面、等待提示、回复耗时、系统通知全部变成地道中文,还会把官方那些放飞自我的 loading 动词翻成"蹦迪中""七荤八素中"之类的中式幽默。支持 macOS、Linux、WSL 与 Windows,升级后还能自动修复,绝不弄坏你的 CLI。
一、这个汉化插件到底改了什么?
很多人以为"汉化"只是翻译几个按钮文字。claude-code-zh-cn 的覆盖范围比这大多了:
| 功能模块 | 规模 | 你能看到的效果 |
|---|---|---|
| AI 回复偏好 | 默认中文 | AI 回答默认用简体中文 |
| Spinner 等待动词 | 187 个 | Thinking → 思考中、Boogieing → 蹦迪中 |
| Spinner 等待提示 | 41 条 | Shift+Tab 等快捷键提示全部中文 |
| 系统通知 | 6 条 | 后台任务完成提醒不再"洋气" |
| UI 界面文字 | 2314 条翻译 | 启动页、设置、权限弹窗等全面中文化 |
| 防崩降级机制 | 全自动 | 补丁失败自动回滚英文,绝不卡死 Claude Code |
翻译数据全部集中在几个 JSON 文件里,想查证随时可以打开看:
- 完整界面翻译表:cli-translations.json(共 2314 条英译中对照)
- 187 个等待动词:verbs/zh-CN.json
- 41 条等待提示:tips/zh-CN.json
装完后的实际效果大概是这样的——原版还在装模作样地 Photosynthesizing...,现在直接:
⠙ 光合作用中...
💡 按 Shift+Tab 在默认模式、自动接受编辑模式和 Plan 模式之间切换
二、一键安装步骤:5 分钟搞定所有平台
macOS / Linux / WSL:源码安装最省心
git clone https://gitcode.com/gh_mirrors/cl/claude-code-zh-cn
cd claude-code-zh-cn
bash install.sh
Windows:PowerShell 三步走
git clone https://gitcode.com/gh_mirrors/cl/claude-code-zh-cn
cd claude-code-zh-cn
powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1
安装脚本会自动检测你的 Claude Code 安装形态(npm 全局包还是 native 二进制),无需手动选择。安装入口分别是 install.sh 和 install.ps1。
已经在用 Claude Code 插件体系?
也可以走官方 marketplace 流程安装,装好后重启一次 Claude Code,看到"光合作用中"或"思考中"就大功告成!插件规范定义在 plugin/manifest.json 中。
三、会话内无痛切换中英文(0 Token 消耗)
查英文资料、或者遇到疑难 bug 想跟海外社区对齐报错时,完全不需要卸载重装,直接在 Claude Code 输入框里敲:
| 命令 | 效果 |
|---|---|
/chinese(或 /zh) |
瞬间切回中文界面与趣味提示 |
/english(或 /en) |
瞬间切回原汁原味的英文界面 |
底层的 Hook 会在你按下回车时直接拦截处理,毫秒级响应、不消耗任何 token。命令定义可参考 plugin/commands/chinese.md。
四、2314 条翻译背后:四层架构保证"汉化但不搞崩"
Claude Code 的 UI 文字硬编码在一个 13MB 的压缩文件里,硬改很容易把程序改废。项目用分层解耦实现无损汉化:
- Layer 1 原生设置注入:直接写入
settings.json(动词、提示、语言偏好),上游版本更新也不会丢失; - Layer 2 Hook 系统:会话启动和通知弹出时无感注入中文能力;
- Layer 3 插件规范:遵循官方 Plugin 体系挂载标准能力;
- Layer 4 安全 Patch:基于字符串字面量扫描器只改显示文本,绝不误触代码逻辑;永远从原始纯净备份打补丁,拒绝"补丁叠补丁";遇到未适配的新版本会安全降级为英文,保证 Claude Code 永远可用。
补丁核心逻辑见 patch-cli.js,详细支持情况见 docs/support-matrix.md。
五、版本怎么选?看支持矩阵就够了
| 安装形态 | 已验证版本窗口 |
|---|---|
| macOS / Linux / WSL · npm 全局安装 | 2.1.92 - 2.1.112(翻译最完整) |
| macOS · native 二进制(arm64) | 2.1.113 - 2.1.295 内已验证版本 |
| Linux · native 二进制(x64 glibc) | 2.1.220 - 2.1.285 内已验证版本 |
| Windows · npm / native .exe | 2.1.92 - 2.1.112(npm);2.1.113 - 2.1.289(native) |
💡 两个要点:① 想要最完整的翻译,推荐
npm install -g @anthropic-ai/claude-code@2.1.112(2.1.112 实测 1777 处有效 patch);② 高于已验证窗口的新版会先在本机临时副本上翻译并做启动自检,通过后才替换,失败只影响中文覆盖,不影响使用。
完整清单见 docs/support-matrix.md,离线/内网环境安装可参考 docs/offline-install.md。
六、常见问题快速解答
升级后汉化会失效吗? 不会。Layer 1~3 始终常驻生效;Layer 4 检测到新版本会在启动前自动重补丁。即使格式大改导致补丁失败,也会自动回滚为英文,绝不卡死 Claude Code。
界面报 403 / 超时是汉化引起的吗? 不是。插件只负责文案显示,不修改网络、鉴权和 API 请求。这类报错通常是账号风控或代理问题,可用 doctor.sh 辅助排查。
怎么彻底卸载? macOS / Linux / WSL 运行 uninstall.sh,Windows 运行 uninstall.ps1,会从备份完整还原原有文件,不留垃圾。
想自定义动词或提示词? 直接编辑 verbs/zh-CN.json 或 tips/zh-CN.json,重跑一次安装脚本即可。
七、进阶玩法
- Skills 批量汉化:仓库内置 plugin/skill-i18n/ 工具链,可扫描并翻译你的 Skill 描述(默认关闭,显式开启才运行,原文自动备份可随时还原);
- 中文状态机输出样式:plugin/output-styles/chinese.json 让 AI 的输出状态也用中文呈现;
- 翻译质量如何保证? 项目用 tests/translations-schema.test.js 等测试对 2314 条翻译做结构校验,配合 scripts/check-translation-sentinels.js 防止漏翻。
一句话总结:安装一行命令,享受一个说中文的 Claude Code 🎉 从"光合作用中"开始,终端里的每一秒等待都会变得可爱起来。


