클로드 코드 원격 제어: 소파에서도 코딩을 멈추지 않는 법

책상에서 클로드 코드로 리팩토링하고 있었는데 갑자기 택배가 옵니다. “잠깐이면 되겠지” 하고 나갔다 오면 흐름이 끊기죠. 퇴근 후 소파에서 뒹굴거리다가 “아까 그 작업 어디까지 했더라?” 싶을 때도 있고요.

Anthropic이 2026년 2월에 내놓은 Remote Control(원격 제어)은 딱 이 문제를 풀어줍니다. 터미널에서 돌아가는 클로드 코드 세션을 스마트폰이나 다른 컴퓨터 브라우저에서 그대로 이어 쓸 수 있거든요.

원격 제어가 뭔가요?

한마디로 내 컴퓨터에서 돌아가는 클로드 코드 세션에 원격으로 접속하는 겁니다.

클로드 코드를 실행하면 파일 시스템 접근, MCP 서버 연동, 프로젝트 설정 같은 로컬 환경이 그대로 유지되잖아요. 원격 제어는 그 세션에 모바일 앱이나 웹 브라우저로 접근하는 창구를 하나 더 여는 것뿐이에요. 클라우드 서버에서 새로 세션을 여는 게 아닙니다. 내 컴퓨터에서 실행 중인 그 세션 그대로예요.

터미널에서 메시지를 보내든 폰에서 보내든 같은 대화가 이어집니다. 여러 기기에서 동시에 접속해도 실시간으로 동기화되니까 책상에서 시작한 작업을 소파에서 폰으로 마무리할 수 있죠.

시작하기

원격 제어를 쓰려면 먼저 조건을 확인해야 합니다.

구독 플랜은 Pro, Max, Team, Enterprise 모두 지원해요. 단, Team과 Enterprise 플랜에서는 관리자가 먼저 Claude Code admin settings에서 Remote Control 토글을 켜줘야 합니다. API 키 인증으로는 안 되고 반드시 claude.ai 계정으로 로그인해야 해요. 클로드 코드 버전은 v2.1.51 이상이 필요한데 claude --version으로 확인할 수 있습니다.

원격 제어를 시작하는 방법은 세 가지입니다.

첫 번째는 서버 모드예요. 프로젝트 디렉토리에서 아래 명령어를 실행하면 원격 제어 전용 세션이 열립니다.

claude remote-control

터미널에 세션 URL이 뜨고 스페이스바를 누르면 QR 코드도 볼 수 있어요. 이 모드에서는 터미널이 원격 연결을 기다리는 서버 역할만 합니다. 로컬 터미널에서 직접 메시지를 보낼 수는 없고 다른 기기에서만 조작하는 거예요.

서버 모드에서 쓸 수 있는 플래그도 꽤 있습니다.

플래그	설명
--name "My Project"	claude.ai/code 세션 목록에 표시될 이름을 지정합니다.
--spawn <모드>	동시 세션 생성 방식을 설정합니다. same-dir(기본값)은 같은 디렉토리를 공유하고, worktree는 세션마다 git worktree를 만들어 격리합니다. 실행 중에 w 키로 전환할 수도 있어요.
--capacity <N>	최대 동시 세션 수를 설정합니다. 기본값은 32입니다.
--verbose	연결 및 세션 로그를 자세히 표시합니다.
--sandbox / --no-sandbox	샌드박스를 켜거나 끕니다. 기본값은 꺼짐이에요.

두 번째는 인터랙티브 세션이에요. 일반적인 클로드 코드 세션에 원격 제어를 함께 켜는 방식입니다.

claude --remote-control

--rc로 줄여 쓸 수도 있어요. 서버 모드와 달리 터미널에서도 메시지를 보내면서 동시에 다른 기기에서도 접속할 수 있습니다. 세션 이름을 바로 넘길 수도 있어요.

claude --remote-control "My Project"

세 번째는 이미 진행 중인 세션에서 전환하는 거예요. 슬래시 커맨드를 입력하면 됩니다.

/remote-control

