Claude Code Remote Control 완벽 가이드 - 터미널 세션을 폰에서 이어가는 법

Claude Code Remote Control 기능을 활용해 터미널과 모바일을 연결하는 개발자 작업 환경

터미널에서 대규모 리팩터링을 걸어놓고 점심 먹으러 나갔는데, Claude가 중간에 승인을 요청한다. 노트북 앞으로 돌아가야 할까? 이제는 아니다. 폰을 꺼내서 승인 버튼만 누르면 된다.

Anthropic이 2026년 2월 25일 발표한 Claude Code Remote Control은 로컬 터미널에서 실행 중인 Claude Code 세션을 스마트폰이나 웹 브라우저에서 이어서 제어할 수 있는 기능이다. 코드가 클라우드로 올라가는 게 아니다. 내 컴퓨터에서 돌아가는 세션에 원격으로 접속하는 구조다.

이 글에서는 Claude Code Remote Control의 작동 원리, 설정 방법, 실전 활용 시나리오, 그리고 기존 Claude Code on the Web과의 차이까지 한 번에 정리한다.

Claude Code Remote Control이란

Claude Code Remote Control 세션을 실행하는 터미널 코딩 화면과 개발 환경

Claude Code Remote Control은 로컬 머신에서 실행 중인 Claude Code 세션을 다른 기기에서 이어서 조작할 수 있게 해주는 기능이다. 쉽게 말해, 데스크에서 시작한 AI 코딩 작업을 폰이나 태블릿에서 그대로 이어가는 것이다.

핵심은 로컬 실행에 있다. 코드가 Anthropic 클라우드로 올라가지 않는다. 내 컴퓨터에서 Claude Code가 계속 돌아가고 있고, 모바일이나 웹 브라우저는 그 세션의 "리모컨" 역할만 한다. 파일시스템, MCP 서버, 환경변수, 프로젝트 설정 전부 로컬 그대로 유지된다.

연결 방식도 간단하다. 터미널에서 claude remote-control 명령어를 치면 QR 코드가 뜬다. 폰으로 스캔하면 끝이다. 이미 세션이 진행 중이라면 /rc 명령어 한 줄이면 된다.

2026년 2월 기준, Pro 플랜(월 $20)과 Max 플랜(월 $100~$200)에서 Research Preview로 사용할 수 있다. Team과 Enterprise 플랜은 아직 지원하지 않는다.

Claude Code Remote Control 작동 원리

Remote Control의 기술적 구조는 생각보다 단순하면서도 보안에 신경 쓴 설계다.

인바운드 포트를 열지 않는다

로컬 Claude Code는 아웃바운드 HTTPS 요청만 한다. 내 컴퓨터에 인바운드 포트를 여는 게 아니기 때문에 방화벽이나 NAT 뒤에 있어도 문제없다. Anthropic API에 등록한 뒤 폴링 방식으로 원격 명령을 수신하는 구조다.

TLS 암호화와 단기 크레덴셜

모든 통신은 TLS로 암호화되고, 세션마다 단기 크레덴셜을 사용한다. 세션이 끝나면 크레덴셜도 만료된다. 누군가 세션 URL을 가로채더라도 시간이 지나면 쓸 수 없다.

자동 재연결

네트워크가 잠깐 끊겨도 약 10분 안에 다시 연결되면 세션이 유지된다. 지하철에서 와이파이가 끊겼다가 다시 잡혀도, 작업이 날아가지 않는다는 뜻이다.

Claude Code Remote Control 설정 방법

Claude Code Remote Control QR 코드 스캔으로 모바일에서 원격 세션을 연결하는 장면

설정은 3분이면 끝난다. Claude Code 버전 2.1.52 이상이 필요하다.

방법 1. 새 Remote Control 세션 시작

터미널에서 claude remote-control 실행
화면에 세션 URL과 QR 코드가 표시된다
폰에서 Claude 앱(iOS/Android)을 열고 QR 코드를 스캔한다
또는 claude.ai/code에서 세션 URL을 직접 입력한다

방법 2. 기존 세션에서 원격 접속 활성화

이미 Claude Code 세션이 진행 중일 때 /remote-control 또는 /rc 입력
현재 대화 기록을 그대로 가져간 채 원격 연결이 시작된다

모든 세션에 자동 활성화하기

