realiti4/claude-swap

何を解決するか

claude-swap は Claude Code（CLI および VS Code 拡張機能）用のマルチアカウントマネージャーです。ユーザーがログアウトせずに複数の Claude アカウントを簡単に切り替えられるようにするか、残りクォータに基づいてアカウントを自動的にローテーションすることで、レート制限に達する問題を解決します。

動作方法

このツールは、追加された各アカウントの OAuth トークンと設定をバックアップします。各アカウントの資格情報を、プラットフォーム固有の方法（例：macOS Keychain）を使って安全に管理し、ユーザーがアカウントを切り替えると、アクティブなログインを切り替えます。

主なメカニズムは以下の通りです：

• 自動切り替え：バックグラウンドプロセスが使用状況を監視し、しきい値（例：90%）に達した時点で、残りクォータが最も多いアカウントに自動的に切り替えます。
• セッションモード：1つのターミナルセッション内で特定のアカウントとして Claude Code を実行できるモードで、他のターミナルや VS Code 拡張機能には影響しません。
• ディレクトリマッピング：特定のディレクトリを特定のアカウントに紐づけ、cswap run を実行すると、リポジトリに応じて正しいアカウントを自動的に選択します。
• 使用状況の追跡：Anthropic の使用状況 API をポーリングして、5時間および7日間のクォータのライブダッシュボードを提供します。

対象ユーザー

レート制限を回避するため、または業務と個人の環境を分けるために複数のアカウントを管理する開発者。

主な特徴

• ライブダッシュボード：TUI（ターミナルユーザーインターフェース）と、オプションの macOS メニューバー アプリで使用状況を追跡し、アカウントを切り替えられます。
• スマートなローテーション戦略：best（残りクォータが最も多い）や consume-first（リセットが最も早い）などの戦略を含みます。
• 並列実行：複数のアカウントを異なるターミナルセッションで同時に実行できます。
• 安全な統合：Claude Code と同じ資格情報ロックを使用して、トークンのリフレッシュ中に競合を防ぎます。
• スクリプト対応：list、status、switch コマンドの JSON 出力により、自動化が可能になります。