claude-localize

Installation
SKILL.md

Claude Desktop 中文汉化 (claude-localize)

把本机安装的 Claude Desktop 桌面客户端汉化为简体中文,并可随时恢复英文原版。

核心理念是自适应。 Claude Desktop 更新非常频繁,写死路径和正则的工具每次更新都会失效。本 skill 改为运行时探测:先读当前安装版本的 i18n 目录结构、语言加载机制和翻译覆盖率,再决定怎么打补丁。所以即使 Claude 改了内部结构,你(运行本 skill 的 Claude)也能现场判断、调整,而不是盲目套用旧步骤。

目前实现:macOS。Windows 见 references/windows.md(规划中)。

它怎么工作(为什么这么做)

Claude Desktop 的界面文案分两层:

  1. 前端 UI(Electron 渲染层):文案在 Contents/Resources/ion-dist/i18n/{locale}.json,key 是英文原文的哈希。运行时按当前 locale 动态加载对应文件。因为 key 是内容哈希,所以只要英文原文没变,旧译文就还能对上——这让"内置精校译文 + 只翻新增"成为可能。
  2. 桌面/原生层(菜单、托盘、原生弹窗):在 Contents/Resources/{locale}.json 和 {locale}.lproj/Localizable.strings。

汉化的关键有三点(细节见 references/mechanism.md):

  1. 把中文译文写进 app 真正加载的 locale 文件。 实际生效的 locale 由账号/服务端决定(登录英文账号时常是 en-US),而且 app 会把它回写进 config.json——所以光设 config.locale=zh-CN 不管用、会被覆盖。因此本 skill 直接覆盖 en-US.json(以及 zh-CN.json/zh.json),未译 key 仍回退英文;原始英文存为 en-US.original.json 以备恢复与重复打补丁。
  2. 必须开启 Claude 的开发者模式(Settings → Developer)。否则 app 可能加载远程 claude.ai 网页版,本地译文文件根本不会被读取。
  3. 桌面/原生层:写 Contents/Resources/zh-CN.json 和 .lproj/Localizable.strings。
Installs
3
GitHub Stars
38
First Seen
Jul 7, 2026