Claude Code 원격 제어, 지금 쓸 만한가 — 텔레그램 봇 시절부터 공식 기능까지-화이트래빗스토리

노트북에서 Claude Code를 돌려놓고 자리를 비웠을 때, 폰으로 이어서 볼 수 있을까. 결론부터 말하면 됩니다. 예전처럼 tmux를 깔고 텔레그램 봇을 붙일 필요도 없습니다.

다만 "된다"와 "편하다"는 다른 이야기라, 공식 문서를 읽고 GitHub 이슈까지 확인해 정리했습니다.

기준일: 2026년 8월 19일

결론부터

지금 열려 있는 그 세션을 그대로 이어받을 수 있습니다. 세션 안에서 /remote-control 한 줄이면 됩니다. 대화 히스토리도 그대로 넘어갑니다.
셋업은 정말 간단합니다. 별도 서버도, 포트 개방도, 봇 토큰도 없습니다. 명령 한 줄에 QR 코드가 뜹니다.
코드는 계속 내 컴퓨터에서 돕니다. 클라우드로 옮겨가는 게 아니라, 폰이 내 로컬 세션을 들여다보는 창이 됩니다. MCP 서버도 로컬 파일도 그대로입니다.
텔레그램 봇은 이제 필요 없습니다. 푸시 알림이 기본으로 들어 있어서, 작업이 끝나거나 승인이 필요할 때 폰으로 알려줍니다.
단, 연결 안정성은 아직입니다. "자주 끊긴다"는 이슈가 5개월째 열려 있고 공감 표시도 가장 많습니다. 리서치 프리뷰라는 점을 감안해야 합니다.

1. 가장 궁금한 것 — 지금 켜져 있는 창은?

이미 작업 중인 세션이 있다면, 그 안에서 이렇게 칩니다.

/remote-control

또는 짧게
/rc

이러면 지금까지의 대화 히스토리를 그대로 들고 원격 세션이 열립니다. 새 세션을 만드는 게 아니라 쓰던 걸 이어가는 겁니다. 이름을 붙이고 싶으면 인자로 넘기면 됩니다.

/remote-control 홈페이지 리팩터링

연결되면 입력창 아래에 /rc active 표시가 뜹니다. 이 표시를 방향키로 선택하고 Enter를 누르면 세션 URL과 QR 코드가 나옵니다. 폰 카메라로 찍으면 바로 열립니다.

끊고 싶으면 같은 패널에서 연결 해제를 고르면 됩니다. 로컬 세션은 그대로 살아 있습니다. 원격 연결만 끊기는 겁니다.

시작 방법이 네 가지입니다

방법	명령	언제 쓰나
이미 열린 세션에서	`/remote-control`	작업 중 자리를 비울 때. 히스토리 유지
처음부터 켜고 시작	`claude --remote-control`	터미널에서도 치고 폰에서도 볼 때
서버 모드	`claude remote-control`	터미널은 대기만. 폰·브라우저에서만 조작
VS Code	프롬프트에 `/rc`	확장 쓰는 경우

서버 모드는 성격이 좀 다릅니다. 터미널이 연결 대기 상태로만 남고 입력은 원격에서 합니다. 스페이스바를 누르면 QR 코드가 나옵니다. 세션을 여러 개 동시에 서빙할 수도 있는데(기본 32개), --spawn worktree를 주면 세션마다 별도 git worktree를 만들어 서로 파일을 건드리지 않게 격리해줍니다.

2. 예전엔 이렇게 했습니다 — 그리고 왜 불편했나

공식 기능이 나오기 전까지 사람들이 쓰던 방법들입니다. 하나씩 보면 지금 뭐가 좋아졌는지가 분명해집니다.

1세대: tmux + SSH

가장 기본이자 지금도 유효한 방법입니다. 터미널을 닫으면 OS가 SIGHUP을 보내 세션이 죽는데, tmux가 이걸 가로채서 세션을 살려둡니다.

tmux new-session -d -s claude-myproject
# 이 안에서 claude 실행
# 나중에
ssh 내서버
tmux attach -t claude-myproject

불편했던 점: 폰에서 SSH 클라이언트로 붙어 터미널을 조작해야 합니다. 좁은 화면에서 TUI를 다루는 건 고역이고, 네트워크가 바뀌거나 폰이 잠기면 연결이 끊깁니다. 그래서 Mosh를 얹어 재연결을 자동화하는 조합이 자주 쓰였습니다.

2세대: Tailscale 같은 터널

집 컴퓨터에 외부에서 접근하려면 포트를 열거나 VPN이 필요합니다. Tailscale을 쓰면 암호화된 사설망으로 어디서든 붙을 수 있습니다.

불편했던 점: 접근 경로 문제만 해결될 뿐, 여전히 폰에서 터미널을 조작한다는 본질은 같습니다. 그리고 설치·계정·기기 등록이라는 준비 과정이 붙습니다.

