Windows 用户必看!claude-code-zh-cn 汉化插件安装完整指南:PowerShell 一键装,native .exe 也支持
Windows 用户必看!claude-code-zh-cn 汉化插件安装完整指南:PowerShell 一键装,native .exe 也支持
claude-code-zh-cn 是一个把 Claude Code 命令行界面彻底变成简体中文的本地化汉化插件:一条 PowerShell 命令即可完成安装,把加载动效、等待提示、耗时统计和系统通知全部变成地道中文,还内置 187 个趣味动词和 2194 条界面翻译。它同时支持 Windows 的 npm 安装 和 native .exe 原生二进制,更新后还能自动修复,绝不让汉化把 Claude Code 搞崩。
一、为什么 Windows 用户需要这个汉化插件 🇨🇳
Claude Code 是很强的终端 AI 编程助手,但官方把整套界面文字硬编码在一个大文件里,短期内看不到官方中文版。装完本插件后,你会看到这样的变化:
⠙ 光合作用中...
💡 按 Shift+Tab 在默认模式、自动接受编辑模式和 Plan 模式之间切换
琢磨了 1分23秒
原版里那些让人看不懂的英文 loading(Photosynthesizing、Moonwalking…)会被翻译成「蹦迪中」「太空步中」这类中式幽默,AI 回复也会默认优先说中文。
💡 核心特性一览
- 一行安装:PowerShell 脚本自动检测安装方式,无需手动选择
- 启动自愈:Claude Code 升级后自动重打汉化补丁
- 安全降级:补丁失败会自动回滚为英文,绝不损坏 CLI
- 随用随切:会话内
/chinese、/english秒切中英文,不消耗 Token
二、安装前准备:确认 Claude Code 版本与安装方式
在动手之前,先搞清楚两件事:
1. 你用的是哪种安装形态?
Windows 上有两种形态,汉化插件都覆盖:
| 平台 / 安装形态 | 已验证版本窗口 | 说明 |
|---|---|---|
| Windows · npm(PowerShell) | 2.1.92 - 2.1.112 |
用 install.ps1,需 PowerShell 5.1+,翻译最完整 |
Windows · native .exe(x64) |
2.1.113 - 2.1.289 内已验证版本 |
需 node-lief,个别版本未收录 |
用
claude --version查看当前版本。如果你用的是官方安装器装的原生程序(native.exe),属于第二行;如果通过npm全局安装,属于第一行。完整已验证清单见 docs/support-matrix.md。
2. 环境要求
- PowerShell 5.1+(Windows 10/11 自带即可)
- Node.js:native
.exe形态需要node-lief依赖,安装脚本会自动检测并提示 - 运行脚本需要能访问
git命令(用于克隆仓库)
三、PowerShell 一键安装步骤 🚀
跟着下面三步走,全程只需复制粘贴:
第 1 步:克隆仓库
打开 PowerShell(Win+X → 终端 / PowerShell),执行:
git clone https://gitcode.com/gh_mirrors/cl/claude-code-zh-cn.git
cd claude-code-zh-cn
第 2 步:运行安装脚本
powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1
脚本会自动完成这些事:
- 检测你当前是 npm 还是 native
.exe安装 - 合并中文设置到
%USERPROFILE%\.claude\settings.json - 把插件挂载到
%USERPROFILE%\.claude\plugins\claude-code-zh-cn - 安装
claude启动器(用于更新后自动修复) - 对 native
.exe执行安全补丁(仅显示文本,不动代码逻辑)
安装入口脚本见 install.ps1,其中注入的中文配置来自 settings-overlay.json。
第 3 步:重启 Claude Code
装完重启一次 Claude Code,看到「光合作用中」「思考中」等中文,就说明大功告成!
四、native .exe 也支持:Windows 原生二进制汉化说明 🔧
很多 Windows 用户通过官方安装器装的是原生 .exe 程序(而非 cli.js)。好消息是:claude-code-zh-cn 也支持对这类 native .exe 做安全汉化。
工作原理(对应 docs/plans/2026-05-26-windows-native-support.md 的实现方案):
- 提取:从
.exe中抽出内嵌的 Claude JS - 翻译:跑现有的字符串安全补丁,只改显示文案
- 写回:通过
node-lief把翻译后的数据重新打包回 PE 格式的.exe
Windows 特有的两点要知道:
- 🔒 不热改运行中的 exe:Windows 无法在程序运行时替换文件。所以汉化插件采用「启动器」机制——补丁记录在后台,等你下次启动时自动生效。
- 🔄 更新后自动修复:Claude Code 更新后,先保持原版可用;你只需关闭所有 Claude Code 窗口,再通过已安装的
claude启动器重新启动,它会重新打补丁并自检,无需重装。
⚠️ native
.exe已验证窗口为2.1.113 - 2.1.289,部分版本未收录。完整清单以 docs/support-matrix.md 为准;版本窗口数据见 plugin/support-window.json。
五、验证安装成功:如何确认汉化已生效 ✅
装完别急,用下面方法确认:
方法一:直接看界面。 启动 Claude Code,加载时若出现「思考中」「蹦迪中」等中文动词,说明成功。
方法二:跑诊断脚本。 仓库自带一键体检,会给出可执行的下一步建议:
powershell -NoProfile -ExecutionPolicy Bypass -File doctor.ps1
诊断脚本入口见 doctor.ps1。它输出的 languageMode=zh-CN、各层状态等信息可帮助你判断汉化覆盖情况(部分界面为「部分汉化」,动态组合文案可能仍显示英文,属正常边界)。
方法三:检查帮助页。 运行 claude --help,若帮助文本显示中文,说明界面补丁已生效。
六、会话内中英文切换(0 Token 消耗)⚡
查英文资料、或想跟海外社区对齐报错时,完全不用卸载重装!直接在 Claude Code 输入框输入:
| 命令 | 效果 |
|---|---|
/chinese(或 /zh) |
切回中文界面与趣味提示 |
/english(或 /en) |
切回原汁原味的英文界面 |
底层 Hook 在输入时直接拦截处理,毫秒级响应,不消耗任何 token。
七、常见问题 FAQ
Q1:Claude Code 升级后汉化会失效吗?
不会搞坏环境。动词、提示、语言偏好这些基础能力始终常驻生效;native .exe 的界面补丁在检测到新版本时,会在你下次通过启动器启动前自动重新打补丁。即便遇到格式大改的新版,补丁失败也会自动回滚为英文,绝不卡死 Claude Code。
Q2:界面报错(403 / 超时 / 空响应)是汉化引起的吗?
不是。本插件只负责文案显示,不修改任何网络代理、鉴权或 API 请求。这类报错通常是账号风控、网络代理或第三方中转服务波动,可用 doctor.ps1 辅助排查。
Q3:可以自己改动词或提示词吗?
可以!直接编辑 verbs/zh-CN.json(动词)或 tips/zh-CN.json(等待提示),再重跑一次安装脚本即可。
Q4:想彻底卸载 / 恢复英文怎么办?
在克隆的源码目录运行卸载脚本即可,它会从备份完整还原原有文件,不留垃圾:
powershell -NoProfile -ExecutionPolicy Bypass -File uninstall.ps1
卸载入口见 uninstall.ps1;如需更彻底的本地回退,仓库还提供 rollback-local.ps1。
八、总结
| 项目 | 说明 |
|---|---|
| 适用系统 | Windows(npm 与 native .exe 双形态) |
| 安装方式 | PowerShell 一行脚本,自动检测安装形态 |
| 中文化程度 | npm 最完整;native .exe 已验证版本可用 |
| 更新处理 | 启动器自动重打补丁 + 自检,失败安全回滚英文 |
| 语言切换 | 会话内 /chinese / /english 秒切,0 Token |
照着「克隆 → 运行 install.ps1 → 重启」三步,你的 Claude Code 就能在 Windows 上丝滑说中文了。如果后续遇到 native 版本的汉化边界问题,可以进一步参考 docs/windows-2.1.289-local-validation.md 了解各版本实机验证情况。
本项目非 Anthropic 官方产品,仅供学习参考。


