Claude Code 알림을 받는 모든 방법 비교

01한눈에 보는 옵션

02기본 기능: terminal이 알려줘요

Claude Code는 작업을 마치거나 권한 prompt에서 대기 중일 때 사용자가 자리를 비운 것 같으면 이미 알림을 띄워요. 기본적으로 iTerm2, Ghostty, Kitty에서는 데스크톱 알림을 보내고, Apple Terminal에서는 특정한 경우에만 벨을 울리며, 그 밖의 terminal에서는 아무것도 하지 않아요. preferredNotifChannel 설정으로 이 동작을 바꿀 수 있어요. 예를 들어 "terminal_bell"로 설정하면 모든 terminal에 벨 문자가 전송돼요.

장점: 따로 설치할 게 없고, 알림을 전달해 주는 terminal이라면 SSH에서도 동작해요. 한계: 지금 앞에 있는 컴퓨터에만 알림이 가고, 많은 terminal(IDE terminal 포함)은 기본적으로 아무 알림도 받지 못하며, 답장도 할 수 없어요. 자세한 내용은 terminal bell 가이드를 참고하세요.

03직접 만든 hook: 데스크톱 알림

hook을 쓰면 Claude Code가 정해진 시점에 명령을 실행하게 할 수 있어요. Notification hook은 Claude가 사용자의 확인이 필요할 때 실행돼요(권한 prompt가 약 6초 동안 대기했거나, Claude가 작업을 마치고 약 60초 동안 유휴 상태일 때). Stop hook은 턴이 끝나는 즉시 실행돼요. 둘 중 하나를 플랫폼의 알림 명령에 연결하면 Mac, Windows, Linux의 어떤 terminal에서든 알림을 받을 수 있어요. 자세한 방법은 Claude 작업 완료 알림 받기 가이드에서 확인하세요.

장점: 무료이고, 외부로 정보가 나가지 않으며, 완전히 직접 제어할 수 있고, 네트워크도 필요 없어요. 한계: 여전히 그 컴퓨터에서만 알림이 뜨고, headless 서버나 SSH 환경에서는 데스크톱 명령이 알림을 띄울 데스크톱이 없어요(SSH 환경에서의 알림 참고).

04직접 만든 hook: 휴대폰으로 push

같은 hook에서 push 서비스를 호출할 수도 있어요. 많이 쓰는 선택지는 다음과 같아요.

• ntfy: curl 한 줄로 topic에 게시하고, iPhone이나 Android의 ntfy 앱에서 받아요. ntfy.sh에서는 무료이고, 서버를 직접 호스팅할 수도 있어요. ntfy 가이드를 참고하세요.
• Pushover: 매달 무료 메시지 한도가 있는 API로, 전용 앱을 제공해요. 메시지는 1,024자로 제한돼요.
• Telegram, Slack, Discord: bot이나 incoming webhook으로 이미 보고 있는 채팅방에 메시지를 보내요. Telegram, Slack, Discord 가이드를 참고하세요.

장점: 어디에 있든 휴대폰으로 알림이 오고, 저렴하거나 무료이며, 무엇이 전송되는지 정확히 알 수 있어요. 한계: 단방향이에요. 휴대폰으로 Claude가 기다리고 있다는 건 알 수 있지만, 세션은 여전히 키보드 앞으로 돌아올 때까지 기다려요. 또한 비밀 정보(topic 이름, token, webhook URL)를 관리해야 하고, hook은 자리에 있든 없든 실행되기 때문에 언제 보내지 않을지도 직접 정해야 해요.

05Anthropic의 Remote Control과 Claude 앱

Remote Control은 iPhone과 Android의 Claude 앱, 또는 브라우저의 claude.ai/code를 컴퓨터에서 실행 중인 Claude Code 세션에 연결해 줘요. 대화 전체를 보고 직접 입력할 수 있으며, 권한 prompt와 AskUserQuestion 질문도 휴대폰으로 전달돼요. /config에서 Push when actions required와 Push when Claude decides를 켜면 앱이 push 알림을 보내요. 연결된 terminal에서 입력 중이거나 그 terminal에 포커스가 있을 때는 알림을 보내지 않아요.

