DUNHKpcc/Claude-Guardian

Claude-Guardian 是什么？

Claude-Guardian 是一个 “技能” ——一组打包的指令、参考资料和脚本——你可以提供给 AI 编码代理（特别是支持“技能”功能的代理，如 Codex）。它的作用是逐步指导你为使用 Claude（AI 助手）设置一个安全稳定的环境。

可以把它想象成一个 “清单与教练”包：代理会了解你的情况，向你提问，然后引导你完成诸如选择运行 Claude 的位置、设置固定网络出口 IP、配置防火墙以及安全管理你的账户等事项。

---

它实际上做什么？

README 列出了以下主要功能：

领域	它帮助解决什么
路线选择	选择在你的电脑上（本地）、虚拟机（VM）或远程服务器（VPS）上运行 Claude。它解释了每种方案的权衡。
固定出口 IP	解释三种获得稳定网络身份的方法：商业代理服务（“机场”服务）、自建代理和共享住宅带宽。包含 17 份 VPS 推荐报告。
账号注册	推荐适合初学者的组合（Apple 应用内购买 + Gmail/Outlook + VPS IP + VM 或本地 + Pro 计划），以及电子邮件提供商、升级时机（Free → Pro → Max）和移动端防封检查清单的指导。
支付	根据你的地区/设备/预算建议支付方式，但 你 始终自己完成支付。
VM 设置	客户机操作系统选择（Omarchy、macOS）、局域网网卡设置、构建顺序，以及“默认拒绝”防火墙脚本（默认阻止流量，除非明确允许）。
VPS 设置	使用 VPS 作为开发机器：Ubuntu 24.04、远程桌面（Xvfb + noVNC）、VS Code Remote-SSH、tmux、入站防火墙脚本。
本地设置	配置 Clash Verge / FlClash 的 TUN 模式和 DNS、Windows 防火墙、Mac 的 LuLu 防火墙——提供基于提示的指导。
整机统一出口	确保你的整个机器仅使用 IPv4（而非 IPv6），具有严格的路由、DNS 设置、泄漏检测，以及一个根据观察到的证据判断设置是否“已建立 / 已违反 / 不完整”的验证脚本。
线路优化	诊断并优化你的网络路径：SSH 动态转发、Realm 中继、BBR 拥塞控制——每次更改都会被记录并可回滚。
错误处理	指导你处理常见的 Claude 错误（403、429、529）、计费冲突和疑似凭据泄漏——暂停、收集证据，然后行动。
清理计划	规划如何从旧设备（Mac、Windows、Linux）中移除残留的 Claude 数据，以及如何在封禁后清理代理/VPN 日志和终端历史。从不永久删除——始终在你的确认下可逆。
来源链接	每个答案都包含指向来源材料的链接。也可以用作搜索工具，查找关于 VPS、住宅带宽、网络线路和封禁经验的论坛帖子。

---

关键原则（“底线”）

README 明确说明了边界：

• 金钱和账户是你的：所有支付、注册、登录、KYC 和 OAuth 都由你自己完成。
• 不请求凭据：该工具从不询问你的 IP、订阅链接、密码、UUID 或完整配置。
• 准备期间不接触 Claude：在设置过程中，它不会启动客户端、登录或访问 Claude 的服务。
• 适应你的环境：作者在自己的 Mac、Windows、VM 和 VPS 上测试过。你的系统可能不同，因此代理会验证并调整——如果出现问题则回滚。
• 不保证防封：价格和访问规则变化很快；购买前请查看官方页面。

---

工作原理

1. 你 描述你的需求和环境。
2. 代理（使用该技能）理解、判断并解释。
3. 它使用一个 访谈状态机——根据条件安排数百个问题。只有在你选择路线后，它才会询问特定路线的问题，并记录你的授权。
4. 它从 参考库（S01–S08、R01、R02 部分）中提取信息，并运行 脚本——要么你自己运行，要么代理在你的批准下运行。
5. 任何更改后都会进行 验证和回滚。