3세대: 텔레그램 봇 브릿지

여기서 발상이 바뀝니다. 터미널을 원격으로 보는 대신, 메신저를 인터페이스로 쓰는 방식입니다. 봇이 Claude Code의 출력을 텔레그램으로 보내주고, 답장을 다시 세션에 밀어 넣습니다.

왜 인기였나: 알림이 폰으로 바로 오고, 답장은 그냥 채팅이라 터미널을 흉내 낼 필요가 없습니다. 승인 여부만 물어보는 상황에서는 이게 훨씬 자연스럽습니다.

불편했던 점: 봇 토큰을 발급하고, 브릿지 프로세스를 따로 띄워 살려두고, 출력 형식을 다듬는 작업이 전부 직접 관리 대상이 됩니다. 게다가 대화 내용이 메신저를 거치고, 파일을 보거나 diff를 확인하는 건 사실상 포기해야 합니다. 되긴 되는데 계속 손이 가는 구조였습니다.

4세대: 공식 Remote Control (2026년 2월)

앞의 세 가지가 각자 해결하려던 걸 한 번에 처리합니다.

예전에 직접 하던 것	지금
tmux로 세션 살려두기	로컬 세션이 그대로 유지됨
SSH·Tailscale로 접근 경로 만들기	아웃바운드 HTTPS만 사용. 포트 개방 없음
텔레그램 봇으로 알림 받기	푸시 알림 기본 내장
좁은 화면에서 터미널 조작	claude.ai/code 또는 Claude 앱의 정식 UI
파일 확인 포기	`@` 입력하면 로컬 파일 경로 자동완성

구조가 중요합니다. 내 컴퓨터가 바깥으로 나가는 HTTPS 요청만 하고, 들어오는 포트는 열지 않습니다. 폰에서 보낸 메시지는 Anthropic 서버를 거쳐 내 로컬 세션으로 전달됩니다. 그래서 공유기 설정을 건드릴 일이 없습니다.

3. 텔레그램이 하던 일 — 푸시 알림

원격 제어를 원하는 이유의 절반은 사실 "다 됐는지 알려줘"입니다. 이건 별도 설정이 있습니다.

Claude 앱(iOS/Android)을 설치하고 터미널과 같은 계정으로 로그인합니다.
OS 알림 권한을 허용합니다.
터미널에서 /config를 열고 Push when Claude decides(작업 완료 등 Claude가 판단해서 보냄), Push when actions required(승인·질문이 필요할 때) 중 필요한 걸 켭니다.

프롬프트에 직접 요청할 수도 있습니다. 테스트 끝나면 알려줘 같은 식입니다.

앱이 아직 없다면 세션에서 /mobile을 치면 다운로드 QR이 나옵니다.

덧붙여, 터미널에도 힌트가 뜹니다. 한 턴이 오래 걸리면 "Still working — 폰에서 확인하기" 알림이, 권한 승인을 여러 번 하면 "폰에서 승인하기" 알림이 세션 URL과 함께 나타납니다.

4. 그래서, 지금 쓸 만한가

여기가 솔직해야 할 부분입니다. 설계와 셋업은 좋은데 연결 안정성은 아직 미덥지 않습니다.

공식 문서는 "노트북이 절전에 들어가거나 네트워크가 끊겨도 자동으로 재연결된다"고 설명합니다. 그런데 실제 이슈 트래커를 보면 이야기가 조금 다릅니다.

이슈	등록	내용
#33041	2026-03	몇 분마다 끊기고 수동 재시작 필요 (댓글 14, 공감 29 — 관련 이슈 중 최다)
#78607	2026-07	연결 실패가 반복됨
#84324	2026-08	기능이 멈추거나 응답 없음
#85189	2026-08	실패해도 오류 내용을 보여주지 않음
#87213	2026-08	대화를 재개하면 이미 죽은 세션 ID로 재연결을 시도함

전부 지금도 열려 있는 이슈입니다. 특히 3월에 등록된 #33041이 5개월이 지나도록 열려 있고 공감 표시가 가장 많다는 점은 그냥 넘기기 어렵습니다.

#87213은 구조적인 지적이라 참고할 만합니다. Remote Control이 프로세스가 아니라 대화에 묶여 있어서, --continue로 대화를 재개하면 기록된 옛 세션 ID를 그대로 다시 쓰려 하고, 그 세션이 이미 없으면 재연결이 계속 실패한다는 내용입니다.

쓰기 전에 확인할 조건

요구사항이 은근히 까다로워서, 안 되는 경우 대부분은 이 중 하나입니다.

