Claude Code Provider Switcher

A powerful CLI tool that lets you seamlessly switch between different AI providers for Claude Code, including OpenRouter, Anthropic, MiniMax, Ollama, Claude Code Proxy, and the original Claude Code configuration.

Command Aliases

Quick Tip: Use cs as a shorter alias instead of typing claude-switch!

# Both commands work the same:
claude-switch openrouter
cs openrouter  # Much shorter!

🚀 Features

• Multi-Provider Support: Switch between OpenRouter, Anthropic, MiniMax, Ollama, Claude Code Proxy, and original Claude Code
• Enhanced Interactive Menu: Beautiful, intuitive interface with visual hierarchy and icons
• Centralized Configuration: Secure, centralized base URL management for all providers
• Security-First: Explicit base URL configuration prevents URL hijacking attacks
• Default Configuration: Set and save your preferred provider and model
• Model Selection: Choose from hundreds of models across different providers
• Auto-Restart: Automatically restarts with new configuration after changes
• Cross-Platform: Works on Windows, macOS, and Linux
• Global Installation: Install once and use anywhere

📦 Installation

Prerequisites

First, ensure you have Claude Code installed.

npm install -g @anthropic-ai/claude-code

Global Installation (Method 1)

# Install globally
npm install -g @adrianr84/claude-code-provider-switch

Global Installation (Method 2 - Alternative)

# Clone the repository
git clone https://github.com/adrianR84/claude-code-provider-switch.git
cd claude-code-provider-switch

# Install globally
npm install -g .

# Or use npm link for development (changes are immediate)
npm run link

🎯 Quick Start

Basic Usage

# Show interactive menu with enhanced visual interface
claude-switch ui
cs ui  # Much shorter!

# Use a specific provider
claude-switch openrouter
cs openrouter  # Much shorter!
claude-switch anthropic
cs anthropic  # Much shorter!
claude-switch minimax
cs minimax  # Much shorter!
claude-switch ollama
cs ollama  # Much shorter!
claude-switch original
cs original  # Much shorter!

# Use specific provider with model selection
claude-switch openrouter --model
cs openrouter --model  # Much shorter!
claude-switch minimax --model
cs minimax --model  # Much shorter!

Enhanced Menu Interface

When you run claude-switch ui, you'll see a beautifully formatted interactive menu:

Claude Code Provider Switcher

Configuration: Global (~/.claude/.claude-switch-env)

Current default: OpenRouter ⭐ [DEFAULT] (openrouter/free)

Available providers:

❯ 1) OpenRouter ⭐ [DEFAULT] ── (openrouter, or, open)
  2) Ollama ── (ollama, oll)
  3) Minimax ── (minimax, min, mm)
  4) Anthropic ── (anthropic, ant)
  5) Original Claude Code ── (original, orig, def, d)
──────────────────────────────────────────────────────────
  6) ⚙️ Set as Default
  7) 🔑 Manage API Keys
  8) ❓ Help

🎯 Navigation:
  • Use ↑/↓ arrows to navigate options
  • Press Enter to select highlighted option
  • Press 1-8 for quick select
  • Press ESC to exit

⭐ Tips:
  • ⭐ indicates your current default provider
  • 🌐 Providers: Launch AI models with different services
  • 🔸 Management: Configure settings and preferences

Configuration Management

# Set up default provider and model interactively
claude-switch set-default
cs set-default  # Much shorter!

# View current defaults
claude-switch show-defaults
cs show-defaults  # Much shorter!

# Clear all defaults
claude-switch clear-defaults
cs clear-defaults  # Much shorter!

# Manage API keys interactively
claude-switch api-keys
cs api-keys  # Much shorter!

⚙️ Configuration

Security & Centralization

The CLI now features centralized base URL management for enhanced security:

• 🔒 Secure: All providers use explicitly configured base URLs from constants.js
• 🛡️ Anti-Hijacking: Prevents URL hijacking through malicious environment variables
• 📍 Centralized: Single source of truth for all provider configurations
• ✅ Consistent: Uniform behavior across all providers

Environment Variables

The CLI is designed to create a ~/.claude/.claude-switch-env (in your home directory) with this syntax:

# API Keys for different providers
OPENROUTER_AUTH_TOKEN=your_openrouter_token_here
ANTHROPIC_API_KEY=your_anthropic_key_here
MINIMAX_AUTH_TOKEN=your_minimax_token_here
OLLAMA_AUTH_TOKEN=your_ollama_token_here

# Optional: Default models for each provider
OPENROUTER_MODEL=openrouter/free
OLLAMA_MODEL=minimax-m2.5:cloud
ANTHROPIC_MODEL=claude-3-5-sonnet-latest
MINIMAX_MODEL=minimax-m2.7

