claude-swap自动切换深度解析2个配置让Claude Code撞上限自动轮换不中断【免费下载链接】claude-swapSwitch between multiple Claude Code accounts, with automatic rate-limit rotation, usage dashboard, and parallel sessions项目地址: https://gitcode.com/gh_mirrors/cl/claude-swapclaude-swap 是一款面向 Claude Code 的多账号切换工具内置自动切换引擎持续监控每个账号的 5 小时/7 天额度用量在触达限流之前自动轮换到额度最充裕的账号让长时间运行的任务永不断档。本文带你用 2 个配置项把这套限流自动轮换机制完整跑起来。为什么需要自动切换账号Claude Code 的订阅账号受两层限流约束5 小时窗口和7 天窗口。重度使用下一两个小时就可能撞上限报错、干等、手动换号一气呵成。cswap auto的解法很直接前台循环默认每 60 秒轮询一次用量当当前账号的约束窗口5h/7d 中占用率更高的那个触及阈值时主动切换到额度剩余最多的账号。关键在于它是前置切换——切换发生时旧账号依然有效正在运行的 Claude Code 会在下次调用时自然拾取新凭证全程无需重启、不干扰任务。引擎在写入时持有 Claude Code 自己的凭证锁实现见 autoswitch.py所以切换永远不会和 token 刷新打架。快速上手3 步开启自动轮换# 1. 安装 uv tool install claude-swap # 或 pipx install claude-swap # 2. 录入账号先登录第 1 个账号执行 cswap add # 再登录第 2 个账号不要先 /logout再次执行 cswap add # 3. 启动自动切换 cswap auto启动后会看到一行提示例如Auto-switch running: threshold 90%, every 60s按 Ctrl-C 停止。想先观察它的决策而不实际动手加--dry-run即可。配置一切换阈值何时切autoswitch.threshold决定用掉多少时开始找下家取值 50–99.9默认90%。cswap config set autoswitch.threshold 80 # 更早切换留足缓冲为什么默认不是 100%90% 给 macOS 钥匙串约 30 秒的缓存滞后、以及一个重型子代理轮次烧过临界点都留了余量见 settings.py 中的注释。命令行参数cswap auto --threshold 80可临时覆盖适合单次实验。候选账号必须低于阈值且比当前账号好出一个迟滞幅度默认 10 个百分点这样两个都贴着线的账号绝不会来回乒乓而严格更优的账号一定会被选中。配置二轮换策略切到谁autoswitch.strategy决定目标账号怎么选只有两种取值cswap config set autoswitch.strategy best # 默认 cswap config set autoswitch.strategy consume-first # 用满优先best默认稳坐当前账号直到接近限额然后跳到额度剩余最多的账号。适合谁余粮多睡谁的日常使用。consume-first用满优先主动停留在周窗口重置时间最近的账号上专烧快过期的周额度用完了再走人。适合多账号都接近周限额、担心周额度作废的场景。两种策略的行为差异都实现在 autoswitch.py 的tick()决策循环中。进阶把单模型限额也纳入决策可选第三配置如果你主要用某一个模型、先撞它的每周单模型限额可以让引擎一并盯着cswap config set autoswitch.model Fable # 或 Fable,Opus甚至 all模型名取cswap list里每行的名称大小写不敏感。配置后即使账号的 5h/7d 窗口还有余量该模型周额度烧光时也会触发切换。安全机制它为什么不会乱切冷却时间默认两次主动切换之间至少间隔 5 分钟autoswitch.cooldownSeconds。令牌保鲜激活目标账号前会先刷新其 token刷新令牌已死的账号会被隔离并明确报告而不是带病上阵。自适应轮询正在燃烧的账号查得密、闲置账号查得稀API 流量始终平稳账号再多也不撞 Anthropic 的接口限额节奏常量集中在 poll_policy.py。状态持久化冷却与隔离记录写入autoswitch_state.json所以 cron 驱动的--once跨进程也能衔接。后台运行让 cron 替你值班--once模式只做一次检查-切换就退出退出码即结果0已切换 /1出错 /2无需动作 /3无可切换目标非常适合定时任务*/5 * * * * cswap auto --once --json ~/.cswap-auto.log 21加--json时每次 tick 输出一行 JSON 事件poll、switch、no-switch、all-exhausted等方便写脚本追踪。实时监控watch 面板自动切换开着时另开一个终端跑cswap watch即可看到每个账号 5h/7d 进度条、重置倒计时和当前活跃账号active标记切换发生在哪个窗口上一目了然图中账号 3 的 5h 窗口已达 96%红色告警而当前活跃的账号 2 还有 24% 余量——引擎会在账号 2 触及阈值前完成轮换。小结2 个配置速查配置命令默认值作用切换阈值cswap config set autoswitch.threshold 8090%约束窗口用到多少时开始找下家轮换策略cswap config set autoswitch.strategy consume-firstbest切到余量最多还是先烧快过期的配好这两项Claude Code 撞上限之前账号已经悄悄换好——你只需要继续写代码。更多细节隔离恢复、账号禁用、导出导入可参考 README.md 的 Automatic switching 章节。【免费下载链接】claude-swapSwitch between multiple Claude Code accounts, with automatic rate-limit rotation, usage dashboard, and parallel sessions项目地址: https://gitcode.com/gh_mirrors/cl/claude-swap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考