PVE on Svtter's Blog

在虚拟机上运行 Claude Code 实现自动化测试与开发

Thu, 25 Dec 2025 00:00:00 +0800

最近我验证了一套行之有效的 AI 开发方法，还不影响现有的工作流。这里总结一下。

为什么选择 VM + Claude Code

隔离性：避免污染主系统，可快照回滚
可复现：团队成员可以快速复制相同环境
适合自动化测试：Playwright 等浏览器自动化工具需要桌面环境
安全: 不怎么担心 agent 生成 rm -rf / 命令。虚拟机崩溃不影响虚拟化平台,重新创建一个即可。

环境搭建

1. PVE 创建 Ubuntu Desktop VM

下载 Ubuntu Desktop ISO，上传到 PVE 的 ISO 存储
创建 VM：
- CPU：host 类型，2-4 核
- 内存：4-8 GB
- 磁盘：VirtIO SCSI，40GB+
- 网卡：VirtIO
挂载 ISO，启动安装
安装完成后安装 qemu-guest-agent：

1
2


sudo apt install qemu-guest-agent
sudo systemctl enable --now qemu-guest-agent

2. 配置 Xfce + xrdp 远程桌面

安装 xrdp 和 Xfce（比 GNOME 更轻量、兼容性更好）：

1
2
3
4
5
6


sudo apt install xrdp
sudo systemctl enable xrdp
sudo systemctl start xrdp

sudo apt install xfce4 xfce4-goodies
echo xfce4-session > ~/.xsession

安装过程中提示选择 display manager，选 lightdm。

解决黑屏问题

编辑 xrdp 启动脚本：

1

sudo nano /etc/xrdp/startwm.sh

在最后两行 test -x 和 exec 之前加上：

1
2
3


unset DBUS_SESSION_BUS_ADDRESS
unset XDG_RUNTIME_DIR
startxfce4

重启 xrdp：

1

sudo systemctl restart xrdp

注意：连接前不要在本地登录桌面，否则同用户会黑屏。

调整分辨率/DPI

Windows 远程桌面连接前，在"显示选项"里调低分辨率（如 1920×1080）
或在 Xfce 内：设置管理器 → 外观 → 字体 → 调高 DPI（如 120）

禁用崩溃提示

切换桌面后可能有 GNOME 组件崩溃提示（不影响使用）：

1

sudo systemctl disable apport

3. 安装 Claude Code

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 安装 Node.js（如使用 nvm）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 或使用官方安装脚本
curl -fsSL https://claude.ai/install.sh | bash

首次运行 claude 命令，按提示登录认证。

自动化测试工作流：MCP 配置

Playwright MCP

MCP	特点
`@playwright/mcp` (微软官方)	轻量、基于无障碍树
`@executeautomation/playwright-mcp-server` (社区)	功能更全、支持截图、JS 执行
`@agentdeskai/browser-tools-mcp`	console 日志监控、Lighthouse 性能分析

Claude Code 配置

在项目根目录创建 .mcp.json：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


{
 "mcpServers": {
 "playwright": {
 "command": "npx",
 "args": ["-y", "@executeautomation/playwright-mcp-server"]
 },
 "browser-tools": {
 "command": "npx",
 "args": ["-y", "@agentdeskai/browser-tools-mcp"]
 }
 }
}

或用 CLI 添加：

1

claude mcp add playwright --scope project -- npx -y @executeautomation/playwright-mcp-server

OpenCode 配置

如果使用 OpenCode，配置格式不同（opencode.json）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


{
 "$schema": "https://opencode.ai/config.json",
 "mcp": {
 "playwright": {
 "type": "local",
 "command": ["npx", "-y", "@executeautomation/playwright-mcp-server"],
 "enabled": true
 },
 "browser-tools": {
 "type": "local",
 "command": ["npx", "-y", "@agentdeskai/browser-tools-mcp"],
 "enabled": true
 }
 }
}