장점: Anthropic이 직접 만들었고, 휴대폰에서 세션 전체를 다룰 수 있으며, 서드파티가 끼지 않아요. 한계(Anthropic 문서 기준): claude.ai로 로그인한 Pro, Max, Ultra, Team, Enterprise 플랜이 필요하고, API key는 지원하지 않으며, Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry나 커스텀 ANTHROPIC_BASE_URL에서는 사용할 수 없어요. Team과 Enterprise에서는 Owner가 기능을 켜야 해요. 세션은 Remote Control로 시작하거나(또는 시작 시 연결되도록 설정해야) 하고, "decides" push를 언제 보낼지는 Claude가 판단해요. 두 토글 외에 이벤트별 설정은 없어요.

06전용 알림 도구

위에서 소개한 hook을 기반으로 답장 기능까지 더한 도구가 여럿 있어요.

• claude-remote-approver는 PermissionRequest hook과 ntfy를 사용하는 오픈소스(MIT) npm 패키지예요. 권한 요청마다 Approve와 Deny 버튼이 달린 알림이 오고, AskUserQuestion 선택지도 버튼으로 표시돼요. 제한 시간(기본 120초) 안에 응답이 없으면 Claude Code는 terminal prompt로 돌아가요.
• Pushary는 npx pushary@latest setup으로 설정하는 호스팅 서비스예요. Claude Code hook을 설치해서 Claude가 작업을 마치면 push를 보내고, 휴대폰에서 승인하거나 답할 수 있게 해 줘요.
• Claude Code Notifier(저희 제품)는 Mac, Windows, Linux용 무료 command line 도구인 ccn과 iPhone, Android용 휴대폰 앱으로 구성돼요. 독립적으로 개발한 제품이며 Anthropic이 만든 것이 아니에요.

그 밖에도 미리 만들어 둔 스크립트로 ntfy, Discord, 데스크톱에 알림을 보내는 오픈소스 프로젝트들이 있어요. 스크립트를 직접 짜지 않고 DIY 방식을 쓰고 싶다면 살펴볼 만해요.

07Claude Code Notifier의 역할

단방향 알림만 필요하다면 ntfy나 데스크톱 알림 도구를 쓰는 10줄짜리 hook으로도 충분하고, 비용도 들지 않아요.

Claude Code Notifier는 알림을 받은 그다음을 위한 도구예요. ccn만 설치해도 Claude가 작업을 마치거나, 권한이 필요하거나, 질문할 때 Mac, Windows, Linux에서 데스크톱 알림을 보여 줘요. 휴대폰을 페어링하면 다음과 같은 일을 할 수 있어요.

• 휴대폰에서 권한 요청을 한 번만 허용, 세션 동안 허용, 또는 거부
• Claude가 선택을 요청하면 답 고르기
• Claude가 작업을 마치면 바로 다음 지시 보내기

자리에 있는지도 감지해요. 최근 30초 안에 입력했다면 아무것도 기다리지 않아요. terminal이 평소처럼 묻고, 휴대폰에는 기껏해야 알림 정도만 가요. 자리를 비웠다면 terminal은 직접 정한 최대 시간까지 휴대폰의 응답을 기다리고, 키보드를 건드리는 순간 대기를 멈춰요. hook 기반이라 IDE terminal을 포함한 어떤 terminal에서든 동작하고, 세션에서 Remote Control을 켤 필요도 없어요. 휴대폰 앱은 구독 또는 평생 이용권 구매가 필요해요. 요금을 확인하세요. 설치는 ccn 페이지에서 할 수 있어요.

08선택 방법

• 컴퓨터 앞에 앉아 있고 가볍게 알림만 받고 싶다면: 기본 제공 알림이나 데스크톱 hook.
• 휴대폰으로 알림을 받고, 답은 자리로 돌아가서 하겠다면: ntfy나 채팅 webhook.
• 휴대폰에서 대화 전체를 보고 싶고 claude.ai 플랜으로 로그인한다면: Remote Control.
• 휴대폰에서 승인하고, 답하고, 작업을 이어 가고 싶고, 키보드 앞에 있을 때는 알림이 조용하길 원한다면: Claude Code Notifier 같은 전용 도구.

09FAQ