로그인
KO

IDE Remote: 휴대폰이나 다른 컴퓨터에서 IDE 사용하기

IDE Remote는 JumPHP IDE를 휴대폰이나 다른 컴퓨터와 공유합니다. Claude와의 대화, 터미널, (읽기 전용) 파일이 웹 페이지에 나타나며, 활성 패널에 실시간으로 입력할 수 있습니다. 소파에서 Claude를 지켜보거나, 답하거나, 자리를 비운 채 빌드를 확인할 때 편리합니다.

데이터(대화, 터미널 텍스트, 읽은 파일)만 오가며 화면 영상은 전혀 전송되지 않습니다. 모든 것은 종단 간(end-to-end) 암호화됩니다. 키는 링크 안에 있으며 어떤 서버도 볼 수 없습니다.

필요한 것

  • 프로젝트를 연 데스크톱 IDE.
  • 브라우저가 있는 휴대폰 또는 다른 컴퓨터, 그리고 IDE가 주는 링크.
  • 인터넷(relay 경유) 또는 직접 연결을 위한 같은 로컬 네트워크.

IDE 공유하기

  1. IDE에서 Claude 패널을 열고 전화 아이콘 옆의 화면 아이콘을 클릭합니다.
  2. 공유할 항목(범위)을 고릅니다.
    • Claude 패널: 대화만;
    • 터미널: 터미널만;
    • IDE 전체: Claude, 터미널, 그리고 읽기 전용 파일.
  3. IDE가 링크와 QR 코드를 보여 줍니다: https://play.jumphp.net/jumphp-ide-remote/play/#.... 휴대폰에서 열거나 다른 컴퓨터의 페이지에 붙여 넣으세요.
  4. PC에서 창이 묻습니다: "“<기기>”이(가) <범위>을(를) 사용하도록 허용할까요?". 허용을 클릭하세요. 그전까지는 아무 응답도 하지 않습니다.
  5. 페이지에 IDE가 나타납니다. 입력하면 활성 패널로 전달됩니다.

애플리케이션은 jumphp-ide-remote입니다(해당 페이지).

relay 또는 직접 연결

  • relay(기본): 양쪽 모두 wss://jumphp.net/ide-relay/ws에 접속합니다. 어디서나, 어떤 네트워크에서든 작동합니다. relay는 암호화된 바이트만 전달합니다.
  • 직접: IDE에서 허용하면 IDE가 로컬 네트워크에서 대기하고, 기기는 집 밖으로 나가지 않고 연결합니다. 더 빠르고 서버를 거치지 않습니다. 휴대폰 브라우저에서는 JumPHP runtime이 필요합니다(브라우저만으로는 네트워크 안의 PC에 닿을 수 없습니다). Safari / iPhone은 항상 relay를 사용합니다.

페이지는 먼저 잠시 직접 연결을 시도한 뒤 스스로 relay로 전환합니다.

PC에서 제어하기

  • 공유는 직접 켜야만 하며 8시간 후 만료됩니다.
  • IDE는 연결된 기기 목록을 보여 줍니다. 해제는 한 기기를 끊고, 공유 중지는 모두 끊어 링크를 쓸모없게 만듭니다.
  • IDE를 닫으면 공유가 끝납니다.

보안 요약

  • 종단 간 암호화(AES-256-GCM). 키는 링크의 프래그먼트(# 뒤)에 있으며, 브라우저는 이를 서버로 보내지 않습니다. 링크를 가진 누구나 연결을 요청할 수 있으므로 비밀번호처럼 다루고 게시하지 마세요.
  • 새 기기마다 PC에서 동의가 필요합니다.
  • 기본 거부: IDE는 선택한 범위의 몇 가지 명령(Claude에 보내기, Claude 중지, 기록 읽기, 터미널 입력, 파일 읽기)만 실행합니다. 나머지는 모두 거부됩니다.
  • 휴대폰에서 파일 쓰기는 불가능합니다. 파일은 Claude 패널의 일반 규칙에 따라 Claude를 통해서만 바뀝니다. 페이지에서 commit, push, 실행, 설치도 할 수 없습니다.
  • 한 번에 하나의 Claude: 터미널의 Remote Control이 세션을 잡고 있으면 텍스트는 그 터미널 탭에 입력됩니다.

문제 해결

PC가 전혀 묻지 않습니다. 공유가 켜져 있는지(화면 아이콘이 켜짐), 링크가 최신인지 확인하세요(새로 공유하면 새 링크가 만들어집니다). 링크는 #... 부분까지 전체를 열어야 합니다. 일부 메신저는 이를 잘라 버리므로 QR 코드로 열거나 페이지의 입력란에 붙여 넣으세요. 8시간이 지난 링크는 무효입니다.

브라우저가 연결을 차단합니다. VPN, 회사 필터, 광고 차단기가 wss://jumphp.net/ide-relay/ws를 차단할 수 있습니다. 허용하거나 없이 시도해 보세요. 휴대폰 브라우저에서 직접 모드를 쓰려면 JumPHP runtime을 설치하고, 묻는 경우 애플리케이션을 허용하세요.

직접 연결이 안 되고 relay가 사용됩니다. 정상이며 문제없습니다. 원인: 두 기기가 같은 네트워크에 있지 않음(게스트 Wi-Fi, "클라이언트 격리"), PC 방화벽이 포트를 차단함, 휴대폰에 runtime이 없음, 또는 Safari / iPhone 사용. relay를 통해서도 모든 것이 똑같이 작동합니다.

"만료됨" 또는 "해제됨". 공유가 끝났습니다(8시간, 해제, 공유 중지, 또는 IDE 종료). 화면 아이콘을 다시 클릭해 새 링크를 받으세요.

"거부됨". 누군가 PC에서 거부를 클릭했습니다. 링크를 다시 열고 한 번 더 요청하세요.

IDE의 Claude와, 직접 모드는 runtime도 참고하세요.

직접 또는 AI와 함께 디버깅: Xdebug와 PHP Debugger.