Claude Multi-Account Switcher

Quickly switch between Claude accounts (subscriptions) in Claude Code inside VS Code, with live usage limits for all your accounts at a glance.

Why

You have several Claude subscriptions. When one account runs out of usage (the 5-hour or weekly window), switch Claude Code to another account with a single click — no manual logout and re-login.

Features

• Save accounts — log in normally in Claude Code, then click "Save current account"; the extension remembers the profile (tokens are kept in VS Code's encrypted secret storage).
• Fast switching — from the panel, the status bar, or the command palette (QuickPick).
• Live usage limits — utilization (%) of the 5-hour and weekly windows for each account, with time until reset. Data comes from the same source as the /usage command.
• Say Hi warmup — run a one-turn claude -p "Hi" on inactive saved accounts using --model haiku by default, without switching the active .credentials.json.
• Independent account windows — open the same project in separate VS Code windows, each with its own Claude account and CLAUDE_CONFIG_DIR.
• Login helper — opens an integrated terminal with claude auth login.
• Isolated reauthorization — if a saved profile's credentials break, re-login happens in that profile's own CLAUDE_CONFIG_DIR instead of copying the currently active account.
• Status bar — the active account and its usage % always in view.

Requirements

• Claude Code CLI is required for this extension to work correctly.
• The claude command must be available in VS Code's PATH, or claudeSwitcher.claudeCommand must point to the full path of claude, claude.exe, or claude.cmd.
• On Windows PowerShell, Claude Code CLI can be installed with:

irm https://claude.ai/install.ps1 | iex

How it works

• Claude Code credentials live in ~/.claude/.credentials.json. Switching accounts simply and safely swaps the contents of that file (a .bak backup is kept so you can undo).
• After switching you must reload the VS Code window so Claude Code picks up the new account — the extension offers to do it automatically (auto-reload can be enabled in settings).
• Saved inactive accounts are warmed up through an isolated CLAUDE_CONFIG_DIR under the extension's global storage. This lets "Say Hi" refresh/use that account without changing the currently active Claude Code account.
• Independent windows use generated .code-workspace files under the extension's global storage. Each window points Claude Code at the selected account's isolated config directory.
• Usage is read from the unofficial api.anthropic.com/api/oauth/usage endpoint (the same source as /usage). It is heavily rate-limited, so refreshing is capped to a safe interval (240s by default, minimum 180s) plus a manual ⟳ refresh.
• Token refreshes are guarded with a cross-window lock. This reduces intermittent login failures caused by two VS Code windows trying to spend the same rotating refresh token at once.

Usage

1. Log in to Claude Code with account #1.
2. Open the Claude Accounts panel (activity bar icon) → "+ Save current account".
3. Log out / log in (/login) to account #2 in Claude Code → "Save current account" again.
4. From now on, switch with one click via "Switch" on an account card (or the status bar / Claude: Switch account). After confirmation the window reloads and Claude Code runs on the selected account.

Commands

Settings

Troubleshooting Say Hi

If Say Hi reports that claude is not recognized, the VS Code extension process cannot find the Claude Code CLI. Try these in order:

1. Run where claude in PowerShell or CMD.
2. If it is found, restart VS Code so the extension host gets the refreshed PATH.
3. If it is not found, install Claude Code CLI. On Windows PowerShell, the official installer is:

irm https://claude.ai/install.ps1 | iex

4. If the command exists but VS Code still cannot see it, set claudeSwitcher.claudeCommand to the full path, for example C:\Users\you\AppData\Roaming\npm\claude.cmd or the path returned by where claude.

Parallel VS Code windows

Use Claude: Open independent account window or the Window button on an account card. The extension writes the saved account credentials to a per-account config directory, generates a .code-workspace file for the current folder/workspace, and opens it in a new VS Code window.

The default Claude Code login file is global, so two regular VS Code windows share the same active account. Independent windows avoid that by setting both:

{
  "claudeCode.environmentVariables": [
    {
      "name": "CLAUDE_CONFIG_DIR",
      "value": "C:\\Users\\you\\.claude-user2"
    }
  ],
  "claudeSwitcher.credentialsPath": "C:\\Users\\you\\.claude-user2\\.credentials.json"
}

Open one generated window per account you want to run. Avoid running two active Claude Code sessions on the same account at the same time, because the upstream refresh token still belongs to that account and can rotate.

Security and disclaimers

• This extension does not collect telemetry, analytics, account identifiers, prompts, credentials, tokens, usage data, or any other personal data.
• No login data is sent to the extension author, publisher, marketplace backend, or any custom third-party server controlled by this extension.
• Saved profile secrets are stored in VS Code's encrypted SecretStorage.
• Claude Code itself requires local .credentials.json files. For account switching, Say Hi, and independent windows, the extension writes credentials only to local Claude Code config directories on your machine, including isolated per-account CLAUDE_CONFIG_DIR folders under the extension's global storage.
• Credentials are never intentionally logged. Protect your machine and OS user account, because anyone with local filesystem access to your user profile may be able to read Claude Code credential files.
• Network requests made by the extension go only to Anthropic endpoints needed for token refresh and usage-limit checks. Say Hi is executed through the local Claude Code CLI, which communicates with Anthropic as Claude Code normally does.
• This tool is for managing your own accounts.
• The usage endpoint and the token-refresh flow are unofficial and may change or stop working on Anthropic's side.
• Currently the file-based .credentials.json model is supported (Windows/Linux). The macOS Keychain is not supported yet.

Development

npm install
npm run watch       # build in watch mode
# press F5 in VS Code -> Extension Development Host
npm run build:vsix  # build the .vsix package

License

MIT