claude-desktop-zh-cn-macos

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

claude-desktop-zh-cn-macos

★ 13 Open GitHub ↗

Claude Desktop macOS zh-CN installer

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Claude Desktop macOS 中文安装器

给 macOS 版 Claude Desktop 添加简体中文界面的安装器。

本项目只提供安装脚本、检查脚本、回滚脚本和使用文档。中文语言资源会在安装时从公开汉化项目拉取：

<https://github.com/javaht/claude-desktop-zh-cn>

这样做可以保持本仓库干净，避免复制第三方翻译资源，也方便上游更新后继续使用。

## 功能

- 给 Claude Desktop 添加 `zh-CN` 语言包
- 自动把 Claude 语言设置为简体中文
- 兼容常见的 `Claude` 和 `Claude-3p` 配置目录
- 安装前保留原始 Claude.app 备份
- 提供检查和回滚脚本

## 支持环境

- macOS
- 已安装 Claude Desktop
- 系统自带 `/usr/bin/python3`
- 已安装 `git`

## 安装

```bash
git clone https://github.com/QuanShengLi0508/claude-desktop-zh-cn-macos.git
cd claude-desktop-zh-cn-macos
chmod +x scripts/*.sh
./scripts/install.sh
```

如果 `/Applications/Claude.app` 由 root 管理，使用：

```bash
sudo ./scripts/install.sh
```

安装完成后 Claude 会重新打开。若界面没有立即切换，彻底退出 Claude 后再打开一次，或到 Claude 的语言菜单中选择 `中文（中国）`。

## 发布到 GitHub

先登录 GitHub CLI：

```bash
gh auth login
```

然后在仓库根目录运行：

```bash
./scripts/publish-github.sh claude-desktop-zh-cn-macos
```

默认创建 public repo。若要改成私有仓库：

```bash
VISIBILITY=private ./scripts/publish-github.sh claude-desktop-zh-cn-macos
```

## 检查

```bash
./scripts/doctor.sh
```

它会检查：

- `zh-CN.json` 是否已写入 Claude.app
- 用户配置里的 `locale` 是否为 `zh-CN`
- Claude 当前进程是否以中文语言启动

## 回滚

安装器会把原始应用备份到类似下面的位置：

```text
/Applications/Claude.backup-before-zh-CN-20260430-172749.app
```

回滚到最近一次备份：

```bash
./scripts/rollback.sh
```

如果 `/Applications` 需要管理员权限：

```bash
sudo ./scripts/rollback.sh
```

## 常见问题

### 为什么官方设置中文后还是英文？

Claude Desktop 当前版本没有内置 `zh-CN` 主界面语言包。只改 macOS 语言偏好或 `config.json` 不够，应用会回退到英文。本安装器会把中文语言包写入应用资源，再把 locale 指向 `zh-CN`。

### 更新 Claude 后中文没了？

Claude Desktop 更新会覆盖 `/Applications/Claude.app`，重新运行：

```bash
./scripts/install.sh
```

### 这个项目会读取或上传 API Key 吗？

不会。本项目只改本地语言资源和 locale 配置，不读取、打印或上传任何 API Key。

## 许可证

本仓库脚本与文档使用 MIT License。

中文翻译资源来自上游项目，版权与授权请遵循上游仓库说明。

claude-desktop-zh-cn-macos

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README