SkillAgentSearch skills...

claude-desktop-zh-cn

Claude Desktop Chinese Patch (macOS & Windows & Linux)

Install / Use

npx skills add javaht/claude-desktop-zh-cn

Installs into whichever agent you are using.

About this skill
🤖

CLAUDE.md

Claude Code project instructions

Quality Score

90/100

Supported Platforms

Claude Code

Tags

Our assessment of claude-desktop-zh-cn

claude-desktop-zh-cn scores 90/100 on our quality scale, 1220th of 4,700 Development & Engineering skills we index (top 26%).

Its CLAUDE.md is 15 KB long, well organised into 21 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.

With 8,628 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
8/15
Adoption
17/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so claude-desktop-zh-cn is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 95/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

claude-desktop-zh-cn compared with similar skills

All 4 of these similar skills score higher than claude-desktop-zh-cn; compare them before choosing.

SkillScoreStarsUpdatedFormat
claude-desktop-zh-cn (this skill)by javaht908.6ktodayCLAUDE.md
claude-memby thedotmack100117.6ktodayCLAUDE.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
Understand-Anythingby Egonex-AI10092.8k1d agoCLAUDE.md

Frequently asked questions

How do I install claude-desktop-zh-cn?
Run npx skills add javaht/claude-desktop-zh-cn. The install tabs above show the steps for each supported agent.
Which AI agents does claude-desktop-zh-cn work with?
It is written for Claude Code, as a CLAUDE.md file. Other agents that read the same format can often use it too.
Is claude-desktop-zh-cn safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 95/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is claude-desktop-zh-cn still maintained?
The repository was last updated today, so claude-desktop-zh-cn is actively maintained.

Claude Desktop 中文补丁

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

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

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

赞助商

<details open> <summary>点击折叠</summary> <table width="100%"> <tr> <td width="250" align="center" valign="middle"><a href="https://tokenmetro.com"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/tokenmetro-dark.png"><img src="docs/images/tokenmetro-light.png" alt="TokenMetro" width="216"></picture></a></td> <td valign="middle"><strong>TokenMetro</strong> - 一家计费透明、自建号池的中转站。<br> 相对官方价格:GPT 1 折,Gemini 一次 5分,DeepSeek0.1折。<br> 明码标价,显示多少扣多少,不玩汇率魔术;自建号池,拒绝掺水。<br> 私信客服领取1r体验金,一键上车:<a href="https://tokenmetro.com">https://tokenmetro.com</a></td> </tr> <tr> <td width="250" align="center" valign="middle"><a href="https://www.oxoapi.com"><img src="docs/images/oxoapi.png" alt="OXOAPI" width="151"></a></td> <td valign="middle"><strong>OXOAPI</strong> - 高质量国模自部署资源,AI 模型统一接口入口。热门国产模型 DeepSeek、Kimi、GLM 低至 4.5-6 折,海外模型低至 2.5 折;官网实时公开报价,价格自动刷新、通道状态透明可见;支持开具发票,企业采购更省心。注册即用:<a href="https://www.oxoapi.com">www.oxoapi.com</a>,完整价格表:<a href="https://www.oxoapi.com/pricing">www.oxoapi.com/pricing</a></td> </tr> </table> </details> <p align="center"><strong>遇到问题请及时反馈,欢迎扫码加入 claude desktop 交流。</strong></p> <p align="center"><img src="docs/images/wechat-group.png" alt="claude desktop 交流群二维码" width="360"></p>

界面截图

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

功能特点

  • 一键安装 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 权限模式。原英文名称与搜索高亮保留,点击后仍执行原命令;自定义技能、第三方插件命令、连接器和未知命令不强行翻译。

  • resources/slash-command-glosses.json:简体、繁体台湾、繁体香港的说明词表。
  • resources/slash-command-menu-patch.json:两平台共用的组件匹配规则、唯一锚点和显示层补丁。匹配局部变量而不是固定 bundle 文件名。
  • 重复安装不重复追加;直接切换语言时只更新说明词表。Windows 在写入前沿用现有原文件备份机制,macOS 沿用整包备份和重签流程。
  • 若组件缺失、锚点不唯一或已有补丁形态不符,会输出 WARNING 并保持该菜单文件不变,其他汉化步骤继续。应用升级后可能需要更新匹配规则,语法匹配不代表兼容所有未来版本。
  • 此功能不注入在线账号页面,也未接入 Linux 的独立安装脚本。

