ccn 설치 - Claude Code Notifier

ccn은 Claude Code가 훅을 통해 실행하는 작은 프로그램이에요. Claude가 끝나거나 사용자를 필요로 할 때 스마트폰으로 푸시 알림을 보내고, 그 자리에서 승인, 거부, 답변할 수 있게 해 줘요. 백그라운드에서 실행되는 건 없고, 어떤 터미널에서든 작동해요.

코드 스마트폰에서 Claude Code Notifier를 열고 컴퓨터를 추가하세요. 앱에 6자리 코드와, 코드가 이미 들어 있는 실행 명령이 표시돼요. 아직 앱이 없나요? iOS 또는 Android용을 받으세요.

01설치 및 페어링

macOS 및 Linux

curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913

Windows (PowerShell)

irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913

Windows 지원은 베타예요.

Homebrew

brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913

Node.js 사용자

npx @touchtap/ccn pair 482913

각 명령은 ccn 설치와 페어링을 한 번에 처리해요. 코드 없이 설치하려면 코드 부분(| sh 또는 && 앞부분만 남기고 나머지)을 빼고 실행한 뒤 나중에 ccn pair CODE를 실행하세요. 482913은 스마트폰에 표시된 코드로 바꾸세요. 코드는 5분간 유효하고, 만료되면 앱이 새 코드를 만들어요. 페어링하면 ~/.claude/settings.json에 항목 7개가 추가되고, 파일의 나머지 내용은 그대로 유지돼요.

02제공 기능

Claude 작업 완료: 작업이 끝나는 순간 푸시 알림이 와요.
권한: 스마트폰에서 한 번 허용, 세션 동안 허용, 거부를 선택하세요.
질문: Claude가 선택을 요청하면 답을 골라 보내세요.
후속 지시: Claude가 끝난 직후 스마트폰으로 다음 지시를 보내세요.

최근 30초 안에 입력했다면 아무것도 기다리지 않아요. 터미널이 평소처럼 묻고 스마트폰에는 알림만 가요. 자리를 비웠다면 터미널이 스마트폰의 답을 기다리다가, 키보드를 만지는 즉시 기다림을 멈춰요. 대기 시간은 앱에서 컴퓨터별로 바꿀 수 있어요.

03명령어

명령어기능

ccn pair CODE스마트폰과 페어링하고 훅 설치

ccn doctor훅, 페어링, 연결 상태 점검

ccn test테스트 알림 보내기

ccn devices페어링된 스마트폰 목록 보기 또는 해제

ccn config show이 컴퓨터의 설정 보기

ccn sync스마트폰에서 바꾼 설정을 지금 가져오기

04Mac 앱

Claude Code Notifier Mac 메뉴 막대 앱도 계속 사용할 수 있고, 무료예요. 터미널보다 앱이 편하다면 다운로드하거나 brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier를 실행하세요. ccn과 달리 스마트폰 없이도 Mac 알림을 표시하고 웹훅을 보낼 수 있지만, 스마트폰에서 답하려면 iTerm2, kitty 또는 tmux가 필요해요. 같은 Mac에서 둘을 함께 실행하지 마세요. 알림이 두 번씩 와요. 앱에서 ccn으로 바꾸려면 ccn pair CODE --replace-mac-app으로 페어링해 앱의 훅을 제거한 뒤 앱을 종료하세요.

05제거

ccn uninstall

이 명령은 settings.json에서 훅을 제거하고, 페어링을 해제하고, 로컬 상태를 삭제해요. 그다음 실행 파일을 삭제하세요. macOS와 Linux는 ~/.local/bin/ccn, Windows는 %LOCALAPPDATA%\Programs\ccn, Homebrew는 brew uninstall ccn을 사용하세요.