claude-desktop-zh-cn README

The project's README from github.com/javaht/claude-desktop-zh-cn. As one markdown file: README.md.

Claude Desktop 中文补丁

一个用于 Claude Desktop 的本地中文界面补丁,支持简体中文、繁体中文(中国台湾)和繁体中文(中国香港)。

macOS 双击 install-mac.command;Windows 双击 install-windows.bat 后按 UAC 提示授权。脚本会给 Claude Desktop 添加中文语言选项并安装中文界面资源。

本项目支持官方账号和第三方 API,但不同安装模式覆盖的界面与 Cowork 兼容性不同,请先阅读下方的模式说明。第三方 API 配置可参考 这篇教程。

赞助商

点击折叠
Weaves API 感谢 Weaves API 对本项目提供的赞助!Weaves API 是一家可靠高效的 API 服务提供商,为 Claude Code、Codex 等平台提供中转服务。Weaves API 为我们的软件用户提供专属折扣:使用此链接注册并加入用户服务群,即可赠送 5 刀体验金。

遇到问题请及时反馈,欢迎扫码加入 claude desktop 交流。

claude desktop 交流群二维码

界面截图

Claude Desktop 中文界面截图 Claude Desktop 中文设置界面截图

功能特点

适用环境

使用方式

macOS

  1. 退出 Claude Desktop。
  2. 下载或克隆本项目。
  3. 双击 install-mac.command,选择操作:
    • 1 完整补丁:支持官方账号和第三方 API;会修改 app.asar,包含在线页面 DOM 汉化、在线语言锁定、第三方模型名校验绕过和 app.asar 内模型选择器汉化。此模式不适合依赖 Cowork 沙箱/工作区的场景。
    • 2 跳过结构性 app.asar 补丁:仍会安装中文资源、注册中文语言、汉化前端 bundle,并对少量主进程菜单做等长替换;不会注入在线页面 DOM 汉化,不会绕过第三方模型名校验,也不会修改 app.asar 内模型选择器。此模式仍会对应用做本机 ad-hoc 重签名,不承诺 Cowork 可用。
    • 3 Frida 运行时汉化启动(实验):不写磁盘 app.asar、不复制官方包到其他路径;用 Frida 内存补丁 + CDP 注入。在 SIP 仍开启时,会就地对 /Applications/Claude.app 做 ad-hoc 重签名(加 get-task-allow、去掉 Hardened Runtime),否则 Frida 无法 attach。账号模式跟随客户端原有配置。需要本机允许写入 /Applications/Claude.app 的签名,不能当普通用户的通用安装方式。
    • 4 恢复原样 / 卸载补丁。
    • 5 自动更新设置:输入 y 禁止自动更新,输入 n 允许自动更新。
    • 6 CC Switch skills 同步:输入 y 同步,输入 n 删除之前的同步。
  4. 选择安装后,脚本会先恢复已有旧备份以清理上一轮补丁;没有旧备份时会直接继续。
  5. 选择语言:1=简体中文,2=繁体中文(中国台湾),3=繁体中文(中国香港)。
  6. 按提示输入 Mac 登录密码(选项 1/2/4/5)。安装完成后 Claude 会自动重新打开。
  7. 如果没有自动切换,打开左下角账号菜单,选择 Language -> 对应的中文选项。

CC Switch skills 同步会扫描 ~/.cc-switch/skills 下包含 SKILL.md 的目录,只为 Claude Desktop 中不存在的同名 skill 创建软链接并更新 skills manifest。取消同步只删除由该目录同步出的软链接和对应记录,不删除 CC Switch 源目录。

macOS 汉化后的自动更新

汉化会对应用做本机 ad-hoc 重签名。从 2026-08 版本起,重签时会显式写入 identifier 级别的 designated requirement(替代默认的 cdhash 级别),因此 Claude Desktop 的官方自动更新下载后可以正常安装,不会再卡在“下载完成但版本不变”。注意两点:

