Claude Desktop 简体中文补丁

Claude Desktop 简体中文补丁。项目只修改本机已经安装好的官方 Claude Desktop 资源文件，不包含、不分发、不替换 Claude Desktop 本体。

致谢：https://linux.do/

当前状态

适配版本：Claude Desktop 1.12603.2
macOS：已按官方 Claude Desktop 1.12603.2 的 /Applications/Claude.app 资源结构做 dry-run 验证
Windows：保留 AppX / MSIX 补丁逻辑；旧版存在 statsig 语言表时会自动补丁
Linux：使用同一套 Electron 资源补丁逻辑，仍建议在对应发行版实机复测
发布内容：只包含补丁资源、安装脚本、恢复脚本和验证脚本
不再依赖固定前端 chunk 文件名，改为安装时扫描当前版本资源并按内容替换
翻译审计：本地资源语言表已按官方 1.12603.2 英文基线全量扫描；除品牌名、产品名、系统名、路径、URL、协议、代码/配置标识和纯格式占位符外，无实际英文回落，详见 docs/translation-audit-1.12603.2.json

重要说明

本项目不是 Claude Desktop 安装包，也不是 Claude 插件。

使用前请先安装官方 Claude Desktop 完整版：

Windows：官方 Claude Desktop
macOS：官方 Claude Desktop
Linux：如果使用非官方/社区打包版本，需要手动指定 Claude 的 resources 目录

补丁默认会同时写入：

zh-CN 语言文件
en-US 槽位的中文覆盖文件

这是因为 Claude Desktop 部分界面仍可能读取英文槽位。若你不想覆盖 en-US，可以使用 -NoForceEnglishSlot 或 --no-force-english-slot。

效果截图

汉化范围

补丁覆盖两类文本：

