폰에서 Claude Code 작업을 승인해도 안전한가요?

01원격 승인의 동작 방식

Claude Code에는 PermissionRequest라는 hook 이벤트가 있어요. Claude Code가 도구 사용 권한을 물어보려 할 때 실행되죠. hook은 allow 또는 deny 결정으로 응답할 수 있고, Claude Code는 terminal에서 답을 기다리는 대신 그 결정을 사용해요. 원격 승인 도구는 이 hook을 이용해 요청을 폰으로 보내고, 기다렸다가, 응답을 돌려줘요. JSON 예시는 PermissionRequest 가이드에서 볼 수 있어요.

이 설계에는 보안 측면에서 중요한 특성이 세 가지 있어요. 모두 Anthropic의 hook 문서에 나와 있는 내용이에요.

• prompt가 뜰 상황에서만 실행돼요. 권한 모드나 allow 규칙이 이미 작업을 허용한다면 요청 자체가 없어요. 원격 승인으로 키보드 앞에 있을 때보다 Claude에게 더 많은 권한을 줄 수는 없어요.
• deny 규칙이 항상 우선해요. hook이 allow를 반환해도 설정의 deny 규칙을 우회하지 못해요. Read(./.env)를 deny했다면 폰에서 탭해도 Claude가 그 파일을 읽을 수 없어요.
• hook은 내 계정 권한으로 실행돼요. command hook은 사용자의 전체 권한으로 실행돼요. hook으로 설치한 프로그램은 내 계정이 접근할 수 있는 모든 것을 읽고 바꿀 수 있어요. 그래서 폰뿐 아니라 어떤 도구를 고르느냐도 보안의 일부예요.

02위험 요소와 각각을 막는 장치

다른 사람이 응답하는 경우

최악의 경우는 의도하지 않은 사람이나 기기가 작업을 승인하는 거예요. 이를 막는 장치는 다음과 같아요.

• 페어링. 폰은 페어링된 컴퓨터에 대해서만 응답할 수 있어요. Claude Code Notifier는 QR 코드나 24시간 유효한 6자리 코드로 페어링하며, 컴퓨터당 최대 세 대의 폰을 연결할 수 있어요.
• 해제. ccn devices로 컴퓨터에 페어링된 폰 목록을 보고, ccn devices revoke <name>으로 하나를 제거할 수 있어요. ccn forget은 서버에서 컴퓨터와 페어링 정보를 모두 지워요.
• 폰 잠금. 잠금이 풀린 폰을 가진 사람은 누구나 응답할 수 있어요. 폰을 컴퓨터의 Claude Code 세션 열쇠라고 생각하고, 비밀번호나 생체 인증 잠금을 사용하세요.

읽지 않은 걸 승인하는 경우

폰에서는 긴 shell 명령을 대충 훑어보기 쉬워요. 다음 습관이 도움이 돼요.

• allow를 탭하기 전에 명령 전체를 읽으세요. 확실히 괜찮아 보이지 않으면 deny하고 나중에 terminal에서 확인하세요.
• git push, 배포, 패키지 설치처럼 프로젝트 밖의 상태를 바꾸는 작업에는 allow for the session보다 allow once를 쓰는 게 좋아요.
• 위험한 명령은 ask 규칙으로, 비밀 정보는 deny 규칙으로 설정해 두세요. 그러면 위험한 경우를 대기열에서 급하게 탭 한 번으로 정하는 게 아니라, 차분하게 작성해 둔 규칙이 결정하게 돼요. 문법은 권한 모드 가이드에서 확인할 수 있어요.

실제로 키보드 앞에 있을 때

컴퓨터 앞에 앉아 있는데 요청이 휴대폰에도 오면, 같은 prompt에 두 곳(나와 내 휴대폰)에서 답할 수 있게 돼요. Claude Code Notifier는 컴퓨터에서 사용자가 자리에 있는지 확인해요. 최근 30초 안에 입력한 적이 있으면 휴대폰 응답을 기다리지 않고 terminal이 평소처럼 물어봐요. 자리를 비운 상태라면 terminal은 직접 정한 최대 시간까지 휴대폰의 응답을 기다리고, 키보드를 건드리는 순간 대기를 멈춰요. 유휴 상태 확인은 컴퓨터에서 이뤄지고 그 결과는 전송되지 않아요.

프로젝트 정보가 컴퓨터 밖으로 나가는 문제

요청을 보여 주려면 누군가는 그 내용을 휴대폰으로 보내야 해요. 직접 만들든 아니든, Claude Code용 휴대폰 알림이라면 피할 수 없는 프라이버시상의 트레이드오프예요. Claude Code Notifier의 경우 개인정보 처리방침에 따르면 다음과 같아요.

