Claude Code Hook 食譜：Stop 事件桌面通知＋音效（跨 macOS／Linux／Windows）

# 目標：Claude Code 跑完一輪（Stop 事件）就桌面通知＋播音效
# 放到 ~/.claude/settings.json（全域，所有專案通用）。
# 機制：Stop hook 在 Claude 結束回應時觸發；可同時跳通知與播聲音。
#       下面腳本自動判斷作業系統，挑對的通知/播音指令。

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash {{HOOKS_DIR}}/notify-on-stop.sh"
          }
        ]
      }
    ]
  }
}

# ---- notify-on-stop.sh ----
# chmod +x 後使用。跨平台：macOS 用 afplay + osascript；Linux 用 paplay/aplay + notify-send；Windows(WSL) 用 PowerShell。
#!/usr/bin/env bash
set -euo pipefail

TITLE="{{NOTIFY_TITLE}}"          # 例：Claude Code
MESSAGE="{{NOTIFY_MESSAGE}}"      # 例：任務完成，回來看看 ✅

case "$(uname -s)" in
  Darwin)   # macOS
    afplay {{MAC_SOUND_PATH}} >/dev/null 2>&1 || true   # 例：/System/Library/Sounds/Glass.aiff
    osascript -e "display notification \"$MESSAGE\" with title \"$TITLE\" sound name \"Glass\"" >/dev/null 2>&1 || true
    ;;
  Linux)
    if grep -qi microsoft /proc/version 2>/dev/null; then
      # WSL：呼叫 Windows 端 PowerShell 播音＋通知
      powershell.exe -c "[console]::beep(880,300); New-BurntToastNotification -Text '$TITLE','$MESSAGE'" >/dev/null 2>&1 \
        || powershell.exe -c "[console]::beep(880,300)" >/dev/null 2>&1 || true
    else
      # 原生 Linux
      command -v paplay >/dev/null 2>&1 && paplay {{LINUX_SOUND_PATH}} >/dev/null 2>&1 \
        || (command -v aplay >/dev/null 2>&1 && aplay {{LINUX_SOUND_PATH}} >/dev/null 2>&1) || true
      command -v notify-send >/dev/null 2>&1 && notify-send "$TITLE" "$MESSAGE" >/dev/null 2>&1 || true
    fi
    ;;
  *)        # 其他（含 Git Bash on Windows）：盡量響個鈴
    printf '\a' || true
    ;;
esac
exit 0
# 小技巧：想分辨「完成」vs「需要你輸入」，可另外掛 Notification 事件用不同聲音，
#         這樣聽聲音就知道該回來按核准、還是任務真的做完了。

把方括號 [ ] 內的變數換成你的內容，丟進 Claude Code。

# 目標：Claude Code 跑完一輪（Stop 事件）就桌面通知＋播音效
# 放到 ~/.claude/settings.json（全域，所有專案通用）。
# 機制：Stop hook 在 Claude 結束回應時觸發；可同時跳通知與播聲音。
#       下面腳本自動判斷作業系統，挑對的通知/播音指令。

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash {{HOOKS_DIR}}/notify-on-stop.sh"
          }
        ]
      }
    ]
  }
}

# ---- notify-on-stop.sh ----
# chmod +x 後使用。跨平台：macOS 用 afplay + osascript；Linux 用 paplay/aplay + notify-send；Windows(WSL) 用 PowerShell。
#!/usr/bin/env bash
set -euo pipefail

TITLE="{{NOTIFY_TITLE}}"          # 例：Claude Code
MESSAGE="{{NOTIFY_MESSAGE}}"      # 例：任務完成，回來看看 ✅

case "$(uname -s)" in
  Darwin)   # macOS
    afplay {{MAC_SOUND_PATH}} >/dev/null 2>&1 || true   # 例：/System/Library/Sounds/Glass.aiff
    osascript -e "display notification \"$MESSAGE\" with title \"$TITLE\" sound name \"Glass\"" >/dev/null 2>&1 || true
    ;;
  Linux)
    if grep -qi microsoft /proc/version 2>/dev/null; then
      # WSL：呼叫 Windows 端 PowerShell 播音＋通知
      powershell.exe -c "[console]::beep(880,300); New-BurntToastNotification -Text '$TITLE','$MESSAGE'" >/dev/null 2>&1 \
        || powershell.exe -c "[console]::beep(880,300)" >/dev/null 2>&1 || true
    else
      # 原生 Linux
      command -v paplay >/dev/null 2>&1 && paplay {{LINUX_SOUND_PATH}} >/dev/null 2>&1 \
        || (command -v aplay >/dev/null 2>&1 && aplay {{LINUX_SOUND_PATH}} >/dev/null 2>&1) || true
      command -v notify-send >/dev/null 2>&1 && notify-send "$TITLE" "$MESSAGE" >/dev/null 2>&1 || true
    fi
    ;;
  *)        # 其他（含 Git Bash on Windows）：盡量響個鈴
    printf '\a' || true
    ;;
esac
exit 0
# 小技巧：想分辨「完成」vs「需要你輸入」，可另外掛 Notification 事件用不同聲音，
#         這樣聽聲音就知道該回來按核准、還是任務真的做完了。