claude-code-zh-cn
taekchef · taekchef/claude-code-zh-cn
Một plugin bản địa hóa Claude Code CLI sang tiếng Trung giản thể, thay đổi văn bản giao diện người dùng, lời nhắc và thông báo hệ thống để có trải nghiệm được dịch hoàn chỉnh.
Claude Code CLI 简体中文本地化 / 汉化插件;支持 macOS、Linux、WSL、Windows 与新版 native,一行安装,更新后自动修复。
Xem trước
Bạn có thể làm gì với nó
- Sử dụng Claude Code với giao diện tiếng Trung giản thể được bản địa hóa hoàn chỉnh.
- Chuyển đổi ngôn ngữ của Claude Code giữa tiếng Trung và tiếng Anh trong một phiên làm việc.
- Nhận thông báo hệ thống và lời nhắc bằng tiếng Trung khi tương tác với Claude Code.
Kiểm tra an toàn
Dùng được, nhưng nên đọc ghi chú trước.
- ●Trình cài đặt tải script từ xa và chạy thẳng bằng shell.
install-remote.sh
Quét tự động các file trong repo. Luôn xem lại code trước khi chạy.
Trích từ README
claude-code-zh-cn
Claude Code 简体中文本地化插件
让终端里的 Claude Code 彻底说人话 🇨🇳
English · 简体中文 · 官方网站 · Codex 中文版
187 个趣味 spinner 动词,41 条中文提示,回复耗时中文化;另有 2194 条界面翻译。
macOS · Linux · WSL · Windows
一行远程安装 · 启动自愈修复 · 会话内随时切中英文
📢 赞助商
claude-code-zh-cn × Infistar.cc 无限星河
跑 Claude Code 自动写代码与长会话,Token 消耗极大,还常卡在海外信用卡和 429 报错 💸。
推荐 Infistar 的中转服务,体验顺手:
- ⚙️ 配置零成本:设好
ANTHROPIC_BASE_URL即跑,全面兼容 Claude Code 与本地化插件。 - 🏷️ 价格打穿底线:低至官方 0.1 折起,倍率透明,挂着 Agent 疯狂刷代码不心疼。
- 🧩 主流模型聚合:Claude、DeepSeek、GPT、Gemini 一个 Key 全搞定。
- 💳 国人友好:人民币直付免海外卡,支持开票,全模型可验真。
- 🎁 专属福利:通过 专属推广通道 注册立送 $5 试跑额度,先领了跑几轮长会话测测代码生成效果 🚀!
🧐 为什么搞这个?
Claude Code 是个很顶的终端 AI 编程助手,但官方把整个界面硬编码在一个 13MB 的大文件里,短期内根本指望不上官方出中文。
敲代码已经够掉头发了,凭什么等待时还要面对冷冰冰的洋文 loading?
于是就有了这个项目 —— 一条命令,把终端界面、等待提示、耗时统计、系统通知全都变成地道中文,还把官方放飞自我的怪话动词全译成了中式幽默!
👀 效果预览
https://github.com/user-attachments/assets/ff572893-f927-402c-9217-f68f04f4c9d5
原版在装模作样地 Photosynthesizing...,现在直接:
⠙ 光合作用中...
💡 按 Shift+Tab 在默认模式、自动接受编辑模式和 Plan 模式之间切换
还有更多接地气的画风:
⠙ 蹦迪中... ⠙ 七荤八素中... ⠙ 搞事情中...
⠙ 瞎忙活中... ⠙ 花里胡哨中... ⠙ 变魔术中...
琢磨了 1分23秒
装完即用,AI 回复也默认优先说中文。
⚡ 极速安装
选项 A:极速脚本(推荐)
macOS / Linux / WSL 用户直接在终端粘贴回车:
curl -fsSL https://github.com/taekchef/claude-code-zh-cn/releases/latest/download/install-remote.sh | bash
Windows 用户通过 PowerShell 运行:
git clone https://github.com/taekchef/claude-code-zh-cn.git
cd claude-code-zh-cn
powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1
选项 B:通过 Claude Code 官方插件市场安装
如果你已经在用 Claude Code 的插件体系:
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
装好后重启一次 Claude Code,看到“光合作用中”或“思考中”即表示大功告成!
🔄 会话内无痛切换中英文(0 Token 消耗)
查英文资料、或者遇到疑难 bug 想跟海外社区对齐报错时,完全不需要卸载重装!
直接在 Claude Code 的输入框里输入:
| 命令 | 效果 |
|---|---|
/chinese(或 /zh) | 瞬间切回中文界面与趣味提示 |
/english(或 /en) | 瞬间切回原汁原味的英文界面 |
底层的 Hook 会在输入时直接拦截处理,不消耗任何 token,毫秒级响应。
🎭 187 个整活动词大赏
原版 Claude Code 的 loading 动词里藏了一堆开发者的精神状态(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 |
| 系统通知 | 6 条 | Notification Hook 拦截翻译 |
| UI 文字中文化 | 2314 条翻译,2.1.112 实测 1777 处有效 patch | 字符串 Token 安全 Patch |
| 防崩与降级 | 全自动 | 启动前校验,失败自动回滚英文,绝不损坏 CLI |
展开查看:四层架构技术原理(怎么做到既汉化又不搞崩 CLI?)
Claude Code 的 UI 文字硬编码在 13MB 的压缩文件内。我们通过分层解耦实现无损汉化:
- Layer 1 原生设置注入:直接注入
settings.json(动词、提示、语言),上游版本更新也不会丢失。 - Layer 2 Hook 系统:在会话启动和通知弹出时无感注入中文能力。
- Layer 3 插件规范:遵循官方 Plugin 体系,挂载标准能力。
- Layer 4 安全 Patch:
- 基于 Node.js 的字符串字面量扫描器,只改显示文本,绝不误触代码逻辑、注释或正则表达式。
- 永远从原始纯净备份进行补丁,拒绝“补丁叠补丁”。
- 包含严格的语法校验和启动自检。即使遇到未适配的全新上游版本,patch 硬编码文字(2314 条翻译;代表版本
2.1.112实测 1777 处有效 patch)也能安全降级为英文,保证你的 Claude Code 永远可用。
💻 支持环境与版本
macOS arm64 的 Claude Code 2.1.296 显示模块包含 using 语法,界面补丁需用 Node.js 24+ 运行。旧 Node 会在语法校验时拒绝该补丁并保留当前程序和备份;等待动词等设置不受影响。
| 平台 / 安装形态 | 已验证版本窗口 | 说明 |
|---|---|---|
| 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.295 内的已验证版本 | 需要 node-lief;个别版本未收录,见支持矩阵 |
| Linux · native binary(x64 glibc) | 2.1.220 - 2.1.285 | 需要 node-lief >=1.3.0;未收录版本先本机验证,不含 arm64、musl |
| Windows · npm(PowerShell) | 2.1.92 - 2.1.112 | 用 install.ps1,需 PowerShell 5.1+ |
| Windows · native .exe(x64) | 2.1.113 - 2.1.289 内的已验证版本 | 需要 node-lief;个别版本未收录,见支持矩阵 |
| Linux · 其他官方安装器形态 | 暂无已验证版本 | 仅 Layer 1~3 生效 |
- macOS / Windows 版本号不是运行门禁:高于已知 native 下限、且仍能被识别的新版会先在本机临时副本上翻译并执行启动自检;通过后才替换。已有词条继续中文,新文案原样保留英文。
- Linux 本机验证:Linux x64 glibc 的未收录版本先按程序结构和启动自检验证;不支持 arm64、musl,不代表未来版本全量兼容。
- 失败不伤 CLI:补丁、重打包或启动自检任一步失败,都会保留或恢复原文件;失败只影响中文覆盖,不影响 Claude Code 使用。
- Windows 不热改运行中的 exe:Claude Code 更新后先保持原版可用;关闭占用窗口后通过已安装的
claude启动器再次启动,自动补丁并自检,无需重装。- 格式变化才停手:如果未来版本不再是可识别的 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/claude-code@2.1.112。
| 安装方式 | 中文化程度 |
|---|---|
npm install -g @anthropic-ai/claude-code@2.1.112 | 最完整(推荐) |
npm install -g @anthropic-ai/claude-code(latest) | macOS / Windows native 新版先本机自检;Linux x64 glibc 新版先本机自检 |
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.112 | 官方安装器指定已验证旧版本(需要 node-lief) |
curl -fsSL https://claude.ai/install.sh | sh(latest) | macOS 新版先本机自检;Linux x64 glibc 新版先本机自检 |
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.285 | Linux x64 glibc 已验证版本(需要 node-lief >=1.3.0);不含 arm64、musl 或未验证版本 |
powershell -File install.ps1 | Windows:旧 npm cli.js 最完整;native |