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

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

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 쪽과 통신합니다. 웹·모바일 클라이언트와의 메시지는 Anthropic 인프라에서 스트리밍으로 중계됩니다.

flowchart TB
    subgraph local["로컬 머신"]
        CC["Claude Code<br/>(세션·도구·파일)"]
    end
    subgraph anthropic["Anthropic"]
        API["API<br/>등록·폴링·메시지 중계"]
    end
    subgraph clients["원격 UI"]
        WM["웹 / 모바일<br/>claude.ai/code"]
    end
    CC <-->|"HTTPS 아웃바운드<br/>스트리밍"| API
    WM <-->|"스트리밍"| API

1. Remote Control을 켜면 로컬 Claude Code가 Anthropic API에 세션을 등록합니다.
2. 아웃바운드 HTTPS로 작업을 폴링합니다. 방화벽 뒤에서도 일반적인 아웃바운드만 허용되면 연결됩니다.
3. Anthropic 서버가 웹·모바일과 로컬 세션 사이에서 스트리밍으로 메시지를 중계합니다.

소스 코드 본문이 클라우드로 복사되는 흐름은 아닙니다. 연결 후에는 터미널과 웹·모바일을 동시에 쓸 수 있고, 대화는 기기 간에 실시간으로 맞춰집니다. 터미널에서 메시지를 보내다가 폰에서 이어 보내는 것도 가능합니다.

시작하기

요구사항

• 구독: Pro 또는 Max (API 키만으로는 사용 불가)
• 인증: /login으로 claude.ai 로그인 완료
• 버전: 최신 권장 (claude update)
• 워크스페이스 신뢰: 프로젝트 디렉터리에서 최소 한 번 claude를 실행해 신뢰 대화상자를 수락

새 세션으로 시작

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을 켠 뒤 다른 기기에서 붙는 경로는 대략 네 가지입니다.

flowchart LR
    A["Remote Control ON"] --> B["URL 복사·열기"]
    A --> C["터미널에서<br/>스페이스바 → QR"]
    A --> D["claude.ai/code<br/>세션 목록"]
    A --> E["/mobile →<br/>앱 설치 QR"]
    C --> F["폰 카메라·앱으로 스캔"]
    B --> G["브라우저에서 세션 열기"]
    D --> G

URL 직접 열기

터미널에 나온 세션 URL을 브라우저에서 열면 됩니다. 같은 Wi-Fi에 있을 필요는 없습니다.

QR 코드 스캔

claude remote-control로 시작했다면 스페이스바로 QR을 토글합니다. /rc로 켠 경우에는 URL과 함께 표시되는 경우가 많습니다. 폰으로 스캔해 Claude 앱에서 세션을 여는 방식이 가장 빠른 편입니다.

세션 목록에서 선택

claude.ai/code ↗나 Claude 앱의 세션 목록에서 고릅니다. 온라인인 로컬 세션은 컴퓨터 아이콘과 초록 점으로 표시됩니다.

Claude 앱 설치

모바일 앱이 없다면 터미널에서 /mobile을 입력하면 iOS/Android용 다운로드 QR이 나옵니다.

보안

보안 모델은 아래 세 가지를 전제로 합니다.

flowchart TB
    R["Remote Control 보안 원칙"]
    R --> P1["코드는 로컬에 머무름<br/>클라우드 VM으로 이전 없음"]
    R --> P2["TLS 경유 Anthropic API<br/>일반 Claude Code와 동일한 전송 보호"]
    R --> P3["다수의 단기 credential<br/>목적·수명이 분리되어 blast radius 제한"]

1. 코드는 로컬에 머무릅니다

실행과 파일 접근은 로컬 경계 안에서 이루어지므로, 기존 로컬 개발 환경의 신뢰 모델을 그대로 가져갈 수 있습니다.

2. 일반 Claude Code와 같은 전송 보호

트래픽은 Anthropic API를 통해 TLS로 암호화됩니다. 별도 VPN이나 터널 도구가 필수는 아닙니다.

3. Multiple short-lived credentials

하나의 장기 토큰 대신 여러 개의 단기 credential을 씁니다. 각각은 목적이 한정되고 독립적으로 만료되어, 하나가 노출되어도 영향 범위를 줄이는 설계입니다.

주의: 세션 URL은 비밀번호처럼 다루세요. 링크를 가진 사람은 세션을 조작할 수 있습니다. Slack·SNS에 올리지 마세요.

vs Claude Code on the web

Claude Code on the web ↗과 이름이 비슷해 헷갈리기 쉽습니다. 둘 다 브라우저에서 Claude Code를 쓰게 해 주지만, 코드가 도는 위치가 다릅니다.

어떤 걸 선택할까?

flowchart TD
    Q1{"이미 로컬에서<br/>작업 중인가?"}
    Q1 -->|예| Q2{"MCP·로컬 파일·<br/>.claude 설정이<br/>필요한가?"}
    Q1 -->|아니오| WEB["Claude Code on the web<br/>고려"]
    Q2 -->|예| RC["Remote Control"]
    Q2 -->|아니오| Q3{"다른 기기 UI만<br/>옮기면 되는가?"}
    Q3 -->|예| RC
    Q3 -->|아니오| WEB

Remote Control은 책상에서 시작한 세션을 소파·회의실·이동 중에 그대로 이어가고 싶을 때 맞습니다. 로컬 파일, MCP, 프로젝트별 설정이 유지된다는 점이 장점입니다.

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

실전 활용 팁

장시간 작업 모니터링

리팩토링이나 테스트 스위트를 돌려 둔 뒤 자리를 비워야 할 때, 폰으로 접속해 진행을 보고 승인·거부만 해도 됩니다.

flowchart TD
    S1["작업 전 충분한 컨텍스트·지시"] --> S2["/rc 로 Remote Control"]
    S2 --> S3["QR 스캔 또는 URL"]
    S3 --> S4["자리 비움"]
    S4 --> S5["폰에서 모니터링·승인·거부"]

프로덕션 긴급 대응

저녁 식사 중 알림이 와도 워크스테이션으로 달려갈 필요만은 없습니다. 이미 켜 둔 세션에 폰으로 붙어 원인 분석을 지시하고, 핫픽스 승인 정도는 모바일에서도 처리하기 쉽습니다.

회의 중 작업 관리

긴 빌드·디버깅을 시작해 둔 채 회의에 들어가도, 폰으로 “문제를 찾았는지” 확인하고 수정안을 승인할 수 있습니다.

실전 팁 모음

제한사항

• 원격 연결은 세션당 1개: 동시에 여러 기기에서 같은 세션을 붙이는 식은 지원 범위 밖입니다.
• 터미널·프로세스 유지: 터미널을 닫거나 Claude 프로세스를 끄면 세션이 끝납니다.
• 네트워크 타임아웃: 머신은 켜져 있어도 네트워크가 약 10분간 끊기면 세션이 타임아웃될 수 있습니다.
• 슬립·깨어남: 노트북이 슬립하면 일시 중지되고, 깨어나면 자동 재연결을 시도합니다.
• 모바일 UI: 폰은 모니터링·간단 승인에 맞고, 긴 코드 리뷰에는 부적합합니다.
• Team/Enterprise: 현재 Pro/Max에서 사용 가능합니다.

마무리

Remote Control을 세 줄로만 짚으면 다음과 같습니다.

1. 코드는 로컬, UI는 어디서든 — 리포를 클라우드로 올리지 않고도 폰·태블릿·다른 브라우저에서 이어갑니다.
2. 시작은 한 줄 — claude remote-control 또는 /rc입니다.
3. 모니터링·의사결정용 — 모바일에서 긴 타이핑보다는 진행 확인과 승인에 쓰는 편이 좋습니다.

Research Preview 단계이지만, “터미널 앞에만 붙어 있어야 한다”는 루틴을 꽤 바꿔 주는 기능입니다. Pro나 Max를 쓰고 계시다면 claude update 후 한번 붙여 보시길 권합니다.

관련 글

• Claude Code Agent Teams 완벽 가이드
• Claude Code Channels 살펴보기

참고 자료

공식 문서

• Remote Control 문서 ↗
• CLI Reference ↗
• Security ↗
• Claude Code on the web ↗

블로그 및 리뷰

• Simon Willison 블로그 ↗
• NxCode 가이드 ↗
• SmartScope 3분 요약 ↗
• MacStories Hands-On ↗