Remote Control (원격 제어)
Remote Control을 사용하면 로컬 Claude Code 세션을 다른 기기에서 계속 작업할 수 있습니다. (출처: 공식 문서)
개요
Remote Control은 로컬 컴퓨터에서 실행 중인 Claude Code 세션에 다른 기기에서 연결할 수 있는 기능입니다. 이를 통해:
- 모바일 기기 연결: 휴대폰이나 태블릿에서 로컬 세션 제어
- 다른 컴퓨터에서 계속 작업: 집 회사 간 세션 이동
- 로컬 실행 유지: 모든 코드와 MCP 서버가 로컬에서 실행
요구 사항
구독 플랜
| 플랜 | Remote Control 지원 |
|---|---|
| Pro | 지원 |
| Max | 지원 |
| Team | 지원 안 함 |
| Enterprise | 지원 안 함 |
Team 및 Enterprise 플랜 사용자는 Remote Control을 사용할 수 없습니다.
인증 및 보안
Remote Control을 사용하기 전에 다음이 필요합니다:
- 로그인:
claude auth login으로 인증 완료 - 워크스페이스 신뢰: 워크스페이스가 신뢰된 상태여야 함
사용 방법
방법 1: 독립 명령어로 시작
터미널에서 다음 명령어 실행:
claude remote-control
방법 2: 세션 중에 활성화
이미 Claude Code 세션이 실행 중인 경우:
/remote-control
또는 짧은 별칭:
/rc
연결 방법
Remote Control을 시작하면 다음과 같은 연결 옵션이 제공됩니다:
1. URL로 연결
Remote Control URL: https://code.claude.com/r/abc123xyz
- URL을 복사
- 다른 기기의 브라우저에서 URL 열기
- Anthropic 계정으로 로그인
- 세션에 자동 연결
2. QR 코드로 연결 (모바일)
터미널에 QR 코드가 표시됩니다:
[QR Code 이미지]
- 모바일 기기의 카메라 앱 열기
- QR 코드 스캔
- 표시된 URL 탭
- 로그인 후 연결
3. 세션 목록에서 연결
이미 연결된 기기가 있는 경우:
- Claude Code Web 방문
- 로그인
- 활성 세션 목록에서 세션 선택
보안 아키텍처
Remote Control은 다음 보안 메커니즘을 사용합니다:
통신 보안
- TLS 암호화: 모든 통신은 Anthropic API를 통해 TLS로 암호화
- 아웃바운드 전용: 로컬 머신에서 나가는 연결만 사용 (인바운드 포트 불필요)
- 범위 지정 자격 증명: 세션별 고유 자격 증명
보안 경계
┌─────────────────┐
│ 원격 기기 │
│ (브라우저) │
└────────┬────────┘
│ HTTPS/TLS
▼
┌─────────────────┐
│ Anthropic API │
│ (중계 서버) │
└────────┬────────┘
│ HTTPS/TLS
▼
┌─────────────────┐
│ 로컬 머신 │
│ (Claude Code) │
└─────────────────┘
로컬 데이터 유지
- 모든 코드, 파일, 프로젝트는 로컬에 유지
- 원격 기기는 명령만 전송, 결과만 수신
- MCP 서버, 로컬 도구는 모두 로컬에서 실행
제한 사항
단일 세션 제한
- 동시에 하나의 Remote Control 세션만 활성화 가능
- 새 연결이 시작되면 이전 연결이 끊김
터미널 유지 필요
- 터미널이 열려 있어야 함
- 터미널을 닫으면 Remote Control 세션이 종료
- macOS에서는
tldr(tty-less) 모드 사용 권장
명령어 제한
일부 고급 기능은 제한될 수 있습니다:
- 대화형 파일 편집기
- 로컬 전용 도구 (일부)
- GUI 의존 기능
Remote Control vs Claude Code on the Web
| 기능 | Remote Control | Claude Code on the Web |
|---|---|---|
| 실행 위치 | 로컬 머신 | 클라우드 |
| MCP 서버 | 로컬 서버 사용 | 사용 불가 |
| 프로젝트 컨텍스트 | 전체 로컬 파일 | 업로드 필요 |
| 터미널 종료 시 | 세션 종료 | 계속 실행 |
| 병렬 작업 | 단일 세션 | 여러 세션 |
언제 Remote Control을 사용해야 할까
Remote Control 권장:
- 로컬 MCP 서버를 사용해야 할 때
- 대형 프로젝트 컨텍스트가 필요할 때
- 로컬 도구/스크립트를 실행해야 할 때
- 코드가 로컬에 있어야 할 때
Claude Code on the Web 권장:
- 병렬 작업이 필요할 때
- 간단한 질문/작업일 때
- 로컬 설정 없이 빠르게 사용할 때
자동 시작 설정
자주 사용하는 경우 Remote Control을 자동으로 시작하도록 설정할 수 있습니다.
설정 파일
~/.claude/settings.json:
{
"autoEnableRemoteControl": true
}
이 설정을 켜면 Claude Code를 시작할 때마다 자동으로 Remote Control이 활성화됩니다.
문제 해결
연결이 끊김
문제: Remote Control 연결이 자주 끊김
해결책:
- 인터넷 연결 확인
- Anthropic API 상태 확인: https://status.anthropic.com
claude auth status로 인증 상태 확인
QR 코드가 표시되지 않음
문제: 터미널에 QR 코드가 표시되지 않음
해결책:
- URL을 직접 사용
- 터미널이 UTF-8을 지원하는지 확인
- 대형 터미널 창 사용
터미널 닫힘 문제
문제: 터미널을 실수로 닫아서 세션이 종료됨
해결책:
- macOS:
tldr모드 사용 (터미널 없이 실행) - tmux/screen: 세션 관리자 사용
- nohup: 백그라운드 실행
# tmux 사용 예시
tmux new-session -d 'claude remote-control'
인증 오류
문제: "Not authenticated" 오류
해결책:
claude auth login
워크스페이스 신뢰 오류
문제: "Workspace not trusted" 오류
해결책:
/workspace trust
팁과 모범 사례
모바일 워크플로우
- 집: 컴퓨터에서
claude remote-control시작 - 이동 중: 모바일로 QR 코드 스캔 후 작업 계속
- 도착 후: 다시 컴퓨터에서 작업
보안 모범 사례
- 공용 와이파이에서는 주의 사용 (HTTPS 암호화되어 있음)
- 세션 종료 후 로그아웃
- URL 공유하지 않기
성능 최적화
- 빠른 인터넷 연결 사용
- 로컬 머신의 성능에 따라 반응 속도 달라짐
- 대형 파일 전송은 피하기
추가 자료
팁: Remote Control은 Pro/Max 플랜 사용자를 위한 강력한 기능입니다. 로컬 개발 환경의 장점과 클라우드의 유연성을 결합합니다.