# Claude Code Remote Control

> Clean Markdown view of GeekNews topic #27013. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=27013](https://news.hada.io/topic?id=27013)
- GeekNews Markdown: [https://news.hada.io/topic/27013.md](https://news.hada.io/topic/27013.md)
- Type: GN+
- Author: [neo](https://news.hada.io/@neo)
- Published: 2026-02-26T09:55:30+09:00
- Updated: 2026-02-26T09:55:30+09:00
- Original source: [code.claude.com](https://code.claude.com/docs/en/remote-control)
- Points: 4
- Comments: 2

## Topic Body

- **로컬 개발 세션을 다른 기기에서 이어서 사용할 수 있는 기능**으로, Claude Code가 실행 중인 컴퓨터에 원격으로 접속해 작업을 지속할 수 있음  
- **claude.ai/code 웹 인터페이스**나 **Claude 모바일 앱(iOS·Android)** 을 통해 접속하며, 로컬 환경이 그대로 유지되어 파일시스템·도구·프로젝트 설정을 그대로 활용 가능  
- **Pro 및 Max 요금제 사용자**에게 연구 미리보기 형태로 제공되며, Team·Enterprise 요금제에서는 지원되지 않음  
- 모든 통신은 **Anthropic API를 통한 TLS 암호화 연결**로 이루어지며, 세션은 로컬에서 실행되어 클라우드로 데이터가 이동하지 않음  
- **로컬 개발 환경을 유지하면서도 기기 간 연속 작업이 가능한 구조**로, 원격 협업과 이동 중 개발 효율을 높이는 기능임  

---

### Remote Control 개요
- Remote Control은 **로컬 Claude Code 세션을 다른 기기에서 이어서 사용할 수 있게 하는 기능**  
  - 휴대폰, 태블릿, 다른 브라우저 등에서 동일한 세션을 이어서 작업 가능  
  - claude.ai/code 또는 Claude 모바일 앱을 통해 접속 지원  
- **Pro·Max 요금제 사용자만 이용 가능**, Team·Enterprise 요금제에서는 제공되지 않음  
- 세션은 로컬에서 계속 실행되며, **클라우드로 전송되지 않음**  
- 주요 기능  
  - **로컬 환경 원격 사용**: 파일시스템, MCP 서버, 도구, 프로젝트 설정 유지  
  - **기기 간 동기화**: 터미널·브라우저·모바일 간 대화 동기화  
  - **자동 재연결**: 네트워크 끊김이나 절전 후 자동 복구  

### 요구사항 (Requirements)
- **Pro 또는 Max 구독 플랜** 필요, API 키는 지원되지 않음  
- `claude` 명령어 실행 후 `/login`으로 claude.ai 인증 필요  
- 프로젝트 디렉터리에서 `claude`를 한 번 실행해 **워크스페이스 신뢰 설정** 수락 필요  

### Remote Control 세션 시작
- 새 세션 생성 또는 기존 세션을 원격으로 연결 가능  
- 프로젝트 디렉터리에서 다음 명령 실행  
  ```
  claude remote-control
  ```
  - 터미널에서 세션 URL 표시, 스페이스바로 **QR 코드 표시** 가능  
  - `--verbose`, `--sandbox`, `--no-sandbox` 플래그 지원  
- 기존 Claude Code 세션에서 `/remote-control` 또는 `/rc` 명령으로 원격 제어 시작 가능  
  - 현재 대화 기록을 유지하며 세션 URL과 QR 코드 제공  
  - `/rename` 명령으로 세션 이름 지정 가능  

### 다른 기기에서 연결
- **세션 URL을 브라우저에서 열기** 또는 **QR 코드 스캔**으로 접속  
- claude.ai/code나 Claude 앱에서 세션 목록을 통해 접속 가능  
  - 온라인 상태일 경우 **컴퓨터 아이콘과 녹색 점 표시**  
- 세션 이름은 마지막 메시지, `/rename` 값, 또는 기본 “Remote Control session”으로 표시  
- `/mobile` 명령으로 iOS·Android 앱 다운로드 QR 코드 표시 가능  

### 모든 세션에 Remote Control 활성화
- `/config` 명령에서 **Enable Remote Control for all sessions** 옵션을 `true`로 설정  
- 각 Claude Code 인스턴스는 **한 번에 하나의 원격 세션만 지원**  

### 연결 및 보안
- 로컬 세션은 **아웃바운드 HTTPS 요청만 수행**, 인바운드 포트는 열리지 않음  
- Remote Control 시작 시 Anthropic API에 등록 후 작업을 폴링  
- 다른 기기에서 연결 시, **서버가 메시지를 스트리밍 방식으로 중계**  
- 모든 트래픽은 **TLS 암호화**를 사용하며, **단기 자격 증명**으로 세분화된 접근 제어 수행  

### Claude Code on the web과의 차이
- 두 기능 모두 claude.ai/code 인터페이스를 사용하지만,  
  - **Remote Control**은 로컬 머신에서 실행되어 MCP 서버·도구·설정 사용 가능  
  - **Claude Code on the web**은 Anthropic 클라우드 인프라에서 실행  
- 로컬 작업을 이어가려면 Remote Control,  
  클론되지 않은 저장소나 병렬 작업에는 Claude Code on the web 사용  

### 제한 사항
- **한 번에 하나의 원격 세션만 지원**  
- **터미널이 열려 있어야 함**, `claude` 프로세스 종료 시 세션 종료  
- **10분 이상 네트워크 불가 상태** 시 세션 타임아웃 후 종료  

### 관련 자료
- [Claude Code on the web] – 클라우드 기반 세션 실행  
- [Authentication] – `/login` 설정 및 인증 관리  
- [CLI reference] – `claude remote-control` 명령 전체 목록  
- [Security] – Remote Control 보안 모델 설명  
- [Data usage] – Anthropic API를 통한 데이터 흐름 설명

## Comments



### Comment 53317

- Author: roxie
- Created: 2026-03-19T02:43:15+09:00
- Points: 1

아직 좀 불안정한 것 같아서, 그냥 tailscale 붙여서 쓰려구요

### Comment 51921

- Author: neo
- Created: 2026-02-26T09:55:31+09:00
- Points: 1

###### [Hacker News 의견들](https://news.ycombinator.com/item?id=47148454) 
- 이 프리릴리스 버전은 **매우 불안정하고 버그가 많음**  
  Claude를 멈추려 해도 계속 실행되고, UI가 자주 끊기며, 세션이 하나만 유지되고 로드도 잘 안 됨  
  코드 탭을 벗어날 때마다 세션이 사라졌다가 다시 기다려야 함  
  XML이 그대로 출력되는 등 완성도가 낮음  
  - 나도 비슷하게 겪고 결국 포기했음  
    “코딩은 이미 해결된 문제 아닌가, Boris?”라는 생각이 들었음  
  - 내 경우 `/remote-control` 명령이 QR코드 대신 긴 URL만 출력했음  
    모바일 앱에서는 세션이 안 보이고, URL을 직접 입력해도 연결이 안 됨  
    GitHub 연결을 요구하는 등 **설계가 복잡하고 버그투성이**였음  
    권한 요청도 중복되고, 멈춤 버튼도 작동 안 함  
    Claude가 스스로 테스트를 작성한 게 아닌가 싶을 정도로 품질이 낮음  
  - 나도 같은 경험을 했음. 코드 기능은 멋지지만 **테스트 부족**이 명확함  
    인턴 몇 명만 써도 충분히 잡을 수 있을 수준의 문제임  
  - 기대했는데 제약이 너무 많음  
    지금은 **Tailscale + Termius(iOS)** 조합으로 쓰고 있음  
    입력은 잘 되지만 음성 입력으로 stdin에 직접 텍스트를 넣을 수 없는 점이 아쉬움  
  - 모바일 앱뿐 아니라 **Claude Code Web**도 신뢰성이 낮음  
    Opus 토큰을 많이 소모하고 이유 없이 멈춤  
    진행 상태를 알 수 없고, 결국 다시 실행해야 해서 시간과 비용이 낭비됨  

- 나는 오래전부터 이 방식을 써왔음  
  **Tailscale**을 두 기기에 설치하고, **tmux**와 모바일 터미널(echo/Termius)을 이용해 원격 로그인함  
  `tmux new -s <feature>`로 세션 이름을 지정해두면 언제든 `tmux attach -t <feature>`로 재접속 가능함  
  - 오늘 **zmx**라는 대안을 발견했음 ([GitHub 링크](https://github.com/neurosnap/zmx))  
    tmux처럼 세션 유지가 되지만 터미널 에뮬레이션을 하지 않아 스크롤이 정상 작동함  
    Claude Code와 함께 써보니 노트북과 폰 간 전환이 꽤 매끄러웠음  
  - 나도 같은 방식으로 쓰지만, Termius에서 **자동완성·스와이프 입력**이 안 돼서 불편함  
  - 대부분 이 방식으로 시작했을 것 같음  
  - CC를 열 때마다 tmux가 자동 실행되게 alias를 쓰는지 궁금함  
    여러 세션을 동시에 다룰 때는 어떻게 하는지도 알고 싶음  
    mosh는 꼭 필요한지, 설정이 어려웠음  
  - 나도 같은 세팅을 쓰는데, 새 기능의 장점이 뭔지 모르겠음  
    Tmux/Tailscale/Termius 조합이면 이미 완전한 제어가 가능한데, 단지 설정 편의성 때문인지 궁금함  

- **Opencode**의 `web` 명령은 로컬 세션을 브라우저에서 실행하게 해줌  
  CLI와 동일한 권한으로 작동하고 인터페이스도 깔끔함  
  무료 모델로 바로 테스트 가능함 ([문서 링크](https://opencode.ai/docs/web/))  
  - 하지만 폰에서 버그가 너무 많아 결국 **Termux**로 돌아감  

- [Happy Engineering](https://happy.engineering/)은 이미 같은 기능을 훨씬 안정적으로 제공함  
  Codex도 지원함  
  - 나도 이걸 자주 썼는데, 최근 **초기화 오류 버그**가 생겨서 폰 클라이언트에서 실패함  
    그래도 무료·익명·암호화 지원 등 훌륭한 소프트웨어임  
    빨리 수정되길 바람. tmux 터널링으로 돌아가고 싶지 않음  

- 이상하게도 많은 회사들이 원격 제어를 이렇게 힘들게 구현함  
  **SSH는 20년째 안정적으로 작동**해왔고, 인증 문제도 빠르게 패치되어왔음  
  - 그래도 AI 회사라면 접근 방식이 완전히 다르긴 함  

- “이 기능이 모바일 코딩 스타트업의 기회를 죽인다”는 말에 동의하지 않음  
  코딩 에이전트는 **스트리밍 서비스처럼 여러 개를 구독**하게 될 것임  
  그래서 범용 제어판이 필요하고, 모바일 인터페이스는 단순한 원격 제어 이상을 제공해야 함  
  - 하지만 스트리밍처럼 여러 구독을 강요하는 건 모두가 불만임  
    비용도 늘고, 광고도 많고, 파편화가 심함  
  - 나는 VSCode에서 **Copilot Auto**를 쓰는데, ChatGPT나 Claude와 큰 차이를 못 느낌  
    라디오처럼 필요할 때 채널을 바꾸는 느낌임  
    특별한 게 필요할 땐 Spotify를 켜고, 아닐 땐 그냥 조용히 둠  
  - 나도 폰으로 작업을 많이 해서 내 워크플로를 직접 만들었음  
    CLI 제공자들을 통합해주는 **범용 제어 플랜**이 필요하다고 생각함  
    관련 비교글을 [여기](https://yepanywhere.com/subscription-access-approaches) 정리했음  

- **Claude Code 팀**에게 하고 싶은 말은, 핵심 경험을 먼저 안정화하라는 것임  
  새로운 기능을 내는 건 좋지만, 깊이 있는 개선이 우선임  
  - “Vibe 코딩”으로 80%는 되지만, **마감 품질**이 나머지 80%를 차지함  
  - Xcode용 Claude Agent 클라이언트는 웹이나 Mac 앱보다 훨씬 안정적임  

- 요즘 Claude Code는 너무 자주 깨지고 바뀜  
  **Anthropic이 속도를 늦춰야 함**  
  매일 “오늘은 뭐가 또 고장났나” 하는 피로감이 큼  
  - Claude Code 자체는 좋은 제품임  
    방향을 분산시키지 말고 모델과 품질을 꾸준히 개선했으면 함  

- “이건 **GNU screen을 가장 비효율적으로 재발명한 것**” 같음  
  - 그래도 이 방식은 공인 IP나 VPS, VPN 없이 쓸 수 있고, 폰에 터미널 앱 설치만으로 충분함  
  - 사실 터미널·SSH·tmux를 폰에서 재현하려는 시도는 많았지만, **엄지로 쓰기엔 끔찍한 경험**임  
    게다가 Tailscale 같은 중앙 제공자를 거치므로 완전한 자율성도 아님  
  - 기술적으로는 맞는 말이지만, 이건 **지속 세션**보다 **추상화 계층**이 핵심임  
    tmux는 명령을 알아야 하지만, 이건 결과 중심임  
    나처럼 늦게 코딩을 시작한 사람에겐 이 방식이 훨씬 효율적임  
  - 실제로 명령은 Anthropic 서버를 통해 **폴링 메커니즘**으로 전달됨  
  - 나는 colo 서버에서 tmux로 에이전트를 돌리고, 이동 중엔 RC 앱으로 접근함  

- 나도 비슷한 목표로 프로젝트를 만들었음  
  웹 서버를 띄워 브라우저나 Android 앱으로 접속하면 Claude Code 세션이 **실시간 동기화**되고,  
  서버 재시작 시 자동 복원됨  
  최근엔 예약 작업과 **에이전트 팀 구성 기능**도 추가함  
  Opus 4.6으로 실험하며 만든 프로젝트이며, [GitHub 링크](http://github.com/vincent-163/claude-code-multi/)에서 설치 가능함  
  피드백을 환영함