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 輸出，便於自動化。