Airsc is free for everyone. If it helps you, support it with $2–$20.

Support
VISign in
PluginCautionDocs, writing & contentBeginner friendly

claude-code-zh-cn

taekchef · taekchef/claude-code-zh-cn

A plugin that localizes the Claude Code CLI into Simplified Chinese, changing UI text, prompts, and system notifications for a fully translated experience.

Claude Code CLI 简体中文本地化 / 汉化插件；支持 macOS、Linux、WSL、Windows 与新版 native，一行安装，更新后自动修复。

806 stars42License: MITUpdated 5 days ago0 opens

Preview

▍

What you can do with it

  • Use Claude Code with a fully localized Simplified Chinese interface.
  • Switch Claude Code's language between Chinese and English during a session.
  • Receive system notifications and prompts in Chinese when interacting with Claude Code.

Safety check

Caution

Usable, but read the notes first.

  • ●Installer downloads a remote script and pipes it to the shell.install-remote.sh

Automated scan of the repo files. Always review code you run.

From the 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
View source on GitHub