Claude Code가 계속 실행됩니다
tmux 덕분에 SSH 연결이 끊겨도 Claude는 하던 일을 계속합니다. 설정, 훅, 상태 표시줄도 미리 준비되어 있습니다.
Claude Code, RDP로 접속하는 KDE Plasma 데스크톱, 안전하게 설정된 SSH, 그리고 제가 매일 쓰는 설정이 명령어 하나로 설치됩니다. 내 컴퓨터에서 설정을 바꾸면 서버에도 그대로 반영됩니다.
curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash시스템을 업데이트하고 기본 도구와 swap을 설치합니다. 보안 업데이트는 자동으로 적용됩니다.
SSH 키로 로그인하는 sudo 권한 사용자를 만듭니다.
비밀번호 로그인을 끕니다. root도 비밀번호로는 들어올 수 없습니다. 클라우드 이미지의 기본 설정보다 우선 적용됩니다.
방화벽(ufw)을 켜고 SSH와 RDP 포트만 엽니다.
KDE Plasma 데스크톱을 설치합니다. 서버에는 모니터가 없으므로 로그인 화면은 설치하지 않습니다.
xrdp를 53389 포트로 엽니다. 접속하면 Plasma가 시작되고 불필요한 비밀번호 창은 뜨지 않습니다.
Docker, GitHub CLI, Chrome을 설치합니다.
Claude Code를 공식 방식으로 설치하고 휴대폰 알림을 설정합니다.
KDE 레이아웃, Claude 설정, 훅, tmux 설정을 적용합니다.
tmux 덕분에 SSH 연결이 끊겨도 Claude는 하던 일을 계속합니다. 설정, 훅, 상태 표시줄도 미리 준비되어 있습니다.
패널, 단축키, 창 배치, Konsole 프로필을 내 컴퓨터에서 가져와 서버에 똑같이 적용합니다.
SSH는 키로만 접속할 수 있고 root 비밀번호 로그인은 막혀 있습니다. 방화벽과 자동 업데이트도 켜져 있습니다.
Claude가 질문하면 ntfy로 휴대폰에 알림이 옵니다. 컴퓨터 앞에서 기다릴 필요가 없습니다.
Docker, GitHub CLI, Node, ripgrep, 빌드 도구, Chrome이 설치되어 있습니다.
각 단계는 이미 설치된 것을 먼저 확인합니다. 언제든 다시 실행해도 되고, --only로 필요한 단계만 실행할 수도 있습니다.
모든 설정은 저장소에 보관됩니다. 내 컴퓨터에서 올리면 서버가 주기적으로 가져갑니다.
claude-vps publishKDE와 Claude 설정을 모으고, 개인 경로를 지운 뒤 커밋하고 푸시합니다.
git push설정은 dotfiles/home 폴더에 일반 파일로 저장됩니다. 무엇이 바뀌었는지 확인하기 쉽습니다.
claude-vps sync변경 사항을 가져와 적용합니다. 덮어쓰는 파일은 먼저 백업합니다. 30분마다 자동으로 실행할 수도 있습니다.
네. Claude Code는 터미널 앱이라 어떤 Linux 서버에서도 동작합니다. 내 기기에서 링크를 열어 한 번만 로그인하면 되고, 접속을 끊어도 tmux 안에서 계속 실행됩니다.
터미널만 쓴다면 2 vCPU, 4 GB RAM이면 충분합니다. KDE Plasma 데스크톱까지 쓰려면 4 vCPU, 8 GB RAM은 되어야 쾌적합니다.
Ubuntu 24.04 LTS 이상이며 26.04 LTS도 지원합니다. amd64에서는 모든 항목이 설치되고, arm64에서는 Chrome을 제외하고 동작합니다.
Claude Code가 포함된 요금제(Pro 또는 Max)나 Anthropic API 키가 필요합니다. claude-vps 자체는 무료이며 MIT 라이선스입니다.
xrdp는 세션을 암호화하고 기본값이 아닌 포트를 씁니다. 더 안전하게 하려면 --rdp-private로 포트를 닫아 두고 SSH 터널로 접속하면 됩니다.
네. 저장소를 포크하고, 내 컴퓨터에서 claude-vps capture를 실행한 뒤, 설치 스크립트가 포크한 저장소를 쓰도록 지정하면 됩니다. 이후 올리는 모든 변경 사항이 서버에 반영됩니다.
Hetzner, DigitalOcean, 집에 남는 컴퓨터 등 Ubuntu 24.04 이상이면 어디서나 동작합니다.
curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash