Claude Code 원격 제어(Remote Control) 완전 가이드
기준 버전: Claude Code v2.1.51 이상
원본 영상: Using Claude Code Remote Control (2026년 3월 18일 공개)
목차
- 개요 및 배경
- Remote Control이란 무엇인가
- 작동 원리 및 기술 아키텍처
- 사용 가능 플랜 및 요구 사항
- 시작하는 방법: 3가지 세션 시작 방식
- 원격 디바이스에서 연결하는 방법
- Spawn 모드: 원격으로 새 세션 생성하기
- 설정에서 Remote Control 항상 활성화하기
- 보안 모델
- 실제 활용 시나리오
- Cloud 기반 Claude Code와의 차이점
- 현재 알려진 제한 사항
- 자주 묻는 질문(FAQ)
1. 개요 및 배경
Claude Code는 2025년 5월 Anthropic이 출시한 터미널 기반 AI 코딩 어시스턴트로, 출시 이후 빠른 속도로 개발자 커뮤니티에서 인기를 얻었다. 2026년 2월 기준 연간 반복 수익(ARR)이 25억 달러를 돌파하는 등 폭발적인 성장세를 보이고 있으며, Visual Studio Code에서만 하루 2,900만 건의 설치가 이루어지고 있다.
그러나 Claude Code는 한 가지 근본적인 한계를 가지고 있었다. 세션이 오직 데스크탑 터미널에서만 실행된다는 점이었다. 개발자들이 장시간 작업을 시작해놓고 외출하거나, 회의에 들어가거나, 다른 기기를 사용해야 할 때 해당 세션을 그대로 유지하거나 이어받을 방법이 없었다. 일부 사용자들은 SSH 터널, tmux 세션, ngrok 프록시, 심지어 WebSocket 브릿지를 직접 구현하는 등 복잡한 우회 방법을 사용해왔지만, 이런 해결책들은 불안정하고 설정이 번거로운 경우가 많았다.
이러한 문제를 해결하기 위해 Anthropic은 2026년 2월 25일 Remote Control 기능을 공식 출시했다. 이 기능은 로컬 Claude Code 세션을 모바일 디바이스나 웹 브라우저에서 원격으로 제어할 수 있도록 해주는 동기화 레이어(synchronization layer)로, 개발자가 데스크탑에서 시작한 작업을 어디서든 이어받을 수 있게 해준다.
2. Remote Control이란 무엇인가
Remote Control은 로컬 머신에서 실행 중인 Claude Code 세션을 claude.ai/code 웹 인터페이스 또는 iOS, Android용 Claude 모바일 앱과 연결하는 기능이다. 한마디로 말하면, “로컬에서 실행하고, 어디서나 제어한다(Run locally, control from anywhere)” 는 개념을 실현한 것이다.
이 기능의 핵심 가치는 다음 세 가지로 요약된다.
첫째, 세션의 연속성 보장이다. 데스크탑에서 시작한 세션의 대화 히스토리, 파일 컨텍스트, 설정이 모두 그대로 유지된다. 원격 기기에서 접속해도 동일한 세션을 이어받는 것이기 때문에, 처음부터 다시 시작할 필요가 없다.
둘째, 로컬 환경의 완전한 접근성이다. 클라우드 기반 솔루션과 달리 파일 시스템, MCP(Model Context Protocol) 서버, 커스텀 툴, 프로젝트 설정 등 로컬 환경의 모든 요소가 그대로 활성화된 상태로 유지된다. 코드는 결코 클라우드로 이동하지 않는다.
셋째, 멀티 디바이스 동기화이다. 터미널, 브라우저, 모바일 앱 중 어느 곳에서 메시지를 보내도 모든 연결된 기기에서 대화 내용이 실시간으로 동기화된다.
3. 작동 원리 및 기술 아키텍처
Remote Control은 클라우드 마이그레이션이 아닌 보안 동기화 브릿지다. 아키텍처를 이해하면 이 기능이 왜 안전하고 신뢰할 수 있는지 알 수 있다.
사용자가 claude remote-control 명령을 실행하면, 로컬 머신의 Claude Code 프로세스는 Anthropic의 API로 아웃바운드 HTTPS 연결을 맺는다. 이때 인바운드 포트를 열거나 머신을 공개 인터넷에 노출시키는 일은 전혀 없다. 로컬 프로세스가 API 서버에 등록되고, 이후 원격 기기에서 해당 세션 URL로 접속하면, Anthropic의 서버가 원격 클라이언트와 로컬 세션 사이의 메시지를 스트리밍 연결로 중계하는 구조다.
이 과정에서 중요한 것은, 파일과 MCP 서버는 절대 머신을 떠나지 않는다는 점이다. 채팅 메시지와 툴 실행 결과만이 TLS로 암호화된 브릿지를 통해 흐른다. 인증은 claude.ai 계정과 연동되어 있어 별도의 API 키가 필요하지 않으며, 각각의 목적에 맞게 스코핑된 단기 자격증명이 사용된다.
또한 자동 재연결 기능도 내장되어 있다. 노트북이 절전 모드에 들어가거나 네트워크가 일시적으로 끊겨도, 머신이 다시 온라인 상태가 되면 세션이 자동으로 재연결된다. 다만, 머신이 깨어 있더라도 네트워크 단절이 약 10분 이상 지속되면 세션이 타임아웃될 수 있으므로, 이 경우 claude remote-control 명령을 다시 실행해야 한다.
4. 사용 가능 플랜 및 요구 사항
지원 플랜
Remote Control은 공식 문서 기준으로 Pro, Max, Team, Enterprise 플랜 모두에서 사용 가능하다. 단, Team과 Enterprise 플랜은 관리자가 먼저 관리자 설정에서 Claude Code를 활성화해야 한다. 출시 초기에는 Max 플랜 사용자들에게 먼저 롤아웃이 진행되었으며, 현재는 Pro 플랜 사용자들에게도 순차적으로 확대되고 있다.
API 키 방식의 인증은 지원하지 않는다. 반드시 claude.ai 계정을 통해 인증해야 한다.
기술 요구 사항
Remote Control을 사용하기 위해서는 다음 조건들을 충족해야 한다.
Claude Code 버전: v2.1.51 이상이 필요하다. claude --version 명령으로 현재 버전을 확인할 수 있다.
인증: 터미널에서 claude를 실행한 후 /login 명령을 통해 claude.ai 계정으로 로그인되어 있어야 한다.
워크스페이스 신뢰: 프로젝트 디렉토리에서 적어도 한 번 claude를 실행하여 신뢰 다이얼로그를 수락해야 한다.
5. 시작하는 방법: 3가지 세션 시작 방식
Remote Control 세션을 시작하는 방법은 크게 세 가지가 있으며, 각각의 상황에 맞게 선택해서 사용할 수 있다.
방법 1: 전용 Remote Control 서버 모드
가장 기본적인 방법으로, 프로젝트 디렉토리로 이동한 후 다음 명령을 실행한다.
1
2
cd /your/project
claude remote-control
이 명령을 실행하면 터미널에 서버 프로세스가 시작되고, 원격 연결을 기다리는 상태가 된다. 화면에는 다른 디바이스에서 접속할 수 있는 세션 URL이 표시되며, 스페이스바를 누르면 스마트폰으로 빠르게 접속할 수 있는 QR 코드가 토글 방식으로 나타난다. 세션이 활성화된 동안 터미널에는 연결 상태와 툴 활동이 실시간으로 표시된다.
이 모드는 순수하게 원격 제어만을 위한 서버를 실행하는 것으로, 터미널에서 직접 메시지를 입력할 수는 없다. 원격 기기에서만 제어한다.
방법 2: 원격 제어가 활성화된 인터랙티브 세션
터미널에서 직접 상호작용하면서 동시에 원격에서도 제어하고 싶다면 --remote-control 또는 줄임말 --rc 플래그를 사용한다.
1
2
3
claude --remote-control
# 또는
claude --rc
이 방법은 터미널에서 평소처럼 대화하면서, 동시에 모바일이나 웹에서도 같은 세션에 접속해 제어할 수 있는 완전한 인터랙티브 세션을 제공한다.
방법 3: 이미 진행 중인 세션을 원격으로 전환
이미 Claude Code 세션을 실행 중인 상태에서 갑자기 자리를 비워야 하거나 원격 제어를 활성화하고 싶을 때는, 현재 세션에서 슬래시 명령을 사용한다.
1
2
3
/remote-control
# 또는 줄임말
/rc
이 명령은 현재 대화 히스토리를 모두 유지한 채로 Remote Control 세션으로 전환한다. 이전 대화 내용이 그대로 이어지기 때문에 컨텍스트 손실 없이 원격으로 넘어갈 수 있다. 참고로 이 명령을 사용할 때는 --verbose, --sandbox, --no-sandbox 플래그는 사용할 수 없다.
팁: /rename 명령으로 세션에 설명적인 이름을 붙여두면, 여러 디바이스에서 세션 목록 중 원하는 것을 쉽게 찾을 수 있다.
6. 원격 디바이스에서 연결하는 방법
세션이 시작되면 다른 디바이스에서 연결하는 방법은 다음과 같이 세 가지가 있다.
URL로 직접 접속: 터미널에 표시된 세션 URL을 브라우저에서 열면 claude.ai/code의 해당 세션으로 바로 이동한다. 이 URL을 다른 사람과 공유하거나, 북마크해두고 사용할 수 있다.
QR 코드 스캔: claude remote-control 서버 모드에서는 스페이스바를 누르면 QR 코드가 나타난다. 이를 스마트폰 카메라로 스캔하면 Claude 모바일 앱이나 모바일 브라우저로 바로 이동한다.
세션 목록에서 선택: Claude 앱을 열거나 claude.ai/code에 접속하면 계정에 연결된 활성 세션 목록이 표시된다. 명시적으로 URL 링크를 클릭하지 않아도, Claude 계정에 로그인되어 있기만 하면 목록에서 세션을 찾아 접속할 수 있다. 이는 URL을 따로 저장해두지 않아도 된다는 편리함을 준다.
일단 연결되면, 터미널에서 경험하던 것과 동일한 Claude Code 환경을 원격 기기에서도 그대로 사용할 수 있다. 동일한 툴, MCP 서버, 설정, 파일 시스템 모두 접근 가능하다.
7. Spawn 모드: 원격으로 새 세션 생성하기
Remote Control에는 Spawn 모드라는 고급 기능도 포함되어 있다. 이 모드를 사용하면 원격 기기에서 완전히 새로운 Claude Code 세션을 생성할 수 있다.
터미널에서 claude remote-control을 실행한 후, 웹 또는 모바일에서 Environment 버튼을 탭하여 자신의 디바이스를 선택하면, 거기서 여러 개의 Claude Code 인스턴스를 새로 생성하고 관리할 수 있다.
영상 기준으로는 Spawn 모드가 Mac, Team, Enterprise 사용자에게 우선 제공되었으나, 현재는 플랜별 지원 범위가 업데이트되었을 수 있으므로 공식 문서를 확인하는 것이 좋다.
8. 설정에서 Remote Control 항상 활성화하기
기본적으로는 매번 Remote Control 세션을 시작할 때 명시적으로 활성화해야 한다. 하지만 항상 원격 접속 가능한 상태로 Claude Code를 사용하고 싶다면, /config 설정에서 모든 세션에 대해 Remote Control을 자동으로 활성화하도록 할 수 있다.
1
/config
위 명령을 세션 내에서 실행하면 설정 메뉴가 열리며, 여기서 “Enable Remote Control for all sessions” 옵션을 켜면 이후 모든 세션이 자동으로 원격 제어 가능 상태로 시작된다. 매번 --rc 플래그를 붙이거나 /rc 명령을 실행할 필요가 없어진다.
9. 보안 모델
Remote Control을 사용할 때 보안에 대해 걱정하는 사용자들이 많을 것이다. 핵심 보안 원칙을 정리하면 다음과 같다.
아웃바운드 연결만 사용한다. 로컬 머신은 인바운드 포트를 열지 않는다. 외부에서 직접 머신으로 접근하는 경로는 없으며, 모든 통신은 로컬 프로세스가 Anthropic API로 시작하는 아웃바운드 HTTPS 요청으로만 이루어진다.
파일은 절대 클라우드로 전송되지 않는다. 채팅 메시지와 툴 실행 결과만이 암호화된 채널을 통해 이동하며, 파일 내용 자체는 항상 로컬 머신에 남아 있다.
TLS 암호화가 적용된다. 일반 Claude Code 세션과 동일한 전송 보안(Transport Layer Security)이 사용된다.
Claude 계정에 연결된다. 세션은 사용자의 claude.ai 계정과 연동되어 있으므로, 해당 계정에 로그인된 기기에서만 세션에 접근할 수 있다.
10. 실제 활용 시나리오
시나리오 1: 회의 중 리팩토링 진행 감독
데스크탑에서 대규모 코드 리팩토링 작업을 시작한다. Claude Code가 모듈 이름 변경, import 업데이트, 테스트 실행 등을 진행하는 동안 회의 알림이 뜬다. /rc 명령으로 세션을 원격 모드로 전환한 후, 스마트폰의 Claude 앱으로 접속한다. 회의 중간중간에 진행 상황을 확인하고, 잘못된 방향으로 가려는 부분은 즉시 메시지를 보내 수정하도록 할 수 있다. 데스크탑으로 돌아왔을 때 리팩토링은 훨씬 더 진행되어 있다.
시나리오 2: 통근 중 빌드 모니터링
아침에 집에서 Claude Code로 장시간 빌드 작업을 시작한다. 출근길 지하철에서 모바일로 진행 상황을 확인하고, 필요한 경우 지시를 추가할 수 있다. 사무실에 도착했을 때는 이미 작업이 상당 부분 완료되어 있다.
시나리오 3: MCP 서버를 활용한 원격 작업
커스텀 데이터베이스 툴, 로컬 린팅 서버, 프로젝트 전용 MCP 서버를 사용하는 환경에서 Remote Control의 진가가 발휘된다. 클라우드 기반 솔루션이었다면 이러한 로컬 전용 리소스에 접근할 수 없었겠지만, Remote Control은 실행이 항상 로컬 머신에서 이루어지기 때문에 모든 로컬 리소스를 원격에서도 그대로 활용할 수 있다.
시나리오 4: 긴급 버그 수정
퇴근 후 집에서 갑자기 프로덕션 버그 알림을 받는다. 노트북을 꺼내기 어려운 상황이라면, 스마트폰의 Claude 앱에서 새 Remote Control 세션(Spawn 모드)을 시작하여 긴급 수정 작업을 지시할 수 있다.
11. Cloud 기반 Claude Code와의 차이점
Remote Control과 claude.ai/code의 웹 기반 Claude Code는 비슷해 보이지만 근본적으로 다른 방식으로 동작한다.
| 구분 | Remote Control | Claude Code on the Web |
|---|---|---|
| 실행 위치 | 사용자의 로컬 머신 | Anthropic의 클라우드 인프라 |
| 파일 시스템 접근 | 로컬 파일 시스템 완전 접근 가능 | 샌드박스된 가상 머신, 로컬 파일 없음 |
| MCP 서버 | 로컬 MCP 서버 모두 사용 가능 | 클라우드 환경의 제한된 툴만 사용 |
| 환경 설정 | CLAUDE.md, 커스텀 설정 모두 유지 | 매번 새로운 환경으로 시작 |
| 세션 지속성 | 로컬 프로세스가 유지되는 한 지속 | 클라우드 인스턴스 수명에 의존 |
| 인터넷 연결 | 필요 (원격 제어 시) | 필요 |
웹 인터페이스와 모바일 앱은 Remote Control 세션에서 뷰포트(viewport), 즉 로컬 세션을 들여다보는 창 역할만 할 뿐이다. 실제 연산과 파일 조작은 모두 로컬 머신에서 이루어진다.
12. 현재 알려진 제한 사항
Remote Control은 Research Preview 단계를 거쳐 발전하고 있으며, 현재 알려진 제한 사항은 다음과 같다.
머신당 동시 세션 수: 한 머신에서는 한 번에 하나의 Remote Control 세션만 실행할 수 있다. 여러 개의 장기 실행 작업을 동시에 모니터링하고 싶을 경우 제약이 될 수 있다.
터미널 유지 필요: Remote Control이 작동하기 위해서는 로컬 머신의 터미널 프로세스가 계속 실행 중이어야 한다. 머신이 꺼지거나 터미널이 닫히면 세션도 종료된다.
네트워크 타임아웃: 머신이 깨어 있더라도 네트워크 연결이 약 10분 이상 끊기면 세션이 타임아웃된다. 이 경우 claude remote-control을 다시 실행하여 새 세션을 시작해야 한다.
권한 승인 필요: --dangerously-skip-permissions 플래그가 원격 제어 세션에서는 효과가 없다는 보고가 있다. 이는 원격 세션에서는 각 액션마다 승인이 필요할 수 있음을 의미한다.
Push 알림 미지원: 현재 Claude Code가 특정 작업에서 멈추거나 에러가 발생했을 때 Push 알림을 보내는 기능은 아직 없다. 진행 상황을 파악하려면 직접 앱을 열어서 확인해야 한다.
13. 자주 묻는 질문(FAQ)
Q. Remote Control을 사용할 때 내 코드와 파일이 Anthropic 서버에 저장되나요?
아니다. 파일과 로컬 환경은 절대 머신을 떠나지 않는다. 채팅 메시지와 툴 실행 결과만이 암호화된 채널을 통해 중계될 뿐이며, 이는 일반 Claude Code 사용과 동일한 수준의 데이터 처리 방식이다.
Q. Remote Control 세션에 다른 사람도 접속할 수 있나요?
세션은 claude.ai 계정과 연동되어 있다. 즉, 해당 계정에 로그인된 기기에서만 세션에 접근할 수 있다. 세션 URL을 다른 사람에게 공유하면 접속이 가능할 수 있으므로, URL 관리에 주의해야 한다.
Q. 모바일에서 터미널에서 할 수 있는 모든 것을 할 수 있나요?
대화 메시지를 주고받고, 툴 실행을 승인하거나 거부하는 등 핵심 기능들은 모두 사용할 수 있다. 다만 모바일 인터페이스 특성상 복잡한 키보드 입력이나 특수문자 입력 등에서 약간의 불편함이 있을 수 있다.
Q. 노트북을 닫으면 세션이 끊기나요?
노트북이 절전 모드에 들어가도 일시적인 네트워크 단절이면 자동으로 재연결된다. 단, 10분 이상 네트워크가 끊기면 세션이 타임아웃된다. 완전히 전원이 꺼지면 세션도 종료된다.
Q. 여러 프로젝트를 동시에 원격 제어할 수 있나요?
현재는 머신당 하나의 Remote Control 세션만 지원된다. 여러 프로젝트를 동시에 원격 제어하려면 Spawn 모드를 통해 여러 인스턴스를 생성하는 방법을 활용할 수 있다.
참고 자료
- Claude Code 공식 Remote Control 문서
- Claude Code Remote Control 영상 (YouTube)
- Anthropic 공식 발표 (Noah Zweben, 2026년 2월 24일)
- VentureBeat - Remote Control 상세 분석
이 문서는 2026년 3월 18일 기준의 최신 정보를 바탕으로 작성되었습니다. Remote Control은 계속 발전 중인 기능이므로, 최신 변경 사항은 공식 문서를 참고하세요.