VPS에서 돌리는 Claude Code: Linux 서버에서 실행하고 휴대폰으로 조종하기

준비물

• SSH로 접속할 수 있는 Linux 서버. DigitalOcean이나 OVHcloud 같은 업체에서 빌리면 돼요. Claude Code CLI는 어떤 배포판에서도 돌아가고, Claude Desktop에는 Ubuntu 22.04 이상 또는 Debian 12 이상이 필요해요.
• Claude Pro, Max, Ultra, Team, Enterprise 요금제. Remote Control은 API 키로 작동하지 않고, Team이나 Enterprise에서는 먼저 Owner가 켜야 해요.
• 휴대폰의 Claude 앱(iOS 또는 Android), 또는 브라우저의 claude.ai/code.
• 선택 사항으로, 로그인해야 하는 웹사이트가 Claude에게 필요할 때를 위한 서버의 데스크톱 환경과 원격 데스크톱.

Linux VPS에 Claude Code 설정하는 법

1. 서버 빌리고 접속하기

   DigitalOcean이나 OVHcloud 같은 업체에서 Linux 서버를 만들고 SSH로 접속하세요. Ubuntu 22.04+나 Debian 12+를 고르면 Claude Desktop도 선택지로 남아요. 다른 배포판에서는 CLI를 써요.

2. Claude Code 설치하고 로그인하기

   Anthropic의 설치 스크립트로 Claude Code CLI를 설치하세요. 터미널에서 돌아가기 때문에(Anthropic은 지원 시스템으로 Ubuntu 20.04+와 Debian 10+ 등을 꼽아요) SSH로만 접속하는 헤드리스 서버에 잘 맞아요. Ubuntu 22.04+나 Debian 12+에서는 대신 apt로 Claude Desktop을 설치할 수 있는데, Linux에서는 베타예요(Linux용 Claude Desktop 참고). 그런 다음 claude를 실행하고 API 키가 아니라 Claude 계정으로 로그인하세요.

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

3. Remote Control을 서버 모드로 시작하기

   프로젝트 폴더에서 claude remote-control을 실행하세요. 여러 Claude Code 세션을 한꺼번에 호스팅할 수 있는 서버가 시작되고, 각 세션을 휴대폰에서 열 수 있어요. --chrome을 붙이면 그 세션들에서 Chrome 통합이 켜져요. 대신 모든 대화형 세션이 연결되게 하려면 ~/.claude/settings.json에서 remoteControlAtStartup을 true로 설정하세요.

   # Start a tmux session, so the server keeps running after you close SSH
   tmux new -s claude
   
   # Inside tmux, from your project folder: run the Remote Control server and
   # restart it whenever it exits (it gives up after ~10 minutes offline)
   cd ~/my-project
   while true; do claude remote-control; sleep 10; done
   
   # Detach with Ctrl+B, then D. Reattach later with:
   tmux attach -t claude

4. 로그아웃한 뒤에도 계속 돌아가게 하기

   Remote Control은 claude 프로세스가 돌아가는 동안에만 작동해요. 터미널을 닫으면 그 세션들은 오프라인이 돼요. SSH 연결이 끊겨도 살아남도록 tmux나 screen 안에서, 또는 서비스로 실행하세요. 서버 모드는 네트워크 없이 약 10분이 지나도 종료되니, 위의 루프처럼 자동으로 다시 시작하게 하세요. 긴 실행에서의 권한 모드와 사용량 한도는 Claude Code를 24시간 돌리는 법을 참고하세요.

5. 휴대폰에서 열기

   iOS나 Android의 Claude 앱, 또는 claude.ai/code를 열고 세션을 고르세요. Claude는 서버에서 실행되고, 휴대폰은 대화를 보여 주고 내 메시지를 보내요. 자세한 설정과 문제 해결은 Remote Control 가이드에 있어요. Telegram에서 Claude Code에 메시지를 보내고 싶다면 Claude Code channels를 참고하세요.

출처: Anthropic의 Remote Control 문서(영어)

웹사이트 로그인을 위해 데스크톱 추가하기

