[Claude Code 스킬] 알림 설정 — 긴 작업이 끝나거나 물어볼 때 터미널이 나를 부른다 | DAKER 커뮤니티

무엇

알림(Notifications)은 Claude Code가 긴 작업을 끝냈을 때나 권한·입력을 기다릴 때 소리나 데스크톱 알림으로 나를 부르는 기능입니다. 내부적으로 Claude는 그 두 순간에 '알림 이벤트(Notification event)'를 한 발 쏘고, 우리는 그 신호를 어떤 채널로 받을지만 정하면 됩니다.

비유하면, 오래 걸리는 빌드를 돌려놓고 커피를 내리러 간 사이 비서가 "다 됐어요" 혹은 "이거 실행해도 될까요?" 하고 어깨를 톡 치는 것과 같습니다. 터미널을 멍하니 쳐다보며 진행 막대가 끝나길 기다리는 시간을 없애줍니다.

언제 쓰나

한 번의 응답이 수십 초~수 분 걸리는 작업, 즉 주의가 다른 데 가 있어도 되는 순간에 진가를 발휘합니다.

• 대규모 리팩터·테스트·빌드를 돌려놓고 다른 창에서 일할 때
• 권한 프롬프트(예: 셸 명령 실행 확인)에서 Claude가 멈춰 나를 기다릴 때 — 모르고 방치하면 작업 전체가 멈춰 있습니다
• SSH 원격 세션에서 작업할 때 — 데스크톱 알림은 원격이라도 내 로컬 PC 알림센터로 도착합니다

사용법

먼저 알아둘 것: 데스크톱 알림은 Ghostty·Kitty·iTerm2에서만 기본으로 옵니다. 그 외 터미널은 한 줄 설정으로 '터미널 벨'을 켜는 게 가장 빠릅니다.

# 어떤 터미널이든 통하는 가장 간단한 방법: 터미널 벨
claude config set --global preferredNotifChannel terminal_bell

# 되돌리기(자동 감지로)
claude config set --global preferredNotifChannel auto

iTerm2는 데스크톱 알림을 받으려면 한 번만 켜주면 됩니다: Settings → Profiles → Terminal에서 "Notification Center Alerts" 체크 → "Filter Alerts"에서 "Send escape sequence-generated alerts" 켜기.

소리·Slack·웹훅처럼 내 마음대로 동작시키고 싶으면 Notification 훅을 씁니다. 기본 알림을 대체하는 게 아니라 함께 실행되므로, 데스크톱 알림이 안 오는 Warp·VS Code 통합터미널에서 특히 유용합니다.

// ~/.claude/settings.json — 알림 시 macOS 시스템 사운드 재생
{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          { "type": "command",
            "command": "afplay /System/Library/Sounds/Glass.aiff" }
        ]
      }
    ]
  }
}

팁

• tmux 안에서는 알림이 삼켜집니다. 데스크톱 알림과 진행 막대가 바깥 터미널까지 닿게 하려면 ~/.tmux.conf에 set -g allow-passthrough on을 추가하세요. (덤으로 set -s extended-keys on·set -as terminal-features 'xterm*:extkeys'를 넣으면 Shift+Enter 줄바꿈도 살아납니다.)

• 알림이 안 울리면 OS 권한부터 확인. 채널 설정이 맞아도 터미널 앱 자체가 운영체제 알림 권한이 없으면 조용합니다. 시스템 설정의 알림 권한을 먼저 보세요.

• 훅은 채널과 독립적입니다. terminal_bell로 벨을 울리면서 Notification 훅으로 Slack DM까지 동시에 보낼 수 있습니다. "소리는 못 듣지만 메시지는 본다"는 환경에 맞춰 겹쳐 두세요.

출처

• Configure your terminal for Claude Code — Claude Code Docs
• Hooks guide (Notification 훅) — Claude Code Docs
• Settings (preferredNotifChannel) — Claude Code Docs