claude-chinese-patch

KO | EN

gitlite — search

#hacktoberfest #ai #llm #golang #go #deep-learning #linux #nodejs #macos #awesome #cli #kubernetes #mcp #openai

claude-chinese-patch

(★ 12)

claude code desktop 中文补丁包

claude-chinese-patch Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Claude Desktop 中文语言补丁

为 Claude Desktop 应用添加简体中文支持。

## 背景

Claude Desktop 无中文翻译文件（`zh_CN.json`），本项目通过翻译系统内置语言包来实现对简体中文的支持。

**当前适配版本：Claude Desktop 1.11847.5**

## 文件说明

| 文件 | 安装目标路径 | 说明 |
|------|-------------|------|
| `1.json` | `Resources/ion-dist/i18n/zh-CN.json` | Web 前端主翻译（15966 条） |
| `3.json` | `Resources/zh-CN.json` | Electron 主进程翻译（422 条） |
| `4.json` | `Resources/ion-dist/i18n/zh-CN.overrides.json` | Web 前端翻译覆盖（300 条） |
| `dynamic/zh-CN.json` | `Resources/ion-dist/i18n/dynamic/zh-CN.json` | 动态翻译（65 条） |
| `Localizable.strings` | `Resources/zh_CN.lproj/Localizable.strings` | macOS 原生本地化 |
| `install.sh` | — | 一键安装脚本（macOS） |
| `install-windows.exe` | — | **Windows 一键安装（推荐，双击即可）** |
| `install-windows.py` | — | Windows 安装脚本源码（Python） |
| `uninstall-windows.exe` | — | **Windows 卸载（双击即可）** |
| `uninstall-windows.py` | — | Windows 卸载脚本源码（Python） |

> `2.json`（Statsig 翻译）在当前版本中已不再需要，Statsig 目录已被移除。

---

## macOS 安装方法

### 前提条件

- macOS
- Claude Desktop 已安装（`/Applications/Claude.app`）

### 一键安装

```bash
cd claude-chinese-patch-main
sudo bash install.sh
```

### 手动安装

如脚本无法运行，可手动执行：

```bash
RES="/Applications/Claude.app/Contents/Resources"

# 复制翻译文件
cp 3.json "$RES/zh-CN.json"
cp Localizable.strings "$RES/zh_CN.lproj/Localizable.strings"
cp 1.json "$RES/ion-dist/i18n/zh-CN.json"
cp 4.json "$RES/ion-dist/i18n/zh-CN.overrides.json"
mkdir -p "$RES/ion-dist/i18n/dynamic"
cp dynamic/zh-CN.json "$RES/ion-dist/i18n/dynamic/zh-CN.json"

# 修补前端语言列表（变量名可能随版本变化）
grep -rl '"en-US","de-DE"' "$RES/ion-dist/assets/" | xargs sed -i '' 's/"en-US","de-DE"/"en-US","zh-CN","de-DE"/'
```

### 安装后

1. **Cmd+Q** 完全退出 Claude Desktop（不是关闭窗口）
2. 重新打开 Claude Desktop
3. 进入 **Settings → Language** 选择「中文」
4. 如果 macOS 系统语言已设置为简体中文，应用会自动切换

### macOS 卸载

```bash
RES="/Applications/Claude.app/Contents/Resources"
rm "$RES/zh-CN.json"
rm "$RES/ion-dist/i18n/zh-CN.json"
rm "$RES/ion-dist/i18n/zh-CN.overrides.json"
rm "$RES/ion-dist/i18n/dynamic/zh-CN.json"
```

---

## Windows 安装方法

> **来源：公众号「名侦探科男」**

### 前提条件

- Windows 10/11
- Claude Desktop 已安装（Windows Store / UWP 版本）
- PowerShell（管理员权限）

### 一键安装（推荐：无需任何环境）

**直接双击 `install-windows.exe` 运行即可**，会自动弹出 UAC 管理员授权并完成安装。

### 一键安装（Python 版）

如果你有 Python 环境，推荐使用 Python 版（有更友好的提示）：

```powershell
cd C:\Users\你的用户名\Desktop\claude-chinese-patch-main
python install-windows.py
```

> Python 脚本不受 PowerShell 执行策略限制，无需修改任何系统设置。

### 安装后

1. 完全退出 Claude Desktop（右键系统托盘图标 → 退出）
2. 重新打开 Claude Desktop
3. 进入 **Settings → Language** 选择「中文」

### 卸载

**直接双击 `uninstall-windows.exe`**，或运行：

```powershell
python uninstall-windows.py
```

### Windows 版注意事项

- Claude Desktop（Windows）安装在 `C:\Program Files\WindowsApps\Claude_*`，属于受保护的 UWP 目录，脚本会自动申请写入权限
- Windows 版**无需** `Localizable.strings`（这是 macOS 原生本地化文件）
- Claude 更新后会覆盖补丁文件，需重新运行脚本
- 若 JS 修补失败（界面看不到中文选项），翻译文件仍然安装成功，将 Windows 系统显示语言设置为「中文（简体）」后 Claude 会自动使用中文

---

## 通用注意事项

- Claude Desktop 更新后会覆盖修改，需要重新运行补丁
- 脚本使用动态搜索定位 JS 文件，兼容更新后变量名变化（如 `wj=`、`HP=` 等）
- `.lproj` 目录保持下划线格式（`zh_CN.lproj`），这是 macOS 标准，不需要修改
- `.zst` 压缩缓存无需处理，应用会自动从 `.json` 重新生成

## 兼容性

| 平台 | 支持 | 说明 |
|------|------|------|
| macOS | ✅ | 使用 `install.sh` |
| Windows（Store/UWP） | ✅ | 使用 `install-windows.exe` 或 `.py` |
| Windows（.exe 安装包） | ⚠️ | 路径可能不同，需手动调整 |

## 更新日志

### 2026-06-10（适配 Claude Desktop 1.11847.5）

- **1.json**: 13230 → 15966 条翻译，新增 4366 条，移除 1630 条过期条目
- **3.json**: 361 → 422 条翻译，新增 63 条
- **Localizable.strings**: 大幅更新，覆盖新增的 UI 文本
- **新增** `dynamic/zh-CN.json`（65 条翻译）
- **移除** `statsig` 目录支持（该目录在新版 Claude 中已不存在）
- **更新** `install.sh`：语言列表变量名适配（`wj=` 替代旧的 `HP=`）
- **更新** `install-windows.py`：移除 statsig，新增 dynamic 目录支持

claude-chinese-patch

claude-chinese-patch Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

claude-chinese-patch

claude-chinese-patch Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README