把 Claude Code 的终端界面换成简体中文（claude-code-zh-cn）

Claude Code 是跑在终端里的 AI 编程助手。它的界面文字硬编码在一个 13MB 的 cli.js 里，官方没有做 i18n 基础设施，也没有中文界面。提示语、等待动画、快捷键说明、命令帮助、用量提醒，全是英文。对英文不熟的开发者，这些碎片信息每天都在分散注意力。

claude-code-zh-cn 是 Claude Code CLI 的简体中文本地化插件，用 JavaScript 写成，MIT 许可。一条安装命令把终端界面、等待提示和默认回复换成简体中文。

插件靠四层机制落地中文化：设置注入、Hook 系统、插件系统、CLI Patch。安装脚本会自动检测你用的是哪种 Claude Code 安装方式，包括 npm 包、官方安装器的原生二进制，以及 Windows 的 native .exe。Claude Code 更新之后插件会自动修复；遇到还没验证过的新版本，它会自动降级，翻不了的部分保持英文，CLI 本体保持可启动。

它不做什么

仓库不包含 Claude Code 本体。要用它，得先有一个能跑的 claude 命令，没有的话先按官方方式安装 Claude Code。

中文化覆盖的是界面文案，覆盖不完整。README 里写明，遇到暂未适配的新文案时对应内容保持英文。所以刚升级完 Claude Code 的那几天，界面上会中英文混排。

平台范围是 macOS、Linux、WSL 和 Windows。README 列出的就是这四个，没有提到 Claude Desktop 这类图形客户端。

原生二进制的支持受版本约束。字节码构建是在原字符串的占位里写入中文，译文超过占位长度时只能保留英文，这不是配置能改的。Linux x64 glibc 未收录的版本需要通过本机验证，并需要 node-lief >=1.3.0。

卸载脚本无法判断 language、spinnerTipsEnabled、spinnerTipsOverride、spinnerVerbs 这几个字段是插件写入还是你自己配的，会统一删除。手动维护过这些字段的话，先自行备份。

用之前先准备好什么

• 已经装好 Claude Code，终端里能直接敲 claude。
• Node.js。CLI Patch 这一步需要它；内网无网络或没预装 Node.js 的环境不能只复制插件目录，要按 docs/offline-install.md 准备便携运行环境、依赖和本地源码。
• 可选装 jq。
• Windows native .exe 用户，如果当前 Claude Code 是 2.1.113 及以上，先运行 npm install -g node-lief。不装的话 Layer 4 的 CLI Patch 会跳过，Layer 1~3 不受影响。
• 走完整脚本的 Windows 用户需要 PowerShell 5.1+，Windows 10/11 自带。
• 要把中文设置同步进 CC Switch 的话，安装脚本会先询问，同意后才写。

主要功能

一行远程安装。已经有 claude 命令的机器上跑 curl -fsSL https://github.com/taekchef/claude-code-zh-cn/releases/latest/download/install-remote.sh | bash，脚本会从最新 Release 拉源码包并执行安装，不需要保留本地 clone。

插件市场安装。三平台通用，两条命令把项目登记为插件市场再装插件，全程不依赖本地仓库：

claude plugin marketplace add --scope user https://github.com/taekchef/claude-code-zh-cn
claude plugin install claude-code-zh-cn@claude-code-zh-cn --scope user

界面文案汉化。v2.20.0 的发布说明里 uiTranslations 计数是 2172 条，覆盖 slash 命令描述、快捷键提示面板、用量额度提示、auto mode 引导等。代表版本 2.1.112 实测 1749 处有效 patch。

等待动画与提示中文化。187 个趣味 spinner 动词，41 条中文提示，回复耗时也换成中文，例如把 Photosynthesizing... 显示成「光合作用中...」，把耗时显示成「琢磨了 1分23秒」。

会话内切换语言。装好之后在输入框直接敲 /chinese（或 /zh）切回中文，/english（或 /en）切回英文。这一步由 UserPromptSubmit Hook 拦截处理，不消耗 token。界面里硬编码的那部分文案要重启 Claude Code 才完全生效。

补充安装 skill。在 Claude Code 里说「帮我运行 zh-cn-setup」，或者手动执行 node "${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js"，脚本会补齐缺失的 spinner 配置、检测并同步 CC Switch 通用配置、报告 patch 状态。它只补齐缺失项，不覆盖你已有的手动配置。

