클로드 코드 Hooks로 음성 알림 활용하기🔔

왜 필요하죠?

Claude Code에서 명령을 내리고, 다른 작업을 하다 보면 Claude Code의 작업 완료 시기를 놓치게 됩니다.

이때 음성으로 Notification을 할 수 있는 방법이 있습니다.

 

Claude Code에서 요청한 작업이 완료되었을 때 음성 알림을 받으려면 Hooks 기능을 활용할 수 있습니다.

Hooks 셋팅 방법을 알아보겠습니다.

---

MacOS에 음성 알림 기능 설치

macOS 음성 알림 기능을 사용하려면 terminal-notifier를 설치해야 합니다.

설치를 위해 터미널에서 다음 명령을 수행합니다.

brew install terminal-notifier

 

설치 후에는 터미널에서 다음을 입력해 테스트 해 볼 수 있습니다.

say "요청하신 작업이 완료되었습니다"

음성이 나오면 설치가 정상적으로 된 것입니다.

 

---

Hooks에 음성알림 추가

 

Claude Code의 Hooks에 음성 알림을 추가합니다.

Hooks 설정은 프로젝트와 사용자 Scope으로 할 수 있습니다.

• 프로젝트 Scope 일때는 프로젝트 루트 폴더의 .claude/settings.json
• 사용자 Scope 일때는 ~/.claude/settings.json 

Hooks 추가

• settings.json 파일에 hooks 섹션을 추가하고, 특정 이벤트에 대한 Hook을 정의합니다.
• 작업 완료 시 알림을 받으려면 Stop 이벤트를 활용할 수 있습니다

"hooks": {
    "Notification": [],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "say \"요청하신 작업이 완료되었습니다\""
          }
        ]
      }
    ]
},

이렇게 하면 요청한 작업이 완료되었을때 음성 안내를 받을 수 있습니다.