三亩地 三亩地SAN MU DI · CODE DIARY
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天,欢迎挑你感兴趣的翻一翻。

Claude Desktop中文补丁怎么装?3分钟汉化AI助手界面的完整指南

Claude Desktop中文补丁怎么装?3分钟汉化AI助手界面的完整指南

Claude Desktop中文补丁怎么装?3分钟汉化AI助手界面的完整指南

【免费下载链接】claude-desktop-zh-cnClaude Desktop Chinese Patch (macOS & Windows)项目地址: https://gitcode.com/gh_mirrors/cl/claude-desktop-zh-cn

第一次装好 Claude Desktop,点开图标,满屏的英文设置项扑面而来——对不熟悉英文界面的用户来说,这个第一印象确实不友好。Claude Desktop中文补丁(Claude Desktop Chinese Patch)就是一个专门解决这个问题的免费开源项目:它面向 macOS 和 Windows 版 Claude Desktop 提供完整的本地中文界面,支持简体中文、繁体中文(中国台湾)、繁体中文(中国香港)三种变体,全程脚本化安装,并且随时可以恢复原样。

这篇指南不堆代码、不讲黑话,就按一个普通用户的完整流程来写:装之前要准备什么、两个平台分别怎么操作、装完能看到什么效果、出了状况怎么回退。

装完之后,你的 Claude Desktop 会变成什么样?

先说你最关心的结果。这个补丁不是简单换一个语言包,它覆盖的界面范围比想象中广:

  • 主界面文本:侧边栏、聊天入口、项目、Artifacts 等导航和按钮全部中文化;
  • 设置页面:账号、计费、隐私、连接等设置项都显示为中文,不用再翻着词典找选项;
  • 在线页面:用官方账号登录后,claude.ai 页面里的聊天、项目等内容也会被显示层翻译覆盖;
  • 语言选项:脚本会往前端语言白名单里加入你选的中文变体,并自动写入用户配置,把语言切到中文。

三种中文变体怎么选,看这张表就行:

编号语言变体适用人群
1简体中文(zh-CN)中国大陆用户默认选择
2繁体中文(中国台湾)(zh-TW)台湾地区用户
3繁体中文(中国香港)(zh-HK)香港地区用户

这里有个很实在的细节:脚本会把当前版本的中文翻译和英文原文做"智能合并"。Claude Desktop 更新后冒出来的新字段,如果翻译包还没跟上,会暂时保留英文而不是显示成空白——很多汉化工具恰恰栽在这一步。

开工之前,先花两分钟核对这四件事

安装本身很快,但动手前确认下面几项,能省掉大半麻烦:

  • 系统是 macOS 或 Windows,并且已经装好 Claude Desktop;
  • macOS 用户:系统里有可用的 Python 3(脚本优先使用系统自带的/usr/bin/python3);
  • Windows 用户:能正常弹出 Windows PowerShell 和 UAC 管理员授权窗口;
  • Claude Desktop 处于完全退出状态——这一步最容易被忽略,安装前务必彻底退出。

macOS 用户:照着这七步走,基本不会出错

macOS 的安装入口是一个可双击的脚本文件 install-mac.command,完整流程如下:

  1. 退出 Claude Desktop,克隆项目仓库:git clone https://gitcode.com/gh_mirrors/cl/claude-desktop-zh-cn
  2. 双击install-mac.command,终端窗口弹出后按提示选择安装模式;
  3. 模式有两个主流选项:完整补丁(支持官方账号和第三方 API,包含在线页面汉化和模型名校验绕过)与跳过结构性修改(不动app.asar,适合依赖 Cowork 沙箱/工作区的用户);
  4. 选择语言变体:1 简体、2 繁体(中国台湾)、3 繁体(中国香港);
  5. 按提示输入 Mac 登录密码,脚本会先做备份再打补丁;
  6. 安装完成后 Claude 会自动重新打开;
  7. 如果界面没自动切到中文,打开左下角账号菜单,在Language里手动选择对应的中文选项即可。

需要提醒的是:macOS 完整补丁会修改app.asar并对应用做本机 ad-hoc 重签名,这与新版 Claude 对 Cowork 沙箱的校验存在冲突。日常依赖 Cowork 的用户,请优先考虑第二种模式。

Windows 用户:一次管理员授权,剩下的交给脚本

