▲

Claude Code Remote Control

 (code.claude.com)
1P by GN⁺ 17시간전 | ★ favorite | 댓글 1개
  • 로컬 개발 세션을 다른 기기에서 이어서 사용할 수 있는 기능으로, Claude Code가 실행 중인 컴퓨터에 원격으로 접속해 작업을 지속할 수 있음
  • claude.ai/code 웹 인터페이스나 Claude 모바일 앱(iOS·Android) 을 통해 접속하며, 로컬 환경이 그대로 유지되어 파일시스템·도구·프로젝트 설정을 그대로 활용 가능
  • Pro 및 Max 요금제 사용자에게 연구 미리보기 형태로 제공되며, Team·Enterprise 요금제에서는 지원되지 않음
  • 모든 통신은 Anthropic API를 통한 TLS 암호화 연결로 이루어지며, 세션은 로컬에서 실행되어 클라우드로 데이터가 이동하지 않음
  • 로컬 개발 환경을 유지하면서도 기기 간 연속 작업이 가능한 구조로, 원격 협업과 이동 중 개발 효율을 높이는 기능임

Remote Control 개요

  • Remote Control은 로컬 Claude Code 세션을 다른 기기에서 이어서 사용할 수 있게 하는 기능
    • 휴대폰, 태블릿, 다른 브라우저 등에서 동일한 세션을 이어서 작업 가능
    • claude.ai/code 또는 Claude 모바일 앱을 통해 접속 지원
  • Pro·Max 요금제 사용자만 이용 가능, Team·Enterprise 요금제에서는 제공되지 않음
  • 세션은 로컬에서 계속 실행되며, 클라우드로 전송되지 않음
  • 주요 기능
    • 로컬 환경 원격 사용: 파일시스템, MCP 서버, 도구, 프로젝트 설정 유지
    • 기기 간 동기화: 터미널·브라우저·모바일 간 대화 동기화
    • 자동 재연결: 네트워크 끊김이나 절전 후 자동 복구

요구사항 (Requirements)

  • Pro 또는 Max 구독 플랜 필요, API 키는 지원되지 않음
  • claude 명령어 실행 후 /login으로 claude.ai 인증 필요
  • 프로젝트 디렉터리에서 claude를 한 번 실행해 워크스페이스 신뢰 설정 수락 필요

Remote Control 세션 시작

  • 새 세션 생성 또는 기존 세션을 원격으로 연결 가능
  • 프로젝트 디렉터리에서 다음 명령 실행 
    claude remote-control
    • 터미널에서 세션 URL 표시, 스페이스바로 QR 코드 표시 가능
    • --verbose, --sandbox, --no-sandbox 플래그 지원
  • 기존 Claude Code 세션에서 /remote-control 또는 /rc 명령으로 원격 제어 시작 가능
    • 현재 대화 기록을 유지하며 세션 URL과 QR 코드 제공
    • /rename 명령으로 세션 이름 지정 가능

다른 기기에서 연결

  • 세션 URL을 브라우저에서 열기 또는 QR 코드 스캔으로 접속
  • claude.ai/code나 Claude 앱에서 세션 목록을 통해 접속 가능
    • 온라인 상태일 경우 컴퓨터 아이콘과 녹색 점 표시
  • 세션 이름은 마지막 메시지, /rename 값, 또는 기본 “Remote Control session”으로 표시
  • /mobile 명령으로 iOS·Android 앱 다운로드 QR 코드 표시 가능

모든 세션에 Remote Control 활성화

  • /config 명령에서 Enable Remote Control for all sessions 옵션을 true로 설정
  • 각 Claude Code 인스턴스는 한 번에 하나의 원격 세션만 지원

연결 및 보안

  • 로컬 세션은 아웃바운드 HTTPS 요청만 수행, 인바운드 포트는 열리지 않음
  • Remote Control 시작 시 Anthropic API에 등록 후 작업을 폴링
  • 다른 기기에서 연결 시, 서버가 메시지를 스트리밍 방식으로 중계
  • 모든 트래픽은 TLS 암호화를 사용하며, 단기 자격 증명으로 세분화된 접근 제어 수행