줄여서 /rc로 입력해도 돼요. 뒤에 이름을 붙이면 세션 제목이 됩니다.

/remote-control My Project

이렇게 하면 지금까지의 대화 내역을 그대로 가지고 원격 제어 세션이 열립니다. 단, 이 방식에서는 --verbose, --sandbox 플래그는 사용할 수 없어요.

다른 기기에서 접속하기

원격 제어 세션이 시작되면 접속 방법은 세 가지예요.

가장 간단한 건 터미널에 표시된 URL을 브라우저에 입력하는 겁니다. claude.ai/code로 바로 연결돼서 세션에 들어갈 수 있어요.

스마트폰이라면 QR 코드가 더 편하죠. claude remote-control을 실행한 후 스페이스바를 누르면 QR 코드가 나타나는데 Claude 앱(iOS, Android 모두 지원)으로 스캔하면 바로 접속됩니다.

세 번째 방법은 그냥 claude.ai/code나 Claude 앱을 열어서 세션 목록에서 찾는 거예요. 원격 제어 세션은 컴퓨터 아이콘에 초록색 점이 붙어 있어서 쉽게 구분할 수 있습니다.

세션 목록에 표시되는 이름은 다음 우선순위로 정해집니다.

1. --name, --remote-control, /remote-control에 전달한 이름
2. /rename으로 설정한 이름
3. 기존 대화의 마지막 의미 있는 메시지
4. 접속 후 보내는 첫 번째 프롬프트

아직 Claude 앱을 안 깔았다면 클로드 코드에서 /mobile 명령어를 입력하면 다운로드용 QR 코드를 보여줍니다.

모든 세션에서 자동으로 켜기

기본적으로는 claude remote-control, claude --remote-control, /rc 중 하나를 직접 실행해야 원격 제어가 켜집니다. 매번 입력하기 귀찮다면 자동으로 켜는 옵션이 있어요.

클로드 코드에서 /config를 실행한 뒤 “Enable Remote Control for all sessions”를 true로 설정하면 됩니다. 이후에는 모든 세션이 알아서 원격 접속 가능한 상태로 시작하죠. 끄고 싶으면 다시 false로 돌려놓으면 돼요.

이 설정을 켜면 각 클로드 코드 인스턴스마다 원격 세션이 하나씩 생깁니다. 여러 인스턴스를 동시에 실행하면 각각 독립적인 환경과 세션을 갖게 돼요. 하나의 프로세스에서 여러 동시 세션을 관리하고 싶다면 서버 모드에서 --spawn 플래그를 활용하세요.

보안은 어떻게 될까?

“내 컴퓨터에서 돌아가는 세션을 폰으로 접속한다”고 하면 보안이 걱정될 수 있습니다. 포트를 열어야 하나, 방화벽 설정을 건드려야 하나 궁금하실 텐데 답은 “아니요”예요.

네트워크 구조를 간단히 설명하면 이렇습니다.

내 컴퓨터의 클로드 코드는 외부에서 들어오는 연결(인바운드)을 받지 않아요. Anthropic API로 나가는 HTTPS 연결(아웃바운드)만 씁니다. 원격 제어를 시작하면 클로드 코드가 Anthropic API에 등록하고 작업 요청을 폴링해요. 폰이나 브라우저에서 접속하면 같은 API 엔드포인트를 통해 메시지가 중계되는 방식이죠.

[내 컴퓨터] ──HTTPS──▶ [Anthropic API] ◀──HTTPS── [스마트폰/브라우저]

이 구조 덕분에 NAT, 기업 방화벽, 가정용 라우터 뒤에 있어도 별다른 설정 없이 작동합니다. 포트 포워딩도 VPN도 필요 없어요. 모든 트래픽은 Anthropic API를 경유하는 TLS 연결 위에서 동작하며 일반 클로드 코드 세션과 동일한 전송 보안을 적용받습니다. 인증 정보는 여러 개의 단기 토큰으로 나뉘어 각각 독립적으로 만료돼요.

