YOURSJEYO/claude-switcher

Claude 切换器 – Fail‑Closed 环境管理器（한국어 번역）

What it is – Claude AI 계정을 우발적인 IP 유출로부터 보호하는 네이티브 macOS(및 베타 Windows/Linux) 애플리케이션입니다. Claude를 시작하기 전에 네트워크 및 시스템 핑거프린트(프록시, TUN, 종료 IP, 시간대, 로케일, IPv6, DNS, WebRTC 등)에 대한 14가지 감사를 실행합니다. 어떤 검사가 실패하면 앱은 시작을 거부하여 직접 연결이 실제 IP를 노출하지 못하게 합니다.

주요 기능

기능	작동 방식
실패 시 차단 감사	14가지 환경 검사를 실행하고, 적신호가 있으면 시작을 중단합니다.
STUN 기반 WebRTC 프로브	브라우저 없이 숨겨진 IP 유출을 감지하기 위해 글로벌 및 국내 STUN 서버에 쿼리하는 수제 RFC 5389 클라이언트(Python).
킬 스위치 데몬	감시 프로세스가 10초마다 터널을 폴링하고, 프록시가 손실되면 즉시 Claude를 종료합니다.
세션 스냅샷	각 Claude 계정에는 자체 격리된 데이터 볼륨(디바이스 핑거프린트, OAuth 토큰, 로컬 상태)이 있으며 원자적으로 교체할 수 있습니다.
구성 자가 치유	감시 프로세스가 업데이트나 다른 프로세스가 재설정한 경우 프록시, 시간대, 라우팅 등을 복원합니다.
고정 라우팅	중요한 Claude 도메인은 최우선 라우팅 규칙으로 프록시를 강제하여 타사 스플릿 터널 규칙을 우회합니다.
크로스 플랫폼	macOS(SwiftUI, 외부 종속성 없음), Windows(PowerShell + WPF, 베타), Linux(bash + systemd, 베타).

설치(macOS)

git clone https://github.com/YOURSJEYO/claude-switcher.git
# double‑click installer/安装.command – it auto‑detects your proxy client, group and target region

Xcode 프로젝트 필요 없음 – SwiftUI UI는 단일 main.swift 파일에 있으며 단일 swiftc 호출로 컴파일됩니다.

일반적인 워크플로우

1. Claude 切换器를 실행하고 14가지 검사를 기다립니다(녹색 = OK, 빨간색 = 문제).
2. 모두 녹색이면 시작할 Claude 계정을 선택합니다.
3. 프록시 노드를 변경할 때 ~/.local/bin/claude-switch.sh set‑region을 실행합니다 – 스크립트가 종료 국가를 다시 감지하고 시간대와 로케일을 업데이트하고 앱 구성을 다시 씁니다.
4. 백그라운드 감시 프로세스가 드리프트(예: 프록시 클라이언트 재설정)를 자동으로 수정하고 터널이 끊어지면 Claude를 종료합니다.

왜 중요한가 – Claude(및 유사한 LLM 서비스)는 현재 다차원 위험 점수(IP, 시간대, 로케일, DNS, WebRTC, ASN 등)를 적용합니다. 실제 ISP에서 발생하는 단일 TCP SYN이 금지를 초래할 수 있습니다. 이 도구는 보호를 "프록시를 켜는 것을 기억"에서 시스템 수준 하드 블록으로 전환하여 우발적 유출을 사실상 불가능하게 만듭니다.

프로젝트 상태 – 적극적으로 유지 관리됨(로드맵: macOS 안정, Windows/Linux 베타, 향후 웹 기반 감지기 및 추가 핑거프린트 차원). MIT 라이선스, 타사 종속성 없음.

---

TL;DR – Claude Switcher는 Claude를 시작하기 전에 프록시 전용 환경을 감사하고 강제하는 보안 중심 유틸리티로, 킬 스위치, 스냅샷 기반 계정 격리, 자가 치유 구성을 갖추고 있습니다. 공격적인 남용 방지 시스템에 의해 플래그가 지정되지 않도록 해야 하는 고급 사용자에게 이상적입니다.