Claude Code 中文本地化

---

为什么做这个？

Claude Code 是一个很棒的终端 AI 编程助手，但它没有中文界面。UI 文字主要硬编码在一个 13MB 的 cli.js 里，没有 i18n 基础设施。

官方短期内不太可能加中文支持。所以我做了这个插件，通过四层机制（设置注入 + Hook 系统 + 插件系统 + CLI Patch）实现中文化，自动检测安装方式，更新后自动修复。遇到还没验证过的新版本也不怕：插件会自动降级——翻不了的部分保持英文，CLI 绝不会坏。

效果预览

安装前：

⠙ Photosynthesizing...

  Tip: Press Shift+Tab to switch between default, auto-accept edits, and plan modes

安装后：

⠙ 光合作用中...

  💡 按 Shift+Tab 在默认模式、自动接受编辑模式和 Plan 模式之间切换

更多画风：

⠙ 蹦迪中...          ⠙ 七荤八素中...         ⠙ 搞事情中...
⠙ 瞎忙活中...        ⠙ 花里胡哨中...         ⠙ 变魔术中...

  琢磨了 1分23秒

187 个趣味 spinner 动词，41 条中文提示，回复耗时中文化，AI 默认中文回复。装完即用。

支持范围

平台 / 安装形态	已验证版本窗口	说明
macOS / Linux / WSL · npm 全局安装	2.1.92 - 2.1.112	翻译最完整；launcher 启动前自修复 + session-start 兜底
macOS · 官方安装器（native）	2.1.110 - 2.1.112	需要 node-lief
macOS · native binary（arm64）	2.1.113 - 2.1.211 内的已验证版本	需要 node-lief；个别版本未收录，见支持矩阵
Windows · npm（PowerShell）	2.1.92 - 2.1.112	用 install.ps1，需 PowerShell 5.1+
Windows · native .exe（x64）	2.1.113 - 2.1.211 内的已验证版本	需要 node-lief；个别版本未收录，见支持矩阵
Linux · 官方安装器	暂无已验证版本	仅 Layer 1~3 生效

• 版本号不是运行门禁：高于已知 native 下限、且仍能被识别的新版会先在本机临时提取、翻译、重打包并执行启动自检；通过后才替换。已有词条继续中文，新文案原样保留英文。
• 失败不伤 CLI：补丁、重打包或启动自检任一步失败，都会保留或恢复原文件；失败只影响中文覆盖，不影响 Claude Code 使用。
• Windows 不热改运行中的 exe：Claude Code 更新后先保持原版可用；关闭所有 Claude Code 窗口，再按 Windows 安装命令重跑 install.ps1，由安装器补丁并自检。
• 格式变化才停手：如果未来版本不再是可识别的 native 格式、依赖缺失、提取失败或启动自检失败，只跳过 Layer 4，Layer 1~3 继续生效。
• 矩阵只记录证据：纯上游兼容证据可以更新支持矩阵，不要求插件升版；只有插件代码、翻译或 manifest 变化才发布新版。
• 已验证版本完整清单（含个别未收录版本）见 docs/support-matrix.md，由脚本自动生成。
• Claude Code 从 2.1.113 起 npm 主包切换为 native binary，不再包含旧的 cli.js；要最完整的翻译请用 npm install -g @anthropic-ai/[email protected]。

自动更新边界：正式安装态由 Claude Code 插件管理器更新；旧环境的独立兜底安装只跟随本插件已发布 Release。Claude Code 本体升级不要求中文插件同步升版本；DISABLE_AUTOUPDATER / DISABLE_UPDATER 仍由 Claude Code 本体处理。

Skill / 插件命令说明自动汉化

除了 cli.js 界面文字，本插件还能汉化用户安装的 skill 和插件 / 命令的功能说明——安装新 skill/插件后，开启本功能，下次启动 Claude Code 时，它们在 / 命令列表、/skill、/plugin 界面里的描述会翻译成简体中文。

⚠ 开启前请知情：本功能会修改本机文件——改写 ~/.claude/ 下 skill 的 SKILL.md、command 的 .md、插件的 plugin.json/marketplace.json 的 description 字段。原文备份到 description_en（JSON 为 _description_en），可用 node plugin/skill-i18n/restore.js --all 一键还原，卸载时也会自动还原。description 同时用于 model 自动触发 skill，翻译会影响触发判断（现代多语言 LLM 对中文描述触发良好）。

• 默认禁用，需显式开启：设 ZH_CN_SKILL_I18N_ENABLE=1 后，SessionStart hook 才会后台增量扫描（默认不跑，不消耗 token/额度）。
• 覆盖范围：用户与插件的 skill/command（递归扫描 ~/.claude/{skills,commands} + plugins/{cache,marketplaces}）、插件元数据（plugin.json / marketplace.json）。
• 翻译引擎：默认用 claude CLI（零配置）；可配 OpenAI / Anthropic 兼容 API 加速。
• 可逆：原文备份（description_en + 标记），restore.js --all 一键还原，卸载时自动还原。

详细配置（环境变量、API 接入、权衡说明）见 plugin/skill-i18n/README.md。

职责边界：本功能只翻译用户安装的 skill/插件说明。CC 自带命令（/cd、/help 等）的汉化仍由 cli.js patch（上方翻译表）覆盖。

快速开始

安装

一行安装最新发布版：

curl -fsSL https://github.com/taekchef/claude-code-zh-cn/releases/latest/download/install-remote.sh | bash

这条命令会从本项目最新 GitHub Release 下载源码包，然后执行同一套 install.sh。它和官方安装器的区别：

命令	装什么	什么时候用
curl -fsSL https://github.com/taekchef/claude-code-zh-cn/releases/latest/download/install-remote.sh | bash	中文本地化插件	已经有 claude 命令，只想安装/更新中文插件
curl -fsSL https://claude.ai/install.sh | sh	Claude Code 本体	还没有 claude 命令，或要先安装官方 CLI

远程安装会优先把本项目登记到 Claude Code 插件管理器；当前 CLI 不支持正式注册时，才启用等价的独立 Hook 兜底，不需要保留本地 clone。

如果你要改翻译或调试脚本，再用本地源码安装：

git clone https://github.com/taekchef/claude-code-zh-cn.git
cd claude-code-zh-cn
./install.sh

安装脚本会自动：