YOURSJEYO/claude-switcher

选用指南

AI 根据 README 整理 · 2026/10/20 15:06:39

适用场景

适用于需要安全切换多个Claude账号、防止真实IP泄漏的用户。

查看 README 依据

<img src="assets/icon-2048.png" width="128"> </div> --- ## 为什么做这个 AI 服务平台的风控已经从"看 IP"进化到**全维度环境画像**：时区、Locale、DNS 出口、WebRTC 候选地址、设备指纹、行为时序。绝大多数封号不是因为你做错了什么，而是某个你没意识到的场景里，真实出口 IP 悄悄溜出去了一次——哪怕只是一个 TCP SYN 握手包。 本项目的立场：**防御不建立在"用户记得"上，而建立在系统级的硬性物理约束上**。 > 哪怕代理暴毙、哪怕软件静默升级、哪怕随手乱点，也绝对发不出一次直连请求。 ## 核心创新 ### 1. Block-on-Fail 环境审计引擎 每次启动前强制执行 14 项环境指纹审计，**任一指标不达标，应用物理上不会被拉起**： | # | 检查项 | 防什么 | |---|---|---| | 01 | 代理内核 | 代理根本没在跑就启动 | | 02 | TUN 网卡 | 系统代理开着但流量没被接管 | | 03 | 出口 IP | 出口国家/地区异常 | | 04 | IP 一致性 | 出口 IP 突变（跳节点是风控信号） | | 05 | 时区 | 系统时区与 IP Geo-location 冲突 |

真正的创新在**交叉验证拓扑**：探测列表同时包含全球节点（Google/Cloudflare）与国内骨干节点——走隧道时应回传代理出口 IP，裸连时国内节点必然秒回并当场抓获真实 IP。两种状态可区分、零误报、不依赖"恰好不通"。 ### 3. Fail-Closed Kill-Switch 常驻守护进程以 10s 周期巡检隧道健康度（内核进程 × 虚拟网卡双因子），隧道中断即刻终止受保护进程。区别于客户端自带的 Fail-Open 容错重试——那种机制会把含真实 IP 的握手包送到对方网关日志里，哪怕最终"超时失败"。 ### 4. Session Snapshot 快照隔离 多账号不是"登出再登入"（那会产生大量认证事件与指纹抖动），而是**物理交换数据卷**：每个账号持有独立的 Device Fingerprint、OAuth Credential 与本地状态，切换时原子化封存/载入。对服务端而言，每个账号看到的都是一台恒定不变的设备。 ### 5. 配置漂移自愈（Watchdog） 软件更新会静默重置你的安全配置（我们的生产环境里，TUN 开关被代理客户端更新重置了 4 次，系统时区被改回 8 次）。Watchdog 周期巡检 + 基线回滚 + 全程留痕，配置漂移从"事故"降级为"日志里的一行记录"。 ### 6. Pinned Routing 置顶路由

使用方式

通过双击桌面应用启动，等待14项检查全绿后选择账号启动；支持一键修复。

查看 README 依据

> **Windows 用户**：[`windows/`](windows/) 目录提供 Windows 版（PowerShell + WPF，Beta），安装与注意事项见 [windows/README.md](windows/README.md)。 > **Linux 用户**：[`linux/`](linux/) 目录提供 Linux 版（bash + systemd，Beta），设计取舍（无官方桌面版→切换浏览器登录态）见 [linux/README.md](linux/README.md)。 ```bash # 克隆后双击 installer/安装.command 即可,自动识别代理组名与时区 git clone https://github.com/YOURSJEYO/claude-switcher.git ``` ## 不会配置？交给你的 AI 仓库根目录的 [`AGENTS.md`](AGENTS.md) 是一份完整的 **Agent 交接提示词**：把它直接粘贴给你的本地模型（Kimi Code / Cursor / Claude Code 等），它会按文档自动完成环境检查、安装、配置与验收。里面还附了我们实战踩过的全部坑的排障手册。 ## 使用 1. 双击桌面「Claude切换器」→ 等待 14 项检查

2. 全绿 → 选账号启动；有红项 → 「一键修复」自动处理 3. B 账号首次使用登录一次，以后 A/B 随切随用、互不干扰 ## 项目结构 ``` ├── app/main.swift # SwiftUI 界面(单文件) ├── core/ │ ├── claude-switch.sh # 核心逻辑:审计/切换/修复 │ └── stun-probe.py # STUN 探针(手工协议实现) ├── windows/ # Windows 版(PowerShell 核心 + WPF 界面, Beta) ├── linux/ # Linux 版(bash 核心 + systemd 保镖 + 终端菜单, Beta) ├── daemons/ # Kill-Switch / Watchdog 模板 ├── installer/ # 双击安装/卸载 └── assets/ # 程序生成图标 ``` ## 二改指南 - **改界面**：编辑 `app/main.swift`，`swiftc -O -parse-as-library` 重编译即可

部署要求

需要macOS、Clash Verge（TUN可用）、Claude桌面版和python3。

查看 README 依据

目标服务全家族域名及其生态依赖（Turnstile 人机验证 / Telemetry / Payment / Support）置顶锁定代理路由，优先级高于任何第三方分流规则集——不信任、不验证、直接免疫规则库误判。 ## 实战战绩 这不是玩具项目，每个机制都有生产环境实战记录： ``` 2026-10-07 00:31:12 代理离线(内核或TUN丢失),已自动关闭 Claude ← Kill-Switch 真实拦截 2026-10-04 12:55:26 时区异常: [Asia/Shanghai] 已自动恢复 ← Watchdog 第 8 次拦截漂移 ``` ## 界面  原生 SwiftUI 单文件应用（无 Xcode 工程、无第三方依赖，`swiftc` 一条命令出可执行文件），图标由 Swift 代码程序生成——整个仓库不含一张设计素材。 ## 安装 **系统要求**：macOS · [Clash Verge](https://github.com/clash-verge-rev/clash-verge-rev)（TUN 可用）· Claude 桌面版 · python3

已知限制

Windows和Linux版本目前为Beta状态，Linux版无官方桌面版，需切换浏览器登录态。

查看 README 依据

> **Windows 用户**：[`windows/`](windows/) 目录提供 Windows 版（PowerShell + WPF，Beta），安装与注意事项见 [windows/README.md](windows/README.md)。 > **Linux 用户**：[`linux/`](linux/) 目录提供 Linux 版（bash + systemd，Beta），设计取舍（无官方桌面版→切换浏览器登录态）见 [linux/README.md](linux/README.md)。 ```bash # 克隆后双击 installer/安装.command 即可,自动识别代理组名与时区 git clone https://github.com/YOURSJEYO/claude-switcher.git ``` ## 不会配置？交给你的 AI 仓库根目录的 [`AGENTS.md`](AGENTS.md) 是一份完整的 **Agent 交接提示词**：把它直接粘贴给你的本地模型（Kimi Code / Cursor / Claude Code 等），它会按文档自动完成环境检查、安装、配置与验收。里面还附了我们实战踩过的全部坑的排障手册。 ## 使用 1. 双击桌面「Claude切换器」→ 等待 14 项检查