Claude Code 是一个很棒的终端 AI 编程助手，但它没有中文界面。当前 stable 支持窗口内，UI 文字主要硬编码在一个 13MB 的 cli.js 里，没有 i18n 基础设施。
官方短期内不太可能加中文支持。所以我做了这个插件，通过四层机制（设置注入 + Hook 系统 + 插件系统 + CLI Patch）实现中文化，自动检测安装方式，更新后自动修复。
安装前：
⠙ Photosynthesizing...
Tip: Press Shift+Tab to switch between default, auto-accept edits, and plan modes
安装后：
⠙ 光合作用中...
💡 按 Shift+Tab 在默认模式、自动接受编辑模式和 Plan 模式之间切换
更多画风：
⠙ 蹦迪中... ⠙ 七荤八素中... ⠙ 搞事情中...
⠙ 瞎忙活中... ⠙ 花里胡哨中... ⠙ 变魔术中...
琢磨了 1分23秒
187 个趣味 spinner 动词，41 条中文提示，回复耗时中文化，AI 默认中文回复。装完即用。
| 你现在的情况 | 建议 |
|---|---|
| 想要最完整、最稳的中文化 | 用旧 npm pinned：npm install -g @anthropic-ai/claude-code@2.1.112，CLI Patch 支持最完整 |
| macOS arm64 已在 native 验证窗口内 | 可走 experimental native patch；需要先装 node-lief |
| native 版本刚高于已验证窗口，但仍是同一 minor 线 | 安装时会尝试本机自验证；通过才临时启用 CLI Patch，不等于已发布支持 |
用 latest / next，或版本不在已验证窗口内 |
不满足本机自验证边界时只启用 Layer 1~3；Layer 4 CLI Patch 会跳过 |
| Windows PowerShell | 旧 npm cli.js 路径最稳；Windows native .exe 用户先 npm install -g node-lief 再运行 install.ps1 |
| 被 Claude Code 自动升级后丢中文 | DISABLE_AUTOUPDATER 属于 Claude Code 本体；先看 claude doctor 的 Updates 段，再按 support matrix 判断插件是否已发布支持 |
| 系统 / 通道 | 当前口径 | 已验证窗口 | 说明 |
|---|---|---|---|
| macOS / npm 全局安装 | stable |
2.1.92 - 2.1.112 |
启动前 launcher 自修复 + session-start 二层兜底 |
| macOS / 官方安装器 | experimental |
2.1.110 - 2.1.112 |
指定旧版本的 native 二进制已验证；插件可用 native patch 处理，需要 node-lief，稳定仍建议 npm pinned |
| macOS / native binary | experimental |
2.1.113 - 2.1.173（不含未纳入本轮支持的 2.1.115、2.1.125、2.1.127、2.1.130、2.1.134、2.1.135、2.1.147、2.1.149、2.1.151、2.1.154、2.1.155、2.1.157、2.1.163、2.1.164、2.1.166、2.1.171、2.1.172） |
当前 macOS arm64 native 已验证 extract / patch / repack / --version + 11 个稳定显示面审计；需要 node-lief；未验证新版本会安全跳过 CLI Patch |
| Linux / npm 全局安装 | stable |
2.1.92 - 2.1.112 |
与 npm stable 同口径 |
| Linux / 官方安装器 | unsupported |
- | 当前不承诺支持 |
| Windows / npm 全局安装 (PowerShell) | stable |
2.1.92 - 2.1.112 |
新增 PowerShell 安装脚本（install.ps1）；适用于旧 npm cli.js 形态，CLI Patch 可用；需 PowerShell 5.1+ |
| Windows / native .exe | experimental |
2.1.113 - 2.1.162（不含未纳入本轮支持的 2.1.115、2.1.125、2.1.127、2.1.130、2.1.134、2.1.135、2.1.147、2.1.149、2.1.151、2.1.154、2.1.155、2.1.157） |
当前 Windows x64 native 已验证 extract / patch / repack / --version + 11 个稳定显示面审计；需要 node-lief；未验证新版本会安全跳过 CLI Patch |
| Windows / WSL + npm 全局安装 | 跟随 npm stable |
2.1.92 - 2.1.112 |
必须在 WSL 终端内运行，使用 install.sh |
Windows 用户（原生 PowerShell）：现已新增 PowerShell 安装脚本（install.ps1），可在 Windows 10/11 上原生安装旧 npm cli.js 形态的 Claude Code（
2.1.92 - 2.1.112），无需 WSL。见下方「Windows 原生安装」章节。Windows 用户（WSL）：也可先安装 WSL，然后在 WSL 中安装 Claude Code 和本插件。
Windows native .exe experimental：Windows x64 native binary experimental；需要 node-lief；仅代表列出的已验证版本
2.1.113 - 2.1.162（不含未纳入本轮支持的2.1.115、2.1.125、2.1.127、2.1.130、2.1.134、2.1.135、2.1.147、2.1.149、2.1.151、2.1.154、2.1.155、2.1.157），已通过 extract / patch / repack /--version+ 11 个稳定显示面审计，不代表 future latest 自动稳定。未验证的 latest 会跳过 CLI Patch；如需最稳，请使用npm install -g @anthropic-ai/claude-code@2.1.112。支持边界单一来源：当前口径以 docs/support-matrix.md 为准。该文档由
scripts/upstream-compat.config.json+node scripts/verify-upstream-compat.js --json通过node scripts/generate-support-matrix.js生成。最新版说明：Claude Code 从
2.1.113开始，npm 主包切换为 native binary wrapper，不再包含旧的cli.js。本插件当前 stable CLI Patch 支持到2.1.112；macOS arm64 native binary 现在有独立 experimental 通道，已验证2.1.113 - 2.1.114、2.1.116 - 2.1.124、2.1.126、2.1.128 - 2.1.129、2.1.131 - 2.1.133、2.1.136 - 2.1.146、2.1.148、2.1.150、2.1.152 - 2.1.153、2.1.156、2.1.158 - 2.1.162、2.1.165、2.1.167 - 2.1.170、2.1.173的二进制改写链路和 11 个稳定显示面。Windows x64 native 也有独立 experimental 通道，已验证2.1.113 - 2.1.114、2.1.116 - 2.1.124、2.1.126、2.1.128 - 2.1.129、2.1.131 - 2.1.133、2.1.136 - 2.1.146、2.1.148、2.1.150、2.1.152 - 2.1.153、2.1.156、2.1.158 - 2.1.162的二进制改写链路和 11 个稳定显示面。2.1.115、2.1.125、2.1.127、2.1.130、2.1.134、2.1.135、2.1.147、2.1.149、2.1.151、2.1.154、2.1.155、2.1.157、2.1.163、2.1.164、2.1.166、2.1.171、2.1.172未纳入本轮支持；latest不是 stable 承诺，未验证的新版本会跳过 CLI Patch。
自动更新边界：本插件的“自动更新”只同步中文插件的已发布 Release；
DISABLE_AUTOUPDATER/DISABLE_UPDATER是 Claude Code 本体升级开关，不由本插件兜底。是否生效请看claude doctor的 Updates 段。
当前安装方式口径如下：
| 安装方式 | 说明 | 当前口径 |
|---|---|---|
npm install -g @anthropic-ai/claude-code@2.1.112 |
推荐安装的旧 cli.js 版本；2.1.92 - 2.1.112 范围内也可用 |
stable |
npm install -g @anthropic-ai/claude-code |
npm 全局安装最新版；macOS arm64 / Windows x64 若版本正好在已验证 native 窗口内可走 experimental | experimental / skipped（未验证 native 版本会跳过 CLI Patch） |
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.112 |
官方安装器指定旧版本 | experimental（macOS arm64 已验证；插件会用 native patch 处理，需要 node-lief） |
Claude Code native binary 2.1.113 - 2.1.173（macOS arm64，不含未纳入本轮支持的 2.1.115、2.1.125、2.1.127、2.1.130、2.1.134、2.1.135、2.1.147、2.1.149、2.1.151、2.1.154、2.1.155、2.1.157、2.1.163、2.1.164、2.1.166、2.1.171、2.1.172） |
当前已验证的 native binary 版本，显示审计 11/11 PASS | experimental（需要 node-lief） |
curl -fsSL https://claude.ai/install.sh | sh |
官方安装器 latest | experimental / skipped（只有明确验证版本会启用 CLI Patch） |
powershell -File install.ps1 |
Windows PowerShell 安装（旧 npm cli.js 为 stable；Windows x64 native 2.1.113 - 2.1.162 为 experimental，需要 node-lief） |
stable / experimental（需 PowerShell 5.1+） |
安装脚本会自动检测安装方式，无需手动选择。
native binary 说明：官方安装器和新版 npm 包都可能装到 native 二进制，不是旧 npm
cli.js。本插件的处理方法是：用bun-binary-io.js提取二进制里的 JS → 复用patch-cli.sh翻译 → 再写回二进制。macOS arm642.1.110 - 2.1.112已在临时目录验证通过；2.1.113 - 2.1.114、2.1.116 - 2.1.124、2.1.126、2.1.128 - 2.1.129、2.1.131 - 2.1.133、2.1.136 - 2.1.146、2.1.148、2.1.150、2.1.152 - 2.1.153、2.1.156、2.1.158 - 2.1.162、2.1.165、2.1.167 - 2.1.170、2.1.173额外通过 11 个稳定显示面审计。运行时需要node-lief。要最稳，请优先使用 npm pinned 安装方式。不支持的安装方式：如当前安装方式暂不支持 CLI Patch，安装脚本会明确提示并只启用 Layer 1~3，不会误报“已完成全部 patch”。
本机自验证说明：如果 native 版本刚高于当前已发布支持窗口、但仍在同一 minor 版本线内，安装器会在本机临时尝试 extract / patch / repack /
--version。只有这一步通过才会写入provisionalpatch 记录；doctor 会明确提示“尚未纳入已发布支持窗口”。已明确排除的版本不会进入这条路径。
一行安装最新发布版：
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 |
要固定到最完整支持的旧版本，再用官方入口指定版本：curl -fsSL https://claude.ai/install.sh | bash -s 2.1.112。
远程安装会记录 GitHub Release 来源，插件发布新版本后，SessionStart hook 的自动更新仍然生效；不需要保留本地 clone。
如果你要改翻译或调试脚本，再用本地源码安装：
git clone https://github.com/taekchef/claude-code-zh-cn.git
cd claude-code-zh-cn
./install.sh安装脚本会自动：
- ✅ 备份现有
~/.claude/settings.json和cli.js（或原生二进制） - ✅ 合并中文设置到 settings.json
- ✅ 检测到 CC Switch 通用配置缺少中文设置时，先询问用户；同意后才同步，拒绝则给出手动处理步骤
- ✅ 安装插件到
~/.claude/plugins/claude-code-zh-cn/ - ✅ 在 stable 安装方式上 patch 硬编码文字（1794 条翻译；当前 stable 代表版本
2.1.112实测 1555 处有效 patch，显示审计 11/11 PASS） - ✅ 在 macOS native experimental 已验证版本上 patch 硬编码文字（
2.1.113 - 2.1.114、2.1.116 - 2.1.124、2.1.126、2.1.128 - 2.1.129、2.1.131 - 2.1.133、2.1.136 - 2.1.146、2.1.148、2.1.150、2.1.152 - 2.1.153、2.1.156、2.1.158 - 2.1.162、2.1.165、2.1.167 - 2.1.170、2.1.173实测 1320-1405 处，显示审计 11/11 PASS） - ✅ 如当前安装方式暂不支持 CLI Patch 或缺少
node-lief，自动跳过 Layer 4 并保留 Layer 1~3
git clone https://github.com/taekchef/claude-code-zh-cn.git
cd claude-code-zh-cn
powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1install.ps1 会自动完成与 install.sh 相同的步骤：依赖检查、插件同步、Launcher 安装、Settings 合并、CLI Patch（旧 npm cli.js 稳定支持；Windows x64 native 已验证版本为 experimental）、元数据写入。
CLI Patch 支持范围：install.ps1 可 patch 旧 npm cli.js 形态（
2.1.92 - 2.1.112），也可在安装了node-lief时 experimental patch Windows x64 native2.1.113 - 2.1.162（不含2.1.115、2.1.125、2.1.127、2.1.130、2.1.134、2.1.135、2.1.147、2.1.149、2.1.151、2.1.154、2.1.155、2.1.157）。检测到未验证 Windows native .exe 或缺少node-lief时，会明确跳过 CLI Patch，只启用 Layer 1~3（设置 + Hook + 插件）。如需最稳，请使用npm install -g @anthropic-ai/claude-code@2.1.112安装旧 npm 版本。Windows native patch experimental 本机自验证：如果 Windows native 版本刚高于已验证窗口但仍在同一 minor 线内，安装时会尝试本机自验证，通过才临时启用 CLI Patch；这不等于已发布支持窗口。
Windows native 用户先装 node-lief：如果当前 Claude Code 是
@anthropic-ai/claude-code2.1.113+ native.exe，请先运行npm install -g node-lief，再运行powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1。未安装时 Layer 4 CLI Patch 会跳过；未进已发布窗口的同 minor 版本即使本机自验证通过，也仍会标记为provisional。注意：PowerShell 脚本要求 PS 5.1+（Windows 10/11 自带）。
- Claude Code CLI 版本请先对照 docs/support-matrix.md
- Node.js（CLI Patch 需要）
- 可选：jq（更精准的 JSON 合并）
- 可选：
node-lief（macOS / Windows native experimental 适配需要：npm install -g node-lief；旧版 npm cli.js 路径不需要）
重启 Claude Code 后，发送任意请求。如果看到 spinner 显示“思考中”、“光合作用中”等中文，说明 Layer 1~3 已生效。若安装脚本还显示了 CLI Patch 成功摘要，或 npm 路径升级后首次启动未先掉回关键英文，则 Layer 4 也已启用。
安装后若不确定 Layer 4 是否生效、或 UI 仍是英文，可运行诊断脚本（会检测安装形态、settings、patch 记录，并给出下一步命令）：
macOS / Linux / WSL：
./doctor.shWindows PowerShell：
powershell -NoProfile -ExecutionPolicy Bypass -File .\doctor.ps1如果你手上只有已安装插件，也可以直接运行：
macOS / Linux / WSL：
bash ~/.claude/plugins/claude-code-zh-cn/bin/doctorWindows PowerShell：
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.claude\plugins\claude-code-zh-cn\bin\doctor.ps1"机器可读输出：
- macOS / Linux / WSL：
./doctor.sh --json或bash ~/.claude/plugins/claude-code-zh-cn/bin/doctor --json - Windows PowerShell：
powershell -NoProfile -ExecutionPolicy Bypass -File .\doctor.ps1 --json或powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.claude\plugins\claude-code-zh-cn\bin\doctor.ps1" --json
退出码 0 = 无阻塞项，1 = 需要处理。
如果你使用 CC Switch，doctor 也会只读检查它的 Claude 通用配置是否包含中文设置。缺失时，重新运行 ./install.sh 并同意同步即可；如果你不想让安装器修改 CC Switch，也可以按 FAQ 里的手动步骤处理。
Claude Code 更新后，插件会在首次会话启动时自动检测版本变更并重新 patch，无需手动操作。
插件本体发布新 Release 后，远程安装用户通常不需要手动更新；本地源码安装用户如需手动更新插件本体：
cd claude-code-zh-cn
git pull
./install.shWindows 上：
cd claude-code-zh-cn
git pull
powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1远程安装用户可直接运行：
curl -fsSL https://github.com/taekchef/claude-code-zh-cn/releases/latest/download/uninstall-remote.sh | bash本地源码安装用户运行：
cd claude-code-zh-cn
./uninstall.shWindows 上：
cd claude-code-zh-cn
powershell -NoProfile -ExecutionPolicy Bypass -File uninstall.ps1精准移除插件注入的设置，保留你的其他配置不变。
原版 Claude Code 的 spinner 有一堆故意搞怪的英文动词（Flibbertigibbeting、Photosynthesizing、Moonwalking...），我们全部按原味翻译了：
| 英文 | 中文 | 英文 | 中文 | |
|---|---|---|---|---|
Thinking |
思考中 | Moonwalking |
太空步中 | |
Photosynthesizing |
光合作用中 | Flibbertigibbeting |
叽里呱啦中 | |
Discombobulating |
七荤八素中 | Whatchamacalliting |
那个啊来着中 | |
Shenaniganing |
搞事情中 | Razzmatazzing |
花里胡哨中 | |
Boondoggling |
瞎忙活中 | Prestidigitating |
变魔术中 | |
Clauding |
克劳丁中 | Boogieing |
蹦迪中 | |
Canoodling |
腻歪中 | Spelunking |
探洞中 |
完整 187 个翻译见 verbs/zh-CN.json
| 功能 | 数量 | 怎么做的 |
|---|---|---|
| AI 回复语言 | - | language: Chinese |
| Spinner 动词 | 187 个 | spinnerVerbs |
| Spinner 提示 | 41 条 | spinnerTipsOverride |
| 中文上下文注入 | - | SessionStart Hook |
| 通知翻译 | 6 条 | Notification Hook |
| 输出风格 | - | Chinese Output Style |
| UI 文字中文化 | 1794 条翻译，2.1.112 实测 1555 处有效 patch；macOS native experimental 2.1.113 - 2.1.114、2.1.116 - 2.1.124、2.1.126、2.1.128 - 2.1.129、2.1.131 - 2.1.133、2.1.136 - 2.1.146、2.1.148、2.1.150、2.1.152 - 2.1.153、2.1.156、2.1.158 - 2.1.162、2.1.165、2.1.167 - 2.1.170、2.1.173 实测 1320-1405 处；固定显示面审计均为 11/11 PASS |
CLI Patch（扫描真实双引号字符串 token 后逐条替换）+ 显示面审计 |
| 自动重 patch | - | 版本检测，更新后首次会话重新 patch；不控制 Claude Code 本体是否升级 |
| 插件自动更新 | - | SessionStart Hook（只跟随本插件已发布 Release tag，不兜底 DISABLE_AUTOUPDATER） |
展开看四层架构
当前 stable 支持窗口内，Claude Code CLI 是一个 13MB 的单文件压缩包（cli.js），UI 文字硬编码其中，没有 i18n 基础设施。本项目通过四层机制实现中文化：
language: 控制 AI 回复语言spinnerTipsOverride: 替换等待提示文字spinnerVerbs: 替换 spinner 动词
SessionStart: 会话启动时注入中文上下文指令 + 检测插件 Release 更新 + 检测版本自动重 patchNotification: 拦截系统通知并翻译
- 标准 Claude Code 插件格式
- 提供 Chinese Output Style
- 基于 Node.js 的字符串字面量扫描器，先扫描真实双引号字符串 token，再逐条替换
- 显式排除注释、模板字符串、正则字面量中的
"，避免误改代码结构 - 从
cli-translations.json读取翻译，按长度降序批量替换 - 覆盖：状态消息、按钮文字、错误提示、设置页面、导航、快捷键说明等
- 在当前安装方式不支持或缺少依赖时，Layer 4 会被明确跳过，不影响 Layer 1~3
session-starthook 会限频检查插件 Release tag；检测到新发布版本时自动同步安装态session-starthook 检测版本变更与 patch 规则变更，自动重新 patch- 有版本校验的备份机制，
uninstall.sh可还原
稳定性：Layer 1~3 完全不受 Claude Code 更新影响
Layer 4 自动检测并重新 patch
插件自动更新只跟随已发布 Release，不跟随 main 未发布 commit
claude-code-zh-cn/
├── README.md ← 你在这里
├── LICENSE ← MIT
├── CHANGELOG.md ← 版本变更记录
├── install.sh ← 一键安装 (macOS/Linux)
├── doctor.sh ← 安装诊断（Layer 1–4 状态与建议）
├── doctor.ps1 ← 安装诊断 (Windows PowerShell)
├── install.ps1 ← 一键安装 (Windows PowerShell)
├── uninstall.sh ← 一键卸载 (macOS/Linux)
├── uninstall.ps1 ← 一键卸载 (Windows PowerShell)
├── _validate.ps1 ← PowerShell 语法验证工具
├── patch-cli.sh ← CLI Patch 入口脚本
├── patch-cli.js ← CLI Patch 核心逻辑（扫描字符串字面量后逐条替换）
├── bun-binary-io.js ← 原生二进制 I/O 工具（官方安装器 native experimental）
├── cli-translations.json ← 1794 条 UI 翻译对照表
├── settings-overlay.json ← 合并到 settings.json 的中文设置
├── plugin/
│ ├── manifest.json ← 插件清单
│ ├── hooks.json ← Hook 事件配置
│ ├── bun-binary-io.js ← 原生二进制 I/O（与根目录拷贝一致）
│ ├── hooks/
│ │ ├── session-start ← 注入中文上下文 + 自动 patch
│ │ ├── session-start.ps1 ← 同上 (Windows PowerShell)
│ │ ├── session-start.cmd ← CMD 包装器调用 session-start.ps1
│ │ ├── notification ← 通知翻译
│ │ ├── notification.ps1 ← 同上 (Windows PowerShell)
│ │ └── notification.cmd ← CMD 包装器调用 notification.ps1
│ ├── bin/
│ │ ├── doctor ← 安装诊断 (macOS/Linux/WSL)
│ │ ├── doctor.ps1 ← 安装诊断 (Windows PowerShell)
│ │ ├── claude-launcher.sh ← PATH 注入 launcher (macOS/Linux)
│ │ ├── claude-launcher.ps1 ← PATH 注入 launcher (Windows PowerShell)
│ │ └── claude-launcher.cmd ← PATH 注入 launcher (CMD)
│ └── output-styles/
│ └── chinese.json ← 中文输出风格
├── tips/
│ ├── en.json ← 英文原文（对照）
│ └── zh-CN.json ← 中文翻译
└── verbs/
└── zh-CN.json ← 187 个中文动词
想调整翻译？直接编辑对应的 JSON 文件：
# 编辑 spinner 提示
vim tips/zh-CN.json
# 编辑 spinner 动词
vim verbs/zh-CN.json编辑完后重新运行 ./install.sh 即可生效。
Claude Code 更新后会失效吗？
Layer 1~3（设置、Hook、插件）完全不受影响。Layer 4（CLI Patch）会在支持窗口内自动检测版本变更并重新 patch。
这不等于本插件能阻止 Claude Code 本体升级。DISABLE_AUTOUPDATER / DISABLE_UPDATER 归 Claude Code 自己处理，是否生效请看 claude doctor 的 Updates 段；如果已升到 support matrix 未收录的新窗口，请等本插件发布支持，或临时退回已验证版本。
注意：Claude Code 从 2.1.113 开始，npm latest 切换为 native binary wrapper，不再包含旧的 cli.js。当前 stable CLI Patch 支持到 2.1.112。macOS arm64 native binary 走 experimental 通道，已验证 2.1.113 - 2.1.114、2.1.116 - 2.1.124、2.1.126、2.1.128 - 2.1.129、2.1.131 - 2.1.133、2.1.136 - 2.1.146、2.1.148、2.1.150、2.1.152 - 2.1.153、2.1.156、2.1.158 - 2.1.162、2.1.165、2.1.167 - 2.1.170、2.1.173 的二进制改写链路和 11 个稳定显示面；2.1.115、2.1.125、2.1.127、2.1.130、2.1.134、2.1.135、2.1.147、2.1.149、2.1.151、2.1.154、2.1.155、2.1.157、2.1.163、2.1.164、2.1.166、2.1.171、2.1.172 未纳入本轮支持，未验证 latest 不代表 stable 支持。
插件发布新版本后需要手动重新安装吗？
通常不需要。SessionStart hook 会限频检查已发布的 Release tag；如果发现本地安装版本落后，会自动同步到最新 Release。
注意：
- 自动更新只跟随已发布的 Release tag
- 不会跟随
main上未发布的开发中 commit - 远程安装不需要保留本地 clone；本地源码安装需要保留安装时使用的源码仓库，否则插件仍可继续使用，只是不会自动更新
用 CC Switch 切换供应商后，中文设置又变回去了怎么办？
这是 CC Switch 切换供应商时重写了 ~/.claude/settings.json。新版安装器检测到 CC Switch 的 Claude 通用配置缺少中文设置时，会先询问是否帮你同步；只有你同意后才会修改 CC Switch 的本地数据库，并且会先备份。
你可以直接重新运行：
./install.sh看到提示后选择“帮我同步”。如果是非交互环境，可以显式授权：
ZH_CN_CCSWITCH_SYNC=1 ./install.shWindows PowerShell：
$env:ZH_CN_CCSWITCH_SYNC = "1"; .\install.ps1如果选择自己处理，在 CC Switch 中编辑 Claude 供应商，打开“编辑通用配置”，点击“从编辑内容提取”并保存；之后确认要切换的供应商勾选了“写入通用配置”。
会不会破坏 Claude Code 原有功能？
不会。安装脚本在修改任何文件前都会先备份，且所有 patch 都是纯文字替换。如果有问题，运行 ./uninstall.sh 一键恢复。
支持哪些系统？
macOS、Linux 和 Windows（原生 PowerShell 或 WSL）。需要 Node.js。可选依赖 jq（用于更精准的 JSON 合并）。
Windows：现已支持通过 install.ps1 在 PowerShell 5.1+ 中原生安装。也可以继续通过 WSL 使用 install.sh。
能自定义翻译吗？
可以！编辑 tips/zh-CN.json 和 verbs/zh-CN.json，然后重新运行 ./install.sh 即可。
和 VS Code 扩展的中文化项目有什么区别？
本项目是终端 CLI 的中文化，不依赖 VS Code。zstings/claude-code-zh-cn 是 Claude Code VS Code 扩展的汉化，两者互补。
欢迎 PR！
- 翻译改进 → 编辑
tips/zh-CN.json或verbs/zh-CN.json - 新功能 → 添加 hook 或 output style
- Bug / 没汉化 / 没生效 → 提 诊断 Issue，请带上
doctor --json输出、安装方式、版本和关键路径
- UI 字符串提取自 Claude Code
- 灵感来自 zstings/claude-code-zh-cn（Claude Code VS Code 扩展中文汉化）
claude-code-zh-cn is a Simplified Chinese localization plugin for Claude Code CLI.
It translates 187 spinner verbs, 41 spinner tips, 1794 UI translations, notification messages, and more. The patch combines safe string scanning for legacy cli.js plus an experimental macOS arm64 native-binary path for explicitly verified versions from 2.1.113 through 2.1.173 except unsupported 2.1.115, 2.1.125, 2.1.127, 2.1.130, 2.1.134, 2.1.135, 2.1.147, 2.1.149, 2.1.151, 2.1.154, 2.1.155, 2.1.157, 2.1.163, 2.1.164, 2.1.166, 2.1.171, 2.1.172, now guarded by stable display-surface auditing. On Windows, a PowerShell install script (install.ps1) is available for the old npm cli.js form (2.1.92–2.1.112). Windows native .exe is experimental for explicitly verified versions from 2.1.113 through 2.1.162 except unsupported 2.1.115, 2.1.125, 2.1.127, 2.1.130, 2.1.134, 2.1.135, 2.1.147, 2.1.149, 2.1.151, 2.1.154, 2.1.155, 2.1.157; unverified latest builds are skipped for CLI Patch (Layers 1–3 still active). Current support windows are documented in docs/support-matrix.md.
git clone https://github.com/taekchef/claude-code-zh-cn.git
cd claude-code-zh-cn
./install.shSee full documentation above (in Chinese). PRs and issues welcome!
本项目不是 Anthropic 官方产品。Claude Code 是 Anthropic Inc. 的商标。