realiti4/claude-swap

Switch between multiple Claude Code accounts, with automatic rate-limit rotation, usage dashboard, and parallel sessions

What it solves

claude-swap is a multi-account manager for Claude Code (CLI and VS Code extension). It solves the problem of hitting rate limits by allowing users to easily switch between multiple Claude accounts without logging out, or by automatically rotating accounts based on remaining quota.

How it works

The tool backs up OAuth tokens and configuration for each added account. It manages these credentials securely using platform-specific methods (like macOS Keychain) and swaps the active login when a user switches accounts.

Key mechanisms include:

  • Automatic Switching: A background process monitors usage and switches to the account with the most quota left when a threshold (e.g., 90%) is reached.
  • Session Mode: Allows running Claude Code as a specific account in a single terminal session without affecting other terminals or the VS Code extension.
  • Directory Mapping: Binds specific directories to specific accounts, so cswap run automatically picks the correct account based on the repo.
  • Usage Tracking: Polls Anthropic's usage API to provide a live dashboard of 5-hour and 7-day quotas.

Who it’s for

Developers using Claude Code who manage multiple accounts to avoid rate limits or separate work and personal environments.

Highlights

  • Live Dashboard: A TUI (Terminal User Interface) and an optional macOS menu bar app for tracking usage and switching accounts.
  • Smart Rotation Strategies: Includes strategies like best (most quota left) and consume-first (prioritizes accounts resetting soonest).
  • Parallel Execution: Run multiple accounts simultaneously in different terminal sessions.
  • Safe Integration: Uses the same credential locks as Claude Code to prevent collisions during token refreshes.
  • Scripting Support: Provides JSON output for list, status, and switch commands for automation.

Related

  • Project
    Lampese/codex-switcher

    A desktop application for managing multiple OpenAI Codex accounts, allowing users to switch accounts quickly, monitor usage quotas, and schedule account warm-ups.

  • Project
    Wei-Shaw/claude-relay-service

    A self-hosted API relay service for Claude that enables multi-account management, cost-sharing, and private access to Anthropic's models.

  • Project
    cheapestinference/claude-auto-retry

    A utility for the Claude Code CLI that automatically detects rate limits and API errors, waiting for resets and sending "continue" to resume tasks without manual intervention.

  • Project
    Draculabo/AntigravityManager

    A professional multi-account manager for Google Gemini and Claude AI that automates account switching to bypass quota limits and provides a local API proxy.

  • Project
    kaitranntt/ccs

    A multi-provider profile and runtime manager for Claude Code and compatible CLIs that allows users to switch between different AI providers and accounts without changing config files.