realiti4/claude-swap

项目介绍

claude-swap 解决在同一台机器上使用多个 Claude Code 账号的问题。它备份每个账号的 OAuth 凭证，切换时只替换当前登录，不必退出再重新登录；同时读取各账号的 5 小时和 7 天订阅用量。除了手动切换，它还能监控用量并在触达限额前自动轮换，或让某个终端以指定账号启动 Claude Code，其他终端仍用默认账号。CLI 和 VS Code 扩展都适用。

快速使用

需要 Python 3.12+，并已安装、登录 Claude Code。

1. 用 uv 或 pipx 安装：

   uv tool install claude-swap
   

2. 先在 Claude Code 中登录第一个账号，再注册：

   cswap add
   

3. 添加其他账号时，登录新账号后同样执行 cswap add。不要先执行 /logout，否则可能吊销旧账号的刷新令牌。

4. 查看账号与用量，然后切换：

   cswap list
   cswap switch          # 轮到下一个账号
   cswap switch 2        # 指定槽位或邮箱
   

自动切换示例（窗口用量达到 80% 时切走）：

cswap auto --threshold 80

直接运行 cswap 可打开全屏面板。Linux 和 Windows 下切换后下一条消息即生效；macOS 因 Keychain 缓存，可能延迟约 30 秒。

使用约束

claude-swap 只管理 Claude 订阅登录和 Console API key。通过 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 配置的第三方提供方不会被切换，切换后这些环境变量仍然生效，需要先取消才能使用交换后的账号。API key 账号没有订阅额度，额度感知策略不会把它当作限流账号处理。setup-token 默认显示 usage unavailable，除非开启可选的头探测，而每次探测都会在该账号上发出一次真实的小请求。导出文件默认是明文 JSON，需要加密时得自行通过 gpg 等工具处理。目录到账号的映射是单机配置，不包含在导出中。项目使用 MIT 许可证。

HotRepo 点评

2026-11-13 的 Python 日榜快照记录了 4,679 个 Star 和 506 个 Fork，当天新增 29 个 Star，在 Python 榜上的最好名次为第 11。这条单日记录只能说明当天受到关注，不足以判断长期趋势。README 对这类工具而言相当具体：写清了自动切换的判定规则、供 cron 使用的退出码、JSON 输出结构、各平台凭证存放位置，以及会话模式的边界情况，安装前就能判断是否符合自己的用法。

项目源码与说明