Что устанавливается
claude-vps setup выполняет девять шагов по порядку. Каждый шаг это обычная bash-функция в lib/setup.sh, так что вы можете прочитать, что именно запускается на сервере. Любой шаг можно пропустить через --skip или выполнить только нужные через --only.
1. base
apt upgradeдля всех пакетовgit curl jq ripgrep fd-find tmux htop build-essential python3и ещё несколько пакетов- Node.js 20 или новее. В apt на Ubuntu 24.04 есть только 18, поэтому там он ставится из репозитория NodeSource
- включается
unattended-upgrades, чтобы обновления безопасности ставились без вашего участия - swap-файл на 4 ГБ, если swap нет, а RAM меньше 8 ГБ. Так OOM killer не тронет Plasma и агентов
- часовой пояс, если указан
--timezone
2. user
Создаёт пользователя для работы, добавляет его в группу sudo и копирует ему /root/.ssh/authorized_keys, если своих ключей у него ещё нет. Выбранный пароль вы будете вводить на экране входа RDP.
3. ssh
Создаёт /etc/ssh/sshd_config.d/10-claude-vps.conf:
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin prohibit-passwordsshd берёт первое прочитанное значение, поэтому имя файла начинается с 10-: он читается раньше 50-cloud-init.conf, который есть в большинстве облачных образов. Если у вашего пользователя ещё нет SSH-ключа, шаг пропускается с предупреждением. Так вы не закроете себе доступ к серверу.
4. firewall
ufw пропускает OpenSSH и порт RDP, всё остальное закрыто. С --rdp-private порт RDP тоже остаётся закрытым, а подключаться нужно через SSH-туннель.
5. desktop
kde-plasma-desktop с сессией X11 (plasma-session-x11, kwin-x11 в Ubuntu 25.10 и новее), а также Konsole, Dolphin, Kate, Spectacle и шрифты Noto и JetBrains Mono. SDDM отключается, а целью по умолчанию становится multi-user. За сервером никто не сидит, поэтому он загружается сразу в консоль, а Plasma стартует только при подключении.
Почему X11
xrdp работает с сессией Xorg. В Ubuntu с 24.04 по 26.04 у Plasma 6 ещё есть сессия X11, и именно ей я пользуюсь каждый день через RDP.
6. rdp
xrdpиxorgxrdpна порту 53389 (меняется через--rdp-port)~/.xsession, который запускаетstartplasma-x11с нужными переменнымиXDG_*- правило polkit, которое убирает запрос "authentication is required to create a color managed device". Без него он появляется при каждом входе
7. apps
- Docker (
docker.io, compose v2, buildx), ваш пользователь добавляется в группуdocker - GitHub CLI (
gh) - Google Chrome из apt-репозитория Google (только amd64). Пригодится, когда Claude нужен настоящий браузер
8. claude
- Claude Code через официальный нативный установщик, в
~/.local/bin/claude. Обновляется сам - claudegrid из последнего релиза
.deb: одной командой открывает сетку агентов Claude Code в Konsole или tmux. Заодно добавляет профиль Konsole и пункт в меню приложений - ваш топик ntfy.sh в
~/.claude/ntfy-topic, если вы его указали. Оттуда его читает хук уведомлений
9. dotfiles
Передаёт /opt/claude-vps вашему пользователю, создаёт ссылку на claude-vps в /usr/local/bin и запускает claude-vps apply от вашего имени. Всё из dotfiles/home попадает в домашнюю папку: настройки KDE, профили Konsole, ~/.claude/settings.json, CLAUDE.md, хуки и .tmux.conf.
Повторный запуск
Каждый шаг сначала проверяет, что уже установлено, поэтому запускать его снова безопасно:
sudo claude-vps setup --only desktop,rdp # например, после обновления релиза
sudo claude-vps setup --skip apps # всё, кроме Docker и Chrome
sudo claude-vps setup --no-desktop # сервер только с терминалом