Neler kuruluyor
claude-vps setup dokuz adımı sırayla çalıştırır. Her adım lib/setup.sh içinde düz bir bash fonksiyonu. Sunucunda tam olarak neyin çalıştığını oradan okuyabilirsin. İstediğin adımı --skip ile atlayabilir, --only ile sadece bazılarını çalıştırabilirsin.
1. base
- Bütün paketlere
apt upgrade git curl jq ripgrep fd-find tmux htop build-essential python3ve benzeri araçlar- Node.js 20 veya üstü. Ubuntu 24.04'te apt sadece 18 sürümünü verdiği için orada NodeSource deposundan kurulur
unattended-upgradesaçılır, güvenlik yamaları sen uğraşmadan kurulur- Sunucuda swap yoksa ve RAM 8 GB'tan azsa 4 GB'lık bir swap dosyası. Böylece Plasma ve birkaç Claude birlikte çalışırken bellek dolup OOM killer devreye girmez
--timezoneverdiysen saat dilimi
2. user
Kullanıcını oluşturur ve sudo grubuna ekler. Kullanıcının SSH anahtarı yoksa /root/.ssh/authorized_keys dosyasını ona kopyalar. Burada seçtiğin parolayı RDP giriş ekranında kullanırsın.
3. ssh
/etc/ssh/sshd_config.d/10-claude-vps.conf dosyasını yazar:
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin prohibit-passwordsshd bir ayar için okuduğu ilk değeri kullanır. Dosya adının 10- ile başlaması bu yüzden: çoğu bulut imajıyla gelen 50-cloud-init.conf dosyasından önce okunur. Kullanıcının henüz SSH anahtarı yoksa bu adım bir uyarıyla atlanır, böylece sunucuya erişimini kaybetmezsin.
4. firewall
ufw açılır. Sadece OpenSSH ve RDP portuna izin verilir, geri kalan her şey kapalıdır. RDP portunu kapalı tutup SSH tüneliyle bağlanmak istersen --rdp-private kullan.
5. desktop
kde-plasma-desktop ve X11 oturumu (Ubuntu 25.10 ve üstünde plasma-session-x11 ile kwin-x11), Konsole, Dolphin, Kate, Spectacle, Noto ve JetBrains Mono fontları kurulur. SDDM kapatılır ve varsayılan hedef multi-user yapılır. Sunucunun başında kimse oturmadığı için giriş ekranına gerek yok. Sunucu doğrudan konsola açılır, Plasma sadece sen bağlandığında başlar.
Neden X11
xrdp bir Xorg oturumu çalıştırır. Plasma 6, Ubuntu 24.04 ile 26.04 arasında hâlâ X11 oturumuyla geliyor. Ben de RDP üzerinden her gün bunu kullanıyorum.
6. rdp
xrdpvexorgxrdp, 53389 portunda dinler (--rdp-portile değiştirilebilir)- Doğru
XDG_*değişkenleriylestartplasma-x11başlatan bir~/.xsession - Bir polkit kuralı. Bu kural olmadan her girişte "authentication is required to create a color managed device" diye parola soran bir pencere çıkar
7. apps
- Docker (
docker.io, compose v2, buildx). Kullanıcındockergrubuna eklenir - GitHub CLI (
gh) - Google'ın apt deposundan Google Chrome (sadece amd64). Claude'un gerçek bir tarayıcıya ihtiyacı olduğunda işe yarar
8. claude
- Claude Code, resmi kurulum script'iyle
~/.local/bin/claudekonumuna kurulur. Kendini otomatik günceller - claudegrid, son
.debsürümünden kurulur. Tek komutla Konsole ya da tmux içinde bir Claude Code ajanı ızgarası açar. Bir Konsole profili ve uygulama menüsü kaydı da ekler - ntfy.sh topic'i verdiysen
~/.claude/ntfy-topicdosyasına yazılır. Bildirim hook'u topic'i buradan okur
9. dotfiles
/opt/claude-vps klasörünün sahipliğini senin kullanıcına verir, claude-vps komutunu /usr/local/bin altına linkler ve claude-vps apply komutunu senin kullanıcınla çalıştırır. Bu komut dotfiles/home altındaki her şeyi ev klasörüne yazar: KDE ayarları, Konsole profilleri, ~/.claude/settings.json, CLAUDE.md, hook'lar ve .tmux.conf.
Adımları tekrar çalıştırmak
Her adım önce neyin zaten kurulu olduğuna bakar. Bu yüzden tekrar çalıştırmak güvenli:
sudo claude-vps setup --only desktop,rdp # örneğin Ubuntu sürüm yükseltmesinden sonra
sudo claude-vps setup --skip apps # Docker ve Chrome hariç her şey
sudo claude-vps setup --no-desktop # sadece terminal kullanılacak sunucu