インストールされるもの
claude-vps setup は9つの手順を順番に実行します。どの手順も lib/setup.sh にある普通の bash 関数なので、サーバーで何が実行されるかをそのまま読めます。--skip で手順を飛ばしたり、--only で一部だけを実行したりできます。
1. base
apt upgradeですべてのパッケージを更新git curl jq ripgrep fd-find tmux htop build-essential python3などの基本ツール- Node.js 20 以上。Ubuntu 24.04 の apt には 18 しかないため、NodeSource のリポジトリから入れます
unattended-upgradesを有効化。セキュリティパッチが自動で入ります- swap がなく、メモリが 8 GB 未満なら 4 GB の swap ファイルを作成。Plasma と複数の agent を動かしても OOM killer に止められにくくなります
--timezoneを指定した場合はタイムゾーンを設定
2. user
作業用ユーザーを作成し、sudo グループに追加します。そのユーザーに SSH 鍵がなければ /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 セッション(Ubuntu 25.10 以降では plasma-session-x11 と kwin-x11)、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を作成し、適切なXDG_*変数でstartplasma-x11を起動- polkit のルールを追加。これがないと、ログインのたびに「カラーマネージドデバイスの作成には認証が必要です」という確認が出ます
7. apps
- Docker(
docker.io、compose v2、buildx)。ユーザーをdockerグループに追加 - GitHub CLI(
gh) - Google の apt リポジトリから Google Chrome(amd64 のみ)。Claude が本物のブラウザを必要とするときに便利です
8. claude
- 公式のネイティブインストーラーで Claude Code を
~/.local/bin/claudeに入れます。自動でアップデートされます - claudegrid を最新の
.debリリースからインストールします。1 つのコマンドで Konsole や tmux に Claude Code エージェントのグリッドを開けます。Konsole のプロファイルとアプリメニューの項目も追加されます - ntfy.sh の topic を指定した場合は
~/.claude/ntfy-topicに保存します。通知用の hook はここから読み込みます
9. dotfiles
/opt/claude-vps の所有者を作業用ユーザーに変え、claude-vps を /usr/local/bin にリンクし、そのユーザーとして claude-vps apply を実行します。これで dotfiles/home 以下のファイルがすべてホームディレクトリに書き込まれます。KDE の設定、Konsole のプロファイル、~/.claude/settings.json、CLAUDE.md、hook、.tmux.conf です。
手順をもう一度実行する
どの手順もまず現在の状態を確認するので、再実行しても問題ありません。
sudo claude-vps setup --only desktop,rdp # 例:OS のバージョンアップ後
sudo claude-vps setup --skip apps # Docker と Chrome 以外をすべて実行
sudo claude-vps setup --no-desktop # ターミナルだけのサーバー