Claude Code를 VM에 얹고 원격으로 제어하기

claude-codeocitmuxai-agent

안녕하세요! 재니미입니다.

이번 글에서는 Claude Code를 설치하려고 합니다. 먼저 하는 이유는 다른 거 없고, 제가 가장 많이 쓰는 도구라서 그렇습니다.

Node.js 설치 (nvm)

이 VM에서 나중에 Node.js가 필요한 도구도 쓸 예정이라 미리 준비해둡니다. Rocky Linux ARM64용 공식 설치 명령이 따로 없어서, nodejs.org 공식 문서가 권장하는 nvm을 씁니다.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.7/install.sh | bash
source ~/.bashrc   # 또는 새 셸 열기

nvm install --lts
nvm use --lts
node -v

Claude Code 설치

공식 빠른 시작 가이드의 기본 설치(권장) 방법을 그대로 따랐습니다. 네이티브 바이너리를 직접 받아오는 방식이라 Claude Code 자체에는 Node.js가 필요 없습니다.

curl -fsSL https://claude.ai/install.sh | bash

설치가 끝나면 확인합니다.

claude --version

tmux 세션 위에서 띄웁니다

앞 편에서 준비한 tmux 없이 그냥 실행하면 SSH가 끊기는 순간 클로드 세션이 죽습니다. 반드시 세션 안에서 띄워야 합니다.

tmux new -s claude-session
claude   # 최초 실행 시 인증

인증이 끝나면 Ctrl+b → d로 빠져나와도 프로세스는 계속 돕니다.

원격에서 다시 붙기

이 VM은 퍼블릭 IP가 없어서, 앞서 다룬 것처럼 OCI 클라우드 셸(Cloud Shell)을 거쳐야 접속할 수 있습니다. 브라우저로 OCI 콘솔의 클라우드 셸을 열고, 거기서 다시 SSH로 붙습니다.

ssh -i <프라이빗키> rocky@<인스턴스_Private_IP>
tmux attach -t claude-session

노트북이든 스마트폰 브라우저든, 클라우드 셸 콘솔에 들어갈 수만 있으면 이전 작업 맥락이 그대로 이어집니다.

확인

claude --version

리모트 컨트롤 활성화

여기까지는 SSH로 직접 붙어서 터미널을 조작하는 방식입니다. 스마트폰에서 터미널 없이 앱이나 브라우저로 바로 제어하려면 Remote Control을 켜야 합니다. claude를 그냥 실행하는 것만으로는 켜지지 않고, 명시적으로 지정해야 합니다.

claude --remote-control "세션이름"

세션 URL과 QR 코드가 뜨는데, 원격 세션을 만들면 스마트폰 앱, 클로드 코드 웹, PC 앱 모두 동기화되어 쓸 수 있습니다.

여기까지 되면, 노트북을 켜지 않아도 스마트폰이나 다른 컴퓨터로 접속해서 에이전트 상태를 확인하고 다음 작업을 지시할 수 있는 상태가 됩니다.

다음 글에서는 같은 저장소 위에 Antigravity CLI를 하나 더 얹는 이야기를 다루겠습니다.

감사합니다.