Claude-Guardian
Agent带着真实经验，陪你把 Claude 的使用环境准备好、查清楚、用着不烧心。不要碰代过kyc(定制除外) 成品号 代充 成品邮箱 !!!
订阅前准备 · 账号注册与使用节奏 · 固定出口 IP · 本机 / VM / VPS 三条路线 · 防火墙与线路优化 · 分级授权
中文 · English
它能干什么 · 几条底线 · 怎么工作 · 分级授权 · 快速开始 · 选择运行路线 · 文档导航
GPL-3.0-only · 更新记录 · 决策记录 · 反馈问题 · LINUX DO
Claude-Guardian 是一个给 Agent 用的 Skill。它把作者和社区的真实经验、整理好的资料和一批脚本交给 Agent，让 Agent 按你的需求和环境，陪你一步步把订阅、账号、网络出口和运行环境准备好。每个人的系统、网络、预算和目标都不一样，所以它先了解你，再给适合你的做法；风险高的步骤由你拍板。
Partners
它能干什么
| 能力 | 具体做什么 |
|---|
| 🧭 | 选路线 | 帮你在本机、虚拟机（VM）、远程服务器（VPS）之间选，说清每条路线的范围、代价和适合谁 |
| 🌐 | 固定出口 IP | 介绍纯净机场、自建梯（可搭配家宽出口）、家宽拼车三种来源及优缺点；自建梯给 3x-ui + 优化线路 VPS 的简版提示；选 VPS 时附 17 份推荐报告 |
| 📝 | 注册与养号节奏 | 新手试错推荐组合（苹果内购 + Gmail／Outlook + VPS 纯净个人 IP + VM 或本机 + Pro，退款成功率高、稳定率高）；邮箱注册、Gmail / Outlook / Proton、Free → Pro → Max 的间隔、额度使用、并发、教育邮箱；手机端（iOS / Android）防封检查表 |
| 💳 | 订阅与支付 | 按你的地区、设备、预算，从《AI 所有支付方式汇总》里挑候选并说明风险；付款始终由你本人完成 |
| 🖥️ | VM 路线 | 客机系统（Omarchy / macOS）、LAN 独立网卡、搭建顺序，以及 FlClash TUN + nftables 的 fail-closed 防火墙脚本 |
| ☁️ | VPS 路线 | 把 VPS 当开发机：Ubuntu 24.04、环境一致、Xvfb + noVNC 远程桌面、VS Code Remote-SSH、tmux、入站防火墙脚本 |
| 💻 | 本机路线 | Clash Verge / FlClash 的 TUN 与 DNS 引导，Windows 系统防火墙用提示词一步步带你配，Mac 用 PF 脚本（已验收；范围） |
| 🔒 | 整机统一出口 | 整机只走 IPv4、不走 IPv6：TUN 严格路由、DNS、规则兜底、泄漏与故障演练的取证清单（Mac、Windows），egress_verifier.py 按你实际观察到的证据判定 established / violated / incomplete，不回显 IP |
| 📈 | 线路优化 | Agent 逐项诊断并优化线路：SSH 动态转发、Realm 中转、BBR，每项都有原值记录和回滚 |
| 🩺 | 故障分流 | 403 / 429 / 529、账单冲突、疑似凭据泄露：先暂停重试、整理证据，再给下一步 |
| 🧹 | 清理规划 | 规划旧设备 Claude 残留的清理（Mac、Windows、Linux），对话记录问过你再移走；封号后换环境时一并清代理客户端日志、VPN 日志和终端历史里查 IP 的命令；隔离（可恢复）由你确认，不永久删除，源码、Git 历史和 Codex 不动 |
| 📚 | 资料随答附带 | 每个回答附上对应来源链接；资料之外需要补充时，可到 Linux.do、NodeSeek、IDC Flare、V2EX、Reddit、X 查找并标明来源和日期；也可直接当 VPS、家宽、线路、封号经验的帖子与论坛搜索工具用 |
几条底线
- **钱和账号你来：**付款、注册、登录、KYC、OAuth 都由你本人完成。
- **不要你的凭据：**不用交出 IP、订阅链接、密码、UUID 或完整配置。
- **准备阶段不碰 Claude：**不启动客户端、不登录、不访问其服务。
- **按你的环境调整：**这些教程和脚本作者在自己的 Mac、Windows、VM 和 VPS 上都用过。你的系统和应用版本可能不同，Agent 会先核对、按差异调整，出问题就回滚。
- **没人能保证免封：**价格和准入变化快，购买前看一眼官方页面。
怎么工作
flowchart LR
U["你：需求和环境"] --> A["Agent<br/>理解、判断、解释"]
S["Skill<br/>经验 · 资料 · 规则"] --> A
A --> Q["访谈状态机<br/>问什么 · 附什么资料 · 授权记录"]
A --> R["资料库<br/>S01–S08 · S10 · R01 · R02"]
A --> X["脚本与提示词<br/>由你或经批准后运行"]
Q --> A
X --> V["验证与回滚"]
- **Agent 主导：**理解你的需求，挑资料，解释结果，决定下一步。同一个 Skill 对不同的人给出不同的做法。
- **状态机兜底：**上百个访谈问题按条件调度，选定路线后才问路线相关的问题；每次评估都列出要附上的资料。
- **脚本照文档跑：**VM 搭建、防火墙等脚本由你运行，或经你批准后由 Agent 运行。
分级授权：你不需要每一步都在场
只有真正重要的点才需要你。改动按风险分三档，详见分级授权：
| 档位 | 你要做什么 | 包含什么 |
|---|
| 🟢 A 范围内自行做 | 路线和目标确定后，确认一次范围 | 只读诊断、查资料、出方案、预演 |
| 🟡 B 整个计划批准一次 | 批准一张计划，Agent 连续执行，失败自动撤销 | 装客户端、加允许规则、前台转发、临时切 BBR、装 TUN |
| 🔴 C 必须当场确认 | 到这一步 Agent 暂停，你什么时候看到什么时候回复 | 切默认出站为阻止、启用防火墙、改 SSH、持久化改内核、清理数据、账号与钱、凭据、组织设备、接触 Claude |
批准和确认都以你在对话里的明确回复为准，并记录在访谈状态里；换路线后需要重新确认。
快速开始
1. 安装 Skill
将仓库中的 skills/claude-guardian 文件夹复制到你使用的 Codex Skill 目录，保留内部文件结构。分发时同时保留根目录的 LICENSE。
- 需要支持 Skills 的 Codex；脚本需要 Python 3.10+
- Skill 和参考文档可以直接阅读，不运行脚本也能查阅
- 项目不会自行安装 Python、代理工具或后台服务；部分静态 YAML 功能需要可选的 PyYAML，缺少时会停止并说明
macOS / Linux 在 Bash 中运行（已存在仓库时跳过 git clone）：
git clone https://github.com/DUNHKpcc/Claude-Guardian.git
(
set -eu
skill_root="$HOME/.codex/skills"
mkdir -p "$skill_root"
if [ -e "$skill_root/claude-guardian" ] || [ -L "$skill_root/claude-guardian" ]; then
printf '%s\n' '目标已存在，停止安装；请先检查并备份现有 Skill，再手动迁移。' >&2
exit 1
fi
cp -R Claude-Guardian/skills/claude-guardian "$skill_root/claude-guardian"
)
最终应有 ~/.codex/skills/claude-guardian/SKILL.md。该命令遇到已有目标（包括符号链接）会停止，避免嵌套复制或覆盖自定义内容；更新时先检查差异并备份，再手动迁移需要的文件。
**更新：**每次使用时 Agent 会先运行 scripts/update_check.py check（只读，只连 GitHub）和仓库 main 分支逐个文件比较，有更新就告诉你最近更新了什么；你同意后，Agent 先把当前 Skill 备份到 Skill 目录之外，保留你自己改过的文件，再换成新版，步骤见 Skill 更新。
Windows 可手动下载或克隆仓库，在自己的 Codex Skill 目录（通常为 %USERPROFILE%\.codex\skills）中创建缺少的父目录，再复制完整的 claude-guardian 文件夹。确认最终为 skills\claude-guardian\SKILL.md；若同名目标已存在，先检查、备份并手动迁移，不直接合并或覆盖。
2. 在 Codex 中开始对话
$claude-guardian
我第一次准备订阅 Claude，使用 Mac。先帮我比较本机和 VM，再决定怎么检查。
Agent 会先问你在哪个阶段、用什么系统、想达到什么目标，已经回答过的不再重复问；遇到紧急故障或清理任务会直接走对应流程。
3. 选路线，再检查
说清这次要做什么 → 选本机 / VM / VPS → 说明手上有什么网络资源 → 确认检查范围 → 检查 → 按档位批准计划
只想了解订阅或比较方案，停在解释阶段就行，不会动你的设备。
选择运行路线
| 路线 | 适合谁 | 主要内容 |
|---|
本机 Clash Verge FlClash macOS PF Windows Firewall | 直接在自己的 Mac / Windows 上用（默认推荐） | Clash 的 TUN 与 DNS、Windows 系统防火墙、Mac 的 PF，见本机的 Clash 与防火墙；出口 IP 的来源见出口来源 |
VM Omarchy macOS FlClash TUN nftables | 想在虚拟机里建一个独立的工作环境 | 客机首选 Omarchy（Mac 宿主首选 macOS），LAN 独立网卡，搭建顺序和 fail-closed 防火墙脚本见 VM 指引；目标机无法直连时的反向隧道与崩溃自愈见进阶路线 |
VPS Ubuntu 24.04 Xvfb + noVNC Remote-SSH tmux | 把远程服务器当开发机（Claude Code 跑在 VPS 上） | 环境一致、远程桌面、防火墙和线路优化，见 VPS 指引；你买好服务器、给出 SSH 后，Agent 可按分级授权帮你部署 |
三条路线是并列的选择，不是升级顺序；把 VPS 当网络出口不等于选了 VPS 路线。还没买代理或服务器也没关系，可以先做离线预检。HTTP/mixed 入口和上游 SOCKS5 出口的区别见环境入口与路线边界。
**目标机已有 Agent，直接在该机操作。**OpenSSH、Tailscale、内网穿透和远程演练属于本机高级扩展：异机协助，只有需要远程协助时才用，不是本机路线的前置步骤。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