코드가 클라우드 서버로 올라가지 않을까 걱정되는 분도 계실 텐데요. 코드 자체는 내 컴퓨터를 떠나지 않습니다. Anthropic API를 통해 오가는 건 대화 메시지와 도구 실행 결과뿐이에요.

클로드 코드 샌드박스와 함께 쓰면 보안을 더 튼튼하게 할 수 있습니다. claude remote-control --sandbox로 실행하면 파일 시스템과 네트워크가 OS 레벨에서 격리된 상태로 원격 작업을 할 수 있어요.

네트워크가 끊기면?

노트북 뚜껑을 닫거나 와이파이가 잠깐 끊기는 건 일상이죠. 원격 제어는 이런 상황을 잘 처리해요. 컴퓨터가 잠들었다 깨어나면 알아서 재연결되고 원격 세션도 이어서 쓸 수 있습니다.

다만 컴퓨터가 깨어 있는데 네트워크가 약 10분 이상 끊기면 세션이 타임아웃으로 종료돼요. 이때는 claude remote-control을 다시 실행해야 합니다.

주의할 점이 하나 더 있는데 터미널을 닫거나 claude 프로세스를 종료하면 원격 세션도 함께 끝납니다. 원격 제어는 어디까지나 내 컴퓨터에서 돌아가는 프로세스에 원격으로 접속하는 거니까요.

클라우드 실행과 뭐가 다른가요?

Anthropic은 claude.ai/code에서 클라우드 인프라 위에 세션을 실행하는 “Claude Code on the web”도 제공합니다. 둘 다 같은 claude.ai/code 인터페이스를 쓰지만 중요한 차이가 있어요.

원격 제어는 내 컴퓨터에서 실행됩니다. 내 파일 시스템, MCP 서버, 플러그인, 프로젝트 설정이 그대로 유지되죠. 반면 클라우드 실행은 Anthropic이 관리하는 서버에서 돌아가요. 로컬 환경이 필요 없고 레포를 클론하지 않아도 바로 작업할 수 있습니다.

상황에 따라 골라 쓰면 됩니다. 이미 로컬에서 작업 중인 세션을 이어가고 싶으면 원격 제어가 맞고, 로컬 설정 없이 바로 시작하거나 여러 작업을 병렬로 돌리고 싶으면 클라우드 실행이 낫습니다.

실전 활용 팁

원격 제어를 유용하게 쓸 수 있는 시나리오를 몇 가지 소개할게요.

긴 작업을 맡기고 자리를 비울 때가 가장 대표적입니다. 대규모 리팩토링이나 테스트 스위트 실행처럼 오래 걸리는 작업을 클로드 코드에 맡겨놓고 폰으로 진행 상황을 확인할 수 있어요. 끝나면 폰에서 결과를 검토하고 추가 지시를 내릴 수도 있죠.

코드 리뷰에도 좋습니다. 출퇴근 지하철에서 PR을 확인하다가 “이 부분 수정해줘”라고 원격 세션에 바로 요청할 수 있어요. 클로드 코드 Hooks를 설정해두었다면 커밋이나 포맷팅까지 알아서 처리되니까 폰에서도 완결된 워크플로우가 가능합니다.

팀 미팅 중에 급한 수정이 필요할 때도 쓸 만해요. 노트북을 열지 않고 태블릿이나 폰에서 간단한 수정을 지시할 수 있거든요.

알아두면 좋은 제약사항

현재 원격 제어에는 몇 가지 제약이 있습니다.

인터랙티브 세션에서는 원격 연결이 하나만 가능해요. 여러 기기에서 동시에 접속할 수는 있지만 하나의 프로세스가 하나의 원격 세션만 갖는 구조입니다. 여러 동시 세션이 필요하다면 서버 모드에서 --spawn 플래그를 쓰세요.

터미널이 열려 있어야 해요. 원격 제어는 로컬 프로세스로 동작하기 때문에 터미널을 닫으면 세션도 끝납니다. 장시간 원격으로 작업할 계획이라면 터미널 멀티플렉서를 함께 쓰는 걸 추천해요. tmux나 Zellij 같은 도구로 세션을 백그라운드에 띄워두면 SSH 연결이 끊겨도 프로세스가 살아 있으니까요.