# Default provider and model settings
DEFAULT_PROVIDER=default  # Use 'default' to show menu on startup, or set to 'openrouter', 'anthropic', 'minimax', 'ollama', or 'original'
DEFAULT_MODEL=

When you run the CLI for the first time, based on your selection, it will ask for the API keys or Auth Tokens and after this will be saved in the environment file for future use.

Global vs Local Configuration

The CLI supports two configuration modes:

Global Configuration (Default)

• Location: ~/.claude/.claude-switch-env (in your home directory)
• Priority: Used when no local environment file exists
• Benefit: Share configuration across all projects
• Creation: Automatically created on first run when no local environment file exists

Local Configuration

• Location: .claude-switch-env-local file in your project directory
• Priority: Overrides global configuration when present
• Benefit: Project-specific settings
• Creation: Create manually or use "Save Configuration Locally" menu option

Configuration Display

The main menu shows which configuration source is active:

Configuration: Global (~/.claude/.claude-switch-env)
Configuration: Local (current_folder/.claude-switch-env-local)

Menu Behavior

• No defaults set: Shows interactive menu for provider selection
• Defaults set: Auto-launches with configured provider
• Fresh install: Always shows menu until you set defaults

Switching Between Modes

• To Local: Use "Save Configuration Locally" option from main menu
• To Global: Delete local .claude-switch-env-local file to fall back to global config
• Priority: Local always takes precedence over global when both exist

API Key Management

For easier API key management, use the interactive menu:

# Launch interactive API key management
claude-switch api-keys
cs api-keys  # Much shorter!

Or access it through the main menu (option 6) when you run claude-switch without arguments.

Features:

• 🔐 Secure: API keys are masked for display (shows only first 4 and last 4 characters)
• 🎯 Visual: Clear status indicators (✅/❌) show which providers have keys configured
• ⚡ Interactive: Arrow key navigation with visual selection indicators and icons
• 🔄 Flexible: Update, remove, or set new API keys interactively
• 🎨 Enhanced UI: Beautiful menu with visual hierarchy and intuitive navigation

Provider Setup

OpenRouter

1. Get your API key from OpenRouter
2. Run claude-switch ui to set the API key interactively
3. Select OpenRouter from the menu to browse and choose available models

Anthropic

1. Get your API key from Anthropic Console
2. Run claude-switch ui to set the API key interactively
3. Select Anthropic from the menu to browse and choose available models

MiniMax

1. Get your API key from MiniMax Console
2. Run claude-switch ui to set the API key interactively
3. Select MiniMax from the menu to browse and choose available minimal models

Ollama

1. Install and run Ollama
2. Run claude-switch ui to set the API key interactively (optional, for remote instances)
3. Select Ollama from the menu to see locally available models

Claude Code Proxy

Use Claude Code with OpenAI, Gemini, or other LiteLLM backends through a local proxy server.

1. Install the proxy server:

   Docker (recommended):

   git clone https://github.com/1rgs/claude-code-proxy.git
   cd claude-code-proxy
   cp .env.example .env
   # Edit .env: set OPENAI_API_KEY (required), GEMINI_API_KEY, etc.
   docker run -d --env-file .env -p 8082:8082 ghcr.io/1rgs/claude-code-proxy:latest

   Or from source:

   git clone https://github.com/1rgs/claude-code-proxy.git
   cd claude-code-proxy
   cp .env.example .env
   # Edit .env: set OPENAI_API_KEY (required)
   uv run uvicorn server:app --host 0.0.0.0 --port 8082

2. Run claude-switch proxy — if the proxy is running, Claude Code launches immediately with ANTHROPIC_BASE_URL=http://localhost:8082

3. Set a default model: add PROXY_MODEL=gpt-4o to your env file

📋 Commands Reference

Provider Commands

| Command | Description | Example | | ------------ | ------------------------------- | ---------------------------- | | openrouter | Use OpenRouter provider | claude-switch openrouter | | anthropic | Use Anthropic provider | claude-switch anthropic | | minimax | Use MiniMax provider | claude-switch minimax | | ollama | Use Ollama provider | claude-switch ollama | | proxy | Use Claude Code Proxy (LiteLLM) | claude-switch proxy | | original | Use original Claude Code | claude-switch original |

Note: All examples also work with the shorter cs alias (e.g., cs openrouter, cs anthropic, cs minimax, cs ollama, cs original)

Model Selection

| Command | Description | Example | | -------------------- | ------------------------- | ---------------------------------- | | <provider> --model | Select model for provider | claude-switch openrouter --model | | minimax --model | Select MiniMax model | claude-switch minimax --model |

Configuration Commands

