휴대폰으로 Claude Code 연결: iOS에서 언제든 세션 확인 및 도구 승인

개발자라면 이런 상황을 한 번쯤 겪어봤을 것이다. Claude Code로 코드를 리팩터링하거나 디버깅하는 중에 갑자기 컴퓨터를 떠나야 하는 경우—회의, 출퇴근, 아니면 그냥 커피 한 잔을 따르러 가는 경우. 이때 Claude Code는 코드를 생성 중이거나, 도구 호출 승인을 기다리거나, 확인이 필요한 질문을 던지고 있을 수 있다. 전통적인 방법은 휴대폰으로 SSH를 통해 컴퓨터에 접속하거나 아예 작업을 중단하는 것이었지만, 전자는 경험이 매우 나쁘다. 터미널 출력이 작은 화면에 가득 차고, 승인 절차는 전부 명령어를 직접 입력해야 한다. 휴대폰으로 Claude Code를 연결하는 최고의 방법은 PandaNpc iOS 앱으로 데스크톱의 세션 흐름을 그대로 휴대폰으로 옮겨서, 언제든 확인하고, 승인하고, 답변하는 것이다.

왜 휴대폰으로 Claude Code를 연결해야 하는가

Claude Code의 상호작용 방식은 "스트리밍 생성 + 권한 확인"이다. 일반적인 도구 호출(예: 파일 읽기/쓰기, 명령 실행)은 사용자 승인이 필요하며, AskUserQuestion 문제 카드는 답변을 입력해야 계속 진행할 수 있다. 컴퓨터 앞에 없다면 Claude Code는 멈추거나, 결국 타임아웃되어 작업을 포기하게 된다. 더 곤란한 점은 작업이 어디까지 진행됐는지 알 수 없다는 것이다—지금 생성 중인지, 아니면 이미 오랫동안 사용자를 기다리고 있는지.

PandaNpc의 iOS 앱(2026년 6월 출시)은 이 문제를 완전히 해결한다. pandapaw 컴포넌트(cc-bridge / cc-tty)를 통해 개발 머신의 Claude Code 세션을 휴대폰에 "노출"시키며, QR 코드를 스캔하기만 하면 페어링된다. 이후 휴대폰에서 전체 세션 흐름을 확인할 수 있다. 여기에는 모든 도구 호출의 권한 승인 카드와 모든 문제 카드가 포함된다. 즉, 컴퓨터 앞에 앉아 있는 것처럼 휴대폰을 스와이프하여 작업을 승인하거나 거부하고, 답변을 직접 입력하여 Claude Code가 계속 진행하도록 할 수 있다.

휴대폰으로 Claude Code를 원격 제어하는 세 단계

1단계: 개발 머신에 pandapaw 브리지 서비스 배포

PandaNpc는 Claude Code 실행 방식을 직접 대체하지 않는다. 대신 경량 브리지 레이어인 pandapaw를 통해 표준 터미널 출력을 휴대폰으로 실시간 전달한다. 선호도에 따라 다음 두 가지 모드를 선택할 수 있다:

• cc-bridge(기본 모드): claude -p(stream-json) 헤드리스 모드로 실행되며, Claude API / SDK credit을 사용한다. 백그라운드 자동화, 장기 작업에 적합하다.
• cc-tty(권장): REPL 방식으로 Claude Code 터미널을 제어하며, 사용자의 Max 구독 크레딧을 사용하고 추가 API credit을 소비하지 않는다. 일상적인 대화형 고빈도 사용에 적합하다.

설치도 매우 간단하다. macOS, Windows 또는 Linux 개발 머신에서 한 줄의 명령을 실행하면(pandanpc.com 문서 참조), pandapaw가 고유한 페어링 토큰과 QR 코드를 생성한다. 전체 과정에서 방화벽이나 포트 포워딩을 수동으로 구성할 필요가 없다. pandapaw는 보안 WebSocket 터널을 통해 연결되므로, 휴대폰은 인터넷에 접속만 할 수 있으면 된다.

2단계: iOS 앱으로 QR 코드를 스캔하여 페어링

곧 출시될 PandaNpc iOS 앱을 열면 메인 화면에 카메라 아이콘이 표시된다. 이를 탭한 후 개발 머신 터미널에 표시된 QR 코드를 스캔하면, 휴대폰이 자동으로 페어링 정보를 파싱하여 안전한 연결을 수립한다. 토큰, IP 또는 비밀키를 수동으로 입력할 필요 없다. 페어링 QR 코드는 단기 유효하며, 만료되면 다시 생성하면 된다.

