[Claude Code] Remote Control — 터미널 세션을 폰에서 이어가기

Remote Control?

로컬 터미널에서 실행 중인 Claude Code 세션을 모바일 앱이나 브라우저에서 이어서 제어할 수 있는 기능이다. 코드는 로컬 머신에서 계속 실행되고, 폰은 리모컨 역할만 한다.

할 수 있는 것:

• 로컬 환경(파일시스템, MCP 서버, 프로젝트 설정) 그대로 원격 접근
• 터미널 ↔ 브라우저 ↔ 모바일 앱 간 대화 실시간 동기화
• 노트북 슬립/네트워크 끊김 시 자동 재연결

사전 준비

• 플랜: Pro 또는 Max (Team/Enterprise 미지원)
• 인증: claude 실행 후 /login으로 claude.ai 로그인 완료
• 버전: Claude Code 2.1.52 이상
• Workspace Trust: 프로젝트 디렉토리에서 claude를 한 번 이상 실행해 trust 승인

시작하기

1. 새 세션으로 시작

 

 

bash

claude remote-control

 

또는 줄여서:

 

 

bash

claude rc

 

2. 기존 세션을 원격으로 전환

이미 Claude Code 세션이 돌고 있다면 슬래시 커맨드를 사용한다:

 

/remote-control

 

또는:

/rc

기존 대화 히스토리가 그대로 유지된다.

3. 연결

터미널에 세션 URL과 QR 코드가 표시된다. 스페이스바를 누르면 QR 코드를 토글할 수 있다.

연결 방법경로

모바일 앱	Claude 앱에서 QR 코드 스캔
브라우저	claude.ai/code에서 세션 URL 접속

플래그 옵션

claude remote-control 명령어에서 사용 가능한 플래그:

플래그설명

--verbose	상세 연결/세션 로그 출력
--sandbox	파일시스템·네트워크 샌드박스 격리 활성화
--no-sandbox	샌드박스 비활성화 (기본값)

/rc 슬래시 커맨드에서는 이 플래그들을 사용할 수 없다.

claude rc vs /rc

	claude rc	/rc
실행 위치	터미널 (새 세션)	Claude Code 세션 내부
대화 히스토리	새로 시작	기존 대화 유지
플래그	--verbose, --sandbox 등 사용 가능	사용 불가
용도	새 작업 시작	진행 중인 작업을 모바일로 전환

Remote Control vs Claude Code on the web

둘 다 claude.ai/code를 사용하지만 실행 환경이 다르다.

	Remote Control	Claude Code on the web
실행 위치	내 로컬 머신	Anthropic 클라우드
파일 접근	로컬 파일시스템	클라우드 환경
MCP 서버	로컬 MCP 그대로 사용	별도 설정 필요
네트워크	로컬 네트워크 환경	클라우드 네트워크

실전 활용

 

 

# 1. 프로젝트에서 리팩토링 작업 시작
cd ~/projects/my-service
claude rc

# 2. QR 코드 스캔해서 모바일 연결

# 3. 점심 먹으러 가면서 폰으로 진행 상황 확인
#    승인 프롬프트가 뜨면 폰에서 바로 승인

# 4. 자리로 돌아오면 터미널에서 바로 이어서 작업

MCP 서버가 연결되어 있다면 원격에서도 그대로 사용 가능하다. 예를 들어 Atlassian MCP가 설정되어 있다면, 폰에서도 Jira 티켓 조회나 Confluence 문서 확인이 된다.

세션 이름 지정 팁: 여러 세션을 동시에 돌릴 경우 /rename으로 이름을 먼저 지어두면 모바일에서 식별이 쉽다.

 

 

/rename feature-auth-refactor
/rc

주의

• Research Preview 단계 (Pro, Max만 지원)
• Team/Enterprise 플랜 미지원
• API 키 인증 미지원 (claude.ai 계정 인증만 가능)
• 노트북 슬립은 자동 재연결되지만, 종료(shutdown)하면 세션 종료
• 네트워크 끊김이 약 10분 이상 지속되면 세션 타임아웃
• 데스크탑 앱에서의 접속은 공식 문서에 명시되어 있지 않음 → 브라우저(claude.ai/code) 사용 권장