Claude Code 'Remote Control' — 폰에서 내 로컬 세션 이어 코딩

 

책상에서 Claude Code로 작업하다 자리를 떠야 할 때, "이 세션 그대로 폰에서 이어서 못 보나?" 싶었던 적 있나요? 이걸 해주는 게 Remote Control입니다. 핵심은 코드가 여전히 내 컴퓨터에서 돌고, 폰·브라우저는 그 세션을 들여다보는 창이라는 점이에요. 이 글에서 켜는 법부터 보안, 웹 버전과의 차이까지 정리합니다.

📌 이 글에서 얻어갈 것

✓ Remote Control이 정확히 무엇인가 (로컬에서 돈다)
✓ 켜는 3가지 방법 (/remote-control 등)
✓ 폰에서 연결하고 푸시 알림 받기
✓ 보안 모델 · 웹 버전과의 차이 · 한계

Remote Control이 뭐야?

Remote Control은 내 컴퓨터에서 돌고 있는 Claude Code 세션을 claude.ai/code와 Claude 모바일 앱(iOS·Android)에 연결해줍니다. 책상에서 작업을 시작하고, 소파에서 폰으로, 또는 다른 컴퓨터의 브라우저로 이어받는 거죠.

"Remote Control 세션은 내 컴퓨터에서 돈다. 웹·모바일 화면은 그 로컬 세션을 들여다보는 창일 뿐이다."

— Claude Code 공식 문서

그래서 내 파일시스템·MCP 서버·도구·프로젝트 설정이 그대로 살아 있습니다. (클라우드에서 도는 'Claude Code on the web'과는 다릅니다.)

켜는 법 — 3가지

먼저 Claude Code v2.1.51 이상, 그리고 claude.ai 로그인(/login)이 필요합니다. 상황에 맞게 셋 중 하나:

# 1) 이미 진행 중인 세션을 이어서 원격 연결
/remote-control          (또는 /rc)

# 2) 처음부터 원격 가능한 인터랙티브 세션으로 시작
claude --remote-control "My Project"

# 3) 서버 모드 (여러 세션 호스팅, 스페이스바로 QR 표시)
claude remote-control

※ VS Code 확장에서도 /remote-control로 켤 수 있습니다. 매 세션 자동 연결을 원하면 /config에서 "Enable Remote Control for all sessions"를 켜세요.

폰에서 연결하기

1

QR 코드 스캔
터미널에 뜬 QR을 Claude 앱으로 스캔하면 바로 그 세션이 열립니다. (서버 모드는 스페이스바로 QR 토글)

2

또는 세션 목록에서
claude.ai/code나 Claude 앱의 Code 탭에서 세션 이름으로 찾기. 온라인이면 컴퓨터 아이콘 + 초록 점으로 표시됩니다.

3

자유롭게 오가기
대화가 터미널·브라우저·폰에서 실시간 동기화돼, 어디서든 메시지를 보낼 수 있어요. 노트북이 잠들거나 네트워크가 끊겨도 복귀하면 자동 재연결됩니다.

🔔 푸시 알림도 온다

Remote Control이 켜져 있으면, 긴 작업이 끝나거나 결정이 필요할 때 Claude가 폰으로 푸시를 보냅니다. 프롬프트에 "테스트 끝나면 알려줘"처럼 요청할 수도 있어요. (v2.1.110 이상)

보안은 어떻게?

🔒 아웃바운드 HTTPS만 — 내 컴퓨터에 인바운드 포트를 절대 열지 않음. 등록 후 일감을 폴링하는 방식

🔐 TLS + 단기 자격증명 — 모든 트래픽이 Anthropic API를 통해 TLS로. 용도별로 쪼개진 짧은 수명의 자격증명이 각각 따로 만료

'웹 버전'과 뭐가 다른가

Remote Control 내 컴퓨터에서 실행. 로컬 파일·MCP·설정 그대로. 진행 중인 작업을 다른 기기에서 이어갈 때.

Claude Code on the web Anthropic 클라우드에서 실행. 로컬 셋업 없이 시작하거나 안 받아둔 레포 작업·병렬 작업에.

알아둘 한계

⚠️ 로컬 프로세스가 살아 있어야 — 터미널을 닫거나 claude를 끄면 세션 종료

⚠️ 장시간 네트워크 단절(약 10분 이상)이면 세션 타임아웃 → 다시 시작

⚠️ 일부 명령은 로컬 전용 — /plugin·/resume 등 터미널 피커는 폰에서 안 됨

자주 묻는 질문 (FAQ)

Q. 어떤 플랜에서 되나요?

Pro·Max·Team·Enterprise에서 가능하고 API 키 인증은 미지원(claude.ai 로그인 필요)입니다. 리서치 프리뷰 단계이며, Team·Enterprise는 관리자가 토글을 켜야 합니다.

Q. 내 코드가 클라우드로 올라가나요?

아니요. 코드는 내 컴퓨터에서만 실행됩니다. 웹·앱은 메시지를 중계할 뿐이고, 트래픽은 TLS로 보호됩니다.

Q. Cursor iOS 앱이랑 비슷한 거 아닌가요?

발상은 비슷합니다(폰에서 에이전트 지휘). Remote Control은 Claude Code의 로컬 세션을 그대로 잇는다는 점이 특징이에요. 내 환경·MCP·설정이 살아 있는 채로 이어집니다.

마치며

Remote Control은 "내 컴퓨터의 힘은 그대로, 손은 폰으로" 옮겨주는 기능입니다. 빌드를 돌려놓고 나가서 알림 받고, 카페에서 다음 지시를 던지는 식이죠. 명령어 하나(/remote-control)면 시작이니, 오늘 한번 켜보세요.

폰으로 코딩 세션 이어가기, 여러분은 어떻게 쓰실 것 같나요? 댓글로 의견 나눠주세요 🙌

---

※ 본 글은 2026년 6월 기준 Claude Code 공식 문서(code.claude.com/docs/en/remote-control)를 확인해 작성했습니다. 리서치 프리뷰 단계라 기능·지원 플랜·버전 요구사항은 바뀔 수 있으니 공식 문서에서 현행 정보를 확인하세요.