开发与回归测试

测试只使用合成菜单和临时目录,不启动或修改已安装的 Claude,不需要管理员权限。运行需要 Python 3.10+、Node.js,以及用于检查 Windows 逻辑的 PowerShell 5.1 或 PowerShell 7:

python -I -m unittest discover -s tests -v
powershell -NoProfile -ExecutionPolicy Bypass -File tests/Test-StructuralReplacements.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File tests/Test-SlashCommandMenu.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File tests/Test-AsarFrontend.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File tests/Test-AsarIntegrity.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File tests/Test-AsarFrontendWorkflow.ps1

PowerShell 7 环境可将 powershell 替换为 pwsh。测试覆盖高风险词跳过、三地 i18n、Windows 真实 C# 快速路径与备用路径、菜单点击/高亮、语言切换、幂等、备份顺序和不兼容组件的安全跳过。合成测试不能替代完整客户端的视觉验收。

如需对已安装 Claude 的实际 ion-dist.asar 做逐文件无损往返验证,可传入包路径:

powershell -NoProfile -ExecutionPolicy Bypass -File tests/Test-AsarRoundTrip.ps1 -ArchivePath "C:\Program Files\WindowsApps\Claude_4.29.0.0_x64__pzs8sxrjxfjjc\app\resources\ion-dist.asar"

macOS 脚本会做什么

  • 安装时备份当前 /Applications/Claude.app 到同目录,名字类似: Claude.backup-before-zh-CN-20260424-120000.app
  • 安装前会先尝试恢复已有旧备份,清理上一轮汉化;没有旧备份时跳过并继续安装。
  • 恢复 / 卸载时选择同目录下最早的 Claude.backup-before-zh-CN-*.app 恢复为 /Applications/Claude.app,并删除其他备份。
  • 复制 Claude.app 到临时目录并打补丁。
  • 给前端语言白名单加入当前选择的中文变体。
  • 汉化前端 bundle 中未走 i18n key 的硬编码文本,并修正中文语言显示名称。
  • 不修改 Contents/Resources/app.asar:在线账号界面由 Claude 原生提供中文,本项目不再注入 DOM 翻译、语言锁定或模型选择器补丁。
  • Claude 4.29+ 的前端改为 Contents/Resources/ion-dist.asar:脚本会先备份原包,解包到临时 ion-dist 目录执行汉化,再按 ASAR 格式重打包并校验结构;重打包后同步 Info.plist 中 ElectronAsarIntegrity 的 Resources/ion-dist.asar 头哈希,避免应用因完整性校验失败无法加载前端。4.29 之前的目录布局保持原有逻辑。
  • 合并当前 Claude 版本的 en-US.json 和随包中文翻译: 当前版本已有中文翻译的 key 会变中文,新版本新增但本包没有的 key 会保留英文,避免应用缺字段。
  • 写入 ~/Library/Application Support/Claude/config.json,设置 "locale" 为所选语言代码(zh-CN、zh-TW 或 zh-HK)。
  • 对修改后的 Claude.app 及其内部 app/framework/原生二进制做一致的本机 ad-hoc 重签名,并清除 com.apple.quarantine 隔离属性。
  • 重新启动 Claude。
  • 可选菜单项 5 用 y/n 控制 Claude Desktop 自动更新:y 禁止自动更新,n 允许自动更新。若当前存在有效的 Claude-3p configLibrary,脚本会写入当前 applied 配置;否则写入 Claude Desktop enterprise policy。
  • 可选菜单项 6 用 y/n 控制 CC Switch skills 同步:y 会把 ~/.cc-switch/skills 中缺失的 skill 软链接到 Claude Desktop 的本地 skills 目录,并更新对应 manifest.json;n 只删除之前同步产生的 CC Switch 软链接和对应 manifest 记录。该操作不需要管理员权限,不会覆盖同名 skill。