구독 플랜이어야 합니다. Pro·Max·Team·Enterprise. API 키로는 안 됩니다.
claude.ai 로그인이 되어 있어야 합니다. 세션에서 /login으로 로그인합니다.
Amazon Bedrock, Google Cloud, Microsoft Foundry에서는 지원하지 않습니다.
ANTHROPIC_BASE_URL이 api.anthropic.com이 아닌 곳(사내 게이트웨이·프록시)을 가리키면 비활성화됩니다.
DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_GROWTHBOOK 중 하나라도 켜져 있으면 안 됩니다. 기능 플래그 평가를 막기 때문입니다.
프로젝트 디렉터리에서 최소 한 번 claude를 실행해 워크스페이스 신뢰 대화상자를 수락해둬야 합니다. 홈 디렉터리에서는 신뢰가 저장되지 않으니 프로젝트 폴더에서 시작하세요.
Team·Enterprise는 관리자가 토글을 켜야 하고, Zero Data Retention 조직은 아예 쓸 수 없습니다.

알아둘 만한 것 하나

Remote Control이 연결된 동안에는 세션 기록(내 메시지, Claude 응답, 도구 활동)이 Anthropic 서버에 저장됩니다. 기기 간 동기화와 재연결을 위해서입니다. 코드 실행과 파일 접근은 내 컴퓨터에 남지만, 대화 내용은 서버를 거친다는 점은 알고 쓰는 편이 낫습니다.

완전히 끄고 싶으면 disableRemoteControl 설정을 씁니다.

5. 실전에서는 이렇게

먼저 짧게 시험해봅니다. 중요한 작업 중에 처음 켜보지 마세요. 가벼운 세션에서 /rc → 폰 연결 → 메시지 한 번 주고받기까지 해보고, 몇 분 두었다가 여전히 붙어 있는지 확인합니다. 끊김 이슈가 열려 있는 만큼 이 확인이 의미가 있습니다.
알림부터 켜는 게 이득입니다. 원격 조작까지 안 가더라도, 긴 작업이 끝났을 때 폰으로 알림 받는 것만으로 상당 부분 해결됩니다. 텔레그램 봇을 쓰던 이유의 절반이 여기였습니다.
자동 연결은 나중에. /config에서 모든 세션에 자동 연결을 켤 수 있지만, 안정성을 확인한 뒤에 켜는 편이 낫습니다.
세션 여러 개를 원격에 둘 거면 worktree 모드로. claude remote-control --spawn worktree를 쓰면 세션마다 별도 worktree라 서로 파일 충돌이 없습니다.
서버를 껐다면 4시간 안에. Ctrl+C로 서버를 멈춰도 약 4시간 동안은 같은 디렉터리에서 claude remote-control --continue로 되살릴 수 있습니다.

6. Remote Control과 웹 버전은 다릅니다

claude.ai/code 라는 같은 화면을 쓰지만 실행되는 곳이 다릅니다. 헷갈리기 쉬운 부분입니다.

	Remote Control	Claude Code on the web
실행 위치	내 컴퓨터	클라우드
로컬 파일·MCP	그대로 사용	사용 불가
내 컴퓨터가 꺼지면	중단됨	계속 실행
적합한 상황	하던 작업을 다른 기기에서 이어가기	로컬 준비 없이 작업 시작, 병렬 실행

즉 "노트북을 덮고 나가도 알아서 돌아가게" 하고 싶다면 Remote Control이 아니라 웹 버전이나 Routines 쪽을 봐야 합니다. Remote Control은 어디까지나 내 컴퓨터에서 도는 세션을 다른 화면에서 보는 것입니다.

정리

질문이 "쓸 수 있나"였다면 답은 예입니다. 예전처럼 tmux·SSH·봇 토큰을 조합할 필요가 없어졌고, 세션 안에서 /rc 한 줄이면 폰에서 이어받습니다. 텔레그램 봇을 만들며 겪던 번거로움은 대부분 사라졌습니다.

질문이 "믿고 맡길 수 있나"였다면 아직 조건부입니다. 리서치 프리뷰이고, 연결이 끊긴다는 보고가 여러 달에 걸쳐 열려 있습니다. 잠깐 자리를 비우고 폰으로 확인하는 용도로는 충분하지만, 장시간 안정적으로 붙어 있어야 하는 작업이라면 아직 지켜볼 단계입니다.

개인적으로는 푸시 알림만 먼저 켜보는 것을 권합니다. 투자 대비 체감이 가장 큽니다.

확인한 자료

공식 문서: Remote Control, Claude Code on the web
열린 이슈: claude-code#33041(잦은 끊김), #78607(연결 실패), #84324(멈춤), #85189(오류 미표시), #87213(재개 시 죽은 세션 바인딩), #86110(VS Code 배너), #84502(데스크톱 앱 세션 미등록)
과거 방식: tmux + SSH, Tailscale, Mosh, 텔레그램 봇 브릿지 — 커뮤니티에서 공유되던 조합들

이슈 상태는 2026년 8월 19일 기준으로 GitHub API로 직접 조회해 확인했습니다.