Claude Desktop 中文补丁

一个用于 Claude Desktop 的本地中文界面补丁，支持简体中文、繁體中文（台灣）和繁體中文（香港）。

macOS 双击 install-mac.command；Windows 双击 install-windows.bat 后按 UAC 提示授权；Linux（deb 包安装）在终端运行 ./install-linux.sh。脚本会给 Claude Desktop 添加中文语言选项并安装中文界面资源。

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

赞助商

界面截图

功能特点

• 一键安装 Claude Desktop 中文界面资源，支持 macOS、Windows 和 Linux（deb 包安装）。
• 支持三种中文变体：zh-CN（简体中文）、zh-TW（繁體中文（台灣））、zh-HK（繁體中文（香港））。
• 自动给 Claude 前端语言白名单加入当前选择的中文变体。
• macOS 和 Windows 只汉化第三方 API 模式的本地界面：Claude 官方账号登录页面已原生支持中文，这两个平台的脚本不再改动它。
• macOS 和 Windows 的本地斜杠菜单支持“英文命令名 + 中文说明”，兼容三种中文变体；命令 ID、搜索与点击行为保持不变。
• macOS 和 Linux 会合并当前 Claude 版本的英文语言文件与随包中文翻译；新版本新增但暂未翻译的字段保留英文，避免界面缺失文本。
• Windows 安装脚本会备份并修改当前 Claude Desktop 的资源文件，卸载时从备份恢复。Claude 4.29+ 的前端改为 ion-dist.asar 后，脚本会解包、重打包并同步 Claude.exe 中对应的 ASAR 头哈希；同时会就地改写 app.asar（保留 unpacked/executable 等元数据，不解包重打包），把桌面词库补进并合并进 resources/i18n，让主进程菜单栏也显示中文。两者都会使原有 Authenticode 签名失效。
• Linux 安装脚本会备份并修改 deb 包安装目录下的资源文件和 app.asar，卸载时从备份恢复；Claude Desktop 升级后会识别版本变化并重新备份。
• macOS 安装前自动备份原始 /Applications/Claude.app。
• 自动写入 Claude 用户配置，将语言设置为所选中文变体。

适用环境

• macOS、Windows 或 Linux（deb 包安装）
• 已安装 Claude Desktop
• macOS 需要可用的 Python 3；脚本优先使用 /usr/bin/python3，不存在时从 PATH 查找 python3
• Windows 需要系统自带的 Windows PowerShell（powershell.exe）；批处理入口会自动请求管理员权限
• Linux 需要 Python 3 和 sudo 权限，且为官方 deb 包安装的 Claude Desktop（资源目录 /usr/lib/claude-desktop/resources，可用环境变量 CLAUDE_RESOURCES 覆盖）

使用方式

macOS

1. 退出 Claude Desktop。
2. 下载或克隆本项目。
3. 双击 install-mac.command，选择操作：
   • 1 安装中文补丁（第三方 API 模式）：安装中文资源、注册中文语言、汉化前端 bundle 与桌面壳层，并对应用做本机 ad-hoc 重签名。不改写 app.asar；官方账号登录界面请直接使用 Claude 自带的语言设置。
   • 2 恢复原样 / 卸载补丁。
   • 3 自动更新设置：输入 y 禁止自动更新，输入 n 允许自动更新。
   • 4 CC Switch skills 同步：输入 y 同步，输入 n 删除之前的同步。
4. 选择安装后，脚本会先恢复已有旧备份以清理上一轮补丁；没有旧备份时会直接继续。
5. 选择语言：1=简体中文，2=繁體中文（台灣），3=繁體中文（香港）。
6. 按提示输入 Mac 登录密码（选项 1/2/3）。安装完成后 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 的官方自动更新下载后可以正常安装，不会再卡在“下载完成但版本不变”。注意两点：

• 更新安装成功后，/Applications/Claude.app 会被官方英文版覆盖，重新运行本补丁即可恢复中文。
• 如果之前打过旧版补丁（默认 ad-hoc DR），需重新打一次补丁才会获得新签名行为。

Windows

1. 退出 Claude Desktop。
2. 下载或克隆本项目。
3. 双击 install-windows.bat；脚本会复制安装文件到当前用户的临时目录，并弹出 UAC 管理员授权窗口。
4. 先选择操作：
   • 1 安装中文补丁（第三方 API 模式，例如 DeepSeek）：安装中文资源、注册中文语言并汉化前端 bundle 与主进程菜单。脚本会在必要时就地改写 app.asar 补入桌面词库；Claude 4.29+ 会重建 ion-dist.asar 并更新 Claude.exe 中对应的完整性哈希，原有 Authenticode 签名会失效；同时脚本会自动修补 cowork-svc.exe 的客户端签名校验分支，彻底解决 Cowork 工作区因签名失效报 RPC pipe closed 的问题（卸载时自动恢复官方原包）。安装后 English 界面同样会显示中文（词库被合并覆盖进 en-US），切换语言无法回到纯英文，需要卸载或恢复备份才能还原。若 Claude 装在 WindowsApps 下且管理员拿不到写权限，脚本会接管该目录的所有权（所有者从 TrustedInstaller 改为 Administrators，卸载后不自动恢复，详见下文注意事项）。第三方模型需在网关或 CC Switch 中映射为 Claude/Anthropic 风格名称。
   • 2 恢复原样 / 卸载补丁。
   • 3 自动更新设置：输入 y 禁止自动更新，输入 n 允许自动更新。
   • 4 CC Switch skills 同步：输入 y 开启同步，输入 n 删除之前的同步。
