Wendo폰에서 Claude Code 사용하는 법
큰 리팩터링을 시작하고 커피를 타러 간 사이, Claude Code가 마이그레이션을 실행해도 되는지 물으며 멈춥니다. 당신은 책상에 없으니 에이전트는 그냥 기다립니다. 이 가이드는 컴퓨터를 일하게 두고 폰으로 지켜보는 방법, 무엇을 어떤 순서로 설정할지를 다룹니다.
왜 이렇게 하고 싶을까
코딩 에이전트가 늘 2분짜리 작업만 하는 것은 아닙니다. 긴 작업은 30분 이상 돌 수 있고, 그동안 Claude Code는 명령 실행, 파일 편집, 프로젝트 밖의 무언가를 건드리는 일에 대해 권한을 묻습니다. 답할 사람이 없으면 기다립니다.
폰이 주머니에 있으면 어디까지 왔는지 보고, 무엇을 묻는지 읽고, 결정할 수 있습니다. 책상에 붙어 있을 필요도, 혹시 몰라 모든 것을 미리 승인해 둘 필요도 없습니다.
필요한 것
Claude Code가 실행되는 컴퓨터에 세 가지, 그리고 폰에 앱 하나입니다.
SSH 서버. 폰은 다른 노트북처럼 SSH로 컴퓨터에 연결합니다.
- macOS: 시스템 설정 › 일반 › 공유 › 원격 로그인.
- Linux(Debian 또는 Ubuntu):
sudo apt install openssh-server
sudo systemctl enable --now ssh집 네트워크 밖에서 접속하는 방법. 같은 Wi-Fi라면 로컬 IP로 충분합니다. 집 밖에서는 Tailscale 같은 VPN이 현명한 길입니다. 폰과 컴퓨터가 한 네트워크에 있는 것처럼 서로 보이고, 22번 포트를 인터넷에 노출할 필요가 없습니다. 특히 비밀번호 로그인이라면 포트 노출은 하지 마세요.
tmux 같은 터미널 멀티플렉서. 없으면 폰의 연결이 끊기거나 앱을 닫을 때 터미널 세션도 함께 죽습니다. tmux가 있으면 Claude Code는 컴퓨터에서 계속 돌고, 같은 세션에 다시 붙기만 하면 됩니다.
brew install tmux # macOS
sudo apt install tmux # Debian/Ubuntu단계별로
- 컴퓨터에서 SSH를 켜고 다른 기기에서 되는지 확인합니다.
ssh your-user@computer-ip. - 집 밖에서 연결하려면 양쪽에 VPN을 설치하고, 그 네트워크에서 컴퓨터가 쓰는 이름이나 IP를 적어 둡니다.
- tmux 안에서 Claude Code를 시작합니다.
tmux new-session -A -s claude
claude-A 플래그는 claude라는 세션이 이미 있으면 두 번째를 만들지 않고 그 세션에 붙는다는 뜻입니다.
- 폰에서 SSH로 연결해 그 tmux 세션에 붙습니다. 거기서 Claude에게 입력하고, 하는 일을 읽고, 답할 수 있습니다.
이렇게 해도 동작합니다. 모자란 것은 편의성입니다. Claude가 아직 당신을 기다리는지 보려고 몇 분마다 앱을 열어야 합니다. 마지막 조각이 필요한 이유입니다.
Wendo가 들어가는 자리
Wendo는 Lirafy가 만든 iOS·Android용 SSH 클라이언트로, 코딩 에이전트를 지켜보기 위해 만들었습니다. 아직 스토어에는 없고, App Store와 Google Play에 곧 출시됩니다.
단순한 SSH 위에 더하는 것은 알림과 승인입니다. 컴퓨터에서 명령 하나를 실행합니다.
curl -fsSL https://wendo.lirafy.dev/install.sh | sh스크립트는 훅과 페어링 스크립트를 ~/.wendo에 내려받고, 없으면 jq와 qrencode를 설치하고, ~/.claude/settings.json에 훅을 등록하고(먼저 settings.json.bak-wendo로 사본 저장), 22번 포트에서 SSH를 기다리는 것이 없으면 경고하고, QR 코드를 출력합니다. 다시 실행해도 중복되는 것은 없습니다.
폰에서는 머신 › 추가로 가서 QR 코드 스캔을 고릅니다. Wendo는 그 첫 순간부터 서버의 호스트 키 지문을 고정하므로 키를 무작정 받아들이지 않습니다. 이어서 앱이 폰의 키를 authorized_keys에 설치하기 위해 컴퓨터에서 실행할 명령을 보여 줍니다.
그때부터 Claude Code가 당신에게 필요로 하는 것, 즉 권한 요청, 질문, 끝난 작업이 모든 머신에서 한곳, 받은 편지함에 나타납니다. 각 권한 요청은 그 행에서 승인하거나 거부할 수 있습니다. 답하지 않아도 이상한 일은 생기지 않습니다. 훅이 90초를 기다리고, 그 뒤에는 Claude Code가 평소처럼 터미널에서 묻습니다. 자세한 내용은 알림과 승인 문서에 있습니다.
Claude를 tmux 안에서 실행하면 알림을 탭했을 때 실행 중인 정확한 패널로 이동합니다. 설정은 tmux 문서에 있고, 네트워크가 끊길 때 어떻게 되는지는 연결이 끊겨도 살아남는 세션에서 다룹니다.
작은 화면에서는 두 가지가 더 도움이 됩니다. Claude가 바꾼 내용을 검토하는 diff 뷰어와, 대화에 이미지 붙여넣기입니다. 웹을 만들고 있다면 브라우저 미리보기도 있습니다.
무료 플랜에는 받은 편지함에서 쓸 수 있는 체험 승인 5회가 포함됩니다. Pro에는 제한이 없습니다.
앱을 닫았을 때
Wendo가 열려 있는 동안 받은 편지함은 저절로 갱신됩니다. 앱을 닫으면 알림은 ntfy를 통해 도착합니다. 직접 호스팅할 수 있는 푸시 알림 서비스입니다. 설정 방법과 토픽이 사실상 비밀번호인 이유는 폰에서 받는 Claude Code 알림 글에 있습니다.
다른 클라이언트를 쓰고 싶다면
어떤 SSH 클라이언트든 기본은 해냅니다. 연결하고, tmux에 붙고, Claude Code와 대화합니다. 잃는 것은 나머지 전부입니다. 훅이 없으면 받은 편지함도, 행에서 승인하는 일도, 세션이 당신을 필요로 할 때의 알림도 없어서, 직접 확인해야 한다는 것을 기억해야 합니다. 그걸로 충분하다면 위의 단계가 필요한 전부입니다.
알아 둘 제한 사항
- Windows에서는 WSL2가 필요합니다. 앱이 SSH로 POSIX 셸 명령을 보내고, tmux는 Windows에 없습니다. 훅이 거기서 실행되도록 Claude Code를 WSL 안에서 실행하세요.
- 지금은 훅이 Claude Code에만 등록됩니다.
- Claude의 질문과 계획 승인은 대기하지 않습니다. 받은 편지함 행이 아니라 채팅 보기에서 답합니다.
- tmux, zellij, herdr 연동은 Wendo Pro 기능입니다.