클로드 코드가 날 부를 때 알림 받기

2026년 9월 30일 올림 · 9월 30일 확인

Claude Code · 읽는 데 4분

긴 작업을 맡겨 놓고 다른 창에 가 있으면, 클로드가 '이거 해도 돼요?' 하고 멈춰 있는 걸 한참 뒤에 발견하곤 하죠.

훅(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년 9월 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

직무별 업무팩 · 준비 중업무팩이 나오면 알려 드릴게요

매주 쓰는 틀을 직무별로 한 번에 묶고 있어요. 돈 내기 전에 이 글부터 따라 해 보세요.