语言表文本
- resources/*.json
- resources/ion-dist/i18n/*.json
- resources/ion-dist/i18n/dynamic/*.json
- resources/ion-dist/i18n/statsig/*.json
- dynamic / statsig 会按当前安装目录实际存在的资源自动选择
前端硬编码文本
- 安装时扫描 resources/ion-dist/assets/v1/*.js
- 根据 patch/hardcoded-replacements.json
- 只做少量已验证的内容级替换，避免批量改写前端 chunk 造成页面渲染异常

patch/manual-translations.json 和 patch/source-translations.json 用于生成语言表，不会在安装时批量改写 JS fallback 文案。

重点覆盖的典型界面包括：

左侧导航
新建任务
项目 / 固定 / 最近
Cowork 首页
Cowork 任务页
计划任务页
自定义 / Skills / 连接器 / 插件
设置页
Claude Code 设置项
输入框、按钮、提示、错误文案
部分模型和网关错误提示

下载

从 GitHub Release 下载对应平台的补丁包：

claude-desktop-zh-cn-patch-windows-<version>.zip
claude-desktop-zh-cn-patch-macos-<version>.tar.gz
claude-desktop-zh-cn-patch-linux-<version>.tar.gz

仓库地址：

https://github.com/guhaigg/claude-desktop-zh-cn-patch

环境要求

已安装官方 Claude Desktop
已安装 Node.js
- 建议 Node.js 18+
- 脚本通过 node 命令运行核心补丁逻辑
Windows 如果 Claude 安装在受保护目录，可能需要管理员权限

Windows 安装

方式一：双击安装

解压 Windows zip 后双击：

install-uac.vbs

这个入口会通过 UAC 以管理员权限运行 AppX / MSIX 补丁入口，补当前 Claude 版本。

方式二：AppX / MSIX 协作版启动入口

如果你使用的是 Windows Store / MSIX 版 Claude Desktop，协作（Cowork）需要通过 AppX 包身份启动。不要直接启动 WindowsApps 里的 Claude.exe，也不要用旧的 Squirrel 目录启动，否则协作可能提示“需要更新的安装版本”。

补丁仓提供普通启动入口：

launch.ps1

它会优先通过：

shell:AppsFolder\Claude_pzs8sxrjxfjjc!Claude

启动 AppX / MSIX 版 Claude Desktop；如果没有 AppX 包，才回退到：

C:\Users\<you>\AppData\Local\AnthropicClaude\app-<version>

普通启动入口不会每次启动都写安装目录。它只做资源 hash 检测：如果当前 AppX / MSIX 安装目录已经是补丁后的资源，就直接启动；如果 Claude 更新后资源漂移，才弹出 UAC 运行一次补丁，然后再通过 AppX 包身份启动。

手动执行：

powershell -ExecutionPolicy Bypass -File .\launch.ps1

方式三：更新后智能重新应用中文补丁

Claude Desktop 更新后，新的安装目录会覆盖或丢失补丁文件。需要重新汉化时，再运行管理员补丁入口：

Windows 下可直接双击：

install-uac.vbs

该入口会：

定位当前 AppX / MSIX 版 Claude Desktop；
关闭正在运行的 Claude；
以管理员权限创建一次性 SYSTEM 任务修改当前版本的资源文件；
通过 AppX 包身份重新启动 Claude。

launch.ps1 的智能检测逻辑是：

定位当前最新 AppX / MSIX Claude 安装目录；
对比补丁资源和当前安装目录资源的 SHA256；
资源一致时直接启动，不写安装目录；
资源漂移时才弹 UAC，运行一次 install-appx.ps1 -NoLaunch 补丁；
补丁完成后再通过 AppX 包身份启动 Claude。

说明：WindowsApps 目录通常只有 SYSTEM / TrustedInstaller 可写，管理员账号也可能只有读取权限。脚本不会修改 WindowsApps ACL，也不会 takeown；只在用户确认 UAC 后使用一次性 SYSTEM worker 完成补丁写入，执行完即清理，不注册常驻计划任务。

也可以手动执行：

powershell -ExecutionPolicy Bypass -File .\install-appx.ps1

方式四：PowerShell 安装

在补丁目录执行：

powershell -ExecutionPolicy Bypass -File .\install.ps1

常用参数：

# 不自动重启 Claude
powershell -ExecutionPolicy Bypass -File .\install.ps1 -NoRestart

# 不覆盖 en-US 槽位，只写 zh-CN
powershell -ExecutionPolicy Bypass -File .\install.ps1 -NoForceEnglishSlot

# 手动指定 Claude app 目录或 resources 目录
powershell -ExecutionPolicy Bypass -File .\install.ps1 -ClaudeAppDir "C:\Users\you\AppData\Local\AnthropicClaude\app-1.9659.2"

# 只预演，不写入文件
powershell -ExecutionPolicy Bypass -File .\install.ps1 -DryRun

Windows 路径说明

脚本会自动尝试查找：

C:\Users\<you>\AppData\Local\AnthropicClaude\app-<version>\resources
C:\Program Files\WindowsApps\Claude_<version>_x64__pzs8sxrjxfjjc\app\resources

如果自动查找失败，请用 -ClaudeAppDir 手动指定。

如果你安装的是 WindowsApps / MSIX 版本，目录可能受系统保护。遇到 EPERM、Access denied 或写入失败时，请使用 install-uac.vbs 或管理员 PowerShell。某些系统策略下仍可能禁止直接修改 WindowsApps 目录，这时建议改用官方普通桌面安装目录或手动指定可写的 Claude 资源目录。

macOS 安装

一行 GitHub 安装命令：

bash -c "$(curl -fsSL https://raw.githubusercontent.com/guhaigg/claude-desktop-zh-cn-patch/master/install-github-macos.sh)"

如果 Claude 不在默认 /Applications/Claude.app，可以指定路径：

CLAUDE_APP_DIR="/Applications/Claude.app" bash -c "$(curl -fsSL https://raw.githubusercontent.com/guhaigg/claude-desktop-zh-cn-patch/master/install-github-macos.sh)"

解压 macOS 包后：

chmod +x ./install.sh ./restore.sh
./install.sh

脚本会自动尝试查找：

/Applications/Claude.app/Contents/Resources
~/Applications/Claude.app/Contents/Resources

手动指定路径：

./install.sh --app-dir "/Applications/Claude.app"

常用参数：

# 不自动重启
./install.sh --no-restart

# 不覆盖 en-US 槽位
./install.sh --no-force-english-slot

# 只预演，不写入文件
./install.sh --dry-run

如果 /Applications/Claude.app 权限不足，请使用管理员权限执行，或先确认当前用户对 Claude.app 有写入权限。

Linux 安装

Linux 版适用于存在 Claude Desktop Electron 资源目录的安装方式。

解压 Linux 包后：

chmod +x ./install.sh ./restore.sh
./install.sh

脚本会自动尝试查找：

~/.local/share/Claude/resources
~/.config/Claude/resources
/opt/Claude/resources
/usr/lib/Claude/resources
/usr/lib64/Claude/resources

如果没找到，请手动指定：

./install.sh --app-dir "/path/to/Claude/resources"

Linux 没有统一官方安装路径，所以 --app-dir 是最稳的方式。

恢复 / 卸载补丁

安装补丁时会在 backups/ 目录生成备份。恢复时默认使用最近一次备份。

Windows

双击：

restore-uac.vbs

或执行：

powershell -ExecutionPolicy Bypass -File .\restore.ps1

指定备份目录：

powershell -ExecutionPolicy Bypass -File .\restore.ps1 -BackupDir ".\backups\claude-desktop-language.2026-06-01-120000"

macOS / Linux

./restore.sh

指定备份目录：

./restore.sh --backup-dir "./backups/claude-desktop-language.2026-06-01-120000"

校验

基础校验：

powershell -ExecutionPolicy Bypass -File .\scripts\verify.ps1

校验内容包括：

补丁 JSON 是否存在
补丁 JSON 是否合法
zh-CN / en-US key 数量是否一致
dynamic / statsig 等可选语言表是否完整
硬编码替换表是否存在
是否包含明显 API key / secret

对实际 Claude 安装目录做 dry-run 校验：

powershell -ExecutionPolicy Bypass -File .\scripts\verify.ps1 -AppDir "C:\Users\you\AppData\Local\AnthropicClaude\app-1.9659.2"

macOS / Linux 可直接调用 Node：

node ./scripts/verify-patch.mjs --app-dir "/Applications/Claude.app"

从新版 Claude 同步语言表

Claude Desktop 更新后，可以基于当前安装目录重新同步语言表：

node .\scripts\sync-from-installed.mjs --app-dir "C:\Users\you\AppData\Local\AnthropicClaude\app-1.9659.2"

同步策略：

使用当前版本 en-US.json 作为最新 key 基线
保留旧补丁里已经存在的翻译
优先应用 patch/manual-translations.json
再应用 patch/source-translations.json
新增但未翻译的 key 会在审计中暴露，发布前不应留下实际英文回落

打包 Release

powershell -ExecutionPolicy Bypass -File .\scripts\build-release.ps1 -Version 1.12603.2

输出：

dist/claude-desktop-zh-cn-patch-windows-1.12603.2.zip
dist/claude-desktop-zh-cn-patch-macos-1.12603.2.tar.gz
dist/claude-desktop-zh-cn-patch-linux-1.12603.2.tar.gz
dist/release-manifest-1.12603.2.json

Release 包只包含补丁项目文件，不包含 Claude Desktop 本体。

目录结构

patch/
  hardcoded-replacements.json
  manual-translations.json
  source-translations.json
  resources/
    zh-CN.json
    en-US.json
    ion-dist/
      i18n/
        zh-CN.json
        en-US.json
        dynamic/
          zh-CN.json
          en-US.json
        statsig/
          zh-CN.json
          en-US.json

scripts/
  apply-patch.mjs
  restore-patch.mjs
  sync-from-installed.mjs
  verify-patch.mjs
  build-release.ps1
  verify.ps1

install.ps1
install-appx.ps1
install-appx-system-worker.ps1
restore.ps1
install.sh
install-github-macos.sh
restore.sh
install-uac.vbs
restore-uac.vbs
manifest.json
README.md

常见问题

这是官方插件吗？

不是。Claude Desktop 当前插件系统不能修改主界面语言资源。本项目通过修改本机资源文件实现中文界面。

会修改账号、API Key、会话内容吗？

不会。补丁只处理 Claude Desktop 的本地语言资源文件和语言配置。不会上传数据，也不会读取账号凭据。

为什么要覆盖 en-US？

Claude Desktop 部分界面仍会读取英文槽位。为了提高汉化覆盖率，默认会把 en-US 槽位也写成中文。如果不想这样做，请使用：

powershell -ExecutionPolicy Bypass -File .\install.ps1 -NoForceEnglishSlot

或：

./install.sh --no-force-english-slot

Claude 更新后还有效吗？

Windows AppX / MSIX 版建议使用 launch.ps1 或桌面快捷方式启动。启动器会先做 hash 检测，Claude 更新后如果新目录资源恢复英文，会弹 UAC 重新补丁一次。大版本变化后仍可能需要重新同步语言表和补充替换词表。

能直接把打好补丁的 Claude 发给别人吗？

不建议，也不是本项目目标。本项目只发布补丁，不分发 Claude Desktop 本体。

已知限制

macOS 已按 Claude Desktop 1.12603.2 资源结构做 dry-run 验证。
Windows AppX / MSIX 逻辑保留兼容旧版资源结构，但新版 Windows 仍建议实机复测。
Linux 使用同一套资源补丁逻辑，但仍需要对应系统实机复测。
已生成 docs/translation-audit-1.12603.2.json，用于记录本地语言表缺失、英文回落、占位符、HTML 标签和 ICU 参数审计结果。
上游新增 key 后需要重新同步、补翻并重新审计。
服务端返回的动态文案、模型错误、账号状态、历史会话标题、用户自定义项目名不会全部自动翻译。
WindowsApps / MSIX 目录受系统保护时，可能需要管理员权限，甚至可能被系统策略禁止直接修改。
Linux 没有统一官方安装目录，通常建议手动传 --app-dir。

License

MIT

Navigation Menu

Repository files navigation

Claude Desktop 简体中文补丁

当前状态

重要说明

效果截图

汉化范围

下载

环境要求

Windows 安装

方式一：双击安装

方式二：AppX / MSIX 协作版启动入口

方式三：更新后智能重新应用中文补丁

方式四：PowerShell 安装

Windows 路径说明

macOS 安装

Linux 安装

恢复 / 卸载补丁

Windows

macOS / Linux

校验

从新版 Claude 同步语言表

打包 Release

目录结构

常见问题

这是官方插件吗？

会修改账号、API Key、会话内容吗？

为什么要覆盖 en-US？

Claude 更新后还有效吗？

能直接把打好补丁的 Claude 发给别人吗？

已知限制

License

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
docs		docs
patch		patch
scripts		scripts
tests		tests
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
install-appx-system-worker.ps1		install-appx-system-worker.ps1
install-appx.ps1		install-appx.ps1
install-github-macos.sh		install-github-macos.sh
install-uac.vbs		install-uac.vbs
install.ps1		install.ps1
install.sh		install.sh
launch.ps1		launch.ps1
manifest.json		manifest.json
restore-uac.vbs		restore-uac.vbs
restore.ps1		restore.ps1
restore.sh		restore.sh

Latest commit

History

Folders and files

Repository files navigation

Claude Desktop 简体中文补丁

当前状态

重要说明

效果截图

汉化范围

下载

环境要求

Windows 安装

方式一：双击安装

方式二：AppX / MSIX 协作版启动入口

方式三：更新后智能重新应用中文补丁

方式四：PowerShell 安装

Windows 路径说明

macOS 安装

Linux 安装

恢复 / 卸载补丁

Windows

macOS / Linux

校验

从新版 Claude 同步语言表

打包 Release

目录结构

常见问题

这是官方插件吗？

会修改账号、API Key、会话内容吗？

为什么要覆盖 en-US？

Claude 更新后还有效吗？

能直接把打好补丁的 Claude 发给别人吗？

已知限制

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages