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 を取得する 3 つの方法を説明します：商用プロキシサービス（「空港」サービス）、セルフホストプロキシ、共有住宅用帯域。17 件の VPS 推奨レポートを含みます。
アカウント登録	初心者向けの組み合わせ（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.

3 つのルート（並行選択、段階ではない）

ルート	最適な用途	主要ツール
ローカル	自分の 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 自体に触れることはありません。