Skip to content

빈 Ubuntu 서버를 명령어 하나로 Claude Code 작업 환경으로.

Claude Code, RDP로 접속하는 KDE Plasma 데스크톱, 안전하게 설정된 SSH, 그리고 제가 매일 쓰는 설정이 명령어 하나로 설치됩니다. 내 컴퓨터에서 설정을 바꾸면 서버에도 그대로 반영됩니다.

$curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash
Ubuntu 26.04✦KDE Plasma 6✦xrdp✦tmux✦Claude Code✦Docker✦GitHub CLI✦Chrome✦ntfy.sh✦ufw✦systemd timers✦VitePress✦Ubuntu 26.04✦KDE Plasma 6✦xrdp✦tmux✦Claude Code✦Docker✦GitHub CLI✦Chrome✦ntfy.sh✦ufw✦systemd timers✦VitePress✦
1명령어
9설치 단계
~10분
11언어
작동 방식

9단계, 모두 읽기 쉬운 bash 스크립트입니다.

01/09
==> base
✓ base system ready
각 단계 자세히 보기 →
  1. 01

    base

    시스템을 업데이트하고 기본 도구와 swap을 설치합니다. 보안 업데이트는 자동으로 적용됩니다.

  2. 02

    user

    SSH 키로 로그인하는 sudo 권한 사용자를 만듭니다.

  3. 03

    ssh

    비밀번호 로그인을 끕니다. root도 비밀번호로는 들어올 수 없습니다. 클라우드 이미지의 기본 설정보다 우선 적용됩니다.

  4. 04

    firewall

    방화벽(ufw)을 켜고 SSH와 RDP 포트만 엽니다.

  5. 05

    desktop

    KDE Plasma 데스크톱을 설치합니다. 서버에는 모니터가 없으므로 로그인 화면은 설치하지 않습니다.

  6. 06

    rdp

    xrdp를 53389 포트로 엽니다. 접속하면 Plasma가 시작되고 불필요한 비밀번호 창은 뜨지 않습니다.

  7. 07

    apps

    Docker, GitHub CLI, Chrome을 설치합니다.

  8. 08

    claude

    Claude Code를 공식 방식으로 설치하고 휴대폰 알림을 설정합니다.

  9. 09

    dotfiles

    KDE 레이아웃, Claude 설정, 훅, tmux 설정을 적용합니다.

포함된 기능

몇 시간씩 일하는 Claude에게 필요한 모든 것.

claude

Claude Code가 계속 실행됩니다

tmux 덕분에 SSH 연결이 끊겨도 Claude는 하던 일을 계속합니다. 설정, 훅, 상태 표시줄도 미리 준비되어 있습니다.

plasma

기본값이 아닌 내 KDE

패널, 단축키, 창 배치, Konsole 프로필을 내 컴퓨터에서 가져와 서버에 똑같이 적용합니다.

security

처음부터 안전하게

SSH는 키로만 접속할 수 있고 root 비밀번호 로그인은 막혀 있습니다. 방화벽과 자동 업데이트도 켜져 있습니다.

ntfy

휴대폰으로 알림

Claude가 질문하면 ntfy로 휴대폰에 알림이 옵니다. 컴퓨터 앞에서 기다릴 필요가 없습니다.

tools

개발 도구 기본 탑재

Docker, GitHub CLI, Node, ripgrep, 빌드 도구, Chrome이 설치되어 있습니다.

idempotent

몇 번이든 다시 실행 가능

각 단계는 이미 설치된 것을 먼저 확인합니다. 언제든 다시 실행해도 되고, --only로 필요한 단계만 실행할 수도 있습니다.

설정 동기화

내 컴퓨터에서 바꾸면 서버에도 반영됩니다.

모든 설정은 저장소에 보관됩니다. 내 컴퓨터에서 올리면 서버가 주기적으로 가져갑니다.

01

내 컴퓨터

claude-vps publish

KDE와 Claude 설정을 모으고, 개인 경로를 지운 뒤 커밋하고 푸시합니다.

02

GitHub

git push

설정은 dotfiles/home 폴더에 일반 파일로 저장됩니다. 무엇이 바뀌었는지 확인하기 쉽습니다.

03

서버

claude-vps sync

변경 사항을 가져와 적용합니다. 덮어쓰는 파일은 먼저 백업합니다. 30분마다 자동으로 실행할 수도 있습니다.

FAQ

자주 묻는 질문

VPS에서 Claude Code를 실행할 수 있나요?

네. Claude Code는 터미널 앱이라 어떤 Linux 서버에서도 동작합니다. 내 기기에서 링크를 열어 한 번만 로그인하면 되고, 접속을 끊어도 tmux 안에서 계속 실행됩니다.

Claude Code용 서버 사양은 어느 정도가 필요한가요?

터미널만 쓴다면 2 vCPU, 4 GB RAM이면 충분합니다. KDE Plasma 데스크톱까지 쓰려면 4 vCPU, 8 GB RAM은 되어야 쾌적합니다.

어떤 Ubuntu 버전을 지원하나요?

Ubuntu 24.04 LTS 이상이며 26.04 LTS도 지원합니다. amd64에서는 모든 항목이 설치되고, arm64에서는 Chrome을 제외하고 동작합니다.

Claude 구독이 필요한가요?

Claude Code가 포함된 요금제(Pro 또는 Max)나 Anthropic API 키가 필요합니다. claude-vps 자체는 무료이며 MIT 라이선스입니다.

RDP 포트를 인터넷에 열어도 안전한가요?

xrdp는 세션을 암호화하고 기본값이 아닌 포트를 씁니다. 더 안전하게 하려면 --rdp-private로 포트를 닫아 두고 SSH 터널로 접속하면 됩니다.

내 KDE와 Claude 설정을 쓸 수 있나요?

네. 저장소를 포크하고, 내 컴퓨터에서 claude-vps capture를 실행한 뒤, 설치 스크립트가 포크한 저장소를 쓰도록 지정하면 됩니다. 이후 올리는 모든 변경 사항이 서버에 반영됩니다.

새 서버가 10분이면 준비됩니다.

Hetzner, DigitalOcean, 집에 남는 컴퓨터 등 Ubuntu 24.04 이상이면 어디서나 동작합니다.

$curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash

MIT licensed. Not affiliated with Anthropic.