시작하기
요구사항
- Claude Code CLI
- jq (JSON 파싱용)
- Bash (macOS, Linux) 또는 PowerShell (Windows)
jq 설치
# macOS
brew install jq
# Ubuntu/Debian
sudo apt install jq
# Fedora
sudo dnf install jq
# Windows (Chocolatey)
choco install jq
플랫폼별 알림 도구
| 플랫폼 | 필요한 도구 | 기본 설치 여부 |
|---|---|---|
| macOS | osascript | 기본 설치됨 |
| Linux | notify-send | 대부분 설치됨 |
| Windows | PowerShell | 기본 설치됨 |
| WSL | PowerShell (Windows) | 기본 설치됨 |
Linux에서 notify-send가 없으면:
# Ubuntu/Debian
sudo apt install libnotify-bin
# Fedora
sudo dnf install libnotify
# Arch
sudo pacman -S libnotify
설치
git clone https://github.com/js-koo/claude-code-notifier.git && cd claude-code-notifier && ./install.sh
설치 후 Claude Code를 재시작한다.
설치 확인
/notifier status
정상 설치되면 현재 설정이 표시된다.
/notifier test
알림이 오면 성공.
명령어
| 명령어 | 설명 | 기본값 |
|---|---|---|
/notifier help | 도움말 | |
/notifier status | 현재 설정 | |
/notifier test | 테스트 알림 | |
/notifier duration <초> | 최소 작업 시간 | 20 |
/notifier lang <ko|en> | 알림 언어 | en |
/notifier preview <길이> | 프롬프트 미리보기 | 45 |
/notifier uninstall | 삭제 |
설정 예시
# 30초 이상 걸린 작업만 알림
/notifier duration 30
# 한국어 알림
/notifier lang ko
# 모든 작업 완료 시 알림
/notifier duration 0
알림 메시지
| 상황 | 한국어 | 영어 |
|---|---|---|
| 작업 완료 | 작업 완료! | Task completed! |
| 권한 요청 | 권한 요청 대기 중 | Permission request waiting |
| 입력 대기 | 입력을 기다리는 중 | Waiting for input |
설정 파일
설정은 ~/.config/claude-code-notifier/config에 저장된다.
MIN_DURATION_SECONDS=20
NOTIFIER_LANG=en
PROMPT_PREVIEW_LENGTH=45
삭제
/notifier uninstall
트러블슈팅
알림이 안 온다
notify-send설치 확인 (Linux):
which notify-send
-
알림 권한 확인 (macOS):
- 시스템 설정 → 알림 → 터미널 앱 허용
-
방해 금지 모드 확인
WSL에서 알림이 안 온다
WSL은 Windows 알림을 사용한다:
powershell.exe -Command "echo test"
권한 오류
chmod +x install.sh
chmod +x hooks-handlers/*.sh