[Claude code] Cluade code 알림 설정하기

Claude Code에게 오래 걸리는 작업을 명령한 후, 작업이 완료되기만을 기다리며 화면만 바라본 경험이 있지 않으신가요?

 

저 역시 /init 같은 명령어를 입력하고 작업이 끝날 때까지 무작정 기다린 적이 있습니다.

 

하지만 이 시간이 아깝지 않나요? Claude가 작업을 빠르게 마친다면 문제없겠지만, 오랜 시간이 걸린다면 그 시간 동안 다른 일을 하는 것이 훨씬 생산적일 것입니다.

 

이를 위해 Claude code에서는 알림을 설정할 수 있습니다.

알림 설정 방법은 2가지 방법으로 할 수 있습니다.

• terminal의 알림 기능 사용하기 (iterm2만 가능)
• Claude code 훅 사용하기

 

Terminal의 알림 기능 사용하기

terminal의 notification 기능을 사용하는 것은 iterm2만 가능합니다.

 

1. Iterm2의 설정에 들어갑니다.

 

2. Profile 탭에서 Terminal 탭을 들어갑니다.

3. 스크롤을 아래로 내려서 Silence bell을 체크합니다.

4. Notification Center Alerts를 체크하고 Filter Alerts 버튼을 누릅니다.

5. Send escape sequence-generated alerts를 체크합니다.

 

 

설정을 완료하면 Claude code가 작업을 완료하면 다음과 같이 알림을 볼 수 있습니다.

Claude code 훅 사용하여 알림 받기

Claude code 훅 이란?

Claude Code 훅은 Claude Code의 라이프사이클의 다양한 지점에서 실행되는 사용자 정의 셸 명령어입니다.

 

Claude code 훅의 사용사례는 다음과 같습니다.

• 알림
• 자동 포맷팅
• 로깅
• 피드백
• 사용자 정의 권한

Claude code는 다음의 훅 이벤트를 제공합니다.

• PreToolUse: 도구 호출 전에 실행됩니다(차단 가능).
• PostToolUse: 도구 호출 완료 후 실행됩니다.
• UserPromptSubmit: 사용자가 프롬프트를 제출할 때, Claude가 처리하기 전에 실행됩니다.
• Notification: Claude Code가 알림을 보낼 때 실행됩니다.
• Stop: Claude Code가 응답을 마칠 때 실행됩니다.
• SubagentStop: 서브에이전트 작업이 완료될 때 실행됩니다.
• PreCompact: Claude Code가 컴팩트 작업을 실행하려고 할 때 실행됩니다.
• SessionStart: Claude Code가 새 세션을 시작하거나 기존 세션을 재개할 때 실행됩니다.
• SessionEnd: Claude Code 세션이 종료될 때 실행됩니다.

 

Claude code 훅은 다음 파일에서 작성할 수 있습니다.

• ~/.claude/settings.json - 사용자 설정
• .claude/settings.json - 프로젝트 설정
• .claude/settings.Local.json - 로컬 프로젝트 설정 (커밋되지 않음)
• Enterprise 관리 정책 설정

 

Claude code 훅을 사용하여 알림 받기 (맥 버전)

저는 전역적으로 설정을 하고 싶기 때문에 ~/.claude/settings.json에 작성을 하겠습니다.

 

setting.json에 다음의 내용을 붙여 넣습니다.

{
  ...
  "hooks": {
    "Notification": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Funk.aiff"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Submarine.aiff"
          }
        ]
      }
    ]
  }
}

 

맥의 /System/Library/Sounds 디렉토리에는 다양한 소리 파일이 있는데 취향 것 설정하시면 될 것 같습니다.

 

Claude code 훅을 통한 알림 설정은 이 블로그를 참고했습니다.

https://velog.io/@leochoo/Claude-Code-%EC%95%8C%EB%A6%BC%EC%9D%8C-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0-%ED%84%B0%EB%AF%B8%EB%84%90-%EB%A9%8D%EB%95%8C%EB%A6%AC%EA%B8%B0%EB%8A%94-%EC%9D%B4%EC%A0%9C-%EA%B7%B8%EB%A7%8C

🔔 Claude Code 알림음 설정하기: "터미널 멍때리기"는 이제 그만!

 

해당 블로그에 맥뿐만이 아니라 윈도우와 리눅스 설정 방법도 있으니 참고하시면 좋을 것 같습니다.