Windows 脚本会做什么

  • 查找 Windows 版 Claude Desktop 安装目录。
  • 安装前会先尝试从 resources\.zh-cn-backups 恢复旧备份,清理上一轮汉化;没有旧备份时跳过并继续安装。
  • 复制本仓库现有中文资源,不使用其他语言包项目里的 JSON:
    • resources/frontend-zh-CN.json / frontend-zh-TW.json / frontend-zh-HK.json -> ion-dist\i18n\ 对应语言代码 .json
    • resources/desktop-zh-CN.json / desktop-zh-TW.json / desktop-zh-HK.json -> resources\ 对应语言代码 .json,同时补进 app.asar 的 resources/i18n\ 供主进程菜单读取
    • resources/statsig-zh-CN.json / statsig-zh-TW.json / statsig-zh-HK.json -> ion-dist\i18n\statsig\ 对应语言代码 .json
  • 给前端语言白名单加入当前选择的中文变体。
  • 汉化前端 bundle 中未走 i18n JSON 的硬编码界面文本,例如侧边栏入口、配置页标签和模型选择项。
  • Claude 4.29+ 的主进程菜单只读取 app.asar 内的 resources/i18n 词库:安装器会备份 app.asar,然后在原位改写头部(新内容追加到 payload 末尾,只更新对应条目的 offset/size/integrity),不解包重打包,因此 unpacked、executable、link 等元数据和 .unpacked 目录都不受影响。
  • Claude 4.29+ 的新版前端位于 ion-dist.asar,安装器会先备份原包,再解包到临时 ion-dist 目录执行汉化;完成后按 ASAR 格式重打包、校验结构并替换原文件。
  • 由于 Claude 4.29+ 的壳层和前端都固定按 en-US 加载词库(渲染进程约 1 秒后还会把 locale 写回 en-US),安装器会把所选中文词库合并覆盖进 app.asar 的 resources/i18n/en-US.json 与 ion-dist.asar 的 i18n/en-US.json,未翻译的键保留英文,从而覆盖只存在于词库、JS 里没有字面量的条目(例如模型档位描述)。副作用是 English 界面也会显示中文,且无法通过切换语言还原英文,卸载或恢复备份后才会恢复。
  • 改写 app.asar 或重建 ion-dist.asar 后,安装器会同步 Claude.exe 内嵌的 app.asar 与 ion-dist.asar 头哈希。此时 Claude.exe 的原始 Authenticode 签名会失效;针对该失效导致的 Cowork 管道拦截问题,安装器会自动修补 cowork-svc.exe,将签名强制校验降级为告警,解决 Cowork 工作区报 RPC pipe closed 的问题;卸载时从备份恢复官方未修改的 cowork-svc.exe,签名自动恢复有效。
  • Windows 上 Claude 安装在 C:\Program Files\WindowsApps\<包名>\app,该目录默认属于 TrustedInstaller,UAC 提权后的 Administrators 只有读和执行权限。安装器不再只看 ACL,而是先实测能否写入;不能时依次追加允许规则、清理阻止写入的显式拒绝规则(Windows 中 Deny 优先于 Allow),仍然不行才用 takeown /a + icacls 接管所有权。接管会把该目录的所有者从 TrustedInstaller 改为 Administrators,并授予其完全控制;卸载不会自动恢复,只有重装或升级 Claude 时由系统重置,部分安全软件或企业策略可能拦截或告警。交互模式下执行前会二次确认,输入 n 可跳过;非交互调用(脚本、自动化)默认不接管,必须显式加 -AllowTakeOwnership 或设置环境变量 CLAUDE_ZH_ALLOW_TAKE_OWNERSHIP=1。写入权限最终拿不到时安装会直接中止,而不是继续写 asar 留下「asar 已改、exe 哈希没写回」的半坏状态。
  • 写入 Windows 用户配置,将语言设置为所选语言代码(zh-CN、zh-TW 或 zh-HK)。
  • 可选菜单项 3 用 y/n 控制 Claude Desktop 自动更新:y 禁止自动更新,n 允许自动更新。若当前存在有效的 Claude-3p configLibrary,脚本会写入当前 app

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars8.6k
CategoryDevelopment
Updated9h ago
Forks417

Languages

PowerShell

Trust signals

95/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low