Claude Code on the web과의 차이

  • 두 기능 모두 claude.ai/code 인터페이스를 사용하지만,
    • Remote Control은 로컬 머신에서 실행되어 MCP 서버·도구·설정 사용 가능
    • Claude Code on the web은 Anthropic 클라우드 인프라에서 실행
  • 로컬 작업을 이어가려면 Remote Control,
    클론되지 않은 저장소나 병렬 작업에는 Claude Code on the web 사용

제한 사항

  • 한 번에 하나의 원격 세션만 지원
  • 터미널이 열려 있어야 함, claude 프로세스 종료 시 세션 종료
  • 10분 이상 네트워크 불가 상태 시 세션 타임아웃 후 종료

관련 자료

  • [Claude Code on the web] – 클라우드 기반 세션 실행
  • [Authentication] – /login 설정 및 인증 관리
  • [CLI reference] – claude remote-control 명령 전체 목록
  • [Security] – Remote Control 보안 모델 설명
  • [Data usage] – Anthropic API를 통한 데이터 흐름 설명
▲
GN⁺ 17시간전  [-]
Hacker News 의견들

  • 이 프리릴리스 버전은 매우 불안정하고 버그가 많음
    Claude를 멈추려 해도 계속 실행되고, UI가 자주 끊기며, 세션이 하나만 유지되고 로드도 잘 안 됨
    코드 탭을 벗어날 때마다 세션이 사라졌다가 다시 기다려야 함
    XML이 그대로 출력되는 등 완성도가 낮음

    • 나도 비슷하게 겪고 결국 포기했음
      “코딩은 이미 해결된 문제 아닌가, Boris?”라는 생각이 들었음
    • 내 경우 /remote-control 명령이 QR코드 대신 긴 URL만 출력했음
      모바일 앱에서는 세션이 안 보이고, URL을 직접 입력해도 연결이 안 됨
      GitHub 연결을 요구하는 등 설계가 복잡하고 버그투성이였음
      권한 요청도 중복되고, 멈춤 버튼도 작동 안 함
      Claude가 스스로 테스트를 작성한 게 아닌가 싶을 정도로 품질이 낮음
    • 나도 같은 경험을 했음. 코드 기능은 멋지지만 테스트 부족이 명확함
      인턴 몇 명만 써도 충분히 잡을 수 있을 수준의 문제임
    • 기대했는데 제약이 너무 많음
      지금은 Tailscale + Termius(iOS) 조합으로 쓰고 있음
      입력은 잘 되지만 음성 입력으로 stdin에 직접 텍스트를 넣을 수 없는 점이 아쉬움
    • 모바일 앱뿐 아니라 Claude Code Web도 신뢰성이 낮음
      Opus 토큰을 많이 소모하고 이유 없이 멈춤
      진행 상태를 알 수 없고, 결국 다시 실행해야 해서 시간과 비용이 낭비됨

  • 나는 오래전부터 이 방식을 써왔음
    Tailscale을 두 기기에 설치하고, tmux와 모바일 터미널(echo/Termius)을 이용해 원격 로그인함
    tmux new -s <feature>로 세션 이름을 지정해두면 언제든 tmux attach -t <feature>로 재접속 가능함

    • 오늘 zmx라는 대안을 발견했음 (GitHub 링크)
      tmux처럼 세션 유지가 되지만 터미널 에뮬레이션을 하지 않아 스크롤이 정상 작동함
      Claude Code와 함께 써보니 노트북과 폰 간 전환이 꽤 매끄러웠음
    • 나도 같은 방식으로 쓰지만, Termius에서 자동완성·스와이프 입력이 안 돼서 불편함
    • 대부분 이 방식으로 시작했을 것 같음
    • CC를 열 때마다 tmux가 자동 실행되게 alias를 쓰는지 궁금함
      여러 세션을 동시에 다룰 때는 어떻게 하는지도 알고 싶음
      mosh는 꼭 필요한지, 설정이 어려웠음
    • 나도 같은 세팅을 쓰는데, 새 기능의 장점이 뭔지 모르겠음
      Tmux/Tailscale/Termius 조합이면 이미 완전한 제어가 가능한데, 단지 설정 편의성 때문인지 궁금함

  • Opencode의 web 명령은 로컬 세션을 브라우저에서 실행하게 해줌
    CLI와 동일한 권한으로 작동하고 인터페이스도 깔끔함
    무료 모델로 바로 테스트 가능함 (문서 링크)

    • 하지만 폰에서 버그가 너무 많아 결국 Termux로 돌아감

  • Happy Engineering은 이미 같은 기능을 훨씬 안정적으로 제공함
    Codex도 지원함

    • 나도 이걸 자주 썼는데, 최근 초기화 오류 버그가 생겨서 폰 클라이언트에서 실패함
      그래도 무료·익명·암호화 지원 등 훌륭한 소프트웨어임
      빨리 수정되길 바람. tmux 터널링으로 돌아가고 싶지 않음

  • 이상하게도 많은 회사들이 원격 제어를 이렇게 힘들게 구현함
    SSH는 20년째 안정적으로 작동해왔고, 인증 문제도 빠르게 패치되어왔음

    • 그래도 AI 회사라면 접근 방식이 완전히 다르긴 함

  • “이 기능이 모바일 코딩 스타트업의 기회를 죽인다”는 말에 동의하지 않음
    코딩 에이전트는 스트리밍 서비스처럼 여러 개를 구독하게 될 것임
    그래서 범용 제어판이 필요하고, 모바일 인터페이스는 단순한 원격 제어 이상을 제공해야 함

    • 하지만 스트리밍처럼 여러 구독을 강요하는 건 모두가 불만임
      비용도 늘고, 광고도 많고, 파편화가 심함
    • 나는 VSCode에서 Copilot Auto를 쓰는데, ChatGPT나 Claude와 큰 차이를 못 느낌
      라디오처럼 필요할 때 채널을 바꾸는 느낌임
      특별한 게 필요할 땐 Spotify를 켜고, 아닐 땐 그냥 조용히 둠
    • 나도 폰으로 작업을 많이 해서 내 워크플로를 직접 만들었음
      CLI 제공자들을 통합해주는 범용 제어 플랜이 필요하다고 생각함
      관련 비교글을 여기 정리했음

  • Claude Code 팀에게 하고 싶은 말은, 핵심 경험을 먼저 안정화하라는 것임
    새로운 기능을 내는 건 좋지만, 깊이 있는 개선이 우선임

    • “Vibe 코딩”으로 80%는 되지만, 마감 품질이 나머지 80%를 차지함
    • Xcode용 Claude Agent 클라이언트는 웹이나 Mac 앱보다 훨씬 안정적임

  • 요즘 Claude Code는 너무 자주 깨지고 바뀜
    Anthropic이 속도를 늦춰야 함
    매일 “오늘은 뭐가 또 고장났나” 하는 피로감이 큼

    • Claude Code 자체는 좋은 제품임
      방향을 분산시키지 말고 모델과 품질을 꾸준히 개선했으면 함

  • “이건 GNU screen을 가장 비효율적으로 재발명한 것” 같음

    • 그래도 이 방식은 공인 IP나 VPS, VPN 없이 쓸 수 있고, 폰에 터미널 앱 설치만으로 충분함
    • 사실 터미널·SSH·tmux를 폰에서 재현하려는 시도는 많았지만, 엄지로 쓰기엔 끔찍한 경험임
      게다가 Tailscale 같은 중앙 제공자를 거치므로 완전한 자율성도 아님
    • 기술적으로는 맞는 말이지만, 이건 지속 세션보다 추상화 계층이 핵심임
      tmux는 명령을 알아야 하지만, 이건 결과 중심임
      나처럼 늦게 코딩을 시작한 사람에겐 이 방식이 훨씬 효율적임
    • 실제로 명령은 Anthropic 서버를 통해 폴링 메커니즘으로 전달됨
    • 나는 colo 서버에서 tmux로 에이전트를 돌리고, 이동 중엔 RC 앱으로 접근함

  • 나도 비슷한 목표로 프로젝트를 만들었음
    웹 서버를 띄워 브라우저나 Android 앱으로 접속하면 Claude Code 세션이 실시간 동기화되고,
    서버 재시작 시 자동 복원됨
    최근엔 예약 작업과 에이전트 팀 구성 기능도 추가함
    Opus 4.6으로 실험하며 만든 프로젝트이며, GitHub 링크에서 설치 가능함
    피드백을 환영함

답변달기