Claude Code Remote Control + tmux: 자리를 옮겨도 작업 이어가기

PC에서 시작한 코딩을 휴대폰에서 이어가고 싶다면 Remote Control과 tmux를 함께 사용해보세요. Remote Control은 다른 기기에서 대화하는 통로를, tmux는 터미널 연결이 끊겨도 프로세스가 실행될 공간을 제공합니다.

단, 완전한 무중단을 보장하지는 않습니다. 작업을 실행하는 컴퓨터의 전원과 네트워크가 유지되어야 합니다.

1. 준비하기

Claude Code에서 /login으로 Claude 계정에 로그인하고 프로젝트 신뢰 확인을 완료하세요. 공식 요구사항에는 Pro·Max·Team·Enterprise가 명시되어 있으며 API 키 인증은 지원하지 않습니다. Team·Enterprise는 조직 소유자의 기능 활성화가 필요합니다. 공식 요구사항

tmux가 없다면 운영체제에 맞게 설치합니다.

macOS — Homebrew가 설치된 환경

brew install tmux

Ubuntu / Debian — Windows에서는 WSL의 Ubuntu 내부

sudo apt update
sudo apt install tmux

설치 확인은 tmux -V로 합니다. tmux 설치 안내

2. tmux 안에서 Claude Code 시작하기

아래 경로는 자신의 프로젝트 경로로 바꾸세요. claude-work는 임의로 정한 tmux 세션 이름입니다.

cd /path/to/your/project
tmux new -s claude-work

새로 열린 tmux 안에서 실행합니다.

claude --remote-control

PC에서도 대화할 수 있는 원격 연결 세션입니다. 최초 활성화 확인을 수락하세요.

이미 tmux 안에서 Claude Code를 실행 중이라면 대화창에 /remote-control 또는 /rc를 입력하면 됩니다. tmux 밖에서 시작한 프로세스는 새 tmux를 열어도 자동으로 옮겨지지 않습니다. 기존 작업이 끝난 뒤 tmux 안에서 시작하세요. Remote Control 시작 방법

3. 휴대폰 연결 후 터미널 분리하기

세션 URL 또는 QR 코드로 접속하고 PC와 같은 Claude 계정으로 로그인합니다. Claude 앱이나 claude.ai/code에서 대화를 이어가세요.

PC에서는 Ctrl+B를 누르고 손을 뗀 다음 D를 누릅니다. 기본 tmux 단축키이며, 세션을 종료하지 않고 화면만 분리합니다. 일반 셸로 돌아왔다면 터미널 창을 닫아도 됩니다. SSH로 접속했다면 SSH를 종료해도 tmux 내부 프로세스는 유지됩니다. tmux 사용 안내

4. PC에서 다시 이어가기

같은 컴퓨터, 같은 사용자 계정의 터미널에서 실행합니다.

tmux attach -t claude-work

세션 이름이 기억나지 않으면:

tmux ls

다른 컴퓨터에서 터미널로 복귀하려면, 미리 설정한 SSH로 작업 컴퓨터에 접속한 뒤 위 명령을 실행하세요. 휴대폰에서 Remote Control만 사용할 때는 SSH가 필요하지 않습니다.

exit나 tmux kill-session은 분리 명령이 아닙니다. 잠시 자리를 비울 때는 Ctrl+B → D를 사용하세요. tmux 사용 안내

5. Mac에서는 자동 절전도 챙기기

Mac의 tmux 내부에서, 2단계의 Claude 실행 명령 대신 다음을 사용할 수 있습니다.

caffeinate -i claude --remote-control

Claude 프로세스가 실행되는 동안 유휴 상태에 따른 자동 절전을 방지합니다. 노트북 덮개 닫기나 강제 잠자기까지 막는 기능은 아닙니다. 전원을 연결하고 덮개를 열어두세요. 옵션 설명은 Mac 터미널의 man caffeinate에서 확인할 수 있습니다.

6. 연결이 끊겼을 때

상황	확인할 점
터미널 창·SSH 연결만 종료	tmux에 다시 붙어 작업 확인
PC 절전·종료·재부팅	tmux만으로 실행 유지 불가. 재부팅하면 tmux 세션도 사라짐
휴대폰만 네트워크 끊김	연결 복구 후 원격 세션 다시 열기
Remote Control 연결 오류	PC의 tmux에 붙어 오류 사유 확인 후 필요하면 /remote-control 재실행

이 글은 **대화형 claude --remote-control**을 기준으로 합니다. 공식 문서상 대화형 세션은 네트워크 복구를 계속 재시도하지만, 서버 모드인 claude remote-control은 장시간 네트워크 단절 시 종료될 수 있습니다. tmux가 종료된 프로그램을 자동 재시작하지는 않습니다. Remote Control 제한 사항

외출 전 휴대폰에서 “현재 진행 상황을 알려줘”라고 보내 연결을 확인해보세요. tmux 안에서 실행 → 휴대폰 접속 → Ctrl+B, D → 필요할 때 attach가 기본 흐름입니다.

2026년 9월 11일 공식 문서 기준. 이미지는 실제 화면이 아닌 설명용 일러스트입니다.

#ClaudeCode #RemoteControl #tmux #클로드코드 #AI코딩 #원격개발