| Command | Description | Example | | ---------------- | ----------------------------- | ------------------------------ | | set-default | Interactive default setup | claude-switch set-default | | show-defaults | View current defaults | claude-switch show-defaults | | clear-defaults | Reset all defaults | claude-switch clear-defaults | | api-keys | Manage API keys interactively | claude-switch api-keys | | help | Show help information | claude-switch --help | | version | Show Version information | claude-switch --version |

Note: All commands also work with the shorter cs alias (e.g., cs --help, cs --version, cs set-default, cs clear-defaults)

Aliases

| Command | Aliases | | ------------ | ------------------------------ | | openrouter | or, open | | anthropic | ant | | minimax | min, mm | | ollama | oll | | original | original, orig, def, d |

⚠️ IMPORTANT: Extra Arguments with Default Provider

When a default provider is set, extra arguments are automatically passed to Claude Code:

claude-switch --continue           # Continue previous conversation
cs --continue  # Much shorter!       # Continue previous conversation
claude-switch --resume            # Resume last session
cs --resume  # Much shorter!        # Resume last session
claude-switch -p "Explain what this project does"  # Quick prompt without interactive mode
cs -p "Explain what this project does"  # Much shorter!  # Quick prompt without interactive mode
claude-switch -p "List all providers supported" --output-format json  # Get structured JSON output
cs -p "List all providers supported" --output-format json  # Much shorter!  # Get structured JSON output

This means you can use Claude Code with your default provider seamlessly after setting a default provider, also passing extra arguments like --continue, --resume, etc.

⚠️ Important: Clearing Defaults

If the interactive menu doesn't show and Claude Code opens directly with a predefined provider, you need to clear the default settings:

claude-switch clear-defaults
cs clear-defaults  # Much shorter!

Why This Happens

When you use the "Set as Default" option, the application saves your provider and model choices to provide a faster experience. However, if you want to change providers or access the full menu again, you must clear these defaults first with claude-switch clear-defaults

🎨 Enhanced Menu Features

The interactive menu includes several visual enhancements:

Visual Elements

• Icons: Management options have intuitive icons (⚙️ Settings, 🔑 Keys, ❓ Help, etc.)
• Color Coding: Different colors for different option types
• Star Indicator: ⭐ shows your current default provider
• Separator Line: Clean visual separation between providers and management options
• Inline Aliases: Provider aliases displayed on the same line for cleaner layout

Navigation Improvements

• Arrow Keys: Smooth up/down navigation with visual feedback
• Quick Select: Press number keys for instant selection
• ESC Support: Exit the menu cleanly
• Visual Selection: Clear indicator (❯) shows currently selected option

🔧 Advanced Usage

Programmatic API

You can also use this package as a module in your Node.js applications:

const {
  setDefaultProvider,
  getDefaultProvider,
  launchOpenRouter,
  launchAnthropic,
  showApiKeyMenu,
  updateApiKey,
  maskApiKey,
} = require("@adrianr84/claude-code-provider-switch");

// Set default provider programmatically
await setDefaultProvider("openrouter");

// Get current provider
const current = getDefaultProvider();
console.log(`Current provider: ${current}`);

// Launch specific provider
await launchOpenRouter(false, [], "gpt-4");

// Manage API keys programmatically
await showApiKeyMenu(); // Show interactive API key menu
await updateApiKey({
  id: "openrouter",
  name: "OpenRouter",
  envVar: "OPENROUTER_AUTH_TOKEN",
}); // Update specific API key
console.log(maskApiKey("sk-1234567890abcdef")); // "sk-1234...cdef"

Development

# Install for development with symlink (changes are immediate)
npm run link

# Run directly from source
npm run dev -- --help
cs --help  # Much shorter!

# Run tests
npm run test:all

# Unlink development version
npm run unlink

# Install production version
npm install -g .

🐛 Troubleshooting

Common Issues

"API key required" error

• Check your environment file contains the correct API key
• Ensure the environment file is in your current working directory

Menu selection not showing options, opens Claude Code directly

• Try clearing defaults: claude-switch clear-defaults (or cs clear-defaults)

File permission errors

• Ensure you have write permissions to create/modify the environment file
• Try running with elevated permissions if necessary

Debug Mode

For debugging, you can run the tool directly from source:

node bin/claude-switch.js --help

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Development Scripts

• npm run dev - Run directly from source
• npm run test:validation - Run validation tests
• npm run test:provider - Run provider integration tests
• npm run test:comprehensive - Run comprehensive tests
• npm run test:all - Run all test suites

📄 License

MIT License - see LICENSE file for details

🔗 Related Projects

• Claude Code - Official Claude Code repository
• OpenRouter - Unified API for AI models
• Ollama - Local AI model deployment

📞 Support

If you encounter any issues or have questions:

1. Check the troubleshooting section above
2. Search existing GitHub issues
3. Create a new issue with detailed information
4. Include your OS, Node.js version, and error messages

Made with ❤️ by Adrian R