• 계정이 없어요. 각 컴퓨터와 휴대폰은 무작위 ID로 식별돼요.
• 알림에 담길 수 있는 내용: 프로젝트 이름과 폴더 경로, Claude의 메시지나 질문, prompt의 앞부분, 그리고 권한 요청의 경우 도구 이름과 셸 명령이나 파일 경로 같은 입력 요약(최대 200자)이에요.
• 전송 경로: Cloudflare에서 실행되는 TouchTap의 릴레이 서버를 거치고, push 전달을 위해 축약된 버전이 Apple이나 Google로 가요. 프로젝트 폴더 경로는 Apple이나 Google로 보내지 않아요.
• 보관 기간: 서버는 알림과 그에 대한 응답을 48시간 이내에 삭제해요. 릴레이 서버는 IP 주소를 저장하지 않아요.
• 전송 중 보호: 서버와의 모든 통신은 TLS(HTTPS와 WSS)를 사용해요. 릴레이가 전달을 위해 알림 내용을 보관하므로, 종단 간 암호화가 아니라 전송 구간 암호화예요.
• 판매하지 않아요: 데이터는 판매되거나 광고에 쓰이지 않아요.

컴퓨터에서 ccn의 자격 증명은 무작위 토큰이에요. 기본적으로 macOS에서는 키체인, Windows에서는 자격 증명 관리자에 저장되고, Linux에서는 내 사용자 계정만 읽을 수 있는 파일에 저장돼요. ccn config set credential_store로 시스템 키체인과 파일 중에서 바꿀 수 있어요.

기밀 코드를 다룬다면, 처리방침에서도 권하듯이 휴대폰 알림이 적절한지, 그리고 컴퓨터마다 어떤 종류의 알림을 켤지 고민해 보세요. notify_on_done, notify_on_permission, notify_on_question은 컴퓨터별로 명령줄이나 휴대폰 앱에서 각각 끌 수 있어요.

잠금 화면에 너무 많은 내용이 보이는 문제

명령어나 고객사 프로젝트 이름이 담긴 배너는 휴대폰을 힐끗 보는 누구에게나 보여요. iPhone과 Android 모두 잠금을 해제하기 전까지 알림 미리보기를 숨길 수 있고, 전체 앱이나 특정 앱 단위로 설정할 수 있어요. iPhone에서는 설정 > 알림에 있어요. Android에서는 잠금 화면 알림 설정에 있고, 보통 민감한 콘텐츠 숨기기 옵션으로 제공돼요.

03원격 승인을 직접 만드는 경우

PermissionRequest hook과 채팅 봇이나 push 서비스를 이용해 원격 승인을 직접 만들 수도 있어요. 하지만 그러면 사실상 인증 시스템을 만드는 셈이에요. 나만 응답할 수 있어야 하고, 예전 응답이 새 요청에 적용되면 안 되고, 멈춘 요청 때문에 세션이 막히면 안 돼요. 공용 push 서버를 쓴다면 토픽 이름만이 외부인을 막아 주므로 비밀번호처럼 다뤄야 해요. ntfy 가이드와 Telegram, Slack, Discord 가이드는 알림 전용 설정을 다루는데, 아무것도 승인할 수 없으니 위험이 훨씬 적어요.

04직접 작성하지 않은 저장소의 hook

승인뿐 아니라 모든 hook에 해당하는 위험이 하나 더 있어요. hook은 프로젝트의 .claude/settings.json에 커밋될 수 있어요. 대화형 세션에서는 해당 폴더의 워크스페이스 신뢰 대화상자를 수락하기 전까지 Claude Code가 hook을 실행하지 않으니, 저장소를 신뢰하기 전에 .claude/ 파일을 읽어 보세요. claude -p나 SDK로 실행할 때는 대화상자 없이 폴더를 신뢰된 것으로 간주하므로 커밋된 hook이 실행돼요. 직접 작성하지 않은 코드에 스크립트로 실행할 때는 --settings '{"disableAllHooks": true}'를 넘겨 주세요.

05Claude Code Notifier의 역할

Claude Code Notifier는 TouchTap Ltd가 만든 독립 도구예요. Anthropic이 만들거나 보증하거나 후원하지 않아요. 명령줄 도구인 ccn은 Mac, Windows, Linux에서 Claude Code hook으로 실행되고, iPhone과 Android 앱에서 allow once, allow for the session, deny 중 하나를 선택할 수 있어요. ccn은 GitHub에 소스가 공개되어 있어서, 설치 전에 hook으로 실행될 코드를 정확히 확인할 수 있어요. 설정 방법은 휴대폰 승인 가이드를 참고하세요.

06FAQ