Cute Claude Hooks

中文增强工具包。当前真实可用核心是工具提示与完成通知；界面汉化仅适用于 Claude Code 2.1.112 及以前版本。

一眼看懂

从这里开始

完整说明
⚠️ 重要版本兼容性公告 (2025-05)
Anthropic 从 Claude Code v2.1.113 开始将 npm 包从 Node.js 脚本 (cli.js) 改为编译二进制 (claude.exe)。
这导致所有基于字符串替换的界面汉化方案彻底失效，包括本项目的界面汉化功能。

工具提示 Hook 不受影响，所有版本均可正常使用。界面汉化功能等待后续适配方案。
🌸 让 Claude Code 拥有中文体验！工具提示 Hook，专为编程小白设计（界面汉化仅支持 ≤ 2.1.112 版本）

📸 效果预览

🎯 工具提示效果

每个 Claude Code 执行的操作都会显示中文提示，让你清楚知道它在做什么：

🌐 界面汉化效果（⚠️ 仅 ≤ 2.1.112，新版已失效）
⚠️ 以上界面汉化截图来自旧版本（≤ 2.1.112）。新版 Claude Code（≥ 2.1.113）已改为编译二进制，此功能无法使用。

📝 汉化对照表

📋 支持的命令解释

💡 支持 100+ 常用命令的详细中文解释！

✨ 特性

- 📖 中文操作提示 - 每个操作都有详细的中文解释，小白也能看懂（所有版本可用）
- 🌸 界面汉化 - 配置面板、命令说明、快捷键提示全中文（⚠️ 仅 ≤ 2.1.112）
- 🖥️ 跨平台 - Windows/macOS/Linux 通用
- 📦 轻量级 - 无依赖，秒级安装
- 🔧 易自定义 - 完整的自定义指南
- 🇨🇳 国内加速 - 支持 npmmirror 镜像安装
- 🧪 自动测试 - GitHub Actions 三平台自动测试

📦 安装

功能与安装方式对应表

⚠️ 界面汉化已失效：Claude Code v2.1.113 起改为编译二进制，无法再通过字符串替换修改界面文案。工具提示 Hook 不受影响，所有版本均可使用。

方式一：NPM 安装（推荐）
⚠️ 安装前请先检查版本：claude --version。如果你的版本 ≥ 2.1.113，界面汉化将不可用，但仍可安装工具提示 Hook。

或者使用 npx（无需全局安装）：

方式二：国内加速安装（推荐国内用户）

如果 npm 官方源速度慢，可以使用国内镜像：

或者使用 npx：

安装选项

🎯 功能详解

1️⃣ 工具提示 (Tool Tips)

安装后，Claude Code 每次执行操作都会显示中文提示：

2️⃣ 界面汉化 (Localization) — ⚠️ 仅支持 Claude Code ≤ 2.1.112
注意: Claude Code 从 v2.1.113 开始改为编译二进制发布，界面汉化功能已失效。此功能仅在旧版本（≤ 2.1.112）上可用。

将 Claude Code 的英文界面翻译成中文：

- ✅ /config 配置面板汉化
- ✅ 斜杠命令说明汉化
- ✅ 快捷键提示汉化
- ✅ 欢迎界面汉化
- ✅ 状态信息汉化

3️⃣ 恢复功能 (Restore) — 仅 ≤ 2.1.112

随时可以恢复到英文界面：

Windows:

macOS/Linux:

🪟 Windows 手动安装（自动安装失败时使用）

如果 cute-claude-hooks-install 运行后中文提示没有出现，按以下步骤手动安装：

前提条件
- 已安装 Git for Windows
- 已安装 Node.js 14+

步骤一：复制 hook 脚本

步骤二：确认 bash 可用

步骤三：手动编辑 settings.json

打开 ~/.claude/settings.json，添加或修改 hooks 段：
注意：路径使用正斜杠 /，不要用反斜杠 \

步骤四：验证

如果看到 {"systemMessage":"🌸 📖 读取文件: test.py — 查看这个文件里写了什么 🌸"}，说明脚本正常工作。

常见问题排查

Windows 五步深度自检
Windows…