[공식문서읽기] Claude Code Remote Control - 휴대폰에서 코딩 세션 이어하기

3줄 요약

1. claude를 최신 버전으로 업데이트하세요

2. claude 현재 session에서 /remote-control 명령을 실행하세요.

3. 제공된 url로 모바일에서 여세요

가끔 오류날 때가 있습니다. claude에서 /logout도 해보고, 터미널을 종료하고 재시작도 해보세요. 저같은 경우, 아래 오류가 났는데 터미널 재시작으로 동작하더라고요.

Claude Code on the web is not available for the selected organization. Switch to a different organization or use the CLI.

개요

Claude Code의 Remote Control 기능은 컴퓨터에서 시작한 코딩 세션을 휴대폰, 태블릿, 또는 다른 브라우저에서 이어서 작업할 수 있게 해주는 기능입니다. 책상에서 코딩하다가 소파로 이동해서 휴대폰으로 계속 작업하거나, 다른 컴퓨터의 브라우저에서 이어서 진행할 수 있습니다. 2026년 2월 24일에 공개된 이 기능은 현재 연구 미리보기**(Research Preview)** 단계로 제공되고 있습니다.

---

Remote Control이란?

Remote Control은 claude.ai/code 또는 iOS/Android용 Claude 앱을 컴퓨터에서 실행 중인 Claude Code 세션에 연결하는 기능입니다.

핵심 포인트는 세션이 항상 로컬 컴퓨터에서 실행된다는 것입니다. 코드나 파일이 클라우드로 이동하지 않으며, 웹이나 모바일 인터페이스는 단지 로컬 세션으로 통하는 "창(window)" 역할만 합니다.

Remote Control로 할 수 있는 것들은 다음과 같습니다.

• 로컬 환경 전체를 원격으로 활용: 파일 시스템, MCP 서버, 도구, 프로젝트 구성이 모두 그대로 사용 가능합니다
• 여러 기기에서 동시에 작업: 대화가 모든 연결된 기기에서 실시간 동기화되어, 터미널에서 메시지를 보낸 뒤 휴대폰에서 이어서 보낼 수 있습니다
• 자동 재연결: 노트북이 절전 모드로 전환되거나 네트워크가 끊어져도, 다시 온라인 상태가 되면 세션이 자동으로 복구됩니다

---

요구 사항

Remote Control을 사용하기 위해 필요한 조건은 다음과 같습니다.

• 구독 플랜: Pro 또는 Max 플랜이 필요합니다. API 키로는 사용할 수 없으며, Team이나 Enterprise 플랜에서도 아직 지원되지 않습니다
• 인증: Claude Code에서 /login 명령으로 claude.ai 계정에 로그인되어 있어야 합니다
• 작업 공간 신뢰: 프로젝트 디렉토리에서 최소 한 번 claude를 실행하여 작업 공간 신뢰 대화를 수락해야 합니다

---

세션 시작 방법

Remote Control 세션을 시작하는 방법은 두 가지가 있습니다.

방법 1: 새 세션으로 시작

프로젝트 디렉토리에서 다음 명령을 실행합니다.

claude remote-control

이 명령을 실행하면 터미널에서 프로세스가 계속 실행되면서 원격 연결을 기다립니다. 세션 URL이 표시되고, 스페이스바를 누르면 QR 코드도 확인할 수 있습니다.

지원되는 플래그는 다음과 같습니다.

• --verbose: 상세한 연결 및 세션 로그를 표시합니다
• --sandbox / --no-sandbox: 파일 시스템과 네트워크 격리를 위한 샌드박싱을 켜거나 끕니다 (기본값: 꺼짐)

방법 2: 기존 세션에서 전환

이미 Claude Code 세션 중이라면 슬래시 명령을 사용합니다.

/remote-control

축약형으로 /rc도 사용할 수 있습니다. 현재 대화 기록을 그대로 이어받는 Remote Control 세션이 시작되며, 세션 URL과 QR 코드가 표시됩니다.

팁: /remote-control을 실행하기 전에 /rename으로 세션에 이름을 지정하면, 여러 기기의 세션 목록에서 찾기가 더 쉬워집니다.

---

다른 기기에서 연결하기

Remote Control 세션이 활성화되면 다른 기기에서 연결하는 방법은 세 가지입니다.

- 세션 URL 열기 - 터미널에 표시된 세션 URL을 다른 브라우저에서 열면 claude.ai/code의 해당 세션으로 바로 이동합니다.

- QR 코드 스캔 - 세션 URL 옆에 표시된 QR 코드를 스마트폰 카메라로 스캔하면 Claude 앱에서 바로 열 수 있습니다. claude remote-control 명령을 사용한 경우 스페이스바로 QR 코드 표시를 토글할 수 있습니다.

