Windows 用户必看!claude-code-zh-cn 汉化插件安装完整指南:PowerShell 一键装,native .exe 也支持

原创2026-10-27 21:51:461,834 阅读
文章标签:开发工具国际化CLI插件系统AI 插件

Windows 用户必看!claude-code-zh-cn 汉化插件安装完整指南:PowerShell 一键装,native .exe 也支持

claude-code-zh-cn 是一个把 Claude Code 命令行界面彻底变成简体中文的本地化汉化插件:一条 PowerShell 命令即可完成安装,把加载动效、等待提示、耗时统计和系统通知全部变成地道中文,还内置 187 个趣味动词和 2194 条界面翻译。它同时支持 Windows 的 npm 安装 和 native .exe 原生二进制,更新后还能自动修复,绝不让汉化把 Claude Code 搞崩。

claude-code-zh-cn 汉化插件让 Claude Code 终端界面显示中文效果


一、为什么 Windows 用户需要这个汉化插件 🇨🇳

Claude Code 是很强的终端 AI 编程助手,但官方把整套界面文字硬编码在一个大文件里,短期内看不到官方中文版。装完本插件后,你会看到这样的变化:

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

原版里那些让人看不懂的英文 loading(Photosynthesizing、Moonwalking…)会被翻译成「蹦迪中」「太空步中」这类中式幽默,AI 回复也会默认优先说中文。

claude-code-zh-cn 简体中文汉化插件终端分享卡片,展示一行安装与中文动效

💡 核心特性一览

  • 一行安装: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,看到「光合作用中」「思考中」等中文,就说明大功告成!

claude-code-zh-cn 汉化后 Claude Code 欢迎页显示中文「欢迎回来」与更新内容


四、native .exe 也支持:Windows 原生二进制汉化说明 🔧

很多 Windows 用户通过官方安装器装的是原生 .exe 程序(而非 cli.js)。好消息是:claude-code-zh-cn 也支持对这类 native .exe 做安全汉化。

工作原理(对应 docs/plans/2026-05-26-windows-native-support.md 的实现方案):

  1. 提取:从 .exe 中抽出内嵌的 Claude JS
  2. 翻译:跑现有的字符串安全补丁,只改显示文案
  3. 写回:通过 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 官方产品,仅供学习参考。

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