诊断脚本。仓库根目录有 doctor.sh 和 doctor.ps1，./doctor.sh --json 可以输出 JSON 格式的检查结果，排查「装完没汉化」这类问题时用得上。

卸载与还原。远程安装用户跑 uninstall-remote.sh，本地源码用户跑 ./uninstall.sh，Windows 跑 uninstall.ps1。卸载会还原 CLI 备份，移除中文设置、Hook 和插件注册，其他 Claude Code 配置保留。

安装与最短示例

macOS、Linux、WSL 上最快的路径是那行远程安装命令。Windows 原生完整脚本的步骤是：

git clone https://github.com/taekchef/claude-code-zh-cn.git
cd claude-code-zh-cn
powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1

装完重启一次 Claude Code。看到「思考中」「蹦迪中」「光合作用中」这类中文提示，就说明 spinner 和提示已经生效。想顺手确认覆盖情况，可以用 /chinese 触发一次语言切换，再跑一遍 ./doctor.sh --json。

关键参数

settings 层面会被写入的字段是 language、spinnerTipsEnabled、spinnerTipsOverride、spinnerVerbs。这几个字段决定了回复语言、提示开关和 spinner 词表，卸载时会一并删除。

翻译 skill 描述时，如果 skill 不在 ~/.claude 下，用 ZH_CN_SKILL_I18N_EXTRA_ROOTS 传入真实目录，Windows 多个目录用分号分隔，macOS/Linux 用冒号分隔。译文保留英文备份，可用 node "${CLAUDE_PLUGIN_ROOT}/skill-i18n/restore.js" --all 还原。

CC Switch 数据库里的 skill 描述要单独处理，工具是 cc-switch-descriptions.js，默认只读预览，加 --apply 才写入并自动备份数据库。CLI Patch 的守卫探测支持 --main-table-only 旗标隔离主表。

结果在哪里看

最直接的观察点是重启后的终端界面：spinner 动词、提示行、快捷键面板、帮助屏文案。AI 的默认回复语言由 language 字段控制，切换后不重启也会变。

想知道 CLI Patch 到底改了多少处，看 ./doctor.sh --json 的输出。已收录的平台与版本清单在 docs/support-matrix.md，README 里也提到它不代表完整中文覆盖。同步过 CC Switch 的话，中文设置会出现在 CC Switch 的 Claude「通用配置」里。

实际使用中的坑

「装完没反应，还是英文」是 Issue 区出现频率最高的一类，相关条目评论数在 7 到 12 之间。多数是安装方式与版本没对上，或者装完没重启。当前状态是已解决，仓库提供了 doctor 脚本和 zh-cn-setup skill 来做自检。

用 cc-switch 切换模型之后插件被重置，有一条 11 条评论的 Issue。原因是中文设置写进了 CC Switch 的通用配置，切供应商时可能被覆盖回去。已解决，卸载说明里也提醒了手动维护过这些字段的用户先备份。

被强制升级到 2.1.161 之后中文环境丢失，有用户尝试设置 DISABLE_AUTOUPDATER=1 但没生效。这条已解决，思路是让插件在更新后自动重新 patch，而不是阻止更新。

2.1.252 版本的「没汉化」问题目前仍是待解决状态，是 Issue 列表里少数没有收敛的条目。遇到同类现象可以先跑 doctor 确认是版本未适配还是安装环节出了问题。

横向对照

同为 Claude Code 生态里的插件，下面两个和本项目能解决部分相同的问题——都要通过 Claude Code 的插件机制装进同一个环境，但各自解决的问题不重合。

两个对比项都不做界面汉化，本项目也不提供任何新的 agent 能力或上下文管理，它们在这一点上没有替代关系。要说本项目不如人的地方：它靠补丁改写 Claude Code 的内部文案，Claude Code 每发一版就可能出现一段适配空窗，未适配的部分退回英文；而它的价值又完全绑定在 Claude Code 这一个工具上，换工具就得重找方案。如果你的问题不是语言，而是会话记忆或者多工具协同，这个插件一个字都帮不上。

适合谁

英文界面影响阅读效率、每天都在终端里用 Claude Code 的开发者，适合装它。团队里英文水平参差的，也适合先给统一换上中文界面再排查问题。

需要在离线内网环境部署的，按 docs/offline-install.md 准备运行环境之后同样可以用。手上只有 Claude Desktop 这类图形客户端、或者 Claude Code 版本远远落后于支持矩阵的，先别装，等适配了再上。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.4 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。