Claude Code가 끝나면 알림 받는 법

긴 작업을 맡기고 다른 일을 하다가, Claude Code가 끝나는 순간을 아는 방법이에요. 소리를 내거나 맥 알림을 띄우는 Stop 훅, 그리고 작은 맥 패널을 소개해요.

Claude Code 작업은 몇 분씩 걸릴 때가 많아요. 다른 창으로 갔다가 돌아와 보면 한참 전에 끝나 있거나, 그동안 내내 나를 기다리고 있었던 경우가 생겨요.

방법 1: Stop 훅으로 소리 내기

Claude Code는 Claude가 답을 마칠 때마다 Stop 훅을 실행해요. ~/.claude/settings.json에 아래를 넣으면 짧은 소리가 나요.

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }
        ]
      }
    ]
  }
}

afplay는 macOS에 들어 있고, /System/Library/Sounds/에 다른 소리도 있어요.

방법 2: 알림 띄우기

소리 대신 osascript를 쓰면 맥 알림이 떠요.

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code is done\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

알림은 스크립트 편집기 이름으로 뜨기 때문에, 처음에는 macOS가 허용할지 물어볼 수 있어요. 아무것도 뜨지 않으면 시스템 설정 → 알림을 확인해 보세요.

두 훅 모두 어떤 세션이 끝났다는 것만 알려 줘요. 탭이 여러 개면 어느 탭인지는 직접 찾아야 하고, 놓친 소리는 다시 들을 수 없어요.

방법 3: 무엇이 어디서 끝났는지 보기

Alien Desk는 작은 패널에 Claude Code 탭마다 한 줄씩 보여 줘요. 끝난 탭에는 확인할 때까지 초록 점이 남고, 허락을 기다리는 탭은 맨 위로 올라오며, 한 번 누르면 그 터미널·iTerm2·Ghostty 탭이 앞으로 와요. 탭이 끝날 때 짧은 소리를 낼 수도 있어요. 이 기능은 무료예요.