Skip to content

一台空白的 Ubuntu 服务器, 一条命令变成 Claude Code 工作站。

一条命令装好 Claude Code、可以用 RDP 连接的 KDE Plasma 桌面、加固过的 SSH,以及我每天在用的整套配置。在自己电脑上改了设置,服务器也会跟着更新。

$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种语言
工作原理

九个步骤,全是看得懂的 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 配置文件从你的电脑导出,在服务器上原样还原。

security

默认就很安全

SSH 只能用密钥登录,root 不能用密码登录,防火墙和自动安全更新都已开启。

ntfy

手机收到通知

Claude 需要你确认时,会通过 ntfy.sh 推送到手机。不用一直守在电脑前。

tools

开发工具齐全

Docker、GitHub CLI、Node、ripgrep、编译工具和 Chrome 都已装好。

idempotent

可以重复执行

每一步都会先检查是否已经装好。随时可以重新运行,也可以用 --only 只跑需要的步骤。

配置同步

在自己电脑上改,服务器自动同步。

所有配置都放在仓库里。你在本地发布,服务器定时拉取。

01

你的电脑

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 内存用起来才像一台真正的工作站。

支持哪些 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 这个仓库,在自己电脑上运行 claude-vps capture,再让安装脚本指向你的 fork。之后你发布的每次更改都会同步到服务器。

十分钟后,新服务器就能用了。

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.