3분 세팅, 창 안 봐도 돼요
클로드 코드가 날 부를 때 알림 받기
긴 작업을 맡겨 놓고 다른 창에 가 있으면, 클로드가 '이거 해도 돼요?' 하고 멈춰 있는 걸 한참 뒤에 발견하곤 하죠.
훅(hook)은 클로드 코드가 특정 순간마다 내가 정한 명령을 자동으로 실행하게 하는 장치예요. 여기선 '입력을 기다릴 때' 알림을 띄워요.
1단계설정 파일에 붙여 넣기
홈 폴더의 ~/.claude/settings.json 을 열어요. 없으면 새로 만들면 됩니다.
- 맥이라면 이대로 넣어요.
{ "hooks": { "Notification": [ { "matcher": "", "hooks": [ { "type": "command", "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'" } ] } ] } } - 리눅스는 command 줄만 이걸로 바꿔요.
notify-send 'Claude Code' 'Claude Code needs your attention'
- 윈도우(PowerShell)는 command 줄을 이걸로 바꿔요. 알림 대신 대화상자가 떠요.
powershell.exe -Command "[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')"
- 이미 hooks 항목이 있다면 통째로 바꾸지 말고 그 안에 Notification만 나란히 추가하세요.
- 윈도우 명령을 JSON 안에 넣을 땐 큰따옴표 앞에 \ 를 붙여야 해요.
2단계등록됐는지 확인
- 클로드 코드에서 아래를 치면 훅 목록이 열려요. Notification을 골라 방금 넣은 명령이 보이면 성공.
/hooks
- /hooks 화면은 보기 전용이에요. 고치려면 설정 파일을 직접 고치거나 클로드에게 부탁하세요.
3단계시험해 보기
- Esc로 돌아와 Shift+Tab을 눌러 상태 표시줄에 ⏸ manual mode on 이 뜨게 해요.
- 허락이 필요한 일을 시키고 다른 창으로 넘어가면 알림이 와요.
알림이 너무 자주 오면: matcher로 골라 받기
permission_prompt 허락을 기다린 지 6초쯤 지났을 때만
idle_prompt 답을 끝내고 60초쯤 내가 아무것도 안 쳤을 때만
빈칸("") 모든 알림 종류에
맥에서 알림이 안 뜰 때
원인 osascript 알림은 '스크립트 편집기(Script Editor)' 앱 이름으로 오는데, 이 앱에 알림 권한이 없으면 조용히 실패해요.
해결 터미널에서 osascript -e 'display notification "test"' 를 한 번 실행한 뒤, 시스템 설정 > 알림 에서 스크립트 편집기의 알림 허용을 켜요.

이거 깔고 나서 저는 커피 내리러 가도 안 불안해요. 오늘 밤도 알림 켜 두고 잡니다 🌙
출처 (2026-09-30 확인)
Claude Code 공식 문서 — Automate actions with hooks — https://code.claude.com/docs/en/hooks-guide
Claude Code 공식 문서 — Hooks reference (Notification) — https://code.claude.com/docs/en/hooks
Claude Code 공식 문서 — Automate actions with hooks — https://code.claude.com/docs/en/hooks-guide
Claude Code 공식 문서 — Hooks reference (Notification) — https://code.claude.com/docs/en/hooks