Claude-Guardian

Agent带着真实经验，陪你把 Claude 的使用环境准备好、查清楚、用着不烧心。不要碰代过kyc(定制除外) 成品号 代充 成品邮箱 !!!

订阅前准备 · 账号注册与使用节奏 · 固定出口 IP · 本机 / VM / VPS 三条路线 · 防火墙与线路优化 · 分级授权

中文 · English

它能干什么 · 几条底线 · 怎么工作 · 分级授权 · 快速开始 · 选择运行路线 · 文档导航

GPL-3.0-only · 更新记录 · 决策记录 · 反馈问题 · LINUX DO

Claude-Guardian 是一个给 Agent 用的 Skill。它把作者和社区的真实经验、整理好的资料和一批脚本交给 Agent，让 Agent 按你的需求和环境，陪你一步步把订阅、账号、网络出口和运行环境准备好。每个人的系统、网络、预算和目标都不一样，所以它先了解你，再给适合你的做法；风险高的步骤由你拍板。

Partners

它能干什么

几条底线

• **钱和账号你来：**付款、注册、登录、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 · R01 · R02"]
    A --> X["脚本与提示词<br/>由你或经批准后运行"]
    Q --> A
    X --> V["验证与回滚"]

• **Agent 主导：**理解你的需求，挑资料，解释结果，决定下一步。同一个 Skill 对不同的人给出不同的做法。
• **状态机兜底：**上百个访谈问题按条件调度，选定路线后才问路线相关的问题；每次评估都列出要附上的资料。
• **脚本照文档跑：**VM 搭建、防火墙等脚本由你运行，或经你批准后由 Agent 运行。

分级授权：你不需要每一步都在场

只有真正重要的点才需要你。改动按风险分三档，详见分级授权：

批准和确认都以你在对话里的明确回复为准，并记录在访谈状态里；换路线后需要重新确认。

快速开始

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。该命令遇到已有目标（包括符号链接）会停止，避免嵌套复制或覆盖自定义内容；更新时先检查差异并备份，再手动迁移需要的文件。

Windows 可手动下载或克隆仓库，在自己的 Codex Skill 目录（通常为 %USERPROFILE%\.codex\skills）中创建缺少的父目录，再复制完整的 claude-guardian 文件夹。确认最终为 skills\claude-guardian\SKILL.md；若同名目标已存在，先检查、备份并手动迁移，不直接合并或覆盖。

2. 在 Codex 中开始对话

$claude-guardian
我第一次准备订阅 Claude，使用 Mac。先帮我比较本机和 VM，再决定怎么检查。

Agent 会先问你在哪个阶段、用什么系统、想达到什么目标，已经回答过的不再重复问；遇到紧急故障或清理任务会直接走对应流程。

3. 选路线，再检查

说清这次要做什么 → 选本机 / VM / VPS → 说明手上有什么网络资源 → 确认检查范围 → 检查 → 按档位批准计划

只想了解订阅或比较方案，停在解释阶段就行，不会动你的设备。

选择运行路线

三条路线是并列的选择，不是升级顺序；把 VPS 当网络出口不等于选了 VPS 路线。还没买代理或服务器也没关系，可以先做离线预检。HTTP/mixed 入口和上游 SOCKS5 出口的区别见环境入口与路线边界。

清理旧设备上的 Claude 数据：macOS 有内置宿主，见清理接口说明；Windows 按官方路径写成了 PowerShell 提示词，Linux 见 Linux 清理。封号后换环境，代理客户端日志、VPN 日志和终端历史里查 IP 的命令见环境痕迹清理；Claude 里装的破限、反代分发等非法工具见非法工具清理。

完整规则见接触与授权边界及网络证据说明。

使用示例

以下命令在仓库根目录运行。完整访谈推荐 interview_cli.py；guardian.py interview 是兼容的简化入口。

python3 skills/claude-guardian/scripts/guardian.py --help
python3 skills/claude-guardian/scripts/interview_cli.py --target-ref laptop-a --account-ref account-a

laptop-a 和 account-a 是本地别名，不是设备或账号标识。访谈默认输出下一题和阶段评估，不默认保存；明确需要保存时使用 --output，续接按 访谈说明 处理。

check 的目标绑定必须来自实际宿主与用户确认，不能补造授权。analyze / plan 处理本地结构化事实，样例见 tests/fixtures/。合成数据必须保留合成标记；导入报告不会恢复执行权限。完整契约见清单说明。

Windows 用户使用环境中实际可用的 Python 3 启动命令，例如 py -3。各入口的平台支持以对应帮助和文档为准；不能把核心跨平台测试等同于每个宿主接口均可用。

CLI 与脚本索引

下列路径均位于 skills/claude-guardian/scripts/，命令从仓库根目录执行。