매번 명령어를 치기 귀찮다면, /config에서 "Enable Remote Control for all sessions"를 true로 설정하면 된다. 이후 모든 Claude Code 세션이 자동으로 원격 접속을 지원한다.

실전 활용 시나리오 4가지

Claude Code Remote Control을 활용한 원격 협업과 모바일 코딩 작업 시나리오

Remote Control이 진짜 유용한 건 "AI가 백그라운드에서 일하는 동안 인간은 자유로워진다"는 점이다. 구체적인 상황을 보자.

1. 대규모 리팩터링 중 외출

CSS Modules에서 Tailwind로 전환하는 마이그레이션을 걸어놓았다. 파일이 200개가 넘는다. Claude가 작업하는 동안 밖에 나가서 산책을 한다. 중간에 Claude가 "이 파일은 패턴이 다른데 어떻게 처리할까요?"라고 물으면, 폰에서 바로 방향을 지시한다.

2. 테스트 스위트 실행 중 점심

E2E 테스트를 돌리고 있는데 점심시간이다. 노트북을 그대로 두고 나간다. 테스트 중간에 승인이 필요한 프롬프트가 뜨면 폰에서 처리한다. 밥 먹으면서도 테스트 진행 상황을 실시간으로 확인할 수 있다.

3. 빌드 에러 디버깅

배포 전 빌드를 돌려놨는데 에러가 터졌다. 회의 중이라 노트북을 열 수 없다. 폰에서 에러 로그를 확인하고, Claude에게 수정 방향을 지시한다. 회의가 끝나고 돌아왔을 때는 이미 수정이 완료되어 있다.

4. 코드 리뷰 승인

Claude가 PR 리뷰를 진행하면서 변경 사항을 제안한다. 이동 중에 폰으로 각 제안을 하나씩 확인하고 승인 또는 거절한다. 사무실에 돌아왔을 때는 리뷰 결과가 반영된 코드가 준비되어 있다.

Anthropic PM Noah Zweben의 표현을 빌리면, "산책하고, 햇빛 보고, 강아지 산책시키면서도 플로우를 잃지 않는다."

Claude Code Remote Control vs Claude Code on the Web

Anthropic에는 비슷해 보이는 두 가지 기능이 있다. Remote Control과 Claude Code on the Web이다. 둘 다 claude.ai/code 인터페이스를 사용하지만, 작동 방식이 완전히 다르다.

항목	Remote Control	Claude Code on the Web
실행 위치	내 컴퓨터 (로컬)	Anthropic 클라우드
파일 접근	로컬 파일시스템 그대로	클라우드 가상 환경
MCP 서버	로컬 MCP 서버 사용 가능	사용 불가
환경변수	로컬 환경변수 유지	별도 설정 필요
프로젝트 설정	CLAUDE.md 등 그대로 적용	새로 설정해야 함
컴퓨터 상태	로컬 PC가 켜져 있어야 함	브라우저만 있으면 됨
적합한 상황	진행 중인 작업 이어가기	새 작업 빠르게 시작하기

정리하면 이렇다. Remote Control은 "내 개발 환경을 통째로 들고 다니는 것"이고, Claude Code on the Web은 "깨끗한 클라우드 환경에서 새로 시작하는 것"이다. 이미 로컬에 세팅된 프로젝트를 이어서 작업하려면 Remote Control이 맞고, 간단한 프로토타이핑이나 새 프로젝트를 시작하려면 웹 버전이 낫다.

Claude Code Remote Control 제한사항

아직 Research Preview 단계라 몇 가지 제약이 있다. 사용 전에 알아두면 좋다.

한 번에 하나의 리모트 세션만 가능하다. 여러 기기에서 동시에 접속할 수 없다.
터미널을 닫으면 세션이 종료된다. 로컬에서 Claude Code가 돌아가야 하기 때문에, 노트북 덮개를 닫거나 터미널을 종료하면 원격 세션도 끝난다.
10분 이상 네트워크 끊김 시 타임아웃된다. 짧은 끊김은 자동 재연결되지만, 10분을 넘기면 세션이 만료된다.
Team/Enterprise 플랜은 아직 미지원이다. 2026년 2월 기준, Pro와 Max 플랜에서만 사용할 수 있다.
Claude Code 버전 2.1.52 이상이 필요하다. claude --version으로 확인 후, 필요하면 업데이트해야 한다.

