claude-swap
Switch between multiple Claude Code accounts, with automatic rate-limit rotation, usage dashboard, and parallel sessions
claude-swap is a multi-account manager for Claude Code that enables developers to switch between multiple Claude accounts without logging out. It provides automatic rate-limit rotation, real-time usage tracking across 5-hour and 7-day windows, and parallel session support for both the Claude Code CLI and VS Code extension. The plugin prevents workflow interruptions by proactively switching accounts before hitting rate limits and offers a live dashboard to monitor quota consumption across all registered accounts.
Key Features
Use Cases
- 01Developers managing separate work and personal Claude accounts without constant re-login
- 02Teams sharing a pool of Claude accounts to distribute usage across rate limits
- 03Power users running multiple long-running tasks in parallel across different accounts
- 04Consultants switching between client-specific Claude accounts per project directory
- 05Users monitoring quota consumption across multiple subscriptions to maximize availability
- 06Automating continuous workflows that exceed single-account rate limits
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
claude-swap — FAQ
What is claude-swap and what does it do?+
claude-swap is a plugin that manages multiple Claude Code accounts, enabling seamless switching between them and automatic rotation before rate limits are hit. It tracks usage in real-time and supports running multiple accounts in parallel sessions.
How do I install claude-swap?+
Install via uv with 'uv tool install claude-swap' or pipx with 'pipx install claude-swap'. After installation, log into Claude Code with your first account and run 'cswap add' to register it. Python 3.12+ and an existing Claude Code installation are required.
Which clients does claude-swap work with?+
claude-swap works with both the Claude Code CLI and the VS Code extension. It manages the underlying Claude Code credentials that both interfaces use.
Do I need API keys to use claude-swap?+
No API keys are required for normal OAuth-based Claude accounts. However, claude-swap also supports registering managed API keys (sk-ant-api...) or OAuth setup tokens directly via the 'cswap add-token' command.
Is claude-swap free to use?+
Yes, claude-swap is open-source software released under the MIT license. However, you still need valid Claude Code account subscriptions, each with their own rate limits and potential costs.
Do I need to restart Claude Code after switching accounts?+
Usually not. On Linux and Windows, the new account takes effect immediately on your next message. On macOS, credentials are cached for about 30 seconds by the Keychain, so the switch applies automatically after that brief delay unless you restart Claude Code for instant activation.
How do I install claude-swap?+
Open the source repository on GitHub and follow its README. claude-swap is a plugin — MCP Agents Market links you directly to the official repo.
Is claude-swap free?+
claude-swap is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.