권한 설정도 챙겨야 합니다. 원격 세션에서도 도구를 쓸 때 승인이 필요한데 터미널에서 직접 승인할 수 없는 상황이라면 미리 settings.json에서 자주 쓰는 명령어를 allow 목록에 넣어두는 게 좋아요.

문제가 생겼을 때

원격 제어를 쓰다 보면 에러 메시지를 만날 수 있는데 대부분 인증 문제예요.

“Remote Control requires a claude.ai subscription”이 뜨면 claude.ai 계정으로 로그인되지 않은 상태입니다. claude auth login을 실행하고 claude.ai 옵션을 선택하세요. 환경 변수에 ANTHROPIC_API_KEY가 설정되어 있다면 먼저 해제해야 합니다.

“Remote Control requires a full-scope login token”은 claude setup-token이나 CLAUDE_CODE_OAUTH_TOKEN 환경 변수로 인증한 경우에 나타납니다. 이 토큰은 추론 전용이라 원격 제어 세션을 만들 수 없어요. claude auth login으로 다시 인증하면 해결됩니다.

“Remote Control is disabled by your organization’s policy”는 원인이 세 가지예요. /status로 현재 로그인 상태를 먼저 확인하세요. API 키나 Console 계정으로 인증된 경우, Team/Enterprise 관리자가 아직 활성화하지 않은 경우, 또는 조직의 데이터 보존 정책과 호환되지 않는 경우입니다.

“Remote credentials fetch failed”가 나오면 --verbose 플래그를 붙여서 자세한 오류를 확인해보세요.

claude remote-control --verbose

대부분 로그인이 안 되어 있거나, 방화벽이 Anthropic API로의 아웃바운드 HTTPS(포트 443) 요청을 막고 있는 경우입니다.

다른 원격 접근 방식과 비교

클로드 코드에는 원격 제어 말고도 자리를 비운 상태에서 작업할 수 있는 방법이 여러 가지 있습니다.

방식	트리거	실행 위치	적합한 상황
Remote Control	claude remote-control 또는 /rc	내 컴퓨터	진행 중인 로컬 작업을 다른 기기에서 이어가기
Dispatch	Claude 모바일 앱에서 메시지 전송	내 컴퓨터 (Desktop)	자리 비운 상태에서 작업 위임
Channels	Telegram, Discord 등 채팅 앱 이벤트	내 컴퓨터 (CLI)	CI 실패나 채팅 메시지에 반응
Slack	팀 채널에서 @Claude 멘션	Anthropic 클라우드	팀 채팅에서 PR과 리뷰
Scheduled tasks	스케줄 설정	CLI, Desktop, 또는 클라우드	일일 리뷰 같은 반복 자동화

마치며

원격 제어는 클로드 코드의 “어디서든 코딩” 비전을 보여주는 기능입니다. 무거운 IDE를 들고 다닐 필요 없이 내 컴퓨터의 개발 환경을 그대로 폰에서 쓸 수 있다는 건 꽤 매력적이에요.

Pro부터 Enterprise까지 모든 플랜에서 쓸 수 있고 Anthropic이 꾸준히 개선하고 있어서 앞으로가 더 기대됩니다.

코딩이 아닌 일반 업무도 폰으로 맡기고 싶다면 Claude Dispatch를 확인해보세요. Cowork의 Claude에게 이메일 정리, 보고서 작성 같은 지식 작업을 위임할 수 있습니다. 원격 제어 말고도 궁금한 게 있다면 클로드 코드 샌드박스로 보안을 강화하는 방법이나 클로드 코드 Hooks로 자동화 파이프라인을 만드는 방법도 살펴보세요. 원격으로 접속한 상태에서 타이핑 없이 음성으로 작업을 지시하고 싶다면 클로드 코드 음성 모드도 확인해보세요.

공식 문서에서 더 자세한 내용을 확인할 수 있습니다.