5. 选择安装中文补丁时，脚本会先尝试从旧备份恢复来清理已有汉化；如果没有旧备份，会提示跳过并继续。
6. 选择语言：1=简体中文，2=繁體中文（台灣），3=繁體中文（香港）。
7. 脚本会备份被修改的文件、写入中文资源并重启 Claude Desktop。Claude 4.29+ 的 ion-dist.asar 会先解包到临时目录，完成汉化后再重打包并更新 Claude.exe 内的 ASAR 头哈希。如果没有自动切换，打开左下角账号菜单，选择 Language -> 对应的中文选项。

商店版（Microsoft Store / MSIX）与官网安装包都受支持。安装器会自动识别 Claude、AnthropicPBC.Claude 等包名变化，也会跳过升级残留的旧 app-* 目录。

Linux（deb 包安装）

1. 退出 Claude Desktop（脚本检测到正在运行时也会自动关闭）。
2. 下载或克隆本项目。
3. 在项目目录中打开终端，运行 ./install-linux.sh，选择操作：
   • 1 安装中文补丁：安装中文资源、注册中文语言，并修改 app.asar，包含在线页面 DOM 汉化和在线语言锁定。
   • 2 恢复原样 / 卸载补丁。
4. 选择语言：1=简体中文，2=繁體中文（台灣），3=繁體中文（香港）。
5. 按提示输入 sudo 密码。完成后重新打开 Claude Desktop；如果没有自动切换，打开左下角账号菜单，选择 Language -> 对应的中文选项。

也可以跳过菜单直接调用：./install-linux.sh install zh-CN（可选 zh-TW / zh-HK）或 ./install-linux.sh uninstall。

Linux 升级后恢复

通过 apt 升级 Claude Desktop 会覆盖补丁，界面会变回英文。建议先更新本项目（克隆的用 git pull，下载压缩包的重新下载最新版本），再重新运行一次安装：

git pull
./install-linux.sh install zh-CN

脚本会识别 Claude Desktop 的版本变化，自动丢弃旧版本的备份并重新备份，不会把旧版 app.asar 装回去。若新版本改动了代码结构导致补丁没有生效，脚本会直接报错，请带上 Claude Desktop 版本号反馈。

文件说明

• install-mac.command：macOS 双击运行入口。
• install-windows.bat：Windows 安装 / 恢复菜单入口。
• install-linux.sh：Linux（deb 包）安装 / 恢复菜单入口。
• scripts/install_windows.ps1：Windows 汉化安装和卸载脚本。
• scripts/install_linux.sh：Linux（deb 包）汉化安装和卸载脚本；install-linux.sh 的菜单会调用它，也可直接带参数调用。
• scripts/patch_linux_asar.py：Linux 下复用 patch_claude_zh_cn.py 的 asar 补丁逻辑（伪造 macOS 目录布局 + 跳过 codesign/完整性），并在补丁后校验标记防止静默失败。
• scripts/patch_claude_zh_cn.py：真正执行补丁的 Python 脚本。
• resources/manifest.json / manifest-zh-TW.json / manifest-zh-HK.json：语言包信息。
• resources/frontend-zh-CN.json / frontend-zh-TW.json / frontend-zh-HK.json：Claude 前端界面中文翻译。
• resources/frontend-hardcoded-zh-CN.json / frontend-hardcoded-zh-TW.json / frontend-hardcoded-zh-HK.json：未走 i18n key 的前端硬编码文本映射，也用于在线账号页面的 DOM 翻译表。
• resources/desktop-zh-CN.json / desktop-zh-TW.json / desktop-zh-HK.json：Claude 桌面壳层中文翻译。
• resources/Localizable.strings / Localizable-zh-TW.strings / Localizable-zh-HK.strings：macOS 原生菜单中文资源。
• resources/statsig-zh-CN.json / statsig-zh-TW.json / statsig-zh-HK.json：statsig i18n 兜底资源。
• resources/release.json：安装入口用于检查 GitHub Releases 是否有新版的版本信息。

斜杠菜单双语说明

macOS / Windows 安装时，会尝试给本地 SlashCommandMenuPopupBody 中的已知内置命令追加中文说明，例如 model 选择模型、permissions 权限模式。原英文名称与搜索高亮保留，点击后仍执行原命令；自定义技能、第三方插件命令、连接器和未知命令不强行翻译。

This is the beginning of the README. Read the rest at the original. Read the full README ↗