claude-switch 1.3.0

Anthropic Claude API 配置管理工具，支持多环境切换

Claude Switch

A Python CLI tool for managing multiple Anthropic Claude API configurations with seamless environment switching.

Features

• Multi-configuration management: Handle multiple Anthropic API configurations
• One-click switching: Switch between development, testing, and production environments
• Dual authentication: Support for both auth_token and api_key authentication methods
• Multiple credentials input: Support adding multiple keys at once (comma/space separated)
• Enhanced add command: Choose between creating new config or adding to existing ones
• Automatic environment activation: Environment variables automatically生效 after configuration switch
• Secure storage: Configuration file permission protection with encrypted credential storage
• Interactive navigation: Arrow key navigation with color highlighting
• Backup mechanism: Automatic configuration file backup to prevent data loss

Installation

uv Installation (Recommended)

# Global installation with uv (recommended)
uv pip install --user claude-switch

# Or run without installation using uvx
uvx claude-switch --help

pip Installation

pip install claude-switch

# Or using pipx (recommended to avoid dependency conflicts)
pipx install claude-switch

From Source

git clone https://github.com/elicc/claude-switch.git
cd claude-switch

# Using uv
uv pip install -e .

# Or using pip
pip install -e .

Getting Started

Initialization

After installation, initialize shell integration:

cs init

Initialization will:

• Automatically detect your shell environment (bash/zsh/fish)
• Generate dynamic shell configuration files
• Add configuration to your shell profile
• Optionally add the first configuration

Restart your terminal or run:

source ~/.claude-switch/cs-wrapper.sh

Verification

# Check version
cs --version

# View help
cs --help

# Add first configuration
cs add

Commands

Interactive Operations

• cs - Interactive configuration selection (arrow key navigation)
• cs add - Create new configuration or add credentials to existing ones
• cs css - Quick credential addition (shortcut command)

Management Commands

• cs list - List all configurations
• cs use <name> - Switch to specified configuration
• cs current - Display current configuration
• cs edit <name> - Edit configuration information
• cs remove <name> - Remove configuration
• cs add-credential [config] - Add credentials to specified configuration (or select interactively)

Environment Export

• cs current --export - Output executable export commands

Usage Examples

Adding a Configuration

# Interactive configuration addition with options
cs add
# Choose: Create new configuration OR add credentials to existing

# Quick credential addition
cs css
# Select configuration and add credentials

# Add multiple credentials at once
cs add-credential work
# Input: sk-ant-xxx|prod,sk-ant-yyy|dev,sk-ant-zzz|staging
# Or: sk-ant-xxx|prod sk-ant-yyy|dev sk-ant-zzz|staging

Viewing and Managing Configurations

# View all configurations
cs list
# Output:
# → work - 工作账号 [https://api.anthropic.com] (0tokens, 1keys) [key1]
#   personal - 个人账号 [https://api.anthropic.com] (1tokens, 0keys) [token1]

# Interactive selection
cs
# Use arrow keys to select, press Enter to confirm

# Quick switch
cs use work

Configuration Management

# Edit configuration information
cs edit work

# View current configuration
cs current
# Output: 当前配置: work - 工作账号 [https://api.anthropic.com] (0tokens, 1keys) [key1]

# Export environment variables
cs current --export
# Output: export ANTHROPIC_BASE_URL="..."; export ANTHROPIC_API_KEY="..."

Configuration Structure

Configuration is stored in ~/.claude-switch/config.json:

{
  "version": "2.0",
  "active": "work",
  "configs": {
    "work": {
      "base_url": "https://api.anthropic.com",
      "api_keys": ["sk-xxx"],
      "auth_tokens": [],
      "note": "工作账号",
      "active_key": 0,
      "active_auth": -1
    },
    "personal": {
      "base_url": "https://api.anthropic.com",
      "api_keys": [],
      "auth_tokens": ["sk-yyy"],
      "note": "个人账号",
      "active_key": -1,
      "active_auth": 0
    }
  }
}

Interactive Interface Features

• Cursor highlighting: Current selection line highlighted in green
• Status indicators: Green arrow (→) indicates active configuration
• Rich information: Shows configuration name, description, URL, credential count and type
• Arrow navigation: Supports up/down arrow key selection with Enter confirmation

Security Features

• File permissions: Configuration file automatically set to 0o600 (user-readable only)
• Sensitive information masking: Automatic credential masking during display
• Automatic backup: Automatic backup creation when configuration file is corrupted
• Version compatibility: Automatic configuration version upgrade handling

Advanced Usage

Manual Configuration Editing

You can directly edit the configuration file ~/.claude-switch/config.json. The system automatically handles format errors and creates backups.

Environment Variable Settings

# Automatic activation (requires initialization)
cs use production

# Manual activation
eval $(cs current --export)

Shell Integration

After initialization, the following aliases are automatically available:

• cs - Main command
• csu - Quick configuration switching
• csc - View current configuration
• css - Manual environment variable reload

Troubleshooting

Installation Issues

Problem: cs command not found

# Check if installed correctly
pip list | grep claude-switch

# Check PATH settings
echo $PATH

# Reinstall
pip install --force-reinstall claude-switch

Problem: Permission errors

# Use user installation with pip
pip install --user claude-switch

# Or use uv (recommended)
uv pip install --user claude-switch

# Or use pipx
pipx install claude-switch

Initialization Issues

Problem: Shell integration not working

# Manually source configuration file
source ~/.claude-switch/cs-wrapper.sh

# Check if configuration files exist
ls -la ~/.claude-switch/

# Reinitialize
cs init

Problem: Environment variables not taking effect

# Manually load environment variables
source ~/.claude-switch/env.sh

# Or use export command
eval $(cs current --export)

Compatibility

• Supported Python versions: 3.8+
• Supported operating systems: macOS, Linux, Windows
• Supported shells: bash, zsh, fish
• Supported installation methods: pip, pipx, conda, uv

Getting Help

If you encounter issues:

1. View cs --help for command assistance
2. Check configuration files in ~/.claude-switch/ directory
3. Submit an Issue on GitHub: https://github.com/elicc/claude-switch/issues

License

MIT License