ccn은 Claude Code가 훅을 통해 실행하는 작은 프로그램으로, macOS, Windows, Linux에서 작동해요. 설치만 하면 Claude가 끝났을 때, 권한이 필요할 때, 질문할 때 데스크톱 알림을 받아요. 스마트폰은 원할 때 페어링하세요. 그러면 같은 순간이 푸시 알림으로도 오고, 스마트폰에서 승인, 거부, 답변할 수 있어요. 백그라운드에서 실행되는 건 없고, 어떤 터미널에서든 작동해요.

코드가 있나요? 스마트폰 앱의 6자리 코드를 들고 오셨나요? 스마트폰 페어링으로 가세요. 모든 설치 명령이 코드를 받아 같은 단계에서 페어링해요. 아직 앱이 없나요? iOS 또는 Android용을 받으세요.

01설치

macOS 및 Linux

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

Windows (PowerShell)

irm https://claudecodenotifier.com/web/install.ps1 | iex

Windows 지원은 베타예요. winget과 Scoop 패키지도 준비 중이에요.

Homebrew

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

Node.js 사용자

npx @touchtap/ccn pair

각 명령은 ccn과 훅을 설치하므로, 다음에 Claude Code가 끝나거나 사용자를 필요로 할 때 이 컴퓨터에 알림이 표시돼요. 스마트폰은 필요 없고 백그라운드에서 실행되는 것도 없어요. ccn은 ~/.claude/settings.json에 항목 7개를 추가하고, 파일의 나머지 내용은 그대로 유지해요. 스마트폰 앱의 코드가 있나요? 스마트폰 페어링의 명령은 설치와 페어링을 한 번에 처리해요.

02스마트폰 페어링

페어링은 선택 사항이고 아무것도 막지 않아요. 스마트폰이 페어링됐든 아니든 ccn은 이 컴퓨터에 계속 알림을 보내요. 페어링하면 모든 알림이 스마트폰에도 푸시로 오고, 거기서 승인, 거부, 답변할 수 있어요. 페어링 방법은 두 가지예요.

터미널의 QR 코드 스캔

ccn pair

ccn 또는 ccn pair를 실행하세요. 24시간 동안 유효한 QR 코드와 링크가 표시돼요. 스마트폰 카메라로 코드를 스캔하거나 링크를 스마트폰에서 여세요. 앱이 없으면 링크가 먼저 스토어를 안내하고, 있으면 스마트폰이 스스로 연결돼요. ccn pair --no-wait는 표시만 하고 바로 끝나니, 계속 작업하다가 나중에 스캔해도 돼요.

앱의 코드 입력

ccn pair 482913

스마트폰에서 Claude Code Notifier를 열고 컴퓨터를 추가하세요. 앱에 6자리 코드와, 코드가 이미 들어 있는 실행 명령이 표시돼요. ccn이 설치돼 있다면 ccn pair 뒤에 코드를 붙이면 충분해요. 아니라면 각 설치 명령이 코드를 받아 설치와 페어링을 한 번에 처리해요.

설치 방법실행할 명령

macOS 및 Linuxcurl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913

Windows (PowerShell)irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913

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

Node.js 사용자npx @touchtap/ccn pair 482913

482913은 스마트폰에 표시된 코드로 바꾸세요. 코드는 24시간 동안 유효하고, 만료되면 앱이 새 코드를 만들어요.

스마트폰을 페어링하지 않은 채 데스크톱 알림이 10번 오면 ccn이 ccn pair를 제안하는 한 줄을 덧붙여요. ccn config set pair_nudges off로 끌 수 있어요.

03제공 기능

ccn만으로도 Claude가 끝났을 때, 권한이 필요할 때, 질문할 때 이 컴퓨터에 알림을 표시해요. 스마트폰을 페어링하면 다음 기능이 추가돼요.

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

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

04명령어

명령어기능

ccn pair스마트폰 페어링용 QR 코드와 링크(24시간 유효)를 표시하고 기다리기

ccn pair CODE앱의 6자리 코드로 페어링

ccn pair --no-waitQR 코드와 링크를 표시하고 바로 종료

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

ccn test테스트 알림 보내기

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

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

ccn config set pair_nudges off데스크톱 알림 뒤의 페어링 제안 끄기

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

ccn upgradeccn을 지금 최신 버전으로 업데이트

ccn config set auto_update off매일 하는 업데이트 확인 끄기

ccn unlock라이선스를 구매하고 이 컴퓨터 잠금 해제(라이선스 참고)

05라이선스

claudecodenotifier.com/licence에서 구매한 라이선스는 최대 3대의 컴퓨터와 페어링된 모든 스마트폰을 잠금 해제해요. 라이선스는 컴퓨터에 저장돼요. 키는 스마트폰 앱이 아니라 ccn에 입력하세요.

ccn unlock브라우저에서 라이선스를 구매하고 이 컴퓨터 잠금 해제(--lifetime은 1회 결제)

ccn activate KEY이 컴퓨터에서 키 사용(--replace NAME은 다른 컴퓨터의 자리를 해제)

ccn deactivate다른 곳에서 키를 쓸 수 있도록 이 컴퓨터의 자리 해제

ccn licence플랜, 갱신일, 키를 사용하는 컴퓨터 보기

라이선스가 없으면 ccn이 Claude Code에 하루 한 줄, 그리고 데스크톱 알림으로 잠금 해제 방법을 보여 줄 수 있어요. CCN_NO_NUDGE=1로 끌 수 있어요.

06업데이트

ccn upgrade

ccn은 스스로 최신 상태를 유지해요. 하루 한 번 백그라운드에서 새 버전을 확인하고 설치해요. ccn upgrade는 바로 업데이트하고, ccn config set auto_update off는 매일 하는 확인을 꺼요. Homebrew나 npm으로 설치했다면 ccn은 업데이트를 패키지 관리자에 맡기고 실행할 명령을 알려 줘요.

07Mac 앱

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

08제거

ccn uninstall

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

ccn forget

이 컴퓨터를 릴레이 서버에서 삭제하고 ccn을 제거해요.