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

원격으로 제어할 프로젝트 디렉토리에서 Claude Code를 실행합니다. Remote Control은 이 세션을 그대로 중계하기 때문에, 작업할 프로젝트 위치에서 시작하는 것이 중요합니다. 처음 실행 시 "Trust this workspace?" 프롬프트가 나오면 승인합니다. 이 승인은 Claude Code가 해당 디렉토리의 파일을 읽고 쓸 수 있도록 허용하는 단계입니다.

2단계 — Remote Control 활성화

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

/remote-control

또는 줄여서:

/rc

이 명령은 현재 세션을 Anthropic 서버에 등록하고, 외부에서 접속할 수 있는 고유 URL을 생성합니다. 실행하면 세션 URL이나 QR 코드가 표시됩니다:

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

이 URL이 있어야 다른 기기에서 이 세션에 연결할 수 있습니다.

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

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

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

접속하면 서버에서 실행 중인 Claude Code 세션이 그대로 보입니다. 여기서 입력하는 프롬프트는 서버의 Claude Code가 처리하므로, 로컬 파일 접근·Git·터미널 명령 등 서버 환경의 모든 기능을 그대로 쓸 수 있습니다.

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

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

claude --remote-control

또는:

claude --rc

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

실제 사용 예시

Remote Control의 진짜 가치는 모바일에서 서버의 개발 환경을 그대로 제어할 수 있다는 점입니다. 몇 가지 시나리오를 살펴봅니다.

시나리오 1 — 서버 로그 확인

Check logs of my build server

이동 중에 빌드가 실패했다는 알림을 받았을 때, 모바일에서 이 한 줄만 입력하면 됩니다. Claude Code가 서버에서 journalctl -u build.service 같은 명령을 직접 실행하고 로그를 분석해서 요약해줍니다. SSH 앱을 열고 서버에 접속할 필요가 없습니다.

시나리오 2 — 빌드 에러 수정

Fix this build error

로그에서 원인을 파악한 뒤, 바로 수정을 요청할 수 있습니다. Claude Code가 에러의 원인이 되는 코드를 찾아 수정하고, git commit까지 처리합니다. 모바일 키보드로 코드를 직접 수정할 필요 없이, 자연어로 지시만 하면 됩니다.

시나리오 3 — 테스트 실행 및 확인

Run the tests and tell me if everything passes

코드 수정 후 테스트가 통과하는지 확인하는 단계입니다. Claude Code가 프로젝트의 테스트 스위트를 실행하고, 결과를 요약해서 보여줍니다. 실패한 테스트가 있으면 원인까지 분석해줍니다.

이 모든 과정에서 Claude Code는 서버에서 실행되고, 모바일은 입력과 결과 확인만 담당합니다. 즉, 모바일의 성능이나 개발 도구 설치 여부와 무관하게 서버의 전체 개발 환경을 활용할 수 있습니다.

세션 유지 조건

유지되는 경우:

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

종료되는 경우:

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

보안 구조

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

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

권장 운영 구조

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

AI 서버 (항상 켜져 있음)
  ├ 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가 초안을 생성하고, 작성자가 검토·편집하였습니다.