Windows 端的入口是 install-windows.bat,右键以管理员身份运行即可:

  1. 退出 Claude Desktop,克隆项目仓库(地址同上);
  2. 右键"以管理员身份运行"install-windows.bat,脚本会复制安装文件到临时目录并弹出 UAC 授权窗口;
  3. 选择安装模式:**模式 1(Cowork 兼容 / 第三方 API)**会跳过app.asar修改,保住 Cowork 沙箱和截图工作区;**模式 2(官方账号在线汉化)**提供最完整的界面翻译,但会让Claude.exe的签名变成哈希不匹配,Cowork 可能拒绝启动;
  4. 选择语言变体,然后等待脚本自动备份、写入中文资源并重启 Claude Desktop。

需要说明的是,模式 2 的完整汉化依赖对app.asar的修改,签名变化属于预期现象,不影响日常使用;如果你每天都要用到 Cowork,请老老实实选模式 1。

装完先看效果:中文界面长这样

下面这张图是补丁安装后 Claude Desktop 的主界面,左侧导航和各个功能入口都已经是中文,观感跟英文原版没有差别:

用第三方 API 的用户,请重点读这一节

很多国内用户不是直接订阅官方账号,而是通过第三方 API 网关接入模型,这类用户的配置界面在汉化后长这样:

两个平台都支持第三方 API,但有一个容易踩的坑:新版 Claude Desktop 会对第三方网关的模型名做本地校验,像deepseek-v4-prokimi-*这类模型名可能导致整个配置失效。补丁的处理方式分平台不同:

  • macOS 完整补丁模式:通过等长替换关闭本地模型名校验,这些模型名可以直接使用;
  • Windows 模式 1:不做结构性修改,因此需要你在网关或 CC Switch 里把模型映射成 Claude/Anthropic 风格的名称。

另外,补丁还附带一个实用功能:把 CC Switch 里的 skills 同步到 Claude Desktop(扫描~/.cc-switch/skills下包含SKILL.md的目录,自动创建软链接并更新 manifest)。取消同步时只删除之前创建的软链接,不会动你的源目录,也不覆盖同名 skill。

翻车了别慌:备份、恢复、更新,一次讲清

新手最担心的就是"装坏了怎么办"。这个项目的安全设计,本质上就是围绕"随时可以反悔"来做的。

安装前自动备份。macOS 会把原始应用备份成/Applications/Claude.backup-before-zh-CN-*.app;Windows 会在安装目录的resources\.zh-cn-backups里保存所有被修改文件的原始版本。

一键恢复原样。重新运行安装脚本,选择"恢复原样 / 卸载补丁",macOS 会用最早的备份恢复应用,Windows 会从备份恢复文件并把语言设置改回en-US

关于版本更新。Claude Desktop 更新可能覆盖补丁,推荐的顺序是:先恢复原样 → 更新 Claude Desktop → 用本项目最新版本重新安装。安装时脚本还会询问你是否禁止自动更新,选y就能避免补丁被后台更新悄悄覆盖。

如果遇到的问题自己搞不定,也可以扫码进项目的用户交流群,把脚本日志发出来求助:

高频疑问速答

装完之后会影响运行速度吗?基本不会。补丁只替换界面文本资源和少量本地配置,对内存占用和启动速度的影响可以忽略不计。

在线页面偶尔还有英文,正常吗?正常。在线页面由 claude.ai 动态更新,DOM 汉化依赖英文原文匹配,上游改文案后可能出现少量漏翻,等词表更新就好。

没有 Python 环境也能装吗?macOS 需要 Python 3;Windows 完全不需要,系统自带的 PowerShell 就够了。

两种模式能来回切换吗?可以,但脚本会先清理上一轮补丁再装新的。与其反复横跳,不如先想清楚自己是否依赖 Cowork。

需要花多少钱?项目完全免费开源,没有任何收费项。

最后说两句

说到底,这个补丁解决的是一个很朴素的问题:让工具贴合使用者的语言习惯。对中文开发者、内容创作者和普通用户来说,它省掉的是每天面对英文界面时那一点不必要的认知负担;对依赖第三方 API 的用户来说,它还顺带解决了模型名校验的麻烦。

装之前记住两条就行:依赖 Cowork 就选跳过结构性修改的模式,想要最完整的中文体验就选完整模式;装完如果没自动切换,去左下角账号菜单的Language里手动选一次。剩下的事,脚本都会替你处理妥当。

【免费下载链接】claude-desktop-zh-cnClaude Desktop Chinese Patch (macOS & Windows)项目地址: https://gitcode.com/gh_mirrors/cl/claude-desktop-zh-cn

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

← 返回列表