Claude-Guardian — 让 Agent 陪你把 Claude 环境一步步配稳的开源 Skill

Claude-Guardian 是一个给 Codex 这类编码 Agent 用的 Skill，采用 GPL-3.0-only 协议开源。它把作者和社区在 macOS、Windows、虚拟机与 VPS 上踩过的真实经验、整理好的参考资料和一批脚本打包进同一个目录，让 Agent 先问清楚你的系统、网络、预算和目标，再按你的环境一步步把订阅前准备、账号节奏、网络出口和运行环境配稳。

它本身不启动 Claude 客户端、不登录、不访问 Claude 服务，付款、注册、KYC、OAuth 全部由你本人完成，也不向你索要 IP、订阅链接、密码或完整代理配置。项目在 GitHub 上开源，属于 Skill工具类的开发者工具，也是 AI编程方向少见的环境准备包。

场景痛点

第一次准备订阅 Claude 的人，往往卡在出口 IP 干不干净、本机还是 VM 还是 VPS、防火墙怎么配、邮箱注册和 Free 到 Pro 的间隔怎么把握这些零碎问题上。网上教程东一条西一条，照着装完还是会遇到 403、429 或账单冲突，出了问题不知道该先查哪一步。每个人的系统、网络和预算都不一样，一份教程不可能适配所有情况。Claude-Guardian 把这些经验按状态机拆成上百个访谈问题，Agent 先了解你在哪一步、用什么系统，再给对应做法，风险高的步骤停下来等你拍板，而不是让你照着一篇过时教程硬配。

主要功能特点

给 Agent 用的经验与脚本包

Claude-Guardian不是桌面软件，而是放进 Codex Skill 目录的一个文件夹，里面是经验、资料和 Python 脚本。把skills/claude-guardian复制到 ~/.codex/skills 下即可，脚本需 Python 3.10+。它不自行安装代理工具。这是开源软件里把社区经验工程化的做法。

本机、VM、VPS 三条路线

Agent 先帮你在本机、虚拟机和远程 VPS 之间选一条，说清每条路线的范围和适合谁。本机路线用 Clash 或 FlClash 的 TUN 与 DNS，Windows 走系统防火墙、Mac 走 LuLu；VPS 把 Ubuntu 24.04 当开发机，配 noVNC 远程桌面。这是跨平台应用思路下的环境选择。

固定出口 IP 与网络检查

Skill 介绍机场、自建梯、家宽拼车三种出口来源的优缺点。配好后用 network_check.py 检测路由、IPv4 出口、IPv6 是否堵住和 DNS 泄露，再用 egress_verifier.py 判定整机是否只走 IPv4。线路优化含 SSH 转发和 BBR，每项可回滚。这是网络工具脚本在 AI 环境里的用法。

分级授权三档

改动按风险分三档：A 档只读诊断、查资料、出方案；B 档装客户端、加允许规则、临时切 BBR，你批准后 Agent 连续执行，失败自动撤销；C 档切默认出站为阻止、启用防火墙、改 SSH、接触 Claude，Agent 必须当场暂停等你回复。批准和确认以你在对话里的明确回复为准。这是效率工具里少见的权限分层。

故障分流与旧环境清理

遇到 403、429、529、账单冲突或疑似凭据泄露，Skill 先暂停重试、整理证据，再给下一步建议。封号后换环境时，它会规划旧设备上 Claude 残留的清理，Mac 有内置宿主脚本，Windows 写成 PowerShell 提示词。隔离默认可恢复，不永久删除。这是软件工具里容易被忽略的善后环节。

资料随答附带与离线面板

每个回答附对应来源链接，资料之外需要补充时可到 Linux.do、NodeSeek、V2EX、Reddit、X 查找并标明来源和日期。status_dashboard.py 可把已有报告做成离线 HTML 面板，不会触发新检查。作者明确说没人能保证免封，价格和准入变化快，购买前看一眼官方页面。这是开源项目里少见的诚实边界声明。

官方网站

GitHub 访问

下载地址

https://pan.quark.cn/s/884f89209973

Claude-Guardian — 让 Agent 陪你把 Claude 环境一步步配稳的开源 Skill

场景痛点