SSH로 접속하는 서버에는 화면이 없어요. Claude에게 로그인해야 하는 사이트가 필요해지기 전까지는 괜찮아요. 원격 데스크톱을 추가하면 그 로그인은 내가 직접 하고, 브라우저는 Claude가 쓰게 할 수 있어요.

• VPS에 데스크톱 환경과 원격 데스크톱 서버를 설치하고, 어딘가에 로그인해야 할 때 노트북에서 접속하세요.
• Google Chrome이나 Microsoft Edge에 Claude in Chrome 확장 프로그램을 설치하고, Claude가 쓸 사이트에 로그인하세요. Claude in Chrome은 Linux에서 작동하지만 WSL에서는 지원되지 않아요.
• 세션이 그 브라우저를 쓸 수 있도록 claude remote-control --chrome으로 서버를 시작하세요.
• 원격 데스크톱에는 Tailscale로 접속하세요. Tailscale은 내 기기들을 tailnet이라는 비공개 네트워크에 묶어, 그 기기끼리만 서로 접속할 수 있게 해요. Tailscale 소개를 참고하세요.
• Ubuntu나 Debian에 데스크톱이 있다면 CLI뿐 아니라 Claude Desktop도 선택지가 돼요.

Linux 서버가 못 하는 일

이 중 하나라도 중요하다면 저희 창업자가 쓰는 구성인 집에 둔 Mac mini를 쓰세요.

• 컴퓨터 사용 불가. Linux에서는 Claude가 앱과 화면을 조작할 수 없어요. CLI에서 컴퓨터 사용은 macOS 전용이고, Claude Desktop에서는 macOS와 Windows의 리서치 프리뷰예요.
• iOS 개발 불가. Xcode와 iOS Simulator는 macOS에서만 돌아가서, Linux 서버로는 iPhone 앱을 빌드하거나 실행할 수 없어요.
• 기능이 적은 데스크톱 앱. Linux용 Claude Desktop은 Ubuntu와 Debian용 베타이고, 컴퓨터 사용, Cowork, 받아쓰기가 없어요.
• 계속 떠 있어야 하는 프로세스. 다른 Remote Control 구성과 마찬가지로, 서버에서 claude가 돌아가는 동안에만 세션에 접속할 수 있어요.

Claude Code용 Mac mini vs Linux VPS

서버에 고정 업무 맡기기

잠들지 않는 서버는 메시지를 보내면 언제든 답하지만, 보내지 않으면 기다려요. Crewmark는 그 위의 Claude Code 대화를 직무, 목표, 근무 시간, 하트비트를 갖춘 AI 직원으로 바꿔 줘요. 근무 시간 동안 macOS와 Windows뿐 아니라 Linux에서도 돌아가는 crewmark CLI가 직원을 깨워 공유 보드의 이슈를 처리하게 해요. 직원이 실행되는 컴퓨터는 계속 켜져 있어야 하는데, VPS가 바로 그래요.

1. 직원 채용하기

   AI 직원 직무에서 소프트웨어 엔지니어나 SEO 전문가 같은 직무를 고르고, 목표와 KPI를 적으세요.

2. 서버의 Claude Code 연결하기

   설정 링크를 VPS의 Claude Code 대화에 붙여 넣으세요. crewmark CLI가 설치되고 그 대화가 직원과 연결돼요. Codex도 쓸 수 있어요.

3. 근무 시간과 하트비트 정하기

   평일만 또는 매일로 정할 수 있고, 근무 시간은 자정을 넘겨도 되며, 15, 30, 60, 120, 240분마다 깨어나게 할 수 있어요.

4. 휴대폰에서 이슈 배정하기

   어느 브라우저에서든 crewmark.ai 보드에서 이슈를 만들고 배정하세요. 배정하면 직원이 바로 깨어나요. 리뷰나 결정이 필요하면 직원이 이슈를 Needs action으로 바꾸고 거기서 물어봐요. 맡길 만한 일은 Claude Code 활용 사례에 있어요.

FAQ