Claude Code에 일을 맡겨 두고 끝났는지 터미널을 계속 들여다볼 필요가 없습니다. 공식 훅 안내의 첫 예제가 바로 이것입니다. 설정 파일에 Notification 훅 한 덩어리를 넣으면, Claude가 내 입력을 기다릴 때 맥 알림이 뜹니다.
붙여 넣을 설정
~/.claude/settings.json에 넣습니다. 파일이 없으면 새로 만들고, 이미 hooks가 있으면 그 안에 Notification 항목만 더합니다.
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
}
]
}
]
}
}리눅스는 notify-send 'Claude Code' 'Claude Code needs your attention', 윈도는 PowerShell 명령을 쓰면 됩니다(같은 문서의 탭에 있습니다).
언제 울리나
matcher를 비워 두면 모든 알림 종류에서 울립니다. 훅 레퍼런스의 알림 종류 중 자주 겪는 두 가지는 이렇습니다.
| 종류 | 울리는 때 |
|---|---|
permission_prompt | 도구 사용 허락을 기다리는 창이 약 6초 동안 대답을 못 받았을 때 |
idle_prompt | Claude가 답을 마치고 약 60초 동안 내가 아무것도 치지 않았을 때 |
권한 창만 알림을 받고 싶으면 "matcher": "permission_prompt"처럼 종류 이름을 넣습니다.
알림이 안 뜰 때
붙여 넣었는데 아무것도 안 뜨는 경우가 있습니다. 문서의 시험 명령을 돌려 보면 오류도 출력도 없이 끝나고 종료 코드는 0입니다.
osascript -e 'display notification "test"'
echo $? # 0원인은 스크립트 편집기입니다. osascript 알림은 맥에 들어 있는 스크립트 편집기 앱을 거쳐 나가는데, 이 앱에 알림 권한이 없으면 조용히 실패하고 macOS도 권한을 물어보지 않습니다. 위 시험 명령을 한 번 돌리면 스크립트 편집기가 알림 설정 목록에 나타납니다.
- 시스템 설정 → 알림
- 목록에서 스크립트 편집기
- 알림 허용 켜기
다시 시험 명령을 돌려 알림이 뜨면 끝입니다.