Repo này giải quyết một nỗi đau rất cụ thể: tài khoản Claude bị khóa dù bạn chẳng làm gì sai. Tác giả gọi nó là “Fail-Closed 账号环境管理器”. Nói gọn: trước khi mở app Claude, nó chạy 14 bước kiểm tra môi trường. Chỉ cần một bước đỏ, app không được phép chạy. Không có nút “bỏ qua”. Không có “vẫn tiếp tục”. Không khởi động là không khởi động.
Cái hay nằm ở danh sách 14 bước. Nhiều người nghĩ “đổi IP là xong”, nhưng danh sách này chỉ ra những chỗ rò rỉ mà bạn thường không để ý: IPv6 dual-stack (một kênh vòng qua proxy khá kín), DNS leak qua Fake-IP, timezone lệch với geo của IP, navigator.language đọc ra tiếng Trung trong khi IP ở Mỹ, hay ASN residential với datacenter bị phân biệt rõ. Mỗi bước kiểm tra đi kèm một dòng “防什么” (chặn cái gì), đọc xong thấy rõ tác giả đã bị khóa tài khoản vì những lý do rất cụ thể.
Vì sao repo này đang được chú ý
572 sao sau 6 ngày (tạo 14/10, cập nhật 20/10/2026), phần lớn đến từ cộng đồng người dùng Claude ở Trung Quốc đang vật lộn với chuyện tài khoản bị khóa hàng loạt. Nhưng điểm khiến nó khác mấy repo “proxy tool” thông thường nằm ở triết lý thiết kế: tác giả không tin vào việc người dùng “nhớ” tắt proxy đúng lúc. Bảo vệ phải là ràng buộc vật lý ở tầng hệ thống, để “dù proxy chết, dù app tự update, dù bạn bấm nhầm, cũng không có một gói tin direct nào bay ra”.
Ba thứ kỹ thuật đáng để dev soi kỹ:
- STUN probe viết tay bằng thư viện chuẩn. Tác giả không dùng headless Chrome vì “ICE subsystem không chạy trong môi trường unattended”. Thay vào đó dùng
socketvàstructdựng thẳng Binding Request theo RFC 5389, parse XOR-MAPPED-ADDRESS. Điểm thông minh là topology cross-check: dò cả node quốc tế (Google, Cloudflare) lẫn node trong nước, nên phân biệt được “đã qua tunnel” và “lộ IP thật” mà không phụ thuộc vào việc “tình cờ timeout”. - Kill-Switch kiểu Fail-Closed. Daemon chạy chu kỳ 10 giây, kiểm tra cả process kernel lẫn virtual NIC. Tunnel đứt là kill process được bảo vệ ngay. Tác giả so sánh trực tiếp với cơ chế Fail-Open của client proxy: loại đó retry, và trong lúc retry thì gói SYN mang IP thật đã vào log gateway bên kia rồi, “thất bại” cũng không cứu được.
- Session snapshot thay vì logout/login. Mỗi tài khoản giữ volume dữ liệu riêng: fingerprint, OAuth credential, local state. Chuyển tài khoản là hoán đổi volume nguyên tử, nên phía server luôn thấy “cùng một thiết bị”. Cách này tránh được dãy authentication event và fingerprint jitter mà logout/login sinh ra.
Có thêm hai chi tiết nhỏ nhưng đọc là thấy tác giả làm nghề thật: watchdog tự phục hồi config drift (trong production của họ, TUN switch bị client proxy update reset 4 lần, timezone bị đổi ngược 8 lần), và Pinned Routing đặt domain của Claude cùng hệ sinh thái (Turnstile, Telemetry, Payment, Support) lên trên mọi ruleset chia tải của bên thứ ba, kiểu “không tin, không kiểm, miễn nhiễm với ruleset cấu hình sai”.
Cài và chạy thử
Yêu cầu: macOS, một trong Clash Verge / Shadowrocket / sing-box / ClashX / Surge với TUN bật được, Claude desktop, python3.
# 克隆后双击 installer/安装.command 即可,自动识别代理客户端、代理组名与地区目标
git clone https://github.com/YOURSJEYO/claude-switcher.git
Sau khi cài, đổi sang node quốc gia khác không cần cài lại, chạy một lệnh để re-bind region:
~/.local/bin/claude-switch.sh set-region
# 自动探测出口国家 → 改写自身配置 → 设地区格式 → 弹一次授权锁时区 → 同步看门狗
# 输出: OK:region=JP tz=Asia/Tokyo locale=ja_JP
Phiên bản Windows (windows/, PowerShell + WPF) và Linux (linux/, bash + systemd) đều đang Beta. Repo cũng có AGENTS.md, một prompt bàn giao để bạn paste cho Cursor / Claude Code / Kimi Code tự làm phần cài đặt và check môi trường, kèm luôn troubleshooting cho các lỗi tác giả từng gặp. Nghe hơi lười, nhưng với một tool đụng đến systemd, TUN và timezone thì việc có sẵn prompt cho agent là tiện thật.
Ai nên dùng
Người dùng Claude desktop ở khu vực bị chặn, đặc biệt ai đang chạy nhiều tài khoản trên cùng một máy (dev test nhiều workspace, hoặc dùng chung với nhóm). Ai chỉ dùng Claude qua browser với một tài khoản duy nhất thì tool này hơi nặng, vì nó khóa cứng vào app desktop và yêu cầu TUN hoạt động ổn định. Còn ai đã từng bị khóa oan một lần và không muốn lần hai thì đây đúng là thứ đáng thử.
Một điểm cần nói rõ: tác giả tự nhận tool chỉ chặn rò rỉ kỹ thuật, không cứu được người “tự sát”. README có hẳn mục “使用卫生与被封急救” với mấy lời khuyên khá thẳng: đừng nhét tài khoản subscription vào tool trung gian hay dịch vụ “đi chung”, card thanh toán và địa chỉ billing nên khớp với quốc gia exit IP, đừng kéo full quota mấy ngày đầu với tài khoản mới. Đây là kiểu lời khuyên chỉ viết được khi đã chứng kiến đủ người bị khóa.
Ưu, nhược và mấy điều cần cân nhắc
Ưu: logic chặn rõ ràng, có log thực chiến trong README (Kill-Switch chặn ngày 07/10, watchdog bắt drift lần thứ 8 ngày 04/10). MIT license, không có dependency bên thứ ba trong bản macOS (một file SwiftUI, compile bằng swiftc), icon sinh bằng code. Chuyện nhỏ nhưng đáng ghi nhận: repo không chứa asset thiết kế nào.
Nhược: hệ sinh thái phân mảnh, macOS là bản chính còn Windows và Linux vẫn Beta, phần Linux còn phải chuyển sang dùng login state của browser vì không có app desktop chính thức. Phần cứng: bạn phải có sẵn client proxy chạy TUN. Và quan trọng nhất, bản chất của tool là đối kháng với cơ chế chống lạm dụng của một dịch vụ cụ thể, nên mỗi lần Claude đổi risk engine thì danh sách 14 bước cũng phải đổi theo. Tác giả ghi rõ “dự án cập nhật liên tục”, nghĩa là bạn phải chấp nhận việc pull update thường xuyên, không phải cài một lần rồi quên.
Một chỗ tôi hơi lấn cấn: việc giữ nhiều tài khoản Claude trên một máy để dùng chung có thể vi phạm điều khoản dịch vụ, và chính README cũng cảnh báo “绕过封禁本身违反条款”. Tool này giảm rủi ro kỹ thuật, không hợp pháp hóa hành vi. Cân nhắc trước khi cài cho team.
Repo ở đây: YOURSJEYO/claude-switcher. Nếu bạn chỉ muốn xem cách người ta viết STUN client bằng struct thuần Python trong khoảng 100 dòng thì clone về đọc file core/stun-probe.py cũng đáng, không cần chạy.
