一台机器，一个属于你自己的翻墙节点

租一台便宜 VPS，剩下的交给 Claude Code——选地区、选内核、选协议、定全部参数、开服、发客户端、排障，一条命令开始。

安装到 Claude Code

一键安装

已装 Claude Code？粘这一行到终端：

$ curl -fsSL https://oneboxcc.pages.dev/install.sh | bash

安装器全程只与本站通信——不触碰任何 GitHub 仓库、不写 cookie、不上报任何数据。它会校验 sha256、备份旧版，把 skill 放进 ~/.claude/skills/selfhost-vpn/。

不想直接 pipe 到 bash？先审后跑

$ curl -fsSL https://oneboxcc.pages.dev/install.sh -o i.sh && less i.sh && bash i.sh

安装后怎么用

回到 Claude Code，直接说一句话，或用斜杠命令触发：

帮我在我的 VPS 上自建一个翻墙节点
> /selfhost-vpn

接下来 Claude 会问你预算/地区、拿到 VPS 的 root SSH，然后端到端把节点搭好并给你各设备的分享链接。

手动安装（不执行任何脚本）

直接把 skill 解压进 Claude Code 的 skills 目录：

mkdir -p ~/.claude/skills/selfhost-vpn && curl -fsSL https://oneboxcc.pages.dev/dl/selfhost-vpn.tar.gz | tar -xz -C ~/.claude/skills/selfhost-vpn

校验：curl -fsSL https://oneboxcc.pages.dev/dl/selfhost-vpn.tar.gz.sha256

更新 / 卸载

更新：重跑安装命令即可（自动备份旧版）。卸载：

$ curl -fsSL https://oneboxcc.pages.dev/uninstall.sh | bash
⚠ 和所有 curl | bash 一样：只从你信任的来源安装。本站脚本可读、可先审后跑（上面第二条）。skill 会在你授权后经 SSH 操作你自己的 VPS。

这是什么

onebox 是一个 Claude Code skill。你租一台便宜 VPS（给 root SSH），对 Claude 说一句话，它就替你——

选型
地区、内核（sing-box）、协议（VLESS+REALITY）、以及每一个 REALITY 参数，都由它按实战教条决定。
开服
经 SSH 装 sing-box、生成密钥、写配置、校验、起 systemd 服务、处理防火墙。幂等可重跑。
发客户端
吐出 vless:// 分享链接和完整客户端配置，覆盖 iOS/Mac/Win/安卓/Linux。
诊断
连不上、慢、疑似被墙——内置故障树、诚实解读国内测速、避免双隧道误判。

你只需要准备

① 一台 VPS（就近地区、512MB 起、拿到 root SSH——这是唯一要你自己做的步骤）；② 装好 Claude Code。其余交给它。

五步搞定

  1. 租一台就近的便宜 VPS（东京 / 香港 / 新加坡 / 美西均可），拿到 IP 和 root SSH。
  2. 按上面「一键安装」把 skill 装进 Claude Code。
  3. 对 Claude 说「帮我自建节点」，把 VPS 的地址和访问方式给它。
  4. 把它生成的分享链接导入你的客户端 App。
  5. 连上——出口就是你自己那台机器。

它替你把握的取舍（你不必懂）

协议 REALITY
无需域名、无需证书，混进正常 HTTPS；主动探测看到的是被借用真站的真证书。
地区就近
物理距离压倒一切——平庸线路的日本机常胜过优质线路的美国机。
出口 IP 要干净
买前/开机后先探黑名单与国内可达；不干净就重建换一个，几分钟、零影响。
够用即止
一台机器、一份配置、一个 dead-man switch 监控。不堆商用车队那套复杂度。

想深入原理？装好后 skill 自带 references/（参数、选站、客户端、排障）与 scripts/（开服、检查、发链接）。

其他安装方式（进阶）

上面的一键/手动安装是最简、最私密的方式（全程走本站、零 git 账号）。如果你想要 Claude Code 原生 /plugin 的发现 UI 与自动更新，可走 plugin marketplace——但 Claude Code 的 plugin 源只接受 git（GitHub/GitLab/Codeberg）或 npm，不接受静态文件，所以这条路必须有一个 git 托管。若在意匿名，用一个与真实身份无关的账号镜像本项目，再 /plugin marketplace add 你那个 git 源即可。

多数人用上面的一键安装即可，不需要这条。搭建 git 镜像的具体步骤见项目 README。