配置差异对比：

配置项	Claude Code	OpenCode
顶层 key	`mcpServers`	`mcp`
type	不需要	必须（`local`）
command	字符串	数组

使用示例

配置好后可以用自然语言驱动测试：

1
2
3
4
5


claude "打开 localhost:3000，测试登录流程，验证是否跳转到首页"

claude "截图对比 mobile/tablet/desktop 三种尺寸下的首页布局"

claude "检查页面 console 是否有报错"

效果展示

总结

VM + Claude Code + Playwright MCP 的组合提供了一个隔离、可复现的自动化开发测试环境。整个流程：

PVE 创建 Ubuntu Desktop VM
配置 Xfce + xrdp 远程访问
安装 Claude Code / OpenCode
配置 Playwright MCP
用自然语言驱动自动化测试

Extend LVM Disk.md

Sat, 15 Feb 2025 14:12:37 +0800

使用 PVE + Debian 组合后，开发变得愉快了很多。今天遇到了一个新的问题，磁盘空间不足，拓展之后磁盘大小仍然不变。

我们讨论的是使用 LVM（逻辑卷管理器）的情况。

在这种情况下，我们需要首先看看系统。

1
2
3
4
5
6
7
8
9


root@debian:/home/svtter# lsblk
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS
sda 8:0 0 132G 0 disk
├─sda1 8:1 0 487M 0 part /boot
├─sda2 8:2 0 1K 0 part
└─sda5 8:5 0 31.5G 0 part
 ├─debian--vg-root 254:0 0 30.5G 0 lvm /
 └─debian--vg-swap_1 254:1 0 976M 0 lvm [SWAP]
sr0 11:0 1 1.4G 0 rom

此时我们总共有 132G 的可用空间，使用了 31.5 G。

我们需要调整 /dev/sda5 的大小。

我们首先需要使用一个 bootable usb。如果你使用的 PVE，你可以直接加载一个 iso 来启动。

注意：以下的操作不一定具有可复现性。请务必备份你的数据，以防不测。

在 live system 中，运行parted /dev/sda。

debian live system 中，用户名密码为：user/live，切换 root 用户，只需要sudo su。

在 parted 中，使用 print 查看磁盘情况。

下面是一个操作样例：

1
2
3
4
5
6
7
8
9


# 启动 parted 并选择磁盘
parted /dev/sda
# 查看当前分区表
print
# 调整分区大小（假设要将 /dev/sda5 扩展到最大可用空间）
resizepart 5 # 5 是 /dev/sda5 的分区编号
# 按照提示输入新的分区大小，按 Enter 选择默认的最大可用空间
# 退出 parted
quit

此时，需要首先resizepart /dev/sda2，也就是逻辑卷组。然后在扩展resizepart /dev/sda5。

完成拓展后，运行

1
2
3


pvresize /dev/sda5
vgextend debian-vg /dev/sda5
lvextend -l +100%FREE /dev/debian-vg/root

此时磁盘空间已经拓展了。但是 ext4 文件系统还未适应。

运行命令来重新调整 ext4 文件系统。

1
2


e2fsck -f /dev/debian-vg/root
resize2fs /dev/debian-vg/root

再次查看

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


root@debian:/home/user# sudo lvdisplay /dev/debian-vg/root
 --- Logical volume ---
 LV Path /dev/debian-vg/root
 LV Name root
 VG Name debian-vg
 LV UUID 82SmmD-qnAc-KOIO-1B2Y-ynP3-Mo0E-D12Rq0
 LV Write Access read/write
 LV Creation host, time debian, 2025-02-15 05:49:23 +0000
 LV Status available
 # open 0
 LV Size <91.70 GiB
 Current LE 23475
 Segments 2
 Allocation inherit
 Read ahead sectors auto
 - currently set to 256
 Block device 254:0

这样一来，磁盘空间就拓展了。