vps-vpn-setup Skill：Claude Code 一键部署 VPS + 代理环境的免折腾方案

Skill超级捕获手 技术创作者 2026-08-15 16 阅读

一句话总结

vps-vpn-setup 是一个 Claude Code / Codex CLI 的代理部署 Skill，让你在会话里用自然语言告诉 AI 服务器信息，就能自动完成 VPS + v2ray-agent（VLESS Reality）+ Clash 订阅 + 验证的全流程——无需手动敲 SSH 命令，小白也能跑通。截至 2026-06-16 该项目在 GitHub 收获约 27 Stars，最新推送时间为 2026 年 6 月，是近期 Claude Skills 生态里解决实际痛点的实用工具。

核心功能与设计原则

功能：自动化 VPS 翻墙环境部署链路，具体包括：

  • SSH 远程连入服务器
  • 安装 v2ray-agent（VLESS Reality 无域名版）
  • 获取 clashMeta 订阅链接
  • 给出 Clash Verge 配置清单（图形界面部分由用户手动操作）
  • 验证配置是否生效（出口 IP、服务状态、DNS 检查）

设计原则：

  • 零门槛交互：用户只需提供 IP + 密码（或 PEM 文件），Claude 自动接管所有技术细节
  • 透明可控：每一步操作都会实时告知用户，用户始终知道 AI 在做什么
  • 中文场景优先：明确推荐 VMiss（$5/月起）和 DMIT（$9.9/月起）等国内可购买的服务器
  • Windows 兼容：推荐 WSL2 方案；DMIT PEM 用户可直接在 PowerShell 用 ssh -i 连接

认可度

  • GitHub Stars：约 27（截至 2026-08-15）
  • 最新推送：2026-06-16，距今约 2 个月，属于近期活跃更新的工具
  • 社区定位：非追求 Star 数量的展示型项目，而是解决特定高频痛点的实用型 Skill

这类 Skill 通常在中文开发者圈子里口口相传，实际使用量远超 Star 数体现的热度。

链接

GitHub 仓库：https://github.com/huasanai/vps-vpn-setup

原作者

huasanai（GitHub username: huasanai）

该作者同时维护了多个 Claude Code 工具链相关的开源项目，包括 ai-coding-wiki（面向中文编程小白的 AI Coding 学习 Skill）和 feishu-wiki-mcp（飞书知识库 MCP 连接器），定位为中文 AI Coding 生态的工具型开发者。

详细介绍

在 Claude Code 出现之前，部署一套”国内能访问 Claude / ChatGPT”的代理环境是一件非常繁琐的事：需要手动 SSH 登录服务器、逐行敲命令安装 v2ray-agent、查文档配置 VLESS Reality、找订阅链接、配 Clash 客户端——每一步都可能踩坑，而且第一次成功后，下次换服务器又得重来一遍。

vps-vpn-setup 把这套流程封装成了一个标准的 Claude Skill。用户只需在 Claude Code 会话里输入 /vps-vpn-setup 并提供服务器信息，AI 就会按顺序执行所有操作，最后给出可用的 Clash 配置。整个过程不仅给出结果，还解释每一步在做什么，用户能真正学到背后的原理。

v2ray-agent 的 VLESS Reality 无域名版是目前最推荐的美区 AI 服务访问方案，特点是轻量、隐匿性强、不依赖域名。Clash Verge 则是跨平台的图形化代理客户端。两者结合，配合 Claude Code，整个代理基础设施可以在 10 分钟内从零到可用。

特点

  • 一行命令安装：claude skill install https://github.com/huasanai/vps-vpn-setup，无需手动复制文件
  • 自然语言交互：提供服务器 IP + 密码即可，Claude 自动决定执行顺序和参数
  • 全链路自动化：从 SSH 连接、程序安装、订阅获取到配置验证，全程无需人工介入
  • Windows 友好：通过 WSL2 兼容，或 DMIT 用户可直接用 PowerShell 的 ssh 命令
  • 透明可信：每个步骤都有实时输出，用户随时中断或修改方向
  • 可验证：部署完成后自动检查出口 IP、DNS 和服务状态，确保可用

使用方法

安装：

claude skill install https://github.com/huasanai/vps-vpn-setup

或手动复制 skill/ 目录到 ~/.claude/skills/vps-vpn-setup/。

基础调用（VMiss 密码登录）：

/vps-vpn-setup 我的 VPS 服务器信息：
- IP地址：1.2.3.4
- 密码：your_password
- 服务商：VMiss

基础调用（DMIT PEM 登录）：

/vps-vpn-setup 我的 VPS 服务器信息：
- IP地址：1.2.3.4
- PEM文件：~/Downloads/id_rsa.pem
- 服务商：DMIT

最小示例（完整流程）：

> /vps-vpn-setup
  - IP地址：203.0.113.42
  - 密码：MyPass2026!
  - 服务商：VMiss

< Claude 回复：
  正在连接服务器 203.0.113.42...
  ✅ SSH 连接成功
  正在安装 v2ray-agent (VLESS Reality)...
  ✅ 安装完成，订阅链接已获取
  正在验证出口 IP...
  ✅ 当前出口 IP：203.0.113.42（符合预期）
  ✅ DNS 泄漏检查：通过
  你的 Clash Verge 配置：
  - 订阅地址：[clashmeta://xxx...]
  - 建议代理端口：7890
  - UI 端口：9090

适用场景与目标人群

场景：

  • 国内开发者需要稳定访问 Claude.ai / ChatGPT / GitHub 等海外 AI 服务
  • 换了新服务器后需要重新部署代理环境
  • 想让 Claude Code 在没有代理的服务器上直接联网调用 API

人群：

  • 国内 AI 开发者：需要跨境访问 ChatGPT / Claude API 的工程师
  • Claude Code 新用户：刚装好 Claude Code 但发现访问不了官方服务，不知道怎么配代理
  • 运维经验少的开发者：不想折腾命令行，希望 AI 能全程代劳
  • 多服务器用户：经常换机器，需要可复制的代理部署流程

输入与输出案例

输入（用户向 Claude Code 提供服务器信息）：

/vps-vpn-setup
服务器信息：
- IP：1.2.3.4
- 密码：VMiss2026!
- 服务商：VMiss

输出（Claude 端到端执行日志）：

✅ SSH 连接到 1.2.3.4 成功
✅ 检测到系统：Ubuntu 22.04
✅ 开始安装 v2ray-agent (VLESS Reality)...
   → 下载安装脚本...
   → 配置无域名 VLESS Reality...
   → 启动服务...
✅ v2ray-agent 安装完成
✅ 订阅链接已生成：https://example.com/sub/xxx
✅ Clash Verge 配置：
   - 类型：clashmeta
   - 订阅 URL：[已复制到剪贴板]
   - 本地端口：7890

✅ 验证开始：
   - 出口 IP：1.2.3.4 ✓
   - 服务状态：running ✓
   - DNS 泄漏：未检测到 ✓

🎉 部署完成！将订阅链接粘贴到 Clash Verge 即可使用。

输出（如果密码错误）：

❌ SSH 认证失败，请检查密码是否正确。
   如果使用密钥登录，请改用 PEM 文件方式：
   /vps-vpn-setup IP地址：1.2.3.4
               PEM文件：~/path/to/key.pem
               服务商：DMIT

GitHub: https://github.com/huasanai/vps-vpn-setup

评论区

0 条评论

登录后可评论。

Skill超级捕获手 16 阅读