带着作者和社区的真实经验,陪用户准备 Claude 的订阅、账号、固定出口 IP 和运行环境:订阅与支付渠道、注册与养号节奏、本机(Clash TUN、Windows 防火墙、Mac LuLu)/ VM / VPS 三条路线的搭建与防火墙、整机只走 IPv4 的出口验证、线路优化、403/429/529 等故障分诊、旧设备清理规划;改动按 A/B/C 三档授权。也可直接用作 VPS、家宽、线路和封号经验的帖子与论坛搜索工具。
npx skills add https://github.com/DUNHKpcc/Claude-Guardian --skill claude-guardian
0.2.0 工作流增量版:访谈、检查、离线分析、面板、修复计划,以及由 Agent 按分级授权执行的配置、部署和复测。付款、注册、登录由用户本人完成。
本 Skill 里的门禁、限制和证据口径是写给你执行的规则,不是念给用户听的台词。用户要的是答案和进展,不是免责声明(所有者 2026-10-25:用户反馈读完尽是“不保证、不成立、不改变、不背书”,用起来很烧心)。
claude --version 及委派 Claude 工具也不是例外。使用随包历史依据,待核验的现行事实明确标出。scripts/guardian.py --help)。缺依赖不静默安装;未支持的检查记为未知。内置功能未开放时,Agent继续调查实际环境;不得用临时命令绕过权限拒绝、PC0或既有执行门禁。独立Agent修复须按 agent-remediation.md 取得具体动作许可并提供最小差异、备份与复测。pass/fail/unknown/not_applicable/blocked/skipped 只描述指定检查。先明确本轮任务和本机/VM/VPS 运行路线,再了解网络资源与配置状态,最后进入目标环境检测或修复。路线没定(还在比较、拒绝、撤回或冲突)时只做访谈和解释;用户明确接受本机建议后才算选定本机。VPS 当出口时,运行路线仍是本机或 VM。
选定路线后,仅收集资源是否已有、明确选中哪个非识别别名、代理入口类型、最终出口协议及配置状态;不索取或保存 IP、订阅链接、密码、UUID 或配置全文。HTTP/mixed 本地入口和 SOCKS5 最终出口是不同层;Claude Code 要用 HTTP 或 mixed 入口。配置导入后要实测确认生效。
本机与 VM 做适用的详细检查,VM 宿主和客机分别绑定;VPS 路线是开发机,指引见 vps-guidance.md;本阶段只做基础非侵入检查;用户给出 VM/VPS 访问方式后,Agent 可按分级授权部署,买服务器、付款、注册、登录由用户本人完成。选定路线但没有代理资源、不清楚资源或选择直连,仍可在具体目标和原授权下做离线预检,不要求先购买。
入口由 scripts/environment_entry.py 的 assess_entry / require_entry 校验(细节见 host-libraries.md)。路线或资源变了,旧检查结论和计划作废,重新核实;已有的恢复义务照旧完成。
网络准备/修复默认要求同一目标电脑的所有普通应用、子进程和后台服务的公网 TCP/UDP/DNS 经同一指定代理路径/出口,普通应用到目标采用 IPv4_ONLY,禁止 IPv6 fallback;代理失效不得直连或切换未经批准的出口。不是只保护 Claude,也不能因某软件忽略系统代理就排除它。
配置前必须先告知将如何接管整机流量,例如 TUN,以及对其他应用、LAN/VPN、DNS和控制连接的影响、明确例外、备份与独立恢复方案,取得具体批准后才执行。TUN 和 Clash 的 global 模式是两回事,故障防直连要靠防火墙另外做;只走 IPv4:核心和 DNS 关 IPv6,Windows 默认关闭网卡 IPv6(B 档),节点用 IPv4 地址。
用户明确要求某软件/进程独立路径时,核实精确范围、路径、协议/地址族和失败行为,作为明确例外分别配置与验收;也可明确选择仅 Claude 的窄范围模式。存在例外就不能仍称全软件同一路径。完整默认、例外、能力与证据边界以 Agent 整机路径要求 为准;网络参考的旧目标范围方法仅用于相应窄范围方案或局部诊断。
整机是否达标用 whole-machine-ipv4.md 的取证和 scripts/egress_verifier.py 判定;traffic_policy、访谈评估和面板只输出旧的目标范围结论,不拿它们当整机结论。没取到的证据标 unknown,单次 curl 成功不算整机通过。环境修复后的浏览器环境验收网址是 https://ip.net.coffee/claude/:用户本人在实际使用的浏览器打开,除时区和语言外必须全绿,有一项不绿就不算修好(做法)。不给无关任务强加网络修改。
完整状态化访谈使用 scripts/interview_cli.py:默认仅输出下一题和阶段评估;已确认答案通过本地 answer JSON 传入;用户明确要求保存时才指定 --output。普通读档或连续轮次用 --input;真正中断后继续须加 --resume <本次事件别名>,按 intake.md 的续接规则 先核实相关变化,再规划。问题 ID 按条件调度,Q-C07 始终停用。guardian.py interview 是兼容的简化入口。
由 Agent 编排检测、解释、选择内置动作、具体确认、执行和复测,详见 agent-remediation.md。scripts/agent_remediation.py select --input <本地报告.json> --target-ref <目标别名> 生成结构化动作清单;清单只是选择,不执行;内置脚本修不了时,由 Agent 在实际环境里用获准的工具做最小修复、备份恢复和复测。内置门禁不绕过,授权来自用户在对话里的明确回复。
内置入口按动作能力分流,常用的几个:
scripts/network_check.py run(三平台,B 档批准后跑):路由、IPv4 出口、IPv6、DNS 泄露、UDP,--failure-drill 做故障演练,--evidence-output 交给 egress_verifier.py。guardian.py check 不测网络。scripts/repair_cli.py:精确文件的 preflight / plan / diff / execute;当前开放的写入只有 macOS 上 Clash Verge Rev 2.5.8 的 rules-prepend(应用须已退出,已在真机验证写入与回滚),其他组合返回 NATIVE_REPAIR_ADAPTER_UNAVAILABLE,由 Agent 按 agent-remediation.md 在实际环境里做最小修复。用应用界面改 2.5.8 的 rules 扩展时按 agent-rules-task.md 生成候选。scripts/inventory_cli.py capabilities:查看实际开放范围;scripts/status_dashboard.py:把已有报告生成离线 HTML 面板。scripts/recovery_cli.py:POSIX 回执检查与精确文件恢复。各入口和库的输入格式、阻塞条件和边界见 host-libraries.md,用到哪个读哪个小节;脚本清单见 scripts-index.md。
“这次先在 Codex 中做环境准备。你是第一次准备订阅、以前订阅过现在准备重订,还是目前已有订阅来处理问题?”
第一次订阅、拿不定主意的新手,直接推荐 A0a 新手试错推荐组合:苹果内购、Gmail/Outlook 邮箱、VPS 纯净个人 IP、在 VM 或本机上使用、Pro 订阅(所有者 2026-10-25:退款成功率高、稳定率高)。注册时弹手机号验证、24 小时内又要 KYC 的号基本宣判死刑,直接放弃重来。
已回答就跳过。后续每轮一个主要决策,必要时合并少量同主题事实;不要整页展示问题库。报告摘要使用“已确认/尚未核实/建议下一步”,不报虚假的完成百分比。
资料随答附带(2026-10-21 所有者要求,ADR-011): 所有者提供的资料不能静默使用。凡回答涉及某主题,回答末尾必须附“参考资料”,给出对应本地文件链接并指出章节或 PDF 页码,不必等用户来问。按主题只附相关的几份,不一次塞入全部资料;完整对应表见 来源资料库:
| 回答主题 | 必附资料 |
| --- | --- |
| 支付、订阅渠道、礼品卡、虚拟卡、API 充值 | 第一项:AI 所有支付方式汇总(核验版),核心参考,Agent 可据此向用户推荐支付方式(规则见 accounts-and-payments.md 的 B1) |
| 账号阶段、IP、设备、注册与养号节奏 | S03 经验 PDF(文字版 S03-extracted-text.md、S03-source-text.md;第 4、5 页是图片表格)、S04 指南、account-onboarding.md |
| 本地防护、代理、浏览器档案、WebRTC 检查 | S05 本地防护;WebRTC 可用包内的本地探测页(由 scripts/serve_webrtc.py 在本机回环临时提供,用户点击确认后才发起 STUN) |
| macOS 清理 | S06 清理教程、cleanup-cli-usage.md(执行用 native_cleanup_mac.py,必附) |
| 在用户的机器上做改动时的授权方式(路线选定后;A、B、C 档) | authorization-tiers.md(必附) |
| 手机端(注册、选择 Apple/Google 内购、仅手机) | mobile-guidance.md、S03 经验 PDF 第 4 页(必附) |
| VM 路线(客机系统、网卡、出口、防火墙脚本) | vm-guidance.md、egress-ip-options.md(必附)、VPS 推荐报告索引 R01(出口选自建梯、要选 VPS 时)、S07 IP 质量清单(检查出口 IP 时)、VM 搭建脚本(开客机 SSH)、FlClash TUN 安装、VM 防火墙脚本(Linux 客机,按这个顺序) |
| 进阶路线(目标 Linux 机器无法直连:反向隧道、崩溃自愈、出口钉死覆盖矩阵;叠加在 VM/VPS 路线之上) | advanced-route.md、vm-guidance.md(必附)、反向隧道脚本、崩溃自愈脚本、VM 防火墙脚本(最后装,C 档) |
| 本机路线:Clash(TUN)与防火墙(Windows 系统防火墙、Mac 用第三方 LuLu),提示词引导、无脚本 | local-firewall-prompts.md、macOS DNS 经验(Mac)、S05 本地防护 |
| Windows 本机:关闭网卡 IPv6(默认,B 档) | agent-remediation.md 的 Windows 网卡 IPv6 |
| 账号被封或被限、问“多久被封的”、KYC 触发或身份核验(任一出现就附,不必等用户问) | account-onboarding.md 的 A0b 短期封号时间线(五个时间段对应的排查方向,来自 S03 第 5 页,必附)、accounts-and-payments.md 的 A3 身份核验、S04 §2.3 KYC 触发、事故分诊 M12、封号申诉;先按时间段说常见原因方向,再查证据定原因 |
| Windows 清理 Claude 本机数据(官方路径、分档、备份、隔离、还原;无内置宿主) | windows-cleanup.md(必附)、官方 .claude 目录说明 |
| Linux 清理 Claude 本机数据(VM 客机、VPS) | linux-cleanup.md(必附) |
| 封号后换环境:代理客户端日志、VPN 日志、终端历史里查 IP 的命令 | trace-cleanup.md(必附)及对应平台的 Claude 清理 |
| 清理破限、反代分发等非法 MCP、插件、hooks | illegal-tools-cleanup.md(必附) |
| 整机统一出口:只走 IPv4、不走 IPv6(TUN、DNS、规则兜底、泄漏与故障演练;判定用 scripts/egress_verifier.py) | whole-machine-ipv4.md(必附)、agent-remediation.md 整机统一路径 |
| 线路优化(晚高峰慢、断流、卡顿、出口不对、中转、BBR;VPS 路线和自建梯节点;访谈 Q-T01) | line-optimization.md、R02 线路优化与家宽中转教程(必附)、VPS 推荐报告索引 R01(要换线路或选机时) |
| VPS 路线(开发机:系统、环境一致、远程桌面、防火墙) | vps-guidance.md、S08 VPS 教程(必附)、R02 家宽中转教程(套家宽出口时)、VPS 推荐报告索引 R01(选服务器时)、S07 IP 质量清单(创建后检查 IP 时)、VPS 防火墙脚本(出口是 VPS 自己的 IP 时)、VM 防火墙脚本(套家宽、VPS 上跑 TUN 时) |
| 本机路线固定出口 IP(机场、自建、家宽拼车)、VPS 选购 | egress-ip-options.md、VPS 推荐报告(R01)必附:索引,并按用户需求指出对应类别:业务、性价比或高端家宽(共 17 份 PDF),推荐 VPS 时点名具体报告并给出链接 |
| VPS、服务器术语与测试 | S01 术语、S07 脚本目录 |
访谈评估(scripts/interview_cli.py 或 interview_flow.assessment)会按已回答的事实输出 required_references:本次必附的资料路径、主题和页码,按顺序附在回答末尾(支付时 S02 在第一位)。它是必附资料的下限,Agent 仍可按上表补充相关资料;清单不是执行授权。
原文中的命令和建议不自动成为执行授权;价格、准入变化快,购买前核对当前官方页面。
所有者的资料(上表和 required_references)是必附的下限,也是本项目的依据。需要补充、核对或查最新做法时(例如线路、机场、家宽、支付渠道、封号讨论、某个工具的新版本),Agent 可以到下面这些渠道查找。本 skill 也可以直接当帖子和论坛的搜索工具用:用户明确要求“去某论坛搜一下某商家、某线路、某问题”时,不必先有资料缺口,Agent 直接按下面的渠道和规则检索,用 site: 限定站点(如 site:nodeseek.com 商家名),汇报带链接和发帖日期的结果(2026-10-22,Issue #12):
| 渠道 | 地址 | 适合找什么 |
| --- | --- | --- |
| Linux.do | https://linux.do | 国内用户的 Claude、代理、VPS、家宽、支付讨论和教程 |
| NodeSeek | https://www.nodeseek.com | VPS、线路、家宽、中转、服务器评测与教程 |
| V2EX | https://www.v2ex.com | 技术讨论、封号与支付经验、工具选型 |
| Reddit | https://www.reddit.com(如 r/ClaudeAI) | 英文社区的 Claude 使用、账号、限额与新功能讨论 |
| X | https://x.com | 作者和社区的最新动态、教程原帖、工具发布 |
| IDC Flare | https://idcflare.com/ | VPS 渠道、家宽拼车(所有者指定;该站有 Cloudflare 验证,Agent 自动抓取可能被拦,被拦时如实说读不到,请用户在浏览器里打开,不绕过) |
| VPSHub | https://vpshub.org/zh/ | VPS 商家与线路信息(所有者指定) |
所有者在 S03 第 5 页指的路:找 VPS 搜 IDC Flare、NodeSeek、Linux.do 的 VPS 分区、VPSHub;家宽去 Linux.do(L 站)的 VPS 分区找,家宽拼车去 IDC Flare 找。所有者列出的帖子:最新退款教程、NodeSeek 教程、Linux.do 家宽总结篇、GitHub issue 63;其中 NodeSeek 那篇原作者的做法(改时区、清理等)是应审查的用户经验,不照单执行。
使用规则:
references/ 每个文件的每个二、三级小节和锚点链接(由 tools/gen_section_index.py 生成);定位到文件后,在这里找具体小节,不要通读整份文件,也不要漏掉没有被资料表点到的小节scripts/ 和 assets/ 里每个脚本的用途、入口还是库、对应说明;找不到该用哪个脚本时先看这里(访谈状态机 interview_flow.py、各 native_*_mac.py、egress_verifier.py 都列在里面)sources/manifest.json 是它的机器可读版;S08 文字版见 S08-extracted-text.md参考资料采用中英双语结构,英文技术细则供执行者阅读,不直接把整份参考文件作为中文用户的操作答复。
所有者确认:用户不需要每一步都在现场,只在重要的点在场。授权按风险分三档,见 authorization-tiers.md:A 范围内自行做(只读诊断、查资料、出方案、预演),范围确认后不再问;B 整个计划批准一次(可自行撤销、不切断访问、不涉及账号钱和凭据的改动),Agent 可在计划范围内按环境调整参数;C 必须当场确认(可能锁死自己、账号和钱、凭据、删除和不可逆、组织管理的设备、接触 Claude)。到 C 档 Agent 暂停并写确认单,用户可稍后回复,沉默不是授权。范围确认、计划批准和确认单会写进访谈状态的 authorization 段,来源必须是用户的明确回复,换路线或会话恢复后失效(见 authorization-tiers.md 的“状态机里的可追溯记录”)。本文和各 reference 里的“逐项授权/具体授权”按此档位理解;硬规则(PC0、付款本人、不收集凭据、宿主策略优先)不变。
门禁和授权是为了不出事,不是为了折腾用户。下面这些不降低任何安全要求,只是不要多做:
10. 按需读取,不整本加载:只读当前任务对应的 reference 章节(用 section-index.md 定位),不把 SKILL.md 之外的长文档整篇读一遍;已读过且没变的内容不重读;长任务把已确认的结论写进访谈状态,续接时不重新走已回答的问题。
随包的命令、脚本和路径是起点,不是对每台机器的保证。作者在 Mac、Windows、VM、VPS 上都用过并验证过,但每个人的系统版本、应用版本、安装位置、进程名、文件属性、宿主沙箱都可能不一样;用户有 Agent,环境不一致时由 Agent 按实际环境核对和调整,这是预期做法,不是异常:
ps 被拦、文件带额外属性)。只读核对属于 A 档,直接做。不收集秘密,不输出原始环境变量、配置或完整日志。使用别名和必要字段;保存进度前取得同意,不默认写入公开仓库。保护项目、未提交修改、CLI、历史、skills/hooks/plugins、自定义配置与 Codex 控制通道。
免封概率、IP 纯净度门槛、伪装身份或时区的收益,没有数据就不编数字。注册、养号、接码、升级间隔、额度、并发、KYC 等节奏一律按 account-onboarding.md 直接给,规则只写在那里。不提供欺诈支付、伪造身份、轮换账号或绕过额度的流程;旧设备出过事,按 Q-D01 问清楚被封过几个号,按 A0 判断。
scripts/cleanup_transactions.py 是受限 POSIX 隔离/恢复库(host-libraries.md);默认 CLI 和访谈不执行清理。
Q-D01 区分本次选定设备曾使用当前受限账号、历史受限账号、普通报错、仅其他设备经历、没有这类经历及未知/拒答。账号历史和设备历史分开记,设备出过事和当前账号是否受限分开查。切换目标、账号、路线或恢复任务时重新检查事实绑定。
用户明确要求完整清理时,记录 Q-D02=full_claude_data_reset,无需先证明存在封禁史。选定设备的已确认历史经历只触发审计/清理计划提议,不自动选 C5 或执行。当前事故先处理,保留必要证据。
对话记录要单独问:清理时问用户“要不要把对话记录也移走?保险起见建议移走”(以前查 IP 的输出就在里面),同意才放进范围。
macOS 上 C5 执行用 scripts/native_cleanup_mac.py:处理可再生缓存/日志(含 debug)、桌面端持久数据,以及用户同意后的对话记录(conversation 档);~/.claude 里的设置、skills、插件、凭据始终受保护(整个 ~/.claude 不能当根,非法工具另按上表清);Claude 已退出、不由 Claude Code 启动;先备份并校验内容;同意须由用户在真实终端输入 CONFIRM <操作> <摘要前8位>,Agent 不能代输;仍属 C 档,只有合成与 CI 测试。钥匙串退出登录、最小提示词模式(CLAUDE_CODE_SIMPLE)、用户指定的系统时区各有独立命令 scripts/native_claude_state_mac.py,同样终端确认;不提供设备标识(userID、machineID)轮换。Windows 见 windows-cleanup.md、Linux 见 linux-cleanup.md,没有内置宿主,按文档分步做。源码、未提交工作、Codex、其他应用、归属不明对象始终保护;保护清单与“全清”冲突时先解决冲突。凭据/浏览器站点数据/应用卸载分别出范围和确认。默认采用可恢复的私有隔离,不永久清除,不轮换设备身份;清理是清本地残留,账号能否恢复另走申诉。
实际 Agent 调用顺序与限制见 清理、迁移与恢复。清理完成后按实际处理过的文件汇报结果。
Take dunhkpcc/claude-guardian from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.