Claude Code On-the-Go

1 month ago 11

스마트폰만으로 6개의 Claude Code 에이전트를 병렬 실행하며 개발 작업을 수행하는 구성 설명
Termius와 mosh, Tailscale VPN, Vultr VM을 조합해 노트북 없이도 안정적인 원격 개발 환경 유지
tmux 세션 유지와 Poke 웹훅 알림을 통해 비동기 개발이 가능하며, Claude가 입력을 요청할 때만 푸시 알림으로 응답
보안은 Tailscale 전용 접근, nftables, fail2ban 등 다중 방어 구조로 강화
커피를 기다리거나 이동 중에도 PR 검토·리팩터링·버그 수정이 가능한, 완전한 모바일 개발 워크플로우 구현

전체 구성 개요

스마트폰에서 Termius 앱을 통해 mosh로 Tailscale VPN을 거쳐 Vultr VM에 접속하는 구조
- VM 내부에서 Claude Code가 실행되고, PreToolUse hook이 Poke 웹훅을 호출해 푸시 알림을 전송
- 사용자는 알림을 받고 Claude의 질문에 응답하는 순환 구조
이 방식으로 비동기 개발 루프를 구성, 언제 어디서나 작업 가능

인프라 세부 구성

Vultr VM은 실리콘밸리 리전에 위치하며, 사양은 vhf-8c-32gb
- 비용은 시간당 $0.29, 하루 약 $7 수준
- Tailscale 전용 접근으로 SSH는 비공개, 퍼블릭 포트는 모두 차단
vm-start와 vm-stop 스크립트로 VM의 시작과 종료를 자동화
- iOS 단축어를 통해 Vultr API로 직접 VM을 시작할 수 있음
보안 계층은 클라우드 방화벽, nftables, fail2ban으로 구성

모바일 터미널 환경

Termius가 iOS/Android에서 SSH와 mosh를 지원
- mosh는 네트워크 전환에도 연결이 유지되어, Wi-Fi ↔ 셀룰러 전환이나 절전 모드에서도 세션 지속
- 명령 예시: mosh --ssh="ssh -p 47892" [email protected]
단점으로 SSH agent 포워딩 미지원, GitHub 인증이 필요한 작업은 tmux 내에서 일반 SSH 사용

세션 지속성

로그인 시 자동으로 tmux 세션에 연결되도록 .zshrc 설정
- Termius를 닫았다가 다시 열어도 세션이 그대로 유지
여러 Claude 에이전트를 tmux 창으로 병렬 실행
- C-a c로 새 창 생성, C-a n으로 전환

푸시 알림 시스템

Claude Code의 AskUserQuestion 이벤트 발생 시 PreToolUse hook이 실행
- poke-notify.sh 스크립트가 질문을 추출해 Poke 웹훅으로 POST 요청 전송
- 휴대폰에서 알림을 받고, 질문을 확인 후 즉시 응답 가능
이 기능으로 사용자는 터미널을 계속 확인할 필요 없이 완전한 비동기 개발 가능

신뢰 및 보안 모델

Claude Code는 permissive 모드로 실행되며, VM은 격리되어 프로덕션 시스템 접근 불가
- 개발에 필요한 최소한의 비밀정보만 포함
- 예기치 않은 동작이 발생해도 VM은 폐기 가능
비용 제어를 통해 리스크 최소화, 하루 최대 비용이 제한됨

병렬 개발 구조

Git worktree를 활용해 여러 기능 브랜치를 동시에 운영
- 예: myproject-sidebar, myproject-dark-mode 등
각 worktree는 독립된 tmux 창과 Claude 에이전트를 가짐
- 포트는 브랜치명 해시 기반으로 결정되어 충돌 없음
- 예시 계산식: django_port = 8001 + (hash_val % 99)
최대 6개의 에이전트를 한 번에 실행

활용 시나리오

커피를 기다리거나 이동 중에도 PR 리뷰, 리팩터링, 버그 수정 수행 가능
Claude가 10~20분 걸리는 작업을 수행하는 동안 사용자는 다른 일을 하다가, 알림을 받고 응답 후 다시 진행
데스크톱 없이도 완전한 개발 주기를 스마트폰에서 실현

구성 요소 요약

Vultr: 시간당 $0.29의 클라우드 VM
Tailscale: 안전한 사설 네트워크
Termius: 모바일 SSH 클라이언트
mosh: 네트워크 복원력 있는 셸
tmux: 세션 지속성 유지
Poke: 웹훅 기반 푸시 알림
Claude Code: 실제 개발 작업 수행

결론

전체 환경은 하나의 Claude Code 세션으로 구축 가능
- Vultr API 키와 GitHub 접근 권한만 제공하면 Claude가 보안 개발 VM을 자동 구성
결과적으로 스마트폰만으로 완전한 개발 환경을 구현, 이동성과 효율성을 극대화한 사례

Read Entire Article