1. 从 UTM 官网 安装；从 Ubuntu 官方获取 ARM64 Desktop 镜像。
2. 创建虚拟机时选择 ARM64 Linux 的虚拟化路径；先配置 4 vCPU、6–8GB RAM、60GB 虚拟磁盘。
3. 安装软件期间可临时用 Shared Network 完成系统更新；正式切换前记录安装状态并制作 VM 快照。
4. 安装后关闭 VM，删除临时 NAT/Shared/Bridged 网卡，仅保留一张 Host Only 网卡。

完成切换后，在 Ubuntu 终端运行以下命令。这一步应该在配置任何代理前完成。

ip -br addr
ip route
ip -6 route

# 没有配置代理时，以下外网请求应失败
curl --noproxy '*' -4 --connect-timeout 5 --max-time 8 https://api.ipify.org
curl --noproxy '*' -6 --connect-timeout 5 --max-time 8 https://api64.ipify.org

Host Only 仍允许访问宿主机指定服务，这不是公网直连泄露。若 curl --noproxy '*' 在此阶段成功获取了公网 IP，则必须停下排查是否还有第二张网卡、宿主机 IP 转发、透明代理或意外路由。

使用现有节点配置创建一个单独的 HTTP listener，并通过 proxy 字段绑定确定的搬瓦工节点。推荐使用独立 Mihomo 实例，避免 Clash Verge Rev 的 GUI 合并配置覆盖该入口。

listeners:
  - name: claude-vm-http
    type: http
    listen: "{{HOST_ONLY_IP}}"
    port: {{PROXY_PORT}}
    proxy: "{{BWH_NODE}}"
    users:
      - username: "{{PROXY_USER}}"
        password: "{{PROXY_PASSWORD}}"

规则要求：{{BWH_NODE}} 必须对应配置中实际存在、固定出口的节点，不应指向会选择 DIRECT 的策略组。入口只监听 Host Only IP，不监听 0.0.0.0 或物理 LAN IP；即使设置了账号密码，也不能公开暴露这个未加 TLS 的 HTTP 代理。

先验证 HTTP 网关确实可达。下例使用 curl 的 --proxy-user 避免直接将密码拼到 URL 中；交互式验证时建议临时输入密码，不要把生产凭据写入终端历史或公开文档。

# 根据提示输入代理密码（输入过程不回显）
read -rs -p 'Proxy password: ' PWD; echo
curl -v --max-time 15 \
  --proxy "http://{{HOST_ONLY_IP}}:{{PROXY_PORT}}" \
  --proxy-user "{{PROXY_USER}}:$PWD" \
  https://api.ipify.org
unset PWD

验收是获得搬瓦工美国出口 IP；而非仅仅返回某个美国 IP。之后再配置 Ubuntu 的系统代理、Claude Desktop 所需的代理环境，以及 Claude Code 的 HTTP_PROXY / HTTPS_PROXY。GUI 应用不保证自动继承 shell 变量，需要单独测试。

# 例：在受控会话中设置，避免提交到代码仓库
export HTTP_PROXY='http://{{PROXY_USER}}:ENCODED_PASSWORD@{{HOST_ONLY_IP}}:{{PROXY_PORT}}'
export HTTPS_PROXY="$HTTP_PROXY"
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"

# 需要联网的 git / curl / Node 工具应分别确认代理变量是否生效
# GUI Claude Desktop 必须另行验证 Linux 桌面代理或应用启动环境。

提示：如果 Claude Desktop 当前版本、登录组件或 MCP 不遵守显式 HTTP 代理，它会因网络隔离而无法联网。应修正应用代理配置；不要为了“能连上”而切回 Shared Network。

Claude Desktop 已有官方 Linux beta（支持 Ubuntu/Debian ARM64）；可使用 Anthropic 官方 apt 仓库安装。Linux 版本暂不支持 Computer Use；相关功能需要以官方当前说明为准。

sudo curl -fsSLo \
  /usr/share/keyrings/claude-desktop-archive-keyring.asc \
  https://downloads.claude.ai/claude-desktop/key.asc

echo "deb [signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | \
  sudo tee /etc/apt/sources.list.d/claude-desktop.list

sudo apt update
sudo apt install claude-desktop

这些命令需要预先为 apt 配置代理，或在安装阶段临时联网。Claude Code 使用 Anthropic 当前官方安装方式；MCP Server、Node、Python 等也必须全部安装并运行在 Ubuntu VM 内。不要把宿主机的 Claude.app 或其 MCP 可执行路径挂进 VM，当作“已被隔离”的进程使用。

以下命令属于策略模板，仅适用于已经确认 Host Only 地址、网络稳定和代理可用的 VM。启用之后 DNS、apt、时间同步等直连服务会被阻断，需通过代理或最小例外处理。若 VM 使用动态地址，续租 DHCP 的规则必须另行核实；生产环境可考虑固定客户机地址。

# 在 Ubuntu VM 内执行，先确保能从 UTM 控制台直接登录
sudo ufw default deny incoming
sudo ufw default deny outgoing

# 只允许连接宿主机 Host Only 的专用 HTTP 代理端口
sudo ufw allow out to {{HOST_ONLY_IP}} port {{PROXY_PORT}} proto tcp

# 验证 IPv6 也纳入规则管理：查看 /etc/default/ufw 中 IPV6=yes
sudo ufw status verbose

# 检查无误后再启用；如依赖 DHCP，请先处理租约问题
sudo ufw enable
sudo ufw status numbered

VM 防火墙只保护运行时普通进程。应当用普通用户运行 Claude，避免授予无条件 sudo、root 密钥或修改网络设置的工具权限。具有 VM root 权限的程序可能修改自己的防火墙，但即便如此，Host Only 的“无原生公网出口”仍应继续成立，除非宿主机另行提供网关/隧道。

将专用 Mihomo listener 绑定到真实的 Host Only 接口地址，而非 0.0.0.0。宿主机 PF / Network Extension 防火墙可再限制来源仅为 VM IP、目标仅为代理端口，并拒绝该 VM 对宿主机其他服务的访问。因 UTM 后端与系统规则顺序不同，PF 规则需现场核对后编写，本文不提供可盲目执行的全局 PF 配置。

# 检查 UTM 虚拟网卡及宿主机地址
ifconfig

# 检查专用代理端口监听位置（默认 18888 可替换）
lsof -nP -iTCP:18888 -sTCP:LISTEN

# 查看当前 PF 状态与规则，不会修改系统
sudo pfctl -s info
sudo pfctl -sr
sudo pfctl -a '*' -sr

必须明确禁止：在宿主机为 Host Only 网络开启 IP forwarding/NAT，或者另行配置透明代理、共享互联网、SSH 动态转发等让 VM 获得未受控网络出口。不要向 Claude VM 暴露宿主机 shell、Docker socket、宿主机网络管理服务，避免被当作代理跳板。

专用 listener 的 proxy 绑定具体搬瓦工节点；不要绑定包含 DIRECT 的代理组。代理服务停止、认证失败、远端节点不可用时，该请求应该连接失败。宿主机可以继续供 UU 和其他应用国内直连，因为 Claude VM 不拥有通往物理网络的独立路径。