一键将 Claude Desktop Windows 版界面汉化为简体中文。新版脚本会自动发现当前安装的 Claude Desktop 版本,扫描资源文件并应用稳定补丁,不再依赖固定版本号或 JS 文件名哈希。
- 完全退出 Claude Desktop(包括系统托盘里的 Claude)。
- 可先运行
兼容性检测.bat,确认当前 Claude 版本的资源结构和关键补丁是否可用。 - 右键
汉化应用.bat,选择以管理员身份运行。 - 重新打开 Claude Desktop,在设置里选择中文。
需要恢复英文界面时,右键 汉化回滚.bat 并以管理员身份运行。
脚本会扫描 C:\Program Files\WindowsApps\Claude_*,选择包含 app\resources\app.asar、ion-dist\i18n 和 ion-dist\assets\v1 的最新安装版本。也可以在 config.json 的 installDiscovery.manualInstallRoot 中手动指定 app\resources 目录。
Runtime 补丁来自 patches/main-ui-patches.json。补丁规则只包含稳定的 find / replace 文本,不要求指定 bundle 文件名;应用时会遍历所有 JS/CSS 资源并报告命中、已应用和未命中数量。关键补丁未命中时脚本会停止并提示需要维护,避免静默写坏未知版本。
额外的可见界面文案翻译来自 locales/runtime-zh-CN.translations.json。脚本会把这个人工确认的翻译表自动转换成 defaultMessage、label、title、placeholder 等运行时补丁,用来覆盖设置页、按钮、提示、侧边栏等没有进入官方 locale 文件的英文。
还有英文残留时,运行:
powershell -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\scripts\scan_missing.ps1它会生成 locales\missing-zh-CN.json 缺失汉化清单,列出可见英文候选、来源文件和待填写的 translation 字段。确认翻译后,优先把稳定条目整理进 locales/runtime-zh-CN.translations.json;只有需要特殊精确匹配时,再放进 patches/main-ui-patches.json。
scripts/detect_install.ps1:检测当前 Claude Desktop 版本和资源路径。scripts/diagnose_compatibility.ps1:生成兼容性报告,判断当前版本是否建议应用。scripts/apply_localization.ps1:备份、复制中文资源、应用 runtime 补丁并生成兼容报告。scripts/verify_localization.ps1:验证关键补丁是否命中或已应用。scripts/rollback_localization.ps1:按最近一次备份回滚。scripts/scan_missing.ps1:生成缺失汉化清单。
应用前会备份原始 locale、JS/CSS 和对应 .zst 文件。对被修改的 JS/CSS,如果存在 .zst 缓存,脚本会改名为 .bak,让 Claude 加载明文补丁文件;回滚脚本会恢复最近一次备份。