realiti4/claude-swap

解决的问题

claude-swap 是 Claude Code（CLI 和 VS Code 扩展）的多账户管理器。它通过允许用户在不退出登录的情况下轻松在多个 Claude 账户之间切换，或根据剩余配额自动轮换账户，解决了触达速率限制的问题。

工作原理

该工具会备份每个添加账户的 OAuth 令牌和配置。它使用平台特定的方法（如 macOS Keychain）安全地管理这些凭据，并在用户切换账户时更换当前登录状态。

关键机制包括：

• 自动切换：后台进程监控使用情况，当达到阈值（例如 90%）时，自动切换到剩余配额最多的账户。
• 会话模式：允许在单个终端会话中以特定账户运行 Claude Code，而不会影响其他终端或 VS Code 扩展。
• 目录映射：将特定目录绑定到特定账户，因此 cswap run 会根据仓库自动选择正确的账户。
• 使用情况跟踪：轮询 Anthropic 的使用情况 API，提供 5 小时和 7 天配额的实时仪表板。

适用人群

需要管理多个账户以避免速率限制或分隔工作与个人环境的 Claude Code 用户。

主要亮点

• 实时仪表板：提供 TUI（终端用户界面）和可选的 macOS 菜单栏应用，用于跟踪使用情况和切换账户。
• 智能轮换策略：包含 best（剩余配额最多）和 consume-first（即将重置的账户优先）等策略。
• 并行执行：可在不同终端会话中同时运行多个账户。
• 安全集成：使用与 Claude Code 相同的凭据锁定机制，防止令牌刷新时发生冲突。
• 脚本支持：list、status 和 switch 命令提供 JSON 输出，便于自动化。