Airsc miễn phí cho tất cả. Nếu nó giúp bạn, hãy ủng hộ $2–$20.

Ủng hộ
PluginCẩn thậnTài liệu & nội dungDễ cho người mới

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,一行安装,更新后自动修复。

806 sao42Giấy phép: MITCập nhật 4 ngày trước0 lượt mở

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

Cẩn thậ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 的压缩文件内。我们通过分层解耦实现无损汉化:

  1. Layer 1 原生设置注入:直接注入 settings.json(动词、提示、语言),上游版本更新也不会丢失。
  2. Layer 2 Hook 系统:在会话启动和通知弹出时无感注入中文能力。
  3. Layer 3 插件规范:遵循官方 Plugin 体系,挂载标准能力。
  4. 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.285Linux x64 glibc 已验证版本(需要 node-lief >=1.3.0);不含 arm64、musl 或未验证版本
powershell -File install.ps1Windows:旧 npm cli.js 最完整;native
Xem mã nguồn trên GitHub