Skip to content

空の Ubuntu サーバーが、 コマンド1つで Claude Code 環境に。

Claude Code、RDP で接続できる KDE Plasma デスクトップ、安全な SSH 設定、そして私が毎日使っている設定一式をコマンド1つで入れます。手元の PC で設定を変えれば、サーバーにも反映されます。

$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

    sudo 権限を持つユーザーを作り、SSH 鍵をコピーします。

  3. 03

    ssh

    鍵でのみログインでき、root はパスワードで入れなくなります。cloud-init の設定より優先されます。

  4. 04

    firewall

    ufw を有効にし、SSH と RDP のポートだけを開けます。

  5. 05

    desktop

    KDE Plasma と X11 セッションを入れます。画面のないサーバーなので、ログイン画面は入れません。

  6. 06

    rdp

    xrdp をポート 53389 で起動します。接続すると Plasma が立ち上がり、colord のパスワード確認も出ません。

  7. 07

    apps

    Docker、GitHub CLI、Chrome を入れます。

  8. 08

    claude

    Claude Code を公式の方法で入れ、ntfy の通知を設定します。

  9. 09

    dotfiles

    KDE のレイアウト、Claude の設定、hook、tmux の設定を反映します。

できること

Claude を長時間動かすのに必要なものがそろっています。

claude

Claude Code が止まらない

tmux の中で動くので、SSH が切れても作業は続きます。設定、hook、ステータスラインも最初から入っています。

plasma

いつもの KDE 環境

パネル、ショートカット、タイル配置、Konsole のプロファイルを手元の PC から取り出し、サーバーで同じように再現します。

security

最初から安全

SSH は鍵認証のみ、root のパスワードログインは無効。ufw と自動セキュリティ更新も有効です。

ntfy

スマホに通知が届く

Claude が確認を求めると、ntfy.sh 経由でスマホに通知が届きます。PC の前で待つ必要はありません。

tools

開発ツール入り

Docker、GitHub CLI、Node、ripgrep、ビルドツール、Chrome が入っています。

idempotent

何度でも実行できる

各手順はまず現在の状態を確認します。いつ再実行しても大丈夫で、--only で必要な手順だけを動かすこともできます。

設定の同期

手元で変えた設定が、サーバーにも届きます。

設定はすべてリポジトリで管理します。手元の PC から送り、サーバーは定期的に取り込みます。

01

手元の PC

claude-vps publish

KDE と Claude の設定を集め、ホームディレクトリのパスを置き換えてから commit と push をします。

02

GitHub

git push

設定は dotfiles/home にただのファイルとして置かれます。変更の差分もすぐ確認できます。

03

サーバー

claude-vps sync

変更を取り込んで反映します。上書きするファイルは先にバックアップします。30分ごとの自動同期もできます。

FAQ

よくある質問

Claude Code は VPS で動きますか?

動きます。Claude Code はターミナルアプリなので、どの Linux サーバーでも使えます。手元の端末でリンクを開いて一度ログインすれば、接続を切っても tmux の中で動き続けます。

Claude Code にはどのくらいのサーバーが必要ですか?

ターミナルだけなら 2 vCPU、メモリ 4 GB で足ります。KDE Plasma デスクトップも使うなら、4 vCPU、メモリ 8 GB あると普段使いの PC と同じ感覚で使えます。

対応している 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 の設定を使えますか?

使えます。リポジトリを fork し、手元の PC で claude-vps capture を実行して、インストーラーの参照先を自分の fork にします。あとは publish した変更がすべてサーバーに反映されます。

新しいサーバーは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.