---

三级授权（你不需要每一步都在场）

更改按风险级别分类：

级别	你需要做什么	包含内容
🟢 A — 在范围内执行	选择路线后确认一次范围	只读诊断、研究、建议、试运行
🟡 B — 批准一次计划	批准单个计划；代理持续执行，失败时自动回滚	安装客户端、添加允许规则、端口转发、临时 BBR、安装 TUN
🔴 C — 每次必须确认	代理暂停并等待你的明确回复	将默认出站切换为阻止、启用防火墙、更改 SSH、持久内核更改、清理数据、任何涉及账户/金钱/凭据/组织设备或接触 Claude 本身的操作

你的批准记录在访谈状态中。如果你切换路线，需要重新确认。

---

安装

1. 将仓库中的 skills/claude-guardian 文件夹复制到你的 Codex 技能目录（例如，macOS/Linux 上的 ~/.codex/skills/，Windows 上的 %USERPROFILE%\.codex\skills）。
2. 需要支持技能的 Codex 版本，以及 Python 3.10+ 用于脚本。
3. 如果目标已存在，安装脚本会停止（以避免覆盖自定义内容）。
4. 你可以在不运行任何脚本的情况下阅读技能和参考文档。

然后在 Codex 中开始对话，例如：

$claude-guardian
I'm preparing to subscribe to Claude for the first time, using a Mac. Help me compare local vs. VM first, then decide how to check.

---

三条路线（并行选择，而非递进）

路线	最适合	关键工具
本地	直接在你的 Mac/Windows 上使用 Claude（默认推荐）	Clash Verge、FlClash、LuLu、Windows 防火墙
VM	在虚拟机中构建隔离的工作环境	Omarchy（或 Mac 主机上的 macOS）、FlClash TUN、nftables
VPS	使用远程服务器作为你的开发机器（Claude Code 在 VPS 上运行）	Ubuntu 24.04、Xvfb + noVNC、VS Code Remote-SSH、tmux

注意：使用 VPS 作为网络出口 不 等同于选择 VPS 路线。

---

包含的脚本（开发者部分）

仓库附带多个命令行工具（全部位于 skills/claude-guardian/scripts/）：

• interview_cli.py — 完整的访谈流程，支持恢复
• guardian.py — 简化访谈 + 系统/代理检查
• network_check.py — 网络诊断（路由、IPv4/IPv6、DNS 泄漏、UDP、故障演练）
• egress_verifier.py — 判断机器是否真正仅 IPv4
• status_dashboard.py — 生成离线 HTML 报告仪表板
• inventory_cli.py — 能力查询和配置审计
• agent_remediation.py — 从报告中选择修复操作
• repair_cli.py / recovery_cli.py — 精确文件修复，带收据和回滚
• cleanup_cli.py / native_cleanup_mac.py — Claude 数据清理（macOS 有内置主机）
• serve_webrtc.py — 提供本地 WebRTC 测试页面

输出文件从不覆盖现有文件——它们总是写入新文件。

---

文档与社区

• Wiki：面向用户的教程（从仓库自动生成）
• 参考文档：按主题组织（路线、账户、支付、移动端、出口 IP、防火墙、VM/VPS 指南、线路优化、事件、来源库）
• 社区：Telegram 频道和 QQ 用于分享经验；GitHub Issues 用于错误报告和建议
• 许可证：GPL-3.0-only
• 测试：单元测试、编译检查，以及 Linux/macOS/Windows 上的 CI；作者在真实硬件（Mac、Windows、VM、VPS）上验证了所有内容

---

一句话总结

Claude-Guardian 是一个引导式、注重安全的设置助手，帮助你为使用 Claude 准备一个稳定、安全的环境——而无需你的明确批准，它绝不会接触你的金钱、凭据或 Claude 本身。