Windows

  1. 退出 Claude Desktop。
  2. 下载或克隆本项目。
  3. 双击 install-windows.bat;脚本会复制安装文件到当前用户的临时目录,并弹出 UAC 管理员授权窗口。
  4. 先选择安装模式:
    • 1 Cowork 兼容 / 第三方 API 模式:跳过 app.asar 和 Claude.exe 内嵌完整性哈希修改;仍会安装中文资源、注册中文语言并汉化前端 bundle。在线账号页面中依赖 DOM 注入的文本不会被覆盖,第三方模型需在网关或 CC Switch 中映射为 Claude/Anthropic 风格名称。
    • 2 官方账号在线汉化模式:修改 app.asar 并同步改写 Claude.exe 内嵌完整性哈希,补充在线页面 DOM、主进程菜单和模型选择器汉化。该操作会使 Claude.exe 的 Authenticode 签名变为 HashMismatch,Cowork 沙箱/工作区可能拒绝启动。
    • 3 Frida 运行时汉化(实验):不修改磁盘上的 app.asar / Claude.exe;用 Frida 内存补丁 + CDP 注入在线页 DOM 中文。若本机没有 Python+frida,会提示下载便携运行时到 %LOCALAPPDATA%\claude-zh\runtime(仅本工具使用,不改系统 Python)。可选注册/卸载用户登录常驻;卸载常驻时可选择同时删除便携运行时。需要本机允许 Frida 注入,不能当普通用户的通用安装方式。
    • 在模式 1/2 与模式 3 之间切换时,安装器会先停用旧的 Frida 常驻任务,避免常驻 watcher 接管并重启磁盘补丁模式的 Claude;便携运行时会保留,之后重新选择模式 3 会刷新并复用。
    • 4 恢复原样 / 卸载补丁。
    • 5 自动更新设置:输入 y 禁止自动更新,输入 n 允许自动更新。
    • 6 CC Switch skills 同步:输入 y 开启同步,输入 n 删除之前的同步。
  5. 选择安装中文补丁时,脚本会先尝试从旧备份恢复来清理已有汉化;如果没有旧备份,会提示跳过并继续。
  6. 选择语言:1=简体中文,2=繁体中文(中国台湾),3=繁体中文(中国香港)。
  7. 脚本会备份被修改的文件、写入中文资源并重启 Claude Desktop。如果没有自动切换,打开左下角账号菜单,选择 Language -> 对应的中文选项。

文件说明

macOS 脚本会做什么

Windows 脚本会做什么

卸载 / 恢复

执行对应平台的安装入口并选择 3。macOS 会恢复 /Applications 下最早的 Claude.backup-before-zh-CN-*.app 并删除其他补丁备份;Windows 会恢复备份文件、删除三种中文资源并把用户语言设置恢复为 en-US。

注意事项

Star History

Star History Chart

免责声明

本项目为非官方中文补丁,会修改本机 Claude Desktop 的资源文件及相关本地配置,不会修改 Claude 服务端账号数据。Claude Desktop 更新后资源结构可能变化;若补丁失败,请先恢复原版应用并更新本项目,不要在安装未完成的状态下反复运行脚本。

claude-desktop-zh-cn (javaht/claude-desktop-zh-cn)

i18n
Searching Database…

What is this?An unofficial patch that adds a Chinese interface to the Claude Desktop app: Simplified Chinese (zh-CN), Traditional Chinese for Taiwan (zh-TW) and Hong Kong (zh-HK), on macOS, Windows and Linux.
Is this a separate app, or does it modify my existing Claude Desktop?Not a separate app — a set of installer scripts that patch your existing Claude Desktop: they back up the original files, copy in Chinese language resources and register the language in the app's whitelist.
What needs to be on my machine beforehand?Claude Desktop itself must already be installed. macOS needs a working Python 3 (the script prefers /usr/bin/python3); Windows only needs its built-in PowerShell, and the installer asks for admin rights.
Will a Claude Desktop update wipe the Chinese interface?Yes — updates overwrite the patched files, so the safe cycle is restore the original, update Claude Desktop, then re-apply the newest patch. Full modes also break the app's code signature, which can make the Cowork sandbox refuse to start.
What is the difference between the install modes?Full/official mode also edits app.asar: it translates the claude.ai online pages via DOM injection, localizes the model picker and bypasses validation of third-party gateway model names, but can break Cowork. The mode that skips structural app.asar changes keeps Cowork working but skips online-page translation.
Can I undo the patch and go back to English?Yes — run the same installer and choose the restore/uninstall option. macOS restores the earliest 'Claude.backup-before-zh-CN-*.app' backup; Windows restores the backed-up files, removes the Chinese resources and resets the language to en-US.
Does it work with third-party API accounts?Yes, the patch supports both official accounts and third-party APIs. On macOS the full mode even bypasses Claude Desktop's local Anthropic check on third-party gateway model names like 'deepseek-v4-pro' or 'kimi-', which would otherwise invalidate the whole config.
What is the experimental Frida mode?A launch option that translates Claude in memory at runtime with a Frida patch plus CDP injection instead of modifying app.asar on disk. It is experimental — on macOS it re-signs the app with debug permissions even with SIP on, so it is not meant as a general-purpose install.
Creator
javaht
Size
16.9 MB
Stars
7.7K
Age
5mo
Commits · 90 Days