페어링에 성공하면 앱은 즉시 현재 Claude Code 세션의 전체 상태를 가져온다. 이전에 이미 작업을 실행 중이었다면, 휴대폰에 최근 대화 기록과 승인 대기 중인 카드가 표시된다.

3단계: 휴대폰에서 세션 확인, 도구 승인 및 질문 응답

이것이 휴대폰으로 Claude Code를 연결하는 가장 핵심적인 경험이다. 앱의 세션 뷰는 세 가지 정보를 명확하게 구분한다:

1. 일반 출력: Claude가 생성한 코드, 설명 또는 로그가 시간순으로 표시되며, 스크롤하여 되돌아볼 수 있다.
2. 권한 카드: Claude Code가 도구(예: Read, Bash, Edit)를 실행해야 할 때, 휴대폰 화면에 "승인/거부/매개변수 수정" 버튼이 있는 카드가 팝업된다. 버튼을 한 번 탭하면 승인되며, 어떤 명령도 입력할 필요가 없다.
3. 질문 카드: Claude가 사용자에게 질문할 때(예: "데이터베이스 연결 문자열을 확인해 주세요"), 카드에 전체 질문과 입력란이 표시된다. 휴대폰 키보드로 입력하여 제출하면, Claude Code가 즉시 답변을 받고 계속 실행한다.

더 좋은 점은 휴대폰이 잠긴 상태에서도 Live Activity가 현재 상태를 실시간으로 표시한다는 것이다. "생성 중", "권한 대기 중" 또는 "완료됨". 잠금 화면을 한 번 보면 Claude Code가 사용자를 기다리는지 알 수 있으며, 휴대폰을 잠금 해제하고 반복적으로 새로고침할 필요가 없다.

주의사항 및 FAQ

🔒 보안 및 네트워크

• pandapaw 연결은 기본적으로 암호화 채널을 사용하지만, 신뢰할 수 있는 네트워크(예: 가정용 Wi-Fi, 회사 VPN)에서만 사용하는 것이 좋다. 공공 Wi-Fi에서는 PandaNpc 공식 제공 중계 노드(선택 사항)를 통해 보안을 더 강화할 수 있다.
• 페어링 QR 코드의 유효 기간은 기본 2분이며, 만료 후 다시 생성하면 된다. 타인에게 캡처되는 것을 방지한다.

💡 cc-tty 모드 vs cc-bridge

• cc-tty는 고빈도로 사용하면서 Max 구독을 이미 구매한 사용자에게 적합하다. API credit을 소비하지 않으며, 모든 상호작용이 Claude Code의 Max 크레딧을 사용하므로 지연 시간이 더 낮다.
• cc-bridge는 세밀한 API 제어(예: 사용량 통계)가 필요한 시나리오에 적합하지만, API 호출량을 소비한다. 대부분의 개발자는 cc-tty를 직접 사용하는 것이 좋다.
• 참고로, Max 구독 하나로 Claude 구독을 친구나 팀원에게 안전하게 공유할 수도 있다. 계정 비밀번호를 넘겨줄 필요 없이, 언제든 취소할 수 있다.

❓ FAQ 및 문제 해결

• QR 코드 스캔 후 연결이 안 되나요? 개발 머신에서 pandapaw가 실행 중인지, 휴대폰과 개발 머신이 공인 네트워크에 접근할 수 있는지(또는 같은 내부 네트워크에 있는지) 확인하세요.
• 세션이 동기화되지 않나요? 앱에서 아래로 당겨 새로고침하여 상태를 강제 동기화하세요. Claude Code 프로세스가 재시작된 경우, QR 코드를 다시 스캔하여 페어링해야 합니다.
• 승인 버튼이 반응하지 않나요? iOS 네트워크가 정상인지, 앱에 백그라운드 활동 권한이 있는지(설정에서 백그라운드 새로고침 허용) 확인하세요.

요약

휴대폰으로 Claude Code를 연결하는 것은 더 이상 "임시방편"이 아니라 일상적인 개발 흐름의 일부다. PandaNpc iOS 앱은 pandapaw 브리지와 실시간 세션 동기화를 통해 어떤 상황에서도 코딩 작업을 끊김 없이 이어갈 수 있게 해준다. 지하철을 기다리며 파일 쓰기를 승인하고, 회의 중에 질문에 답하고, 침대에 누워 코드 생성 결과를 확인할 수도 있다. 모든 작업은 실제 Claude Code 세션을 기반으로 하며, 상태를 위조하지 않고 실행 로직을 변경하지 않는다.

개발 작업 중 컴퓨터를 떠나야 할 때, PandaNpc를 열고 QR 코드를 스캔하면 Claude Code의 제어권이 주머니 속에 있게 된다.