Are you the author? Sign in to claim
🌸 Claude Code 界面汉化工具 + 实用 Hooks 集合
⚠️ 重要版本兼容性公告 (2025-05)
Anthropic 从 Claude Code v2.1.113 开始将 npm 包从 Node.js 脚本 (
cli.js) 改为编译二进制 (claude.exe)。 这导致所有基于字符串替换的界面汉化方案彻底失效,包括本项目的界面汉化功能。
Claude Code 版本 工具提示 Hook 界面汉化 ≤ 2.1.112 ✅ 可用 ✅ 可用 ≥ 2.1.113 ✅ 可用 ❌ 已失效 工具提示 Hook 不受影响,所有版本均可正常使用。界面汉化功能等待后续适配方案。
🌸 让 Claude Code 拥有中文体验!工具提示 Hook,专为编程小白设计(界面汉化仅支持 ≤ 2.1.112 版本)
每个 Claude Code 执行的操作都会显示中文提示,让你清楚知道它在做什么:




⚠️ 以上界面汉化截图来自旧版本(≤ 2.1.112)。新版 Claude Code(≥ 2.1.113)已改为编译二进制,此功能无法使用。
| 原文 (English) | 译文 (中文) |
|---|---|
| Welcome back! | 欢迎回来! |
| Auto-compact | 自动压缩 |
| Thinking mode | 深度思考模式 |
| Esc to cancel | Esc 取消 |
| Enter to submit · Esc to cancel | Enter 提交 · Esc 取消 |
| Recent activity | 最近活动记录 |
| Tips for getting started | 入门技巧 |
| 命令类型 | 示例命令 | 中文解释 |
|---|---|---|
| GitHub CLI | gh run list | 🚀 列出 GitHub Actions 运行记录(查看自动化测试历史) |
gh auth status | 🔐 检查 GitHub 登录状态(看是否已登录、登录的是哪个账号) | |
gh repo create | 📦 在 GitHub 上创建新仓库(新建一个代码存储库) | |
| Git | git push | 📚 推送到远程仓库(上传代码到服务器) |
git log | 📜 查看提交日志(看所有修改记录) | |
git status | 📊 查看工作区状态(哪些文件改了) | |
| npm | npm install | 📦 安装依赖包(下载项目所需的库) |
npm run build | 🏗️ 构建项目(编译打包代码) | |
| pip | pip install | 📦 安装 Python 包(下载 Python 库) |
pip list | 📋 列出已安装的包(查看 Python 库) | |
| 网络 | curl | 🌐 获取网页内容(下载或查看网页数据) |
ping | 🌐 测试网络连接(检查能否连上某个地址) | |
| 文件 | cat | 📖 查看文件内容(打开文本文件阅读) |
mkdir | 📁 创建新目录(新建文件夹) |
💡 支持 100+ 常用命令的详细中文解释!
| 功能 | NPM 安装 | 手动/脚本安装 | 版本要求 |
|---|---|---|---|
| 📖 工具提示 Hook (tool-tips-post.sh) | ✅ | ✅ | 所有版本 |
| 🔔 任务完成通知 Hook (task-done-notify.sh) | ✅ | ✅ | 所有版本 |
| 🌐 界面汉化 (配置面板、斜杠命令等) | ⚠️ | ❌ | 仅 ≤ 2.1.112 |
⚠️ 界面汉化已失效:Claude Code v2.1.113 起改为编译二进制,无法再通过字符串替换修改界面文案。工具提示 Hook 不受影响,所有版本均可使用。
⚠️ 安装前请先检查版本:
claude --version。如果你的版本 ≥ 2.1.113,界面汉化将不可用,但仍可安装工具提示 Hook。
# 全局安装
npm install -g cute-claude-hooks
# 运行安装脚本
cute-claude-hooks-install
# 恢复英文界面
cute-claude-hooks-restore
或者使用 npx(无需全局安装):
npx cute-claude-hooks-install
如果 npm 官方源速度慢,可以使用国内镜像:
# 使用 npmmirror 镜像安装
npm install -g cute-claude-hooks --registry=https://registry.npmmirror.com
# 运行安装脚本
cute-claude-hooks-install
或者使用 npx:
npx cute-claude-hooks-install
╔════════════════════════════════════════╗
║ 🌸 Cute Claude Hooks 安装向导 🌸 ║
╠════════════════════════════════════════╣
║ [1] 仅安装工具提示 (推荐新手) ║
║ [2] 仅安装界面汉化 ║
║ [3] 全部安装 (完整中文体验) ← 推荐 ║
║ [4] 卸载 ║
╚════════════════════════════════════════╝
安装后,Claude Code 每次执行操作都会显示中文提示:
✅ 操作成功示例:
🌸 小白提示:🔐 检查 GitHub 登录状态(看是否已登录、登录的是哪个账号) 🌸
🌸 小白提示:🚀 列出 GitHub Actions 运行记录(查看自动化测试历史) 🌸
🌸 小白提示:📦 安装依赖包(下载项目所需的库) 🌸
注意: Claude Code 从 v2.1.113 开始改为编译二进制发布,界面汉化功能已失效。此功能仅在旧版本(≤ 2.1.112)上可用。
将 Claude Code 的英文界面翻译成中文:
/config 配置面板汉化随时可以恢复到英文界面:
Windows:
~/.claude/localize/restore.ps1
macOS/Linux:
~/.claude/localize/restore.sh
如果 cute-claude-hooks-install 运行后中文提示没有出现,按以下步骤手动安装:
# 创建 hooks 目录
mkdir -Force "$env:USERPROFILE\.claude\hooks"
# 复制脚本(替换为你的 npm 全局目录)
$npmDir = (npm root -g).Trim()
copy "$npmDir\cute-claude-hooks\tool-tips-post.sh" "$env:USERPROFILE\.claude\hooks\"
# 检查 bash 是否在 PATH 中
bash --version
# 如果找不到,设置环境变量指向你的 Git Bash
# 将下面的路径改为你实际的 Git Bash 安装路径
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"
打开 ~/.claude/settings.json,添加或修改 hooks 段:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Bash|Read|Write|Edit|Glob|Grep|mcp__*",
"hooks": [
{
"type": "command",
"command": "\"C:/Users/你的用户名/.claude/hooks/tool-tips-post.sh\""
}
]
}
]
}
}
注意:路径使用正斜杠
/,不要用反斜杠\
# 手动测试 hook 脚本
echo '{"tool_name":"Read","file_path":"test.py"}' | bash "$env:USERPROFILE\.claude\hooks\tool-tips-post.sh"
如果看到 {"systemMessage":"🌸 📖 读取文件: test.py — 查看这个文件里写了什么 🌸"},说明脚本正常工作。
| 问题 | 解决方案 |
|---|---|
bash: command not found | 安装 Git for Windows 并确保在 PATH 中 |
| 脚本无输出 | 检查 .sh 文件换行符是否为 LF(非 CRLF) |
| 中文用户名路径乱码 | 确保系统编码为 UTF-8:设置 → 时间和语言 → 语言 → 管理语言设置 → 更改系统区域设置 → 勾选 Beta: 使用 Unicode UTF-8 |
| settings.json 格式错误 | 用 node -e "JSON.parse(require('fs').readFileSync(require('path').join(require('os').homedir(),'.claude','settings.json'),'utf8'));console.log('OK')" 验证 |
Windows 用户遇到疑难问题?把下面这段粘贴给 Claude Code,让它帮你排查:
hljs language-css"你现在是 Windows 专家级运维工程师。请深度扫描我的系统环境,找出导致 Claude Code Hooks 失效的问题。检查项:1) PowerShell 版本和执行策略 2) Node.js 路径是否含中文/空格 3) sh 是否可用(Git bin 是否在 PATH 中)4) git config core.autocrlf 值(必须是 input,true 会导致 CRLF 损坏脚本)5) 系统是否开启 UTF-8 编码支持。"
详细排查步骤见 SKILL.md - Windows 环境深度自检。
编辑 ~/.claude/hooks/tool-tips-post.sh 中的 get_tip() 函数:
# 修改工具提示文本
"Read")
echo "📖 正在读取文件 — 看看里面写了什么"
;;
# 修改命令解释
git)
case "$sub" in
status) echo "查看仓库状态" ;;
log) echo "查看提交历史" ;;
esac
;;
注意: Claude Code 的 hook 输出不支持自定义颜色,提示会以默认颜色显示。
编辑 ~/.claude/localize/keyword.js:
module.exports = {
// 添加新的翻译条目
'Your English text': '你的中文翻译',
// ...
}
然后重新执行 node ~/.claude/localize/localize.js 即可。
cute-claude-hooks/
├── 📄 README.md # 本文档
├── 📄 SKILL.md # 完整自定义指南
├── 📄 LICENSE # MIT 许可证
├── 🔧 tool-tips-post.sh # 工具提示 Hook 脚本
├── 📁 bin/ # 安装脚本
│ ├── 📦 install.js # 统一安装器(hooks + 汉化)
│ └── 📦 restore.js # 恢复英文界面
├── 📁 localize/ # 界面汉化模块
│ ├── 📝 keyword.js # 关键词翻译字典 (151词条)
│ └── 🔧 localize.js # Node.js 全局替换汉化引擎
├── 📁 .github/
│ └── 📁 workflows/
│ └── 🧪 test-localize.yml # 跨平台自动测试
└── 📁 screenshots/ # 截图目录
本项目使用 GitHub Actions 进行跨平台自动测试:
| 平台 | 状态 | 测试内容 |
|---|---|---|
| 🐧 Linux (Ubuntu) | ✅ 通过 | Hook脚本语法 + 界面汉化 (135词条) |
| 🍎 macOS | ✅ 通过 | Hook脚本语法 + 界面汉化 (135词条) |
| 🪟 Windows | ✅ 通过 | Hook脚本语法 + 界面汉化 (135词条) |
查看 SKILL.md 获取:
欢迎提交 Issue 和 PR!特别是:
如果你使用了本项目,欢迎贡献效果截图:
screenshots/ 目录如果你想要更完整的中文体验,可以搭配使用:
MIT License - 自由使用、修改和分发
Made with 🌸 by gugug168
如果这个项目对你有帮助,请给一个 ⭐ Star 支持一下!
Hooking implementations and supporting tools for various coding agents (Claude, Cursor, Gemini, etc)
Claude Code hook that writes a forward-only why-block (decisions, trade-offs, assumptions, limitations) into your PR des
Blocks dangerous git and shell commands from being executed by AI coding agents
One command to install 6 essential safety hooks in 10 seconds — zero dependencies