Claude Code 원격 제어 — 커피 마시면서 코딩시키는 시대가 열렸다

터미널 앞에 앉아 있어야만 Claude Code를 쓸 수 있었던 시대가 끝났다. Anthropic이 Remote Control 기능을 공식 출시했다. 로컬 머신에서 돌아가는 Claude Code 세션을 스마트폰, 태블릿, 다른 PC의 브라우저에서 그대로 이어서 쓸 수 있다. 파일도 로컬, 실행도 로컬, 보안도 로컬 — 원격인 건 내 손가락뿐이다.

핵심 — 로컬 세션에 원격 리모컨을 꽂는 것

Remote Control은 "클라우드에서 돌리는 것"이 아니다. 기존 Claude Code 세션이 내 컴퓨터에서 그대로 돌아가고, claude.ai/code 또는 Claude 모바일 앱이 그 세션에 리모컨처럼 연결되는 구조다.

비유하면 이렇다. TV(로컬 세션)는 거실에 있고, 리모컨(웹/앱)은 내 손에 있다. 채널을 돌리는 건 리모컨이지만, 영상이 나오는 건 여전히 TV다. 파일 시스템, MCP 서버, 프로젝트 설정 모두 로컬 환경 그대로 접근 가능하다.

핵심 차이는 내 환경을 그대로 쓸 수 있느냐다. Remote Control은 내 .claude/ 설정, MCP 서버, 로컬 파일 시스템을 전부 유지한 채로 원격 접근이 가능하다.

사용법 — 명령어 한 줄이면 끝

새 세션 시작

claude remote-control

터미널에 세션 URL이 뜨고, 스페이스바를 누르면 QR 코드가 나온다. 스마트폰으로 QR을 스캔하면 Claude 앱에서 바로 연결된다.

기존 세션에서 전환

이미 Claude Code를 사용 중이라면 슬래시 커맨드로 전환할 수 있다.

/remote-control

축약형은 /rc다. 현재 대화 이력을 그대로 가져간다. /rename으로 세션 이름을 지정해두면 여러 기기에서 찾기 편하다.

모든 세션에 자동 활성화

매번 명령어를 치기 귀찮다면, /config에서 **"Enable Remote Control for all sessions"**을 true로 설정하면 모든 세션이 자동으로 원격 제어 가능 상태가 된다.

[💡 잠깐! 이 용어는?] MCP(Model Context Protocol): AI 모델이 외부 도구와 데이터 소스에 접근할 수 있게 해주는 표준 프로토콜이다. 파일 시스템, DB, API 등을 Claude Code에 연결할 때 사용한다.

연결 방식 — 세 가지 경로

Remote Control 세션이 활성화되면 연결 방법은 세 가지다.

1. 세션 URL 직접 열기

터미널에 표시된 URL을 브라우저에 입력한다. claude.ai/code에서 해당 세션으로 바로 이동한다.

2. QR 코드 스캔

claude remote-control 실행 후 스페이스바를 누르면 QR 코드가 표시된다. Claude 모바일 앱(iOS/Android)으로 스캔하면 즉시 연결된다. 앱이 없다면 Claude Code에서 /mobile 명령어로 다운로드 QR을 띄울 수 있다.

3. 세션 목록에서 선택

claude.ai/code 또는 Claude 앱을 열면 세션 목록에 컴퓨터 아이콘과 초록색 상태 점이 표시된 세션이 보인다. 탭하면 연결된다.

보안 — 인바운드 포트 없음

보안이 걱정될 수 있다. 핵심은 이렇다.

• 아웃바운드 HTTPS만 사용: 로컬 머신에 인바운드 포트를 열지 않는다
• Anthropic API 경유: 모든 트래픽이 TLS로 암호화된 Anthropic API를 통과한다
• 단기 자격증명: 연결마다 개별 목적에 한정된 단기 토큰을 발급한다

비유하면, 집(로컬)에 문을 열어두는 게 아니라 집에서 전화(아웃바운드)를 걸어서 대화하는 방식이다. 외부에서 내 컴퓨터로 직접 들어오는 경로는 없다.

알아둘 제한사항

완벽하진 않다. 현재 알려진 제한은 세 가지다.

그리고 현재 Pro 또는 Max 플랜에서만 사용 가능하다. API 키나 Team/Enterprise 플랜은 아직 미지원이다. Research Preview 단계이기 때문인데, 정식 출시되면 범위가 넓어질 가능성이 높다.

자동 재연결은 지원한다. 노트북이 잠들거나 네트워크가 잠깐 끊겨도, 복구되면 세션이 자동으로 다시 연결된다. 10분 이내라면 문제없다.

실전 시나리오 — 언제 쓰면 좋을까

1. 빌드 돌려놓고 자리 비우기

로컬에서 claude remote-control을 실행하고 빌드 작업을 시킨다. 커피를 사러 가면서 스마트폰으로 진행 상황을 확인하고, 추가 지시를 내린다. 돌아왔을 때 이미 끝나 있다.

2. 회의 중 코드 리뷰 지시

회의실에서 태블릿이나 폰으로 Claude Code 세션에 접속해서 "이 PR의 변경사항 리뷰해줘"를 보낸다. 회의가 끝나면 책상에서 결과를 확인한다.

3. 멀티 디바이스 동시 사용

터미널, 브라우저, 폰 세 곳에서 같은 세션에 메시지를 보낼 수 있다. 대화가 모든 기기에서 동기화된다. 터미널에서 시작한 작업을 폰에서 이어가고, 다시 브라우저에서 마무리하는 흐름이 가능하다.

마무리

Claude Code가 터미널에 묶여 있던 가장 큰 제약이 풀렸다. 로컬 환경의 보안과 성능은 유지하면서, 접근성만 원격으로 확장한 설계가 핵심이다.

지금 당장 쓰고 싶다면:

1. Claude Code 최신 버전 업데이트
2. Pro 또는 Max 플랜 확인
3. claude remote-control 실행
4. QR 코드 스캔하고 폰에서 "Hello" 보내기

커피 마시러 가기 전에 일을 시키는 패턴에서, 커피를 마시면서 일을 시키는 패턴으로. 이건 단순한 편의 기능이 아니라 AI 코딩 워크플로우의 물리적 제약을 하나 더 없앤 것이다.

참고:

• Claude Code Remote Control 공식 문서: https://code.claude.com/docs/ko/remote-control