PushNotification은 당신의 휴대폰이나 Claude 앱으로 PushNotification을 보낼 수 있는 Claude Code의 네이티브 도구입니다.

가장 명확한 사용 사례는 오래 걸리는 작업입니다:

"전체 테스트 스위트(test suite)를 실행하고, 가능한 부분을 수정하며, 스위트가 통과(green)되거나 차단(blocked)되었을 때 PushNotification 도구를 사용하여 나에게 알려줘."

하지만 더 흥미로운 사례는 백그라운드 워크플로(background workflows)입니다:

유용한 예시:

• 빌드가 완료되었을 때 알림
• 모니터(monitor)가 로그에서 운영 환경과 유사한 에러를 발견했을 때 알림
• 예약된 작업(scheduled task)이 무언가를 찾아냈을 때 알림
• Claude가 인간의 결정이 필요한 상황에서 차단되었을 때 알림
• 원격/헤드리스(remote/headless) 세션에 주의가 필요할 때 알림
• 채널 통합(channel integration)이 실패하여 에이전트가 당신에게 DM을 보낼 수 없을 때 알림
• 모닝 브리프(morning brief) 또는 주간 리뷰가 준비되었을 때 알림

이는 Monitor Tool, /loop, Crons와 함께 사용할 때 특히 유용합니다.

작동 방식

1. /config에서 "Push when Claude decides"를 선택하여 모바일 푸시를 활성화합니다.
2. Claude 앱을 통해 모바일 푸시를 위한 원격 제어(remote-control)를 활성화합니다.
3. 프롬프트에서 직접 요청하거나, CLAUDE.md에 규칙을 설정합니다. 예: "테스트를 실행하고 완료되면 PushNotification 도구로 나에게 알려줘."

나의 연결 방식

나의 Claude Code Always-on Agents (claude-code-hermit 플러그인)에서 알림 정책은 다음과 같습니다:

• 실제 양방향 채널(two-way channel)에 접속 가능하다면, 먼저 그곳으로 메시지를 보냅니다.
• 구성된 채널이 없다면, PushNotification을 사용합니다.
• 구성된 채널이 고장 났다면, PushNotification을 폴백(fallback)으로 사용합니다.
• 푸시를 유일한 기록으로 의존하지 마십시오.
• 푸시 메시지는 짧고, 한 줄이며, 실행 가능하고(actionable), 빈도가 낮게 유지하십시오.

이렇게 하면 신호(signal)를 깨끗하게 유지할 수 있습니다. 푸시는 모든 Discord/Telegram 메시지를 중복해서 보내서는 안 됩니다. 일반적인 경로가 없거나, 고장 났거나, 너무 느린 경우를 다루어야 합니다.

모범 사례 (Best practices)

메시지를 짧게 유지하십시오:

api-tests에서 CI 실패: 3개의 인증 회귀(auth regressions). 자세한 내용은 세션을 여세요.

실행 가능한 부분을 먼저 배치하십시오:

결정 필요: Claude가 스키마(schema)를 수정하기 전에 마이그레이션 전략을 선택하세요.

일상적인 진행 상황을 위해 푸시(Push)하지 마십시오. 완료(done), 차단됨(blocked), 실패(failed), 결정 필요(needs decision)와 같은 상태 변화(state changes)를 위해 푸시하십시오.

Claude에게 답변해야 하는 경우, Remote Control 또는 양방향 채널(two-way channel)을 사용하십시오. Push는 오직 사용자의 주의를 끄는 용도로만 사용됩니다.

링크

도구 참조(Tools reference): https://code.claude.com/docs/en/tools-reference

• Remote Control 및 모바일 푸시: https://code.claude.com/docs/en/remote-control
• 채널 참조(Channels reference): https://code.claude.com/docs/en/channels-reference
• Hermit 예시 정책: https://github.com/gtapps/claude-code-hermit/blob/main/plugins/claude-code-hermit/state-templates/CLAUDE-APPEND.md

나의 견해: PushNotification은 작은 도구이지만, 워크플로(workflow)를 변화시킵니다. 이제 Claude Code는 사용자가 작업이 끝났는지 주기적으로 확인하는 동안 터미널에서 조용히 대기하고 있을 필요가 없습니다. 작업이 완료되었거나, 차단되었거나, 혹은 다시 확인해 볼 가치가 있을 때 Claude가 직접 사용자를 호출할 수 있습니다.