최근 Anthropic에서 출시한 Claude Code는 터미널 기반의 강력한 AI 개발 도구로 큰 주목을 받고 있습니다. 하지만 책상을 떠나 소파에서, 혹은 이동 중에 휴대폰으로 작업 중이던 코드를 확인하거나 수정을 지시하고 싶을 때가 있죠.
이런 니즈를 완벽하게 충족시켜주는 기능이 바로 Remote Control 입니다. 이 기능을 사용하면 로컬 파일 시스템과 설정은 그대로 유지하면서, claude.ai/code 웹 페이지나 Claude 모바일 앱을 통해 원격으로 명령을 내릴 수 있습니다.
1. Remote Control이란 무엇인가요?
Remote Control 은 여러분의 컴퓨터에서 실행 중인 Claude Code 세션을 외부 기기(휴대폰, 태블릿, 다른 브라우저)에 연결해 주는 브릿지 역할을 합니다.
핵심은 "세션은 여전히 내 컴퓨터에서 로컬로 실행된다" 는 점입니다. 모든 파일 작업과 MCP 서버 연결은 로컬 환경을 그대로 사용하며, 웹이나 앱은 단지 그 세션을 보여주는 '창'의 역할만 수행합니다.
주요 장점
- 환경 유지: 파일 시스템, 도구, 프로젝트 구성이 모두 로컬과 동일하게 유지됩니다.
- 동시 작업: 터미널과 모바일 앱에서 동시에 메시지를 주고받으며 작업할 수 있습니다.
- 자동 재연결: 네트워크가 잠시 끊기거나 노트북이 절전 모드에 들어가도 온라인 상태가 되면 자동으로 복구됩니다.
2. 시작하기 전 체크리스트
Remote Control을 사용하기 위해서는 몇 가지 준비가 필요합니다.
- 구독 플랜: Pro 또는 Max 플랜 사용자여야 합니다 (API 키 모드 미지원).
- 인증: 터미널에서
claude /login을 통해 로그인이 완료된 상태여야 합니다. - 신뢰 설정: 해당 프로젝트 디렉토리에서 최소 한 번 이상
claude를 실행하여 작업 공간 신뢰를 승인해야 합니다.
3. Remote Control 세션 시작하기
두 가지 방법으로 세션을 시작할 수 있습니다.
방법 A: 처음부터 원격 모드로 시작하기
새로운 작업을 시작할 때 바로 원격 연결을 준비하려면 다음 명령어를 입력하세요.
claude remote-control실행 시 터미널에 접속 URL 이 나타나며, 스페이스바 를 누르면 모바일에서 스캔할 수 있는 QR 코드 가 표시됩니다.
방법 B: 작업 도중 원격으로 전환하기
이미 Claude Code와 대화 중인데 자리를 비워야 한다면, 대화창에 바로 명령어를 입력하세요.
/remote-control
# 또는 짧게
/rc이전 대화 기록이 그대로 유지된 채로 원격 세션이 활성화됩니다.
Tip:
/rename명령어로 세션 이름을 미리 지정해두면 모바일 앱에서 찾기가 훨씬 수월합니다!
4. 다른 기기에서 연결하기
연결 방법은 매우 간단합니다.
- URL 접속: 터미널에 표시된
claude.ai/code/...링크를 브라우저에 붙여넣습니다. - QR 스캔: 모바일 앱이 설치되어 있다면 QR 코드를 찍어 즉시 세션에 진입합니다.
- 목록에서 선택:
claude.ai/code또는 Claude 앱을 열면 현재 활성화된 '컴퓨터 아이콘(녹색 점)' 세션을 확인할 수 있습니다.
5. 웹 버전 Claude Code와의 차이점
Remote Control과 웹 기반 Claude Code는 UI가 동일하여 헷갈릴 수 있습니다. 아래 표를 통해 차이점을 확인하세요.
| 구분 | Remote Control | 웹 버전 Claude Code |
|---|---|---|
| 실행 위치 | 사용자의 로컬 컴퓨터 | Anthropic 클라우드 인프라 |
| 파일 접근 | 내 컴퓨터의 실제 파일 | 클라우드에 업로드/복제된 파일 |
| 도구 활용 | 로컬 MCP 서버 사용 가능 | 클라우드 전용 도구 사용 |
| 추천 케이스 | 로컬 작업 중 기기 이동 시 | 로컬 설정 없이 즉시 코딩 시 |
6. 주의사항 및 제한 사항
- 터미널 유지: Remote Control은 로컬 프로세스입니다. 터미널 창을 닫거나 컴퓨터를 종료하면 원격 세션도 함께 종료됩니다.
- 1:1 연결: 하나의 Claude Code 인스턴스당 하나의 원격 연결만 지원합니다.
- 네트워크 타임아웃: 네트워크 연결이 약 10분 이상 중단되면 보안을 위해 세션이 자동 종료됩니다.
마치며
Claude Code의 Remote Control은 개발자가 책상에만 얽매이지 않게 해주는 혁신적인 기능입니다. 이제 컴파일을 돌려놓고 거실로 나가 모바일로 진행 상황을 체크하거나, 카페에서 가볍게 코드를 수정해 보세요.
더 자세한 설정은 Claude Code 내에서 /config를 입력하여 'Enable Remote Control for all sessions' 옵션을 살펴보시는 것을 추천드립니다!