Windows에서 Claude Code 알림 받기 (PowerShell 및 WSL)

01네이티브 Windows냐 WSL이냐: hook이 실행되는 위치

Claude Code는 Windows에서 네이티브로 실행되거나 WSL 안에서 실행되는데, 이에 따라 알림 hook의 동작 방식이 달라져요.

• 네이티브 Windows. 설정 파일은 %USERPROFILE%\.claude\settings.json에 있어요. Anthropic의 hooks 레퍼런스에 따르면 command hook은 기본적으로 Git Bash에서 실행되고, Git Bash가 설치되어 있지 않으면 PowerShell에서 실행돼요. 특정 hook만 "shell": "powershell"로 PowerShell에서 실행하게 할 수도 있어요. 이때 Claude Code는 pwsh.exe(PowerShell 7)가 있으면 그걸 쓰고, 없으면 powershell.exe(Windows PowerShell 5.1)를 써요.
• WSL. claude를 WSL terminal 안에서 설치하고 실행하므로, 설정 파일은 배포판 안의 Linux 쪽 파일인 ~/.claude/settings.json이고 hook도 Linux 셸에서 실행돼요. 여기서 notify-send를 써도 보통 Windows 데스크톱까지 알림이 가지 않아요. 대신 Windows 프로그램을 호출하세요.

02간단한 테스트: terminal 벨

가장 간단한 신호는 벨이에요. 설정 파일에 다음을 추가하세요.

{
  "preferredNotifChannel": "terminal_bell"
}

그러면 Claude Code가 작업을 끝내거나 입력을 기다릴 때 벨 문자를 보내요. Windows Terminal에서는 벨이 어떻게 동작할지를 settings.json의 bellStyle로 프로필마다 설정해요. "bellStyle": ["window", "taskbar"]로 하면 소리 대신 창과 작업 표시줄 버튼이 깜빡여요. 자세한 내용은 terminal 벨 가이드를 참고하세요. 단, terminal이 화면에 보일 때만 쓸모가 있어요.

03PowerShell로 만드는 Notification hook

Anthropic의 hooks 가이드에 나온 Windows 예제예요. 아무것도 설치하지 않아도 동작해요.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

화면 구석의 토스트가 아니라 대화 상자가 열리고, terminal 뒤에 열릴 수도 있어요. 먼저 PowerShell에서 명령을 테스트해 보세요. Claude Code에서 /hooks를 입력하면 hook이 로드됐는지 확인할 수 있어요.

matcher를 비워 두면 모든 알림 유형에 대해 실행돼요. permission_prompt(승인 요청이 약 6초 동안 대기함)와 idle_prompt(Claude가 약 60초 전에 작업을 마침)도 포함돼요. 타이밍은 Notification hook 가이드에서 설명해요.

04BurntToast로 진짜 토스트 띄우기

BurntToast는 Windows 토스트 알림용으로 널리 쓰이는, 커뮤니티에서 관리하는 PowerShell 모듈이에요. 사용자 계정에 한 번 설치하세요.

Install-Module -Name BurntToast -Scope CurrentUser

그다음 동작하는지 확인하세요.

New-BurntToastNotification -Text 'Claude Code', 'Claude needs your attention'

hook에서 사용해 보세요. 이 버전은 프로필 없이 PowerShell을 시작하고 이번 호출에 한해 실행 정책을 우회하므로, Git Bash에서든 PowerShell에서든 똑같이 동작해요.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude needs your attention'\""
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude has finished'\"",
            "async": true
          }
        ]
      }
    ]
  }
}

Stop hook은 매 턴이 끝날 때마다 실행되므로, 작업이 끝나면 1분 뒤가 아니라 바로 알 수 있어요. Stop hook 가이드를 참고하세요. "async": true는 hook을 백그라운드에서 실행해서 PowerShell이 느리게 시작되더라도 Claude Code가 멈추지 않게 해 줘요.

토스트가 전혀 나타나지 않으면 설정 > 시스템 > 알림을 확인하세요. 알림이 켜져 있고 방해 금지 모드는 꺼져 있어야 해요. BurntToast 토스트는 보통 Windows PowerShell 항목에 표시되므로, 여기도 알림이 허용되어 있어야 해요.

05WSL에서: interop으로 Windows 호출하기

WSL 안에서는 hook이 Linux에서 실행되지만, WSL은 .exe 이름으로 Windows 프로그램을 실행할 수 있어요. Anthropic 가이드에 따르면 Windows interop을 통해 powershell.exe가 PATH에 있어야 해요. 기본값이 그렇고, /etc/wsl.conf의 [interop] 섹션에 있는 appendWindowsPath로 제어해요. WSL 셸에서 확인해 보세요.

command -v powershell.exe

Windows 쪽에 BurntToast가 설치되어 있다면, WSL의 ~/.claude/settings.json에 넣을 hook도 같은 명령이에요.

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -ExecutionPolicy Bypass -Command \"New-BurntToastNotification -Text 'Claude Code', 'Claude has finished'\"",
            "async": true
          }
        ]
      }
    ]
  }
}

WSL에서 Windows PowerShell을 시작하는 데 1초 이상 걸릴 수 있다는 점도 "async": true를 쓰는 이유예요.

06Claude Code Notifier의 역할

위의 hook들은 자리에 앉아 있을 때는 괜찮아요. 하지만 자리를 비우면 소용이 없고, 토스트로는 Claude의 명령을 승인할 수도 없어요.

Claude Code Notifier는 Claude Code의 hook 위에 만든 독립 도구예요(Anthropic이 아닌 TouchTap에서 만들었어요). 무료 커맨드라인 도구인 ccn은 Mac, Windows, Linux에서 동작하며, Windows 지원은 베타예요. 네이티브 Windows에서는 PowerShell에서 설치하세요.

irm https://claudecodenotifier.com/install.ps1 | iex

Claude Code 설정에 자체 hook 항목만 추가하고 나머지 내용은 그대로 두며, 백업도 남겨요. 설치하자마자 Claude가 작업을 끝내거나, 권한이 필요하거나, 질문을 할 때 Windows 토스트를 띄워 줘요. 휴대폰도 네트워크도 필요 없어요. terminal이 아니라 Claude Code에 hook으로 연결되기 때문에 Windows Terminal, PowerShell, IDE terminal에서 모두 똑같이 동작해요.

Claude Code를 WSL에서 실행한다면 Claude Code와 설정이 그곳에 있으므로, Linux용 명령으로 WSL 안에 ccn을 설치하세요.

curl -fsSL https://claudecodenotifier.com/install.sh | sh

그다음 ccn test를 실행하세요. WSL 안에서 보낸 데스크톱 알림이 Windows 데스크톱까지 오는지는 WSL 설정에 따라 달라서, WSL에서는 휴대폰을 쓰는 게 확실해요. 휴대폰을 페어링하면 이벤트가 push 알림으로 오고, 휴대폰에서 권한을 한 번 허용, 세션 동안 허용, 거부할 수 있으며 Claude의 질문에 답하고 다음 지시도 보낼 수 있어요. 휴대폰 페어링, ccn 페이지, 휴대폰 앱 요금제를 참고하세요.

ccn을 설치했다면 알림이 중복되지 않도록 직접 만든 toast hook은 제거하세요.

07FAQ