claude-hook-notify-setup

A setting skill for Claude Code hook to connect with OS native toast notifications. Based on node-notifier, it supports Windows (SnoreToast), macOS (Notification Center), and Linux (libnotify). It pops up a toast in three situations: task completion, permission request, and question. Triggers include: '작업 완료 알림 설정', 'claude 알림 받고 싶어', 'hook 알림', '끝나면 알려줘', '토스트 알림 설정'

claude-hook-notify-setup

Claude Code가 작업을 끝내거나 입력이 필요할 때 OS 네이티브 토스트를 띄운다.

동작 방식

| hook | 발화 시점 | 토스트 내용 | |------|-----------|-------------| | Stop | Claude 턴 종료 | 프로젝트명 / 마지막 응답 요약 (300자) | | PermissionRequest | 도구 실행 권한 요청 시 | Bash 명령어 또는 AskUserQuestion 질문 텍스트 | | Notification | Claude Code 시스템 알림 | 알림 메시지 |

AskUserQuestion도 PermissionRequest로 발화하며, 질문 텍스트가 토스트에 바로 표시된다.

설치 절차

1. 스크립트 배포

mkdir -p ~/.claude/skills/claude-hook-notify-setup/scripts
mkdir -p ~/.claude/skills/claude-hook-notify-setup/assets
cp <skill-path>/scripts/notify.js ~/.claude/skills/claude-hook-notify-setup/scripts/
cp <skill-path>/scripts/package.json ~/.claude/skills/claude-hook-notify-setup/scripts/
cp <skill-path>/assets/toast_img.jpg ~/.claude/skills/claude-hook-notify-setup/assets/
cd ~/.claude/skills/claude-hook-notify-setup/scripts && npm install

2. ~/.claude/settings.json에 hooks 등록

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node /Users/<username>/.claude/skills/claude-hook-notify-setup/scripts/notify.js stop"
          }
        ]
      }
    ],
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node /Users/<username>/.claude/skills/claude-hook-notify-setup/scripts/notify.js notification"
          }
        ]
      }
    ],
    "PermissionRequest": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node /Users/<username>/.claude/skills/claude-hook-notify-setup/scripts/notify.js permission"
          }
        ]
      }
    ]
  }
}

<username>을 실제 사용자명으로 교체. Windows는 C:/Users/<username>/... 형식 사용.

제거

rm -rf ~/.claude/skills/claude-hook-notify-setup

~/.claude/settings.json에서 hooks 블록도 함께 삭제.