밤샘AI
← 자료실
3분 세팅, 창 안 봐도 돼요

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

Claude Code · 읽는 데 4분 · 2026-09-30 확인

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

훅(hook)은 클로드 코드가 특정 순간마다 내가 정한 명령을 자동으로 실행하게 하는 장치예요. 여기선 '입력을 기다릴 때' 알림을 띄워요.

1단계설정 파일에 붙여 넣기

홈 폴더의 ~/.claude/settings.json 을 열어요. 없으면 새로 만들면 됩니다.

  1. 맥이라면 이대로 넣어요.
    {
      "hooks": {
        "Notification": [
          {
            "matcher": "",
            "hooks": [
              {
                "type": "command",
                "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
              }
            ]
          }
        ]
      }
    }
  2. 리눅스는 command 줄만 이걸로 바꿔요.
    notify-send 'Claude Code' 'Claude Code needs your attention'
  3. 윈도우(PowerShell)는 command 줄을 이걸로 바꿔요. 알림 대신 대화상자가 떠요.
    powershell.exe -Command "[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')"

2단계등록됐는지 확인

  1. 클로드 코드에서 아래를 치면 훅 목록이 열려요. Notification을 골라 방금 넣은 명령이 보이면 성공.
    /hooks

3단계시험해 보기

  1. Esc로 돌아와 Shift+Tab을 눌러 상태 표시줄에 ⏸ manual mode on 이 뜨게 해요.
  2. 허락이 필요한 일을 시키고 다른 창으로 넘어가면 알림이 와요.

알림이 너무 자주 오면: 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
잠 못 자고 모은 AI 소식, 매일 만나 보세요.

자료는 공식 도움말을 직접 확인해 만들고, 날짜를 적어 둡니다. 서비스 화면은 바뀔 수 있어요.