如果你和我一样把 Claude Desktop 当日常主力工具用大概率早就在琢磨中文汉化这件事了。Claude Desktop 的界面做得干净但默认只有英文对习惯中文界面的用户来说光是侧边栏的 New Chat、Settings、My Workspace 这几个词就够让人每次多反应半秒。这篇教程把我实测走过的完整流程、踩过的坑、以及不同版本下通用的排查方法都整理出来照着走基本能把主要界面改成中文。适合愿意自己动手折腾配置文件的 Claude Desktop 用户也适合想顺便理解 Electron 应用汉化原理的开发者参考。另外提醒一句这里说的是桌面客户端不是命令行版本的 Claude Code两者改法完全不同。1. 为什么Claude Desktop默认只有英文界面Electron应用的语言机制先说结论Claude Desktop 是一个 Electron 应用它的界面不是用传统 Windows API 画出来的而是用 HTML、CSS、JavaScript 在 Chromium 内核里渲染出来的。这个前提决定了它的汉化思路跟以前汉化 Office、Photoshop 完全不一样。1.1 传统汉化工具为什么在 Claude Desktop 上失灵很多老玩家第一反应是拿出 Resource Hacker 或者 PE 编辑器去改资源段。这些工具对原生 Win32 程序有效因为它们把菜单、对话框字符串放在 PE 文件的资源表里。但 Electron 应用的资源表里几乎只有图标和版本信息界面文字都在 app.asar 这个打包文件内部本质上是网页脚本。所以你要是拿 Resource Hacker 打开 Claude Desktop 的主程序能看到的东西非常有限改了也没用。汉化 Claude Desktop 的正确思路只有一个方向去修改它资源包里的语言文件或者渲染脚本让网页层渲染出来的文字变成中文。听起来麻烦但只要理解了结构操作难度其实比传统汉化还要低因为 HTML 和 JSON 都是明文不需要反编译。1.2 语言开关的读取顺序Electron 应用决定用哪种语言显示通常按这个顺序启动参数 --lang 大于操作系统区域设置大于应用内配置文件最后才是代码里的默认语言。Chromium 内核会把这个语言值暴露给网页层React 组件再根据语言值去 i18n 资源里找对应语言的翻译文本。这里有个关键点如果资源里压根没有中文翻译那不管你系统语言设成什么界面都只会退回英文。这就是为什么“把 Windows 显示语言改成中文”这一招对 Claude Desktop 基本无效——不是它不识别中文系统而是它没带中文语言包。明白了这一点汉化路线就很清楚了要么想办法让应用加载一张它自带但没启用的中文翻译表要么直接把应用里的英文文本替换成中文。下面我会把两条路的实操都写出来。2. 汉化前的准备工具清单、文件定位与备份2.1 需要准备的工具清单先说工具别嫌多其实都是免费的工具用途获取方式Node.js LTS运行 asar 解包/打包命令nodejs.org 官网下载npxNode 自带调用 electron/asar 工具安装 Node.js 后自带VS Code 或 Notepad搜索和编辑解包后的文件官网下载7-Zip应急备用查看包内容官网下载Node.js 装的时候一路默认就行安装完在 PowerShell 里输入node -v能输出版本号就说明 OK。后面所有解包打包命令都通过 npx 调用 electron/asarnpx 会临时下载工具不需要你手动全局安装。2.2 找到Claude Desktop的安装目录和app.asarWindows 上最常见的安装路径是这两个之一用户级安装C:\Users\你的用户名\AppData\Local\Programs\claude-desktop\系统级安装C:\Program Files\Claude Desktop\或类似目录最稳妥的办法是在桌面或开始菜单找到 Claude Desktop 的快捷方式右键选择“打开文件所在位置”进入安装目录后找到resources文件夹里面那个app.asar就是我们要动的主角。如果你装的是 macOS 版路径通常是/Applications/Claude.app/Contents/Resources/app.asarLinux 版一般在/opt/Claude/resources/app.asar。下面以 Windows 为例其他系统的原理相同命令也完全一样。2.3 备份与恢复策略动手前一定先把 app.asar 复制一份到别处比如D:\backup\app.asar.bak。整个汉化流程里最坏的情况就是应用打不开只要把这个备份文件复制回去就能还原。另外我建议把整个resources目录也看一眼如果里面有app-update.yml之类的更新配置后面第 5 节讲自动更新覆盖时会用到。这里有个容易被忽略的细节替换文件之前一定要先把 Claude Desktop 彻底退出包括系统托盘里可能残留的图标否则文件被占用替换会失败或者替换不完整。3. 核心汉化流程从解包到中文语言包注入再到重新打包3.1 用 asar 解包在resources目录下打开 PowerShell建议用管理员权限运行npx electron/asar extract app.asar app_unpacked执行完之后resources目录下会多出一个app_unpacked文件夹里面就是解开的所有资源文件。如果你看到一堆 JS 文件和 HTML 模板不用慌这就是 Electron 应用的正常结构。解包只读不写所以这一步失败的概率很低。常见报错是权限不足用管理员身份重开 PowerShell 就行。3.2 定位语言资源用字符串搜索判断属于哪种情况这是整个汉化流程里最关键的一步。不同版本的 Claude Desktop 内部结构不完全一样与其背路径不如学会自己判断。用 VS Code 打开app_unpacked文件夹按CtrlShiftF全局搜索一个你界面上最显眼的英文词比如New chat或者Settings。根据搜索结果基本就三种情况情况特征汉化方案A搜索结果出现在.json文件里且能看到 en-US 之类的键值对走 i18n 资源文件方案加一个 zh-CN.json 最省事B搜索结果出现在.js文件里是打包后的组件代码走字符串替换方案替换显示文本C搜索不到任何结果文案可能是远程动态加载本地汉化覆盖有限考虑外挂翻译我实测的版本属于 A 和 B 混合的情况主体界面文案在语言资源文件里少量动态拼接的短语在 JS 里。所以下面的操作我会把 A、B 两种方案都讲一遍。3.3 方案A给应用补一张中文语言包如果你在解包后的目录里找到了类似locales、i18n、translations这样的文件夹里面一般放着en-US.json或者其他语言文件。操作分两种情况里面已经存在zh-CN.json那说明官方其实做了中文翻译只是没启用。这时你只需要在第 4 节用启动参数--langzh-CN强制启用即可连文件都不用改。里面只有英文或其他语言复制一份en-US.json重命名为zh-CN.json然后用 VS Code 打开把 value 部分翻译成中文。注意只改冒号右边的 value不要动键名键名是代码里引用的 ID动一个就全乱。翻译量如果很大不建议一个人硬翻。先翻译最常用的几十个键比如侧边栏、设置页、会话操作相关的剩下不常用的可以暂时保留英文界面照样能正常用。3.4 方案B替换 JS 里的硬编码显示文本如果没有语言资源文件或者某些短语硬编码在组件里就需要对 JS 文件做精确替换。我写了一个 Node.js 脚本放在解包目录的上一级运行// replace-ui-strings.js const fs require(fs); const path require(path); const dict { New chat: 新建对话, Settings: 设置, Search: 搜索, Copy: 复制, Delete: 删除, }; function walk(dir) { const entries fs.readdirSync(dir, { withFileTypes: true }); for (const entry of entries) { const full path.join(dir, entry.name); if (entry.isDirectory()) { walk(full); } else if (full.endsWith(.js) || full.endsWith(.mjs)) { let text fs.readFileSync(full, utf8); const before text; for (const [from, to] of Object.entries(dict)) { text text.split(from).join(to); } if (text ! before) { fs.writeFileSync(full, text, utf8); console.log(已处理: full); } } } } walk(./app_unpacked);这里必须强调三个注意事项字典里的键我特意带了英文引号比如New chat就是为了尽量匹配“用户看得到的文本”减少误伤代码里的变量名或 CSS 类名。如果某个词既是显示文本又是内部 key宁可先跳过或者在关键字前面加上更长的上下文去匹配比如aria-label: New chat这种完整写法。替换完成后压缩后的 JS 文件不会因为文本边长变短而损坏JavaScript 字符串本身就是动态长度的这点不用担心。脚本跑完之后控制台会打印所有改动过的文件核对一下数量是否符合预期。3.5 重新打包并验证改动完成后回到resources目录运行npx electron/asar pack app_unpacked app.asar这一条会把修改后的app_unpacked重新打包成 app.asar。打包完成后先别急着启动把原来备份的 app.asar 留着然后启动 Claude Desktop 看看界面。如果正常进入界面说明核心流程已经走通。如果白屏或者闪退直接关掉应用把备份的 app.asar 复制回去恢复原状再回头检查是不是脚本替换到了不该动的地方。4. 让应用真正加载中文启动参数、入口修改与缓存清理4.1 为什么改完文件还是英文locale 的优先级很多人在第 3 节做完后重启应用发现界面还是英文就开始怀疑教程有问题。其实不是问题通常出在语言选择的优先级上。Electron 应用在启动时会先读--lang参数再读系统区域设置最后才轮到资源文件。如果你的系统不是中文环境应用可能仍然按英文区域去加载 en-US。所以汉化文件只是必要条件让应用“选择中文”才是最后的临门一脚。4.2 修改快捷方式与其他启动入口在桌面或开始菜单找到 Claude Desktop 快捷方式右键选择“属性”切到“快捷方式”选项卡在“目标”栏的引号外面加上一个空格和参数--langzh-CN比如原来目标栏是C:\Users\你的用户名\AppData\Local\Programs\claude-desktop\Claude.exe改完之后是C:\Users\你的用户名\AppData\Local\Programs\claude-desktop\Claude.exe --langzh-CN如果你的 Claude Desktop 是通过开始菜单磁贴或者系统自启动项启动的也要把那些入口的启动参数一起改掉否则不同的入口会表现得不一样。4.3 清理用户数据目录的缓存Electron 应用会把渲染进程的缓存写在用户数据目录里常见位置是C:\Users\你的用户名\AppData\Roaming\Claude或者%USERPROFILE%\.claude。改完语言文件后如果不清理缓存有时候界面上还会残留旧的英文渲染结果。建议这样操作彻底退出应用进入用户数据目录把Cache和GPUCache这两个文件夹删除它们会自动重建然后重新打开应用。这一步不影响你的聊天记录和登录状态可以放心做。5. 实测踩坑记录常见问题、排查链路与解决办法5.1 自动更新把汉化覆盖掉这是汉化用户最头疼的一件事。Claude Desktop 默认开启自动更新每次更新都会重新下载完整的 app.asar你辛辛苦苦改好的中文界面一夜回到解放前。目前没有官方开关能一键关闭自动更新实际操作中有几种做法把安装目录里负责更新的可执行文件改名让更新程序无法运行或者在下次更新时留意版本号更新完重新跑一遍第 3 节的脚本。我个人是写了一个补丁脚本每次更新后双击一下就能重新注入比手动返工省事得多。不过要提醒一句关闭自动更新意味着也会错过安全修复如果你经常用这个应用处理敏感信息建议谨慎权衡定期手动检查新版。5.2 右键菜单和系统弹窗仍是英文汉化完成后你可能发现应用主界面是中文了但右键菜单、文件选择框、部分系统级弹窗还是英文。这些控件的文字来自 Chromium 内核自带的语言包和 app.asar 里的应用文案是两套东西。要让这些系统级菜单也变中文需要确认安装目录resources文件夹旁边的locales文件夹里有没有zh-CN.pak文件。正常情况下 Electron 应用会随包分发 Chromium 的多语言文件如果有右键菜单会自动跟随系统中文如果没有可以从同版本 Chrome 的安装目录复制一个过去但不同版本之间可能不兼容复制前记得备份。5.3 重打包后白屏或闪退完整排查链路这个坑我踩过把排查链路完整写出来现象确认双击应用后进程起来但窗口白屏或者一闪而过没有任何提示。第一步恢复先退出应用把备份的 app.asar 复制回去确认是不是改动造成的。如果恢复后正常说明问题出在改动内容上。第二步检查编码用 Notepad 打开被脚本改过的 JS 文件确认保存编码是 UTF-8 无 BOM。带 BOM 的编码会让 ES6 模块解析直接报错这是白屏的高频原因。第三步定位字典把我上面脚本里的 dict 缩小到只有一条记录重新打包测试。如果单条替换没问题再逐条增加直到定位到出问题的那个词。第四步检查语法用 Node 直接对改过的核心 JS 文件做语法检查比如node --check 文件名.js报错会提示具体行号。原因其实就三个脚本误伤关键代码、编码被改动、打包时app_unpacked目录里有残留临时文件。按这个顺序排查基本十分钟内能找到问题。5.4 中文显示成方框的字体问题少数情况下中文替换进去之后界面上显示的是一排排方框这是因为应用渲染时用的字体栈里没有中文字体Chromium 的字体回退机制又没有正确工作。解决思路是给应用注入一条 CSS 规则强制全局字体使用微软雅黑或思源黑体。在解包目录里找到入口 HTML 文件在head里加一行style body, button, input, textarea, div, span { font-family: Microsoft YaHei, PingFang SC, Noto Sans CJK SC, sans-serif; } /style重新打包即可。这个操作只在遇到方框问题时才需要多数 Windows 系统默认字体回退是正常的。6. 不想动安装包的替代方案外挂翻译与本地方案怎么选6.1 外挂翻译工具的原理与优缺点如果你不想承担改坏安装包的风险或者发现界面文案是从云端动态加载的、本地根本改不到那只能走外挂翻译的路子。这类工具的基本原理是对屏幕区域做文字识别把识别出的英文翻译成中文后再叠加上去显示相当于给应用加了一层“实时字幕”。这类方案的优点是不侵入安装文件应用怎么升级都不影响缺点是翻译会有延迟识别位置偶尔会偏移碰上深色主题或者自定义字体时识别率会下降而且它本质上是在翻译显示层不是真正改变应用语言。6.2 我的建议按使用频率选方案如果你只是偶尔打开 Claude Desktop 看看对话外挂翻译完全够用没必要折腾安装包如果你和我一样把它当日常主力工具每天开八个小时那还是花半小时做一次认真的汉化更值得长痛不如短痛。我个人现在的做法是主用汉化版把补丁脚本存在一个固定目录每次应用更新后跑一遍再配合用户数据目录的缓存清理整个过程不超过两分钟。这套流程我前后在不同版本上验证过核心思路一直没变过遇到新版本最多就是搜索关键词和资源文件位置有变化按第 3.2 节的方法重新定位一遍就能继续用。
