永远不再错过 Claude 的消息：macOS 通知系统完整方案

Copyosascript -e 'display notification "Task complete" with title "Claude Code"'

Copy{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Done\" with title \"Claude\"'",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

Copy{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 '~/claude-notify/notify.py'",
            "timeout": 10
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "elicitation_dialog|permission_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "python3 '~/claude-notify/notify.py'",
            "timeout": 10
          }
        ]
      }
    ],
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 '~/claude-notify/notify.py'",
            "timeout": 10
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 '~/claude-notify/notify.py'",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

CopyTink（最轻）  <  Glass（悦耳）  <  Bottle（温和）  <  Funk（有力）
 Session Ended  <  Task Complete  <  Needs Answer   <  Needs Permission

Copy# 构建 terminal-notifier 命令
cmd = [notifier_path, "-title", title, "-message", body,
       "-sound", sound, "-group", group_id]
 
# 仅阻塞类事件穿透勿扰模式
if event_type in ("elicitation_dialog", "permission_prompt"):
    cmd.append("-ignoreDnD")

Copy# 通知分组
if event_type in ("elicitation_dialog", "permission_prompt"):
    group_id = f"claude-{session_id}-action"    # 阻塞类
else:
    group_id = f"claude-{session_id}-info"       # 信息类

Copy#!/bin/bash
# focus-terminal.sh — 通知点击回调
SESSION_ID="$1"
STATE_FILE="/tmp/claude-notify/$SESSION_ID"
 
# 先激活终端应用
osascript -e 'tell application "YourTerminal" to activate'
 
# 如果有存储的窗口位置，提升匹配的窗口
if [ -f "$STATE_FILE" ]; then
    X=$(cut -d',' -f1 < "$STATE_FILE" | tr -d ' ')
    Y=$(cut -d',' -f2 < "$STATE_FILE" | tr -d ' ')
    osascript <<EOF
tell application "System Events" to tell process "YourTerminal"
    repeat with w in windows
        set {wx, wy} to position of w
        if wx is $X and wy is $Y then
            perform action "AXRaise" of w
            exit repeat
        end if
    end repeat
end tell
EOF
fi

CopyCOMPLETION_MESSAGES = [
    "All done, ready for the next one.",
    "Task wrapped up successfully.",
    "Finished! Awaiting your next move.",
    "Done and dusted.",
    "Mission accomplished.",
    "Work complete, standing by.",
    "All set! What's next?",
    "That's a wrap.",
    "Knocked it out. Your turn.",
    "Ready when you are.",
    "Task complete. Over to you.",
    "Delivered as requested.",
]

Copy#!/usr/bin/env python3
"""Claude Code Hooks 通知系统"""
 
import json, sys, os, random, subprocess
 
# ── 配置 ──────────────────────────────────────────
NOTIFIER = os.path.expanduser("~/claude-notify/ClaudeNotify.app/"
    "Contents/MacOS/terminal-notifier")
 
# 事件 → 通知配置映射
NOTIFICATION_MAP = {
    "elicitation_dialog": {
        "subtitle": "Needs Answer",
        "sound": "Bottle",
        "ignore_dnd": True,
        "group_suffix": "action",
    },
    "permission_prompt": {
        "subtitle": "Needs Permission",
        "sound": "Funk",
        "ignore_dnd": True,
        "group_suffix": "action",
    },
    "stop": {
        "subtitle": "Task Complete",
        "sound": "Glass",
        "ignore_dnd": False,
        "group_suffix": "info",
    },
    "session_end": {
        "subtitle": "Session Ended",
        "sound": "Tink",
        "ignore_dnd": False,
        "group_suffix": "info",
    },
}
 
# ── 主逻辑 ─────────────────────────────────────────
def main():
    # 1. 读取 stdin JSON（Hooks 通过 stdin 传入事件数据）
    raw = sys.stdin.read()
    data = json.loads(raw)
 
    event = data.get("hook_event_name", "")
    session_id = data.get("session_id", "unknown")
    project = os.path.basename(
        os.environ.get("CLAUDE_PROJECT_DIR", data.get("cwd", ""))
    )
 
    # 2. SessionStart：仅记录窗口位置，不发通知
    if event == "SessionStart":
        save_window_position(session_id)
        return
 
    # 3. SessionEnd：用户主动退出不通知
    if event == "SessionEnd":
        reason = data.get("reason", "")
        if reason in ("user_exit", "prompt_input_exit"):
            return
        # 异常退出才通知...
 
    # 4. 根据事件类型获取配置，构建 terminal-notifier 命令
    cfg = resolve_config(event, data)
    title = f"{project} | {cfg['subtitle']}"
    group = f"claude-{session_id}-{cfg['group_suffix']}"
 
    cmd = [NOTIFIER, "-title", title, "-message", cfg["body"],
           "-sound", cfg["sound"], "-group", group]
 
    if cfg["ignore_dnd"]:
        cmd.append("-ignoreDnD")
 
    subprocess.run(cmd, timeout=5)
 
if __name__ == "__main__":
    main()