Claude Code의 가장 강력한 기능 중 하나는 원격 제어(Remote Control)입니다. Mac에서 복잡한 코드 리팩터링을 실행해 두고, 자리를 비운 상태에서 iPhone으로 진행 상황을 모니터링하고 명령을 승인할 수 있습니다.
하지만 많은 개발자들이 원격 세션 끊김 현상을 겪고 있습니다. 모바일 웹 화면에 “Disconnected”가 표시되거나, 세션이 감지되지 않거나, 노트북 덮개를 닫는 순간 세션이 강제 종료됩니다.
이 글에서는 Claude Code 원격 제어가 끊기는 원인과 단계별 해결 방법, 끊김 없는 안정적인 모바일 터미널 환경 구축법을 설명합니다.
해결법 1: 기본 비활성화 해제 및 /rc 수동 실행
최신 업데이트에서는 클라우드 리소스 절약을 위해 원격 제어가 기본적으로 비활성화되어 있습니다. 실행 중인 세션에서 다음을 입력하세요:
/rc세션 시작 시 항상 원격 제어를 자동으로 켜려면:
/config set autoRemoteControl true해결법 2: 환경 변수(ANTHROPIC_BASE_URL) 충돌 제거
Headroom이나 LiteLLM 같은 로컬 프록시 도구를 사용하면 ANTHROPIC_BASE_URL이 설정되어 Anthropic의 원격 WebSocket 게이트웨이 연결이 차단됩니다.
unset ANTHROPIC_BASE_URL claude확실한 해결책: Macky를 통한 Mac 네이티브 PTY 직결
불안정한 타사 클라우드 중계를 거치는 대신, Macky를 사용하면 Mac의 의사 터미널(PTY)에 iPhone에서 P2P WebRTC로 직접 연결할 수 있습니다.
- 클램셸 모드 완벽 지원: MacBook 덮개를 닫아도 터미널 세션이 유지됩니다.
- Wi-Fi에서 5G 전환 시에도 끊김 없는 즉각적인 자동 재연결.
- 모바일 보조 키바를 통해 원탭으로 bash 명령 승인(y, Enter, Ctrl+C).