AI 코딩 워크플로우가 달라지는 지점

Remote Control이 단순한 편의 기능처럼 보일 수 있지만, 실제로는 AI 코딩 워크플로우의 근본적인 변화를 만든다.

기존 AI 코딩은 "터미널 앞에 앉아서 지시하고, 결과를 확인하고, 다시 지시하는" 동기적 루프였다. Remote Control은 이걸 비동기적으로 바꾼다. Claude가 작업하는 동안 나는 다른 일을 할 수 있고, Claude가 판단이 필요할 때만 폰으로 알림을 받아 처리한다.

이건 마치 시니어 개발자가 주니어 개발자에게 작업을 맡기는 것과 비슷하다. 큰 방향만 잡아주고, 세부 구현은 맡기면서, 중요한 결정 포인트에서만 개입하는 방식이다. 다만 이 "주니어"가 실수를 거의 안 하고, 24시간 일할 수 있다는 차이가 있다.

Anthropic에 따르면 Claude Code는 2026년 2월 기준 연간 25억 달러 규모의 매출(ARR)을 기록하고 있다. 연초 대비 2배 이상 성장한 수치다. Remote Control은 이 성장세를 더 가속할 기능으로 보인다. 개발자가 "항상 연결된 상태"를 유지하면서도 물리적으로는 자유로워지기 때문이다.

자주 묻는 질문

무료로 쓸 수 있나?

2026년 2월 기준, Claude Pro 플랜(월 $20) 이상부터 사용할 수 있다. 무료 플랜에서는 지원하지 않는다. Team/Enterprise 플랜도 아직 미지원이다.

내 코드가 Anthropic 서버로 전송되나?

아니다. 코드는 로컬 컴퓨터에서만 실행된다. Remote Control은 세션을 원격으로 조작하는 "리모컨" 역할만 할 뿐, 코드나 파일이 클라우드로 이동하지 않는다. 통신은 TLS 암호화로 보호된다.

노트북을 닫아도 되나?

안 된다. Claude Code가 로컬에서 돌아가는 구조이기 때문에, 컴퓨터가 켜져 있고 터미널이 열려 있어야 한다. 절전 모드로 들어가도 세션이 끊긴다. 노트북을 닫고도 작업을 이어가려면 Claude Code on the Web을 쓰는 게 낫다.

여러 기기에서 동시에 접속할 수 있나?

현재는 한 번에 하나의 리모트 세션만 지원한다. 폰으로 접속한 상태에서 태블릿으로도 동시에 접속하는 건 안 된다. 다만 터미널과 원격 기기 사이에서는 대화가 실시간으로 동기화된다.

Claude Code on the Web과 뭐가 다른가?

가장 큰 차이는 실행 위치다. Remote Control은 내 컴퓨터에서 실행되기 때문에 로컬 파일, MCP 서버, 환경변수를 모두 사용할 수 있다. Claude Code on the Web은 Anthropic 클라우드에서 실행되므로 로컬 환경에 접근하지 못한다. 진행 중인 작업을 이어가려면 Remote Control, 새 작업을 시작하려면 웹 버전이 적합하다.

어떤 기기에서 접속할 수 있나?

iOS와 Android의 Claude 앱, 또는 claude.ai/code 웹 인터페이스에서 접속할 수 있다. 모바일 브라우저에서도 가능하다.

지금 바로 시작하는 법

Claude Code를 이미 쓰고 있다면, 터미널을 열고 아래 명령어를 입력하면 된다.

claude remote-control

QR 코드가 뜨면 폰으로 스캔한다. 끝이다. 별도 설치나 복잡한 설정 없이 바로 사용할 수 있다.

아직 Claude Code를 써본 적 없다면, 공식 문서에서 설치부터 시작하면 된다. Pro 플랜이면 충분하다. 월 $20, 약 26,000원 정도.

AI 코딩 에이전트가 백그라운드에서 일하는 동안, 나는 산책을 하거나 점심을 먹거나 회의에 참석한다. 중요한 결정만 폰에서 처리하면 된다. AI 코딩 워크플로우가 "터미널 앞에 앉아있는 시간"에서 벗어나기 시작했다.

AI 코딩 도구 활용법이 더 궁금하다면 자동화 사례에서 다양한 실전 가이드를 확인해 보자. AI 에이전트 활용 영상은 영상 레시피에서 볼 수 있다.