Mac, Windows, Linux에서 폰을 Claude Code에 연결하기

01페어링하면 할 수 있는 것

폰을 페어링하면 Claude Code가 사용자가 필요할 때 바로 알려 줘요.

• 턴이 끝나는 즉시 "Claude 작업 완료" push 알림을 받아요.
• 권한 요청을 한 번만 허용, 세션 동안 허용, 또는 거부할 수 있어요.
• 옵션을 골라 질문에 답할 수 있어요.
• Claude가 작업을 마친 직후 후속 지시를 보낼 수 있어요.

페어링하기 전에도 ccn은 같은 순간에 컴퓨터에 데스크톱 알림을 띄워 줘요. 페어링하면 여기에 폰이 더해지는 거예요.

Claude Code Notifier는 TouchTap Ltd에서 만든 독립 도구로, Anthropic이 만들었거나 Anthropic과 제휴한 제품이 아니에요. Claude Code의 hook을 통해 작동하기 때문에 VS Code, Cursor, JetBrains IDE 안의 terminal을 포함해 어떤 terminal에서 실행한 claude 세션이든 모두 지원해요.

02시작하기 전에

필요한 것:

• 컴퓨터에 설치되어 정상 작동하는 Claude Code
• App Store나 Google Play에서 설치한 Claude Code Notifier 앱. 앱 없이 QR 코드를 먼저 스캔하면 폰에서 스토어로 안내해 줘요.
• 두 기기 모두의 네트워크 연결

앱은 무료로 다운로드할 수 있고, 사용하려면 구독이나 평생 이용권 구매가 필요해요. 연간 요금제에는 무료 체험이 포함돼요. 가격을 참고하세요.

03페어링하는 두 가지 방법

방법은 두 가지예요. 결과는 같으니 편한 쪽을 고르세요.

QR 링크와 6자리 코드는 모두 24시간 동안 유효해요.

04방법 1: QR 코드 스캔하기

Mac 또는 Linux에서

1. terminal을 열고 ccn을 설치하세요:

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

또는 Homebrew로 설치할 수도 있어요:

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

2. ccn(또는 ccn pair)을 실행하세요. 필요하면 hook을 설치한 뒤 QR 코드와 링크를 보여 줘요.
3. 휴대폰 카메라로 QR 코드를 비추고 링크를 여세요. 앱이 설치되어 있으면 바로 열리면서 페어링돼요. 설치되어 있지 않으면 먼저 App Store나 Google Play로 안내하는데, 앱을 설치하면 페어링이 이어서 진행돼요.
4. terminal에 휴대폰이 페어링되었다고 표시돼요.

Windows에서

1. PowerShell을 열고 ccn을 설치하세요(Windows 지원은 베타예요):

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

2. ccn pair를 실행하세요. PowerShell에 QR 코드와 링크가 표시돼요.
3. 위와 같이 휴대폰 카메라로 스캔하세요.
4. PowerShell에 휴대폰이 페어링되었다고 표시돼요.

Node.js나 플러그인으로, 모든 OS에서

Node.js가 있다면 다음 명령 하나로 설치부터 페어링 시작까지 한 번에 할 수 있어요:

npx @touchtap/ccn

또는 Claude Code 안에서 플러그인으로 설치한 뒤 setup 명령을 실행하세요:

/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup

05방법 2: 6자리 코드 입력하기

이 방법은 휴대폰에서 시작해요. 컴퓨터 화면이 잘 안 보이거나, Claude Code를 SSH로 접속하는 서버에서 실행할 때 편해요.

1. Claude Code Notifier 앱을 열고 컴퓨터 > 컴퓨터 추가로 이동하세요.
2. 앱에 6자리 코드와 사용 중인 운영체제에서 실행할 명령어가 표시돼요.
3. 그 명령어를 컴퓨터에서 실행하세요. ccn이 이미 설치되어 있다면 간단히 다음과 같아요:

ccn pair 482913

482913 대신 본인의 코드를 입력하세요.

설치와 페어링을 한 줄로

모든 설치 명령어에 코드를 넘길 수 있어서, 새 컴퓨터에서도 명령어 하나면 충분해요.

Mac 또는 Linux에서:

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

Windows의 PowerShell에서:

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

Claude Code 플러그인이라면 setup 명령에 코드를 넘기세요: /ccn:setup 482913.

06동작 확인하기

다음 두 명령으로 모든 설정이 제대로 되었는지 확인할 수 있어요:

ccn doctor   # checks hooks, credentials, server connection and presence detection
ccn test     # sends a test notification to your phone

이제 실제로 써 보세요. claude를 실행해 간단한 작업을 맡기고 키보드에서 잠시 떠나 보세요. 작업이 끝나면 휴대폰으로 push 알림이 와요.

참고로 ccn은 사용자가 컴퓨터 앞에 있는지 감지해요. 최근 30초 안에 입력한 적이 있으면 권한 prompt와 질문은 평소처럼 terminal에 표시되고, 휴대폰에는 기껏해야 간단한 알림만 가요. 자리를 비우면 휴대폰이 이어받는 걸 확인할 수 있어요.

07여러 기기 페어링하기

• 컴퓨터 여러 대, 휴대폰 한 대. 각 컴퓨터에서 같은 단계를 반복하세요. 회사 Mac, 집의 Linux 머신, Windows 노트북 모두 같은 휴대폰으로 알림을 보낼 수 있어요. 각각을 구분하는 방법은 여러 Claude Code 세션 실행하기를 참고하세요.
• 휴대폰 여러 대, 컴퓨터 한 대. 각 휴대폰을 같은 컴퓨터와 페어링하세요.
• 휴대폰 확인 및 삭제. ccn devices로 페어링된 휴대폰 목록을 보고, ccn devices revoke <name>로 삭제할 수 있어요.

08스크립트와 원격 머신

ccn pair --no-wait는 QR 코드를 출력한 뒤 바로 종료되어 스크립트나 프로비저닝에 적합해요. SSH로 접속한 서버에서는 Claude Code를 쓰는 바로 그 SSH 세션에 코드를 입력하면 되니 보통 6자리 코드 방법이 가장 간단해요. 나머지 설정은 SSH 원격 서버의 Claude Code에서 알림 받기에서 다뤄요.

09페어링이 안 될 때

• 코드가 거부된 경우. 코드는 24시간 동안 유효해요. 앱에서 새 코드를 만들거나 QR 방법을 사용하세요.
• QR 코드가 스캔되지 않아요. terminal 창을 더 크게 키우거나, 출력된 링크를 휴대폰에서 직접 열어 보세요.
• 설치 후 ccn을 찾을 수 없다고 나와요. PATH가 갱신되도록 새 terminal을 열어 주세요.
• 페어링은 됐는데 push가 오지 않아요. ccn doctor를 실행한 다음 ccn test를 실행하고, 휴대폰 설정에서 앱 알림이 허용되어 있는지 확인하세요.

전체 목록은 Claude Code 알림이 오지 않나요? 체크리스트에서 확인할 수 있어요.

10아직 페어링할 준비가 안 됐나요?

괜찮아요. 데스크톱 알림은 ccn을 설치한 순간부터 동작해요. 휴대폰을 페어링하기 전까지는 ccn이 가끔 ccn pair를 권해요. 이 안내를 끄려면:

ccn config set pair_nudges off

11FAQ