Skip to content

CLI ​

text
claude-vps <command> [options]
コマンド実行場所内容
setupサーバー(root)インストール手順を実行
updateサーバー(root)最新版を取得し、初回インストール時のオプションで setup をやり直す
syncサーバーgit pull のあと apply
autosync on|offサーバーsystemd のユーザータイマーで30分ごとに sync を実行
doctorサーバーClaude、tmux、Docker、xrdp、Plasma、ufw、ntfy、autosync を確認
capture手元の PCdotfiles/manifest.txt にあるファイルを dotfiles/home にコピー
publish手元の PCcapture してから commit と push
release X.Y.Z手元の PCVERSION を書き換え、vX.Y.Z タグを付けて push。GitHub が CHANGELOG.md をもとにリリースを公開
applyどこでもdotfiles/home を $HOME に書き込み。上書きするものは先にバックアップ
versionどこでもバージョンを表示

setup ​

bash
sudo claude-vps setup [options]
オプションデフォルト
-u, --user NAME$SUDO_USER。なければ質問作業用ユーザー。存在しなければ作成
--rdp-port PORT53389xrdp のポート
--rdp-privateオフufw で RDP のポートを開けない
--ntfy-topic NAME質問通知に使う ntfy.sh の topic
--timezone TZ変更しない例:Europe/Istanbul
--no-desktopオフ--skip desktop,rdp と同じ
--skip a,bスキップする手順
--only a,b指定した手順だけを実行
-y, --yesオフ質問しない。ユーザー名は dev、パスワードは自動生成
-n, --dry-runオフコマンドを実行せずに表示する

手順の順番:base user ssh firewall desktop rdp apps claude dotfiles

アップデート ​

新しいバージョンが出たら、各サーバーで次を実行します。

bash
sudo claude-vps update

新しいコードを取得し、変更内容を表示してから、setup の全手順をもう一度実行します。完了済みの手順はスキップされます。xrdp と SSH は設定が変わったときだけ再起動するので、開いている RDP セッションは切れません。初回インストールで選んだオプション(ユーザー、RDP ポート、スキップした手順)は /etc/claude-vps.conf に保存され、そのまま使われます。

新しいバージョンが届いたときは claude-vps sync でも知らせてくれます。

バージョンのリリース ​

手元の PC で CHANGELOG.md に ## X.Y.Z のセクションを追加して commit し、次を実行します。

bash
claude-vps release X.Y.Z

リリース用の workflow がタグと VERSION の一致を確認し、GitHub リリースを公開します。リリースノートには changelog のそのセクションが使われます。

設定元のマシン ​

claude-vps capture を実行したマシンは設定元としてマークされます(~/.config/claude-vps/source)。このマシンでは apply と sync がファイルを書き換えません。リポジトリ側のコピーが、いま使っている設定より古い場合があるためです。それでも上書きするときは claude-vps apply --force を使います。

install.sh ​

ブートストラップ用のスクリプトは、3つの環境変数を読み込みます。

変数デフォルト
CLAUDE_VPS_REPOhttps://github.com/halitsever/claude-code-vps.git
CLAUDE_VPS_DIR/opt/claude-vps
CLAUDE_VPS_BRANCHmain

bash -s -- のあとに書いた引数は、すべて setup に渡されます。

MIT licensed. Not affiliated with Anthropic.