Remote Control (원격 제어)

Remote Control을 사용하면 로컬 Claude Code 세션을 다른 기기에서 계속 작업할 수 있습니다. (출처: 공식 문서)

개요

Remote Control은 로컬 컴퓨터에서 실행 중인 Claude Code 세션에 다른 기기에서 연결할 수 있는 기능입니다. 이를 통해:

• 모바일 기기 연결: 휴대폰이나 태블릿에서 로컬 세션 제어
• 다른 컴퓨터에서 계속 작업: 집 회사 간 세션 이동
• 로컬 실행 유지: 모든 코드와 MCP 서버가 로컬에서 실행

요구 사항

구독 플랜

Team 및 Enterprise 플랜 사용자는 Remote Control을 사용할 수 없습니다.

인증 및 보안

Remote Control을 사용하기 전에 다음이 필요합니다:

1. 로그인: claude auth login으로 인증 완료
2. 워크스페이스 신뢰: 워크스페이스가 신뢰된 상태여야 함

사용 방법

방법 1: 독립 명령어로 시작

터미널에서 다음 명령어 실행:

claude remote-control

방법 2: 세션 중에 활성화

이미 Claude Code 세션이 실행 중인 경우:

/remote-control

또는 짧은 별칭:

/rc

연결 방법

Remote Control을 시작하면 다음과 같은 연결 옵션이 제공됩니다:

1. URL로 연결

Remote Control URL: https://code.claude.com/r/abc123xyz

1. URL을 복사
2. 다른 기기의 브라우저에서 URL 열기
3. Anthropic 계정으로 로그인
4. 세션에 자동 연결

2. QR 코드로 연결 (모바일)

터미널에 QR 코드가 표시됩니다:

[QR Code 이미지]

1. 모바일 기기의 카메라 앱 열기
2. QR 코드 스캔
3. 표시된 URL 탭
4. 로그인 후 연결

3. 세션 목록에서 연결

이미 연결된 기기가 있는 경우:

1. Claude Code Web 방문
2. 로그인
3. 활성 세션 목록에서 세션 선택

보안 아키텍처

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을 사용해야 할까

Remote Control 권장:

• 로컬 MCP 서버를 사용해야 할 때
• 대형 프로젝트 컨텍스트가 필요할 때
• 로컬 도구/스크립트를 실행해야 할 때
• 코드가 로컬에 있어야 할 때

Claude Code on the Web 권장:

• 병렬 작업이 필요할 때
• 간단한 질문/작업일 때
• 로컬 설정 없이 빠르게 사용할 때

자동 시작 설정

자주 사용하는 경우 Remote Control을 자동으로 시작하도록 설정할 수 있습니다.

설정 파일

~/.claude/settings.json:

{
  "autoEnableRemoteControl": true
}

이 설정을 켜면 Claude Code를 시작할 때마다 자동으로 Remote Control이 활성화됩니다.

문제 해결

연결이 끊김

문제: Remote Control 연결이 자주 끊김

해결책:

1. 인터넷 연결 확인
2. Anthropic API 상태 확인: https://status.anthropic.com
3. claude auth status로 인증 상태 확인

QR 코드가 표시되지 않음

문제: 터미널에 QR 코드가 표시되지 않음

해결책:

1. URL을 직접 사용
2. 터미널이 UTF-8을 지원하는지 확인
3. 대형 터미널 창 사용

터미널 닫힘 문제

문제: 터미널을 실수로 닫아서 세션이 종료됨

해결책:

1. macOS: tldr 모드 사용 (터미널 없이 실행)
2. tmux/screen: 세션 관리자 사용
3. nohup: 백그라운드 실행

# tmux 사용 예시
tmux new-session -d 'claude remote-control'

인증 오류

문제: "Not authenticated" 오류

해결책:

claude auth login

워크스페이스 신뢰 오류

문제: "Workspace not trusted" 오류

해결책:

/workspace trust

팁과 모범 사례

모바일 워크플로우

1. 집: 컴퓨터에서 claude remote-control 시작
2. 이동 중: 모바일로 QR 코드 스캔 후 작업 계속
3. 도착 후: 다시 컴퓨터에서 작업

보안 모범 사례

• 공용 와이파이에서는 주의 사용 (HTTPS 암호화되어 있음)
• 세션 종료 후 로그아웃
• URL 공유하지 않기

성능 최적화

• 빠른 인터넷 연결 사용
• 로컬 머신의 성능에 따라 반응 속도 달라짐
• 대형 파일 전송은 피하기

추가 자료

• 공식 Remote Control 문서
• 인증 설정 가이드
• 보안 모범 사례

팁: Remote Control은 Pro/Max 플랜 사용자를 위한 강력한 기능입니다. 로컬 개발 환경의 장점과 클라우드의 유연성을 결합합니다.