Claude Code Hooks Sound System

Claude Code Hooks 提示音系统

基于 Claude Code Hooks 机制的声音反馈系统,让你通过声音实时感知 AI 工具的执行状态。

功能特点

• 工具调用前: 不同工具播放不同提示音
• 工具调用后: 检测错误自动播放警告音
• 权限请求时: 播放通知音提醒授权
• 完全可定制: 可自由更换声音和触发条件

声音映射

事件	声音	说明
Bash命令	Tink.aiff	清脆短促
MCP工具	Pop.aiff	轻快弹出
Read文件	Morse.aiff	轻柔提示
Write文件	Purr.aiff	柔和确认
权限请求	Hero.aiff	英雄主题
错误警告	Basso.aiff	低沉警告

快速安装

1. 克隆仓库

git clone https://github.com/PCPrincipal67/claude-code-hooks-sound-system.git
cd claude-code-hooks-sound-system

2. 复制hooks脚本

mkdir -p ~/.claude/hooks
cp hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

3. 配置Claude Code

编辑 `~/.claude/settings.json`,添加hooks配置:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{"type": "command", "command": "$HOME/.claude/hooks/before-bash.sh"}]
      },
      {
        "matcher": "mcp__*",
        "hooks": [{"type": "command", "command": "$HOME/.claude/hooks/before-mcp.sh"}]
      },
      {
        "matcher": "Read",
        "hooks": [{"type": "command", "command": "$HOME/.claude/hooks/before-read.sh"}]
      },
      {
        "matcher": "Write",
        "hooks": [{"type": "command", "command": "$HOME/.claude/hooks/before-write.sh"}]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "*",
        "hooks": [{"type": "command", "command": "$HOME/.claude/hooks/after-tool-use.sh"}]
      }
    ],
    "Notification": [
      {"hooks": [{"type": "command", "command": "$HOME/.claude/hooks/notification.sh"}]}
    ],
    "Stop": [
      {"hooks": [{"type": "command", "command": "$HOME/.claude/hooks/stop.sh"}]}
    ]
  }
}

4. 重启Claude Code

配置生效需要重启 Claude Code。

文件结构

claude-code-hooks-sound-system/
├── README.md
├── LICENSE
├── hooks/
│   ├── before-bash.sh      # Bash工具调用前
│   ├── before-mcp.sh       # MCP工具调用前
│   ├── before-read.sh      # Read工具调用前
│   ├── before-write.sh     # Write工具调