Claude Code Remote Control 실전 가이드 — 서버의 AI를 모바일에서 이어 쓰기

Remote Control이 뭔가요?

서버나 개발 PC에서 돌아가는 Claude Code 세션을 모바일 폰이나 다른 컴퓨터의 브라우저에서 그대로 이어서 사용하는 기능입니다.

Claude Code는 내 머신에서 계속 실행되고, 웹이나 모바일은 세션을 보는 창 역할만 합니다. 로컬 파일, Git, MCP, 도구 전부 그대로 쓸 수 있습니다.

로컬 PC / 서버
  └ Claude Code 실행
        │
        │  Remote Control (HTTPS)
        ▼
모바일 / 다른 PC
  └ claude.ai/code 또는 Claude 앱

일반적인 원격 데스크톱과 달리, 외부 포트를 열 필요가 없고 outbound HTTPS만 사용합니다. 네트워크 설정이 훨씬 단순합니다.

사용 조건

Claude Code 버전

v2.1.51 이상이 필요합니다. 확인 방법:

claude --version

구독 플랜

다음 플랜에서 사용할 수 있습니다:

• Claude Pro
• Claude Max
• Claude Team
• Claude Enterprise

⚠️ API Key 방식으로는 Remote Control을 사용할 수 없습니다. 반드시 Claude 구독 계정으로 로그인해야 합니다.

claude
/login

브라우저 인증을 완료하면 준비 끝입니다.

기본 사용법

1단계 — Claude Code 실행

cd my-project
claude

처음 실행 시 "Trust this workspace?" 프롬프트가 나오면 승인합니다.

2단계 — Remote Control 활성화

Claude Code 프롬프트에서 다음을 입력합니다:

/remote-control

또는 줄여서:

/rc

실행하면 세션 URL이나 QR 코드가 표시됩니다:

Remote Control enabled
Session URL: https://claude.ai/code/session/xxxx

3단계 — 다른 기기에서 접속

브라우저: 표시된 URL을 모바일이나 다른 PC에서 열면 됩니다.

Claude 모바일 앱: 앱에 로그인한 후 Sessions 메뉴에서 해당 세션을 선택합니다.

처음부터 Remote Control 모드로 시작하기

이미 실행 중인 세션에서 /rc를 입력하는 대신, 아예 처음부터 Remote Control 모드로 시작할 수 있습니다:

claude --remote-control

또는:

claude --rc

실행과 동시에 원격 접속이 가능합니다. 기존 세션의 상태가 꼬여 있을 때도 이 방법으로 새로 시작하면 깔끔합니다.

여러 세션 운영 — 서버 모드

서버 모드로 실행하면 여러 세션을 관리할 수 있습니다:

claude remote-control --name dev-server

사용 가능한 옵션:

• --name — 세션 이름 지정
• --capacity — 동시 세션 수 제한
• --spawn — 자동 세션 생성
• --sandbox — 샌드박스 모드

실제 사용 예시

모바일에서 Claude 세션에 접속한 뒤:

Check logs of my build server

Claude Code가 서버에서 journalctl -u build.service 같은 명령을 직접 실행하고 결과를 보여줍니다.

Fix this build error

이렇게 요청하면 Claude Code가 코드를 수정하고, git commit하고, 테스트까지 실행합니다. 모바일에서 타이핑만 하면 됩니다.

세션 유지 조건

유지되는 경우:

• SSH 연결 끊김
• 네트워크 잠깐 끊김
• 노트북 sleep

종료되는 경우:

• Claude Code 프로세스 종료
• 터미널 종료
• 네트워크 장시간 단절 (약 10분 이상)

보안 구조

• 외부 포트 오픈 없음
• outbound HTTPS만 사용
• TLS 기반 스트리밍 연결

방화벽이나 NAT 뒤에 있어도 별도 설정 없이 작동합니다. 일반적인 원격 데스크톱(VNC, RDP)보다 네트워크 설정이 훨씬 간단합니다.

권장 운영 구조

개발자들이 가장 많이 쓰는 구조입니다:

AI 서버 (항상 켜져 있음)
  ├ tmux 세션
  │   └ Claude Code (--remote-control)
  ├ Git
  ├ Docker
  └ MCP 서버

모바일 / 노트북
  └ Claude App 또는 브라우저로 접속

이 구조면 어디서든 서버의 Claude Code를 이어서 사용할 수 있습니다.

알아두면 좋은 것들

연구 프리뷰 단계

Remote Control은 2026년 2월 말에 나온 연구 프리뷰 기능입니다. 아직 다소 불안정한 부분이 있으며, Simon Willison의 블로그나 GitHub에도 유사한 연결 이슈가 다수 보고되어 있습니다.

연결이 안 될 때

• /rc 대신 claude --remote-control로 새 세션을 시작해보세요
• 네트워크 환경이 원인일 수 있습니다 (한국에서 Cloudflare 경유 문제 등)
• VPN을 통하거나 네트워크를 바꿔서 시도해보는 것도 방법입니다

정리

Remote Control의 핵심은 간단합니다:

• 모바일에서 Claude Code 사용 가능 — 이동 중에도 서버 작업
• GUI 원격 접속 불필요 — VNC, RDP 없이 브라우저만으로 충분
• 로컬 개발 환경 그대로 유지 — 파일, Git, MCP, 도구 전부 사용
• 설정이 단순 — 포트 포워딩, 방화벽 설정 불필요

아직 프리뷰 단계라 가끔 연결이 불안정하지만, 서버에서 AI 코딩을 하는 개발자라면 한번 써볼 가치가 충분합니다.

---

이 글은 생성형 AI의 도움을 받아 작성되었습니다. 원본 자료를 기반으로 AI가 초안을 생성하고, 작성자가 검토·편집하였습니다.