Claude Code 终于说中文了!claude-code-zh-cn 汉化插件终极入门指南:2314 条翻译一次看懂

原创2026-10-28 03:41:272,643 阅读
文章标签:开发工具国际化CLI插件系统AI 插件

Claude Code 终于说中文了!claude-code-zh-cn 汉化插件终极入门指南:2314 条翻译一次看懂

claude-code-zh-cn 是一个为 Claude Code CLI 打造的简体中文本地化插件:一行命令安装后,终端界面、等待提示、回复耗时、系统通知全部变成地道中文,还会把官方那些放飞自我的 loading 动词翻成"蹦迪中""七荤八素中"之类的中式幽默。支持 macOS、Linux、WSL 与 Windows,升级后还能自动修复,绝不弄坏你的 CLI。

claude-code-zh-cn 汉化效果演示动图,展示 Claude Code 终端中文界面

一、这个汉化插件到底改了什么?

很多人以为"汉化"只是翻译几个按钮文字。claude-code-zh-cn 的覆盖范围比这大多了:

功能模块 规模 你能看到的效果
AI 回复偏好 默认中文 AI 回答默认用简体中文
Spinner 等待动词 187 个 Thinking → 思考中、Boogieing → 蹦迪中
Spinner 等待提示 41 条 Shift+Tab 等快捷键提示全部中文
系统通知 6 条 后台任务完成提醒不再"洋气"
UI 界面文字 2314 条翻译 启动页、设置、权限弹窗等全面中文化
防崩降级机制 全自动 补丁失败自动回滚英文,绝不卡死 Claude Code

翻译数据全部集中在几个 JSON 文件里,想查证随时可以打开看:

装完后的实际效果大概是这样的——原版还在装模作样地 Photosynthesizing...,现在直接:

⠙ 光合作用中...
💡 按 Shift+Tab 在默认模式、自动接受编辑模式和 Plan 模式之间切换

Claude Code 中文界面截图,显示"欢迎回来!"等已汉化的终端文字

二、一键安装步骤: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-zh-cn 分享卡片,展示一行安装命令与"光合作用中"等中文效果

已经在用 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 的压缩文件里,硬改很容易把程序改废。项目用分层解耦实现无损汉化:

  1. Layer 1 原生设置注入:直接写入 settings.json(动词、提示、语言偏好),上游版本更新也不会丢失;
  2. Layer 2 Hook 系统:会话启动和通知弹出时无感注入中文能力;
  3. Layer 3 插件规范:遵循官方 Plugin 体系挂载标准能力;
  4. 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,重跑一次安装脚本即可。

七、进阶玩法

一句话总结:安装一行命令,享受一个说中文的 Claude Code 🎉 从"光合作用中"开始,终端里的每一秒等待都会变得可爱起来。

登录后查看全文
claude-code-zh-cn