Claude Code 알림 모드: 토스트, 소리, 경고

Claude Code 알림 모드는 다른 곳을 보고 있는 동안 일어난 일을 알려 줍니다. 긴 턴이 끝났을 때, 컨텍스트 창이 거의 찼을 때, 명령이 차단되었을 때, 테스트 실행이 실패했을 때가 대표적입니다. Claude Code 안의 짧은 토스트, 선택적인 소리, 그리고 때로는 시스템 알림을 사용해 다른 창에 있을 때도 알아챌 수 있게 합니다.

Claude Code 알림 모드는 어떻게 작동하나요?#

대부분은 turn.complete를 수신합니다. 이 이벤트는 Claude가 턴을 마칠 때 발생하며 턴의 소요 시간, 중단 여부, 종료 이유, 그리고 서브에이전트 턴의 경우 agentId를 담고 있습니다. 모드는 앱 내 메시지를 위해 $.ui.toast('...')를, 함께 포함된 사운드 클립을 위해 $.audio.play(...)를 호출합니다. 한도에 관한 경고는 보통 턴이 끝난 뒤 읽는 $.session.usage()에서 나오며, 안전 모드는 명령을 거부할 때 tool.call 훅 안에서 토스트를 띄우기도 합니다.

모드 API에는 데스크톱 알림 전용 호출이 없습니다. macOS 알림 센터나 Linux libnotify 팝업을 원하는 모드는 $.process.run으로 osascript나 notify-send를 실행합니다. 셸 문자열 대신 argv 배열로 인수를 넘기면 Claude 답변 텍스트의 따옴표 처리 문제를 피할 수 있습니다.

설치하기 전에 무엇을 확인해야 하나요?#

토스트만 사용하는 모드라면 UI 변경과 경우에 따라 소리 재생 배지가 표시되어야 합니다. 명령어 실행도 보인다면, 알림 프로그램만 호출하는지, 그리고 시스템 알림을 직접 켰을 때만 호출하는지 확인하시기 바랍니다. 모드가 Claude 답변의 일부를 알림에 포함한다면, 그 텍스트가 운영체제의 알림 기록에 남는다는 점을 기억하시기 바랍니다.

그다음 임계값을 살펴보십시오. 좋은 알림 모드는 짧은 턴, 중단된 턴, 서브에이전트 턴에서는 조용히 있으며, /config에서 최소 길이를 바꿀 수 있게 해 줍니다.

토스트, 소리, 시스템 알림 중 무엇을 써야 하나요?#

어차피 터미널에 있다면 토스트를 사용합니다. 긴 턴 동안 브라우저로 전환한다면 소리를 추가합니다. 여러 데스크톱이나 전체 화면 앱을 오가며 작업해 터미널을 전혀 볼 수 없다면 시스템 알림을 켭니다. 대부분의 사용자는 앞의 두 가지만 켜 둡니다.