Claude Code Zh

claude-code-zh —— Claude Code 中文化

能做什么 / 做不到什么

| 层级 | 能不能 | 说明 | | --- | --- | --- | | ① AI 全程中文回复 | ✅ | 写一段指令到 ~/.claude/CLAUDE.md,所有 session 永久生效 | | ② 命令中文 tooltip | ✅ | PostToolUse hook,跑命令后弹中文解释,不碰 Claude 本体 | | ③ 中文状态栏(statusline) | ✅ | 自前轻量 bash 脚本,经 settings.json 的 statusLine 输出「模型名 / 目录 / git 分支 / 上下文用量」。上下文段带进度条+颜色(<70 绿 / 70-84 黄 / ≥85 红+⚠ /compact)。默认不启用,ccstatus on 开启。 | | ④ 界面 chrome(菜单//config 面板) | ❌ | Claude Code v2.1.113+ 已是编译二进制,无 cli.js,字符串替换汉化方案全部失效。别尝试改二进制(会破坏代码签名 + 升级即失效)。 |

如何使用

一键安装

bash install.sh

• 把中文回复指令写进 ~/.claude/CLAUDE.md(用 `` 标记包裹,可逆)
• 安装 tool-tips-post.sh 到 ~/.claude/hooks/
• 用 python3 幂等地把 PostToolUse hook 写进 ~/.claude/settings.json(安装前自动备份为 settings.json.zh.bak)

安装后重启 Claude Code,tooltip 才会加载;中文回复指令下个 session 全局生效。

中文状态栏(可选)

ccstatus on       # 开启:底部显示 🌸 🤖 模型 │ 📁 目录 │ 🌿 分支 │ ctx ▓▓▓░░ 72% /200k
ccstatus off      # 关闭(还原你原来的 statusLine)
ccstatus status   # 查看当前状态

默认不启用;开启会备份你已有的 statusLine,关闭时还原。改动 settings.json 后需重启 Claude Code 生效。

卸载

bash uninstall.sh

干净移除四处改动(CLAUDE.md 区块、settings.json 条目、hook 脚本、statusline/ccstatus 脚本及别名)。statusLine 若被 ccstatus 开过会先还原再删。

工作原理

• 中文回复:靠 CLAUDE.md 指令引导模型语言,不改任何二进制,零风险。
• tooltip:tool-tips-post.sh 从 stdin 读工具调用 JSON,识别 Bash/Read/Write/Edit/Grep/MCP 等,输出 {"systemMessage":"🌸 ... 🌸"},Claude Code 把它显示给用户。脚本只打印,不写文件、不联网、不执行下载内容,exit 0。

自定义

• 嫌 tooltip 太吵:把 settings.json 里该 hook 的 "matcher": "" 改成 "matcher": "Bash"(只在跑命令时提示)。
• 改/加命令翻译:编辑 ~/.claude/hooks/tool-tips-post.sh 里的 desc_shell 函数。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: YuAICode
• Source: YuAICode/ai-skills
• License: MIT

Install and usage instructions live in the source repository linked above.