- claude.ai/code 또는 Claude 앱에서 직접 찾기 - 세션 목록에서 이름으로 세션을 찾을 수 있습니다. Remote Control 세션은 온라인 상태일 때 녹색 상태 점이 있는 컴퓨터 아이콘으로 표시됩니다.

Claude 앱이 아직 없다면 Claude Code 안에서 /mobile 명령을 실행하면 iOS 또는 Android용 다운로드 QR 코드를 볼 수 있습니다.

---

모든 세션에서 자동 활성화

기본적으로 Remote Control은 명시적으로 명령을 실행할 때만 활성화됩니다. 모든 세션에서 자동으로 활성화하려면 다음과 같이 설정합니다.

1. Claude Code 안에서 /config 명령을 실행합니다
2. Enable Remote Control for all sessions 옵션을 true로 설정합니다
3. 비활성화하려면 같은 옵션을 false로 되돌리면 됩니다. 각 Claude Code 인스턴스는 한 번에 하나의 원격 세션만 지원하며, 여러 인스턴스를 실행하면 각각 독립된 세션을 가집니다.

---

연결 및 보안

Remote Control의 보안 구조는 다음과 같이 설계되어 있습니다.

• 인바운드 포트 없음: 로컬 Claude Code 세션은 아웃바운드 HTTPS 요청만 수행하며, 컴퓨터에서 인바운드 포트를 열지 않습니다
• 폴링 방식: Remote Control을 시작하면 Anthropic API에 등록하고 작업을 폴링하는 방식으로 동작합니다
• TLS 암호화: 모든 트래픽은 TLS를 통해 Anthropic API를 거쳐 이동하며, 이는 일반 Claude Code 세션과 동일한 수준의 전송 보안입니다
• 단기 자격 증명: 연결은 각각 단일 목적으로 범위가 지정되고 독립적으로 만료되는 여러 단기 자격 증명을 사용합니다
• 즉, 파일과 MCP 서버는 로컬 컴퓨터를 벗어나지 않으며, 암호화된 채널을 통해 채팅 메시지와 도구 실행 결과만 전달됩니다.

---

Remote Control vs 웹의 Claude Code

Remote Control과 웹의 Claude Code(Claude Code on the Web)는 모두 claude.ai/code 인터페이스를 사용하지만, 핵심 차이는 세션이 실행되는 위치입니다.

Remote Control을 사용하는 경우
로컬에서 작업 중이고 다른 기기에서 이어서 하고 싶을 때

로컬 MCP 서버, 도구, 프로젝트 설정을 그대로 활용해야 할 때

보안상 코드가 로컬에 남아있어야 할 때

웹의 Claude Code를 사용하는 경우
로컬 설정 없이 바로 작업을 시작하고 싶을 때

아직 클론하지 않은 리포지토리에서 작업할 때

여러 작업을 병렬로 실행하고 싶을 때

간단히 말해, Remote Control은 내 컴퓨터의 환경을 원격으로 조종하는 것이고, 웹의 Claude Code는 Anthropic의 클라우드 서버에서 새로 실행하는 것입니다.

---

제한 사항

현재 Remote Control에는 몇 가지 제한이 있습니다.

• 한 번에 하나의 원격 세션: 각 Claude Code 세션은 하나의 원격 연결만 지원합니다
• 터미널은 열려 있어야 함: Remote Control은 로컬 프로세스로 실행되므로, 터미널을 닫거나 claude 프로세스를 중지하면 세션이 종료됩니다
• 네트워크 타임아웃: 컴퓨터가 켜져 있지만 약 10분 이상 네트워크에 접근할 수 없으면 세션이 시간 초과되고 프로세스가 종료됩니다
• 플랜 제한: 현재 Pro 및 Max 플랜에서만 사용 가능하며, Team/Enterprise 플랜에서는 아직 지원되지 않습니다
• 세션이 종료된 경우에는 claude remote-control을 다시 실행하면 새 세션을 시작할 수 있습니다.

---

마무리

Claude Code Remote Control은 개발자의 작업 흐름을 유연하게 만들어주는 기능입니다. 컴퓨터 앞에 앉아 있지 않아도 진행 중인 코딩 세션을 확인하고 이어서 작업할 수 있다는 것은, 특히 장시간 실행되는 작업을 맡겨놓고 이동해야 할 때 매우 유용합니다.

핵심 정리를 하면 다음과 같습니다.

• claude remote-control 또는 /rc로 간단히 시작
• QR 코드 스캔으로 모바일에서 즉시 연결
• 모든 데이터는 로컬에서 실행되고 TLS로 암호화
• Pro/Max 플랜에서 연구 미리보기로 이용 가능

참고 자료

• Claude Code Remote Control 공식 문서
• Claude Code Remote Control 영문 공식 문서
• Anthropic just released a mobile version of Claude Code called Remote Control - VentureBeat
• Claude Code on the Web 공식 문서

이 글은 Claude Code를 활용하여 작성되었습니다.