DUNHKpcc/Claude-Guardian

Claude Guardian is an all-in-one Claude account safety and risk prevention skill.Claude防封实战 It intelligently assesses your device, account history, network environment, and payment options, then provides personalized guidance for local, VPS, or virtual machine setups.

Claude-Guardian이란?

Claude-Guardian은 "스킬" — 지침, 참고 자료, 스크립트를 패키지로 묶은 것 — 로, AI 코딩 에이전트(특히 "스킬" 기능을 지원하는 에이전트, 예: Codex)에 제공합니다. 그 역할은 Claude(AI 어시스턴트)를 사용하기 위한 안전하고 안정적인 환경을 설정하는 과정을 단계별로 안내하는 것입니다.

이것을 "체크리스트 및 코치 패키지" 로 생각하세요. 에이전트는 상황을 읽고 질문한 다음, Claude를 실행할 위치 선택, 고정 네트워크 출구 IP 설정, 방화벽 구성, 계정 안전 관리 등을 안내합니다.

실제로 무엇을 하나요?

README에는 다음과 같은 주요 기능이 나열되어 있습니다:

영역	도움을 주는 내용
경로 선택	자신의 컴퓨터(로컬), 가상 머신(VM), 원격 서버(VPS) 중에서 Claude를 실행할 위치를 선택합니다. 각각의 장단점을 설명합니다.
고정 출구 IP	안정적인 네트워크 ID를 얻는 세 가지 방법을 설명합니다: 상용 프록시 서비스("공항" 서비스), 자체 호스팅 프록시, 공유 주거용 대역폭. VPS 추천 보고서 17개를 포함합니다.
계정 등록	초보자에게 적합한 조합(Apple 인앱 구매 + Gmail/Outlook + VPS IP + VM 또는 로컬 + Pro 플랜)을 권장하며, 이메일 제공업체, 업그레이드 시기(Free → Pro → Max), 모바일 금지 대책 체크리스트에 대한 지침을 제공합니다.
결제	지역/기기/예산에 따라 결제 방법을 제안하지만, 귀하 가 항상 결제를 직접 완료합니다.
VM 설정	게스트 OS 선택(Omarchy, macOS), LAN 네트워크 카드 설정, 빌드 순서, "기본 거부" 방화벽 스크립트(명시적으로 허용되지 않는 한 트래픽 차단)를 제공합니다.
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에서 테스트했습니다. 시스템이 다를 수 있으므로 에이전트가 검증하고 조정하며, 문제가 발생하면 롤백합니다.
금지에 대한 보장 없음: 가격과 액세스 규칙은 빠르게 변합니다. 구매 전 공식 페이지를 확인하세요.

작동 방식

귀하 가 필요 사항과 환경을 설명합니다.
에이전트(스킬 사용)가 이해, 판단, 설명합니다.
조건에 따라 예약된 수백 개의 질문을 가진 인터뷰 상태 머신 을 사용합니다. 경로를 선택한 후에만 경로별 질문을 하고 승인을 기록합니다.
참조 라이브러리(섹션 S01–S08, R01, R02)에서 가져오고 스크립트 를 실행합니다 — 직접 실행하거나 승인을 받아 에이전트가 실행합니다.
변경 후 검증 및 롤백 이 수행됩니다.

3계층 승인(모든 단계에 참석할 필요 없음)

변경 사항은 위험 수준에 따라 분류됩니다:

계층	귀하의 행동	포함 내용
🟢 A — 범위 내 실행	경로 선택 후 범위를 한 번 확인	읽기 전용 진단, 조사, 제안, 드라이런
🟡 B — 계획을 한 번 승인	단일 계획 승인; 에이전트가 지속적으로 실행, 실패 시 자동 롤백	클라이언트 설치, 허용 규칙 추가, 포트 포워딩, 임시 BBR, TUN 설치
🔴 C — 매번 확인 필요	에이전트가 일시 중지하고 명시적 답변을 기다림	기본 아웃바운드를 차단으로 전환, 방화벽 활성화, SSH 변경, 영구 커널 변경, 데이터 정리, 계정/돈/자격 증명/조직 기기와 관련된 모든 것, 또는 Claude 자체에 접촉하는 것

승인은 인터뷰 상태에 기록됩니다. 경로를 전환하면 다시 확인해야 합니다.

설치

저장소에서 skills/claude-guardian 폴더를 Codex 스킬 디렉토리로 복사합니다(예: macOS/Linux의 ~/.codex/skills/, Windows의 %USERPROFILE%\.codex\skills).
스킬을 지원하는 Codex 버전과 스크립트용 Python 3.10+가 필요합니다.
설치 스크립트는 대상이 이미 존재하면 중지합니다(사용자 정의 콘텐츠 덮어쓰기 방지).
스크립트를 실행하지 않고 스킬 및 참조 문서를 읽을 수 있습니다.

그런 다음 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 자체에 절대 접촉하지 않습니다.