# claude-zh **Repository Path**: BraveCao/claude-zh ## Basic Information - **Project Name**: claude-zh - **Description**: Claude 桌面版简体中文汉化:翻译文件 自动安装脚本 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-02 - **Last Updated**: 2026-07-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Claude 桌面版汉化 (claude-zh) 给 **Claude Desktop(Claude.app)** 加简体中文界面。新版应用自带 en-US、ja-JP、ko-KR 等 11 种语言,但**没有简体中文**,且支持语言写死在一个 JS 数组里,所以 Language 菜单里 根本没有中文可选。本项目补上中文翻译并把「中文」加进语言列表。 ## 界面分两层,两套机制 新版 Claude 桌面版的界面由两部分组成,各有独立的翻译系统: 1. **主界面**(侧边栏、设置、对话、Gateway 等)——由 `Contents/Resources/ion-dist/` 下的 i18n 系统渲染,约 **18000 条**文案。这是绝大部分你看到的界面。 - 支持语言写死在 `ion-dist/assets/v1/*.js` 的一个数组里,需要打补丁把 `zh-CN` 加进去; - 翻译文件放 `ion-dist/i18n/zh-CN.json`(主)、`i18n/dynamic/zh-CN.json`(必需)、 `i18n/zh-CN.overrides.json`(可选)。主文件和 dynamic 文件**缺失会导致切中文时报错**, 所以必须都在。 2. **外壳菜单**(macOS 顶部 File/Edit/View、右键菜单、系统对话框)——由 `Contents/Resources/.json` 那套控制,约 **435 条**,key 是内容哈希。 `install.py` 会把这两层一起装好。 ## 文件 - `translate.py` — 批量翻译脚本:读应用的 `en-US.json`,逐批翻成中文,写入 `translations/zh-CN.json`。走 Google 翻译,**需要能访问 Google 的网络环境**。 - `install.py` — **一键安装流程**(推荐入口),四步走完检查与安装。 - `localize_ui.py` — 主界面(ion-dist)汉化的底层逻辑,`install.py` 复用它。 - `localize.py` — 外壳菜单(Resources)汉化的底层逻辑。 - `translations/zh-CN.json` — 主界面中文翻译(约 18000 条)。 - `translations/dynamic/zh-CN.json` — 模型/思考模式等动态描述(已人工翻译)。 - `translations/overrides-zh-CN.json` — 术语修正覆盖层(由 fix_terms.py 生成)。 - `zh-CN.json` — 外壳菜单中文翻译(435 条)。 - `terms.json` — 术语修正表(可编辑,见「修正术语」)。 - `fix_terms.py` — 按术语表修正机翻并生成 overrides。 - `compat.json` — 记录已验证适配的应用版本。 ## 使用(三步) ```bash cd /Users/caoyong/claude-zh # 1) 生成翻译(需能访问 Google;断点续传,中断后重跑会跳过已翻的) python3 translate.py # 2) 一键安装(主界面 + 外壳菜单一起装) python3 install.py # 3) 完全退出并重启 Claude → Settings → Language 选择「中文」 ``` 未翻译的条目会用英文兜底,不会报错。若第 1 步网络不通,可跳过直接跑第 2 步, 界面会保持英文但语言选项里会出现「中文」。 ### install.py 的四步流程 1. 检查应用安装路径及版本(读 `Info.plist`)。 2. 检查翻译覆盖率、判断是否支持。 3. 安装:3a 主界面(打补丁加中文选项 + 装 3 个翻译文件),3b 外壳菜单。所有被覆盖的 文件都会先备份(`*.bak-时间戳`)。 4. 提醒完全退出并重启应用。 ### 常用命令 ```bash python3 install.py # 交互式一键安装 python3 install.py --yes # 全自动,跳过确认 python3 install.py --status # 只检查状态与覆盖率,不改动 python3 install.py --restore # 撤销汉化(恢复备份、删除中文文件) python3 install.py --app "/Applications/Claude.app" # 指定应用路径 ``` 翻译脚本可调参数:`--workers` 并发批数、`--batch-chars` 每批字符上限、`--limit` 限量调试。 若无写入权限,安装命令前加 `sudo`。 ## 修正术语 机器翻译会把一些术语译错(如 Artifact→文物、Token→代币、Model→型号、Sonnet→十四行诗、 Session→会议、Claude→克劳德)。`terms.json` 里维护了一份修正表,`fix_terms.py` 会按 **英文原文**精确定位后做词级替换,安全地改掉这些词。 想新增或调整术语,编辑 `terms.json` 的 `rules`(每条:英文含 `en` 时把中文里的 `wrong` 换成 `right`;`wrong` 留空表示只保留不替换),整句都要重写的放 `fixed`(key 为内容哈希)。 然后: ```bash python3 fix_terms.py --dry # 预览会改哪些,不写盘 python3 fix_terms.py # 应用:更新主翻译 + 生成 overrides-zh-CN.json python3 install.py # 装入应用 # 重启 Claude 生效 ``` 修正会同时写进主翻译和 `overrides-zh-CN.json`(安装时作为 overrides 覆盖层,双保险)。 ## 应用升级后 升级会覆盖 `ion-dist`,中文选项和翻译都会消失。恢复很简单,重跑三步即可: ```bash python3 translate.py # 补翻新版新增的条目(老的自动跳过) python3 install.py # 重新打补丁 + 装翻译 ``` 然后彻底重启 Claude、重新在 Language 里选中文。 ## 说明 - 翻译由机器翻译生成,个别词可能不准。术语类问题在 `terms.json` 里加规则后跑 `fix_terms.py`(见「修正术语」);单条整句不准可直接在 `terms.json` 的 `fixed` 里重写。 - 安装会修改 `/Applications/Claude.app` 内的文件。所有改动前均有备份,可用 `--restore` 撤销。