Skip to content
Go back

Claude Code Remote Control: 어디서든 로컬 개발 세션 이어가기

Published:  at  12:49 AM

책상에서 대규모 리팩토링을 시작했습니다. Claude Code가 열심히 작업 중인데, 슬슬 소파로 옮겨 쉬고 싶습니다. 예전이라면 터미널 앞에 붙어 있어야 했지만, 이제는 폰을 꺼내 QR 코드를 스캔하면 됩니다. Remote Control이 로컬에서 돌아가는 Claude Code 세션을 그대로 폰으로 가져다줍니다.

이 글에서는 2026년 2월 25일 Research Preview로 출시된 Remote Control의 개념, 설정 방법, 보안 모델, 그리고 실전 활용법까지 살펴보겠습니다.


Remote Control이란?

Remote Control은 로컬에서 실행 중인 Claude Code 세션을 claude.ai/code 웹 인터페이스Claude 모바일 앱(iOS/Android)에서 이어서 사용할 수 있게 해주는 기능입니다.

핵심은 단순합니다. 코드는 로컬에 그대로 있고, UI만 다른 기기로 옮깁니다. 클라우드 VM을 띄우거나 코드를 업로드하는 것이 아닙니다. 로컬 머신에서 돌아가는 Claude Code 프로세스에 원격 화면을 붙이는 개념입니다.

동작 원리

┌──────────────┐     HTTPS (아웃바운드)     ┌──────────────────┐
│  로컬 머신     │ ──────────────────────► │  Anthropic API   │
│  Claude Code │ ◄────────────────────── │  (메시지 중계)      │
└──────────────┘     스트리밍 연결          └────────┬─────────┘

                                        스트리밍 연결│

                                         ┌───────▼────────┐
                                         │  웹/모바일 앱     │
                                         │  (claude.ai)   │
                                         └────────────────┘
  1. Remote Control을 시작하면 로컬 Claude Code가 Anthropic API에 등록합니다
  2. 아웃바운드 HTTPS 연결로 작업을 폴링합니다 (인바운드 포트를 열지 않음)
  3. Anthropic 서버가 웹/모바일 클라이언트와 로컬 세션 사이에서 스트리밍 연결로 메시지를 중계합니다

코드 자체가 클라우드로 올라가는 일은 없습니다. 연결 후에는 터미널과 웹/모바일을 동시에 사용할 수 있습니다. 대화가 모든 기기에서 실시간 동기화되므로, 터미널에서 메시지를 보내다가 폰에서 이어서 보내는 것도 가능합니다.


시작하기

요구사항

새 세션으로 시작

claude remote-control

옵션 플래그도 사용할 수 있습니다.

claude remote-control --verbose          # 상세 연결 및 세션 로그
claude remote-control --sandbox          # 파일시스템/네트워크 격리 활성화
claude remote-control --no-sandbox       # 격리 비활성화 (기본값)

기존 세션에서 시작

이미 대화 중인 세션을 원격으로 전환하려면 슬래시 커맨드를 사용합니다.

/remote-control  # 또는 줄여서 /rc

현재 대화 기록이 그대로 유지된 채 원격 접속이 활성화됩니다.

💡 : /rename으로 세션에 이름을 먼저 붙여두세요. 다른 기기에서 세션을 찾을 때 훨씬 편합니다.

참고: /remote-control 슬래시 커맨드에서는 --verbose, --sandbox 등의 플래그를 사용할 수 없습니다.

모든 세션에 자동 활성화

매번 명령을 입력하기 번거롭다면 설정에서 전역으로 켤 수 있습니다.

/config

설정 화면에서 “Enable Remote Control for all sessions”를 true로 변경하면 됩니다.


연결 방법

Remote Control을 시작하면 네 가지 방법으로 다른 기기에서 접속할 수 있습니다.

URL 직접 열기

터미널에 표시된 세션 URL을 브라우저에서 열면 바로 연결됩니다. 같은 네트워크에 있을 필요도 없습니다.

QR 코드 스캔

claude remote-control로 시작한 경우 스페이스바를 누르면 QR 코드가 토글됩니다. /rc로 시작한 경우에는 URL과 함께 자동으로 표시됩니다. 폰 카메라로 스캔하면 Claude 앱에서 세션이 바로 열립니다. 가장 빠른 방법입니다.

세션 목록에서 선택

claude.ai/code 또는 Claude 앱을 열면 세션 목록이 보입니다. 온라인 상태인 세션은 컴퓨터 아이콘 + 초록 점으로 표시됩니다.

Claude 앱 설치

아직 모바일 앱이 없다면 터미널에서 /mobile 명령을 입력하세요. iOS/Android 다운로드 QR 코드가 표시됩니다.


보안

Remote Control의 보안 모델은 세 가지 원칙 위에 설계되어 있습니다.

1. 코드는 로컬에 머뭅니다

코드가 클라우드 VM으로 이동하지 않습니다. 코드가 머신 밖으로 나가지 않으므로, 기존 로컬 개발 환경의 보안 경계가 그대로 유지됩니다.

2. 일반 Claude Code 세션과 동일한 전송 보안

모든 트래픽은 Anthropic API를 통해 TLS로 암호화되어 전송됩니다. 별도의 터널이나 VPN이 필요하지 않습니다.

3. Multiple short-lived credentials

인증에 하나의 장기 토큰을 사용하는 대신, 여러 개의 단기 credential을 사용합니다. 각 credential은 단일 목적에 한정되고 독립적으로 만료됩니다. 하나가 유출되더라도 blast radius가 제한됩니다.

⚠️ 주의: 세션 URL은 비밀번호처럼 취급하세요. 링크가 있으면 누구나 세션을 제어할 수 있습니다. Slack이나 SNS에 절대 공유하지 마세요.


vs Claude Code on the web

Remote Control과 혼동하기 쉬운 기능이 Claude Code on the web입니다. 둘 다 브라우저에서 Claude Code를 쓸 수 있지만, 근본적으로 다릅니다.

구분Remote ControlClaude Code on the web
실행 위치로컬 머신Anthropic 관리 클라우드 VM
파일 접근로컬 파일시스템클라우드 VM에 클론된 리포
MCP 서버로컬 MCP 서버 사용 가능사용 불가
프로젝트 설정로컬 .claude/ 설정 유지별도 환경 설정 필요
병렬 작업1세션만 가능여러 태스크 병렬 가능
로컬 셋업필요불필요
지원 플랜Pro, MaxPro, Max, Team, Enterprise

어떤 걸 선택할까?

Remote Control은 로컬에서 이미 작업 중인 세션을 다른 기기에서 이어가고 싶을 때 적합합니다. 로컬 파일, MCP 서버, 프로젝트 설정이 그대로 유지된다는 것이 핵심입니다.

Claude Code on the web은 로컬 셋업 없이 작업을 시작하거나, 클론하지 않은 리포에서 바로 작업하거나, 여러 태스크를 동시에 돌리고 싶을 때 적합합니다.


실전 활용 팁

장시간 작업 모니터링

대규모 리팩토링이나 테스트 스위트를 시작한 뒤, 자리를 비워야 할 때가 있습니다. 폰에서 Remote Control로 접속하면 진행 상황을 확인하고, 변경사항을 승인하거나 거부할 수 있습니다.

1. 작업 시작 전 Claude에게 충분한 컨텍스트 제공
2. /rc로 Remote Control 활성화
3. QR 코드 스캔 후 자리 비우기
4. 폰에서 진행 상황 모니터링 및 승인/거부

프로덕션 긴급 대응

저녁 식사 중 프로덕션 알림을 받았습니다. 워크스테이션으로 달려갈 필요 없이 폰에서 QR 코드를 스캔해 이미 실행 중인 Claude Code 세션에 연결할 수 있습니다. 원인 분석을 지시하고 핫픽스를 승인하는 정도의 작업은 모바일에서도 충분합니다.

회의 중 작업 관리

복잡한 빌드 디버깅을 시작해 놓고 회의에 들어가야 할 때, 폰으로 Claude가 문제를 찾았는지 확인하고 수정을 승인할 수 있습니다.

실전 팁 모음

설명
시작 전 컨텍스트 확보자리를 비우기 전에 Claude에게 충분한 지시를 주면 폰에서 수정할 일이 줄어듭니다
tmux/screen 사용터미널이 닫혀도 세션을 유지할 수 있는 백업 수단입니다
전용 git 브랜치 생성원격으로 승인한 변경사항을 나중에 데스크탑에서 리뷰하기 편합니다
/rename 활용세션 이름을 지정하면 다른 기기에서 찾기 쉽습니다
노트북 슬립 설정덮었을 때 슬립으로 설정하세요. 하이버네이트(최대절전)는 세션이 끊길 수 있습니다
MCP 서버 사전 설정모바일에서는 새 MCP 서버를 추가할 수 없으므로 미리 설정해두세요

제한사항

알아두어야 할 제약 사항이 있습니다.


마무리

Remote Control의 핵심을 세 줄로 요약하면 이렇습니다.

  1. 코드는 로컬에, UI는 어디서든: 클라우드에 코드를 올리지 않고도 폰, 태블릿, 다른 브라우저에서 세션을 이어갑니다
  2. 설정은 30초: claude remote-control 또는 /rc 한 줄이면 끝입니다
  3. 모니터링과 승인에 최적: 모바일에서 코드를 작성하려는 것이 아니라, 진행 상황을 확인하고 의사결정을 내리는 데 쓰세요

아직 Research Preview 단계이지만, “책상 앞에 붙어 있어야 하는” 개발 워크플로우에 실질적인 변화를 주는 기능입니다. Pro나 Max 플랜을 쓰고 계시다면 claude update 후 한번 시도해 보시길 권합니다.


참고 자료

공식 문서

블로그 및 리뷰



Previous Post
Agent Skills: Vercel의 CLI 도구에서 업계 오픈 표준으로 진화하기까지