---
name: dev:model-switch
description: Switch between Claude and GLM AI models with secure token management
delegates-to: autonomous-agent:orchestrator
---

# Development Model Switch Command

Switch between Claude and GLM models in your Claude Code environment with secure token management and cross-platform compatibility.

## Usage

```bash
# Switch to GLM models (interactive setup)
/dev:model-switch --to glm

# Switch to Claude models (restore defaults)
/dev:model-switch --to claude

# Check current model configuration
/dev:model-switch --status

# Auto-switch based on task type (future feature)
/dev:model-switch --auto

# Set up initial configuration
/dev:model-switch --setup
```

## How It Works

### Model Configuration

The command modifies `~/.claude/settings.json` to configure model endpoints:

**GLM Configuration:**
```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6"
  }
}
```

**Claude Configuration (Default):**
```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_anthropic_api_key",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}
```

### Cross-Platform Implementation

**Windows (PowerShell):**
```powershell
# Create settings directory
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

# Update configuration
$config = Get-Content "$env:USERPROFILE\.claude\settings.json" | ConvertFrom-Json
$config.env.ANTHROPIC_BASE_URL = "https://api.z.ai/api/anthropic"
$config.env.ANTHROPIC_AUTH_TOKEN = $apiKey
$config | ConvertTo-Json | Set-Content "$env:USERPROFILE\.claude\settings.json"
```

**Linux/macOS (Bash):**
```bash
# Create settings directory
mkdir -p ~/.claude

# Update configuration
jq '.env.ANTHROPIC_BASE_URL = "https://api.z.ai/api/anthropic" |
jq '.env.ANTHROPIC_AUTH_TOKEN = "'$apiKey'"' ~/.claude/settings.json > ~/.claude/settings.json.tmp &&
mv ~/.claude/settings.json.tmp ~/.claude/settings.json
```

## Features

### 🔒 **Secure Token Management**

- **Token Validation**: Validates API key format before use
- **Secure Storage**: Stores tokens only in local settings file
- **Privacy First**: Never shares tokens with external services
- **Token Encryption**: Future enhancement for encrypted token storage

### 🌐 **Cross-Platform Compatibility**

- **Windows**: PowerShell script execution
- **Linux/macOS**: Bash script execution with jq fallback
- **Automatic Detection**: Detects platform and uses appropriate method
- **Fallback Options**: Manual instructions if automation fails

### 🎯 **Smart Configuration**

- **Backup Creation**: Automatically backs up current settings
- **Validation**: Validates JSON syntax before applying changes
- **Rollback**: Easy rollback to previous configuration
- **Status Checking**: Real-time configuration status display

### 🚀 **Future Automation**

- **Task-Based Switching**: Automatically switch models based on task complexity
- **Performance Optimization**: Choose models based on task requirements
- **Cost Management**: Optimize model usage for cost efficiency
- **Load Balancing**: Distribute tasks across available models

## Command Options

### Basic Switching

```bash
# Switch to GLM (interactive)
/dev:model-switch --to glm

# Switch to Claude (restore defaults)
/dev:model-switch --to claude
```

### Status and Information

```bash
# Check current configuration
/dev:model-switch --status

# Show available models
/dev:model-switch --list-models

# Validate current configuration
/dev:model-switch --validate
```

### Advanced Options

```bash
# Force switch without confirmation
/dev:model-switch --to glm --force

# Use specific GLM model
/dev:model-switch --to glm --model glm-4.6

# Backup current settings before switching
/dev:model-switch --to glm --backup

# Dry run (show changes without applying)
/dev:model-switch --to glm --dry-run
```

## Model Comparison

| Feature | Claude (Anthropic) | GLM (Z.AI) | Best For |
|---------|-------------------|-------------|-----------|
| **Response Quality** | Excellent | Very Good | General tasks |
| **Speed** | Fast | Very Fast | Quick tasks |
| **Cost** | Higher | Lower | Budget-conscious |
| **Chinese Support** | Good | Excellent | Chinese content |
| **Code Analysis** | Excellent | Good | Code review |
| **Creative Tasks** | Excellent | Very Good | Creative writing |
| **Technical Accuracy** | Excellent | Good | Technical docs |

## Security Best Practices

### 🔒 **Token Security**

- **Never share API keys** in plain text
- **Use environment variables** when possible
- **Rotate tokens regularly** for security
- **Monitor usage** for unauthorized access
- **Store securely** in encrypted format

### 🛡️ **Configuration Security**

- **Backup settings** before making changes
- **Validate JSON syntax** to prevent corruption
- **Use secure connections** (HTTPS only)
- **Close Claude windows** before applying changes
- **Verify changes** after applying

### 🔐 **Privacy Protection**

- **Local storage only** - no cloud sync of tokens
- **No telemetry** - usage data stays private
- **Secure deletion** - clear tokens when needed
- **Access control** - limit file permissions
- **Audit trail** - log configuration changes

## Examples

### Initial GLM Setup

```bash
# First-time GLM setup
/dev:model-switch --to glm

# Interactive prompts:
# 1. Enter your Z.AI API key: [sk-xxxxxxxx]
# 2. Validate API key... ✅ Valid
# 3. Back up current settings... ✅ Backed up
# 4. Apply GLM configuration... ✅ Applied
# 5. Restart Claude Code to apply changes

# Status after setup:
Current Model: GLM (glm-4.6)
API Endpoint: https://api.z.ai/api/anthropic
Token Status: ✅ Valid
Last Updated: 2025-01-26 20:45:30
```

### Quick Model Toggle

```bash
# Switch to GLM for Chinese content
/dev:model-switch --to glm --force

# Switch back to Claude for code analysis
/dev:model-switch --to claude

# Check current status
/dev:model-switch --status
```

### Advanced Configuration

```bash
# Use specific GLM model with backup
/dev:model-switch --to glm --model glm-4.5-air --backup

# Dry run to preview changes
/dev:model-switch --to glm --dry-run

# Validate configuration without switching
/dev:model-switch --validate --target glm
```

## Troubleshooting

### Common Issues

**API Key Invalid:**
```bash
# Check token format
/dev:model-switch --validate-token sk-xxxxxxxx

# Re-enter token
/dev:model-switch --to glm --renew-token
```

**Configuration Not Applied:**
```bash
# Check file permissions
/dev:model-switch --check-permissions

# Manually apply changes
/dev:model-switch --to glm --manual
```

**Model Not Responding:**
```bash
# Test API connection
/dev:model-switch --test-connection

# Switch to backup model
/dev:model-switch --fallback claude
```

### Platform-Specific Issues

**Windows PowerShell:**
```powershell
# Check PowerShell execution policy
Get-ExecutionPolicy

# Allow script execution
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

**Linux/macOS:**
```bash
# Check jq installation
jq --version

# Install jq if needed
# Ubuntu/Debian: sudo apt-get install jq
# macOS: brew install jq
# CentOS/RHEL: sudo yum install jq
```

### Recovery Options

```bash
# Restore from backup
/dev:model-switch --restore-backup

# Reset to defaults
/dev:model-switch --reset-defaults

# Generate new configuration
/dev:model-switch --generate-config
```

## Integration with Learning System

The model-switch command integrates with the autonomous learning system:

**Pattern Storage:**
```json
{
  "model_switch_patterns": {
    "task_type": "chinese_translation",
    "preferred_model": "glm",
    "success_rate": 0.92,
    "performance_improvement": "+15%",
    "cost_savings": "-40%"
  }
}
```

**Auto-Switching Logic:**
- Analyze task requirements
- Match with historical performance
- Recommend optimal model
- Learn from user choices
- Optimize for cost and quality

## Future Enhancements

### 🚀 **Planned Features**

- **Multi-Model Load Balancing**: Distribute tasks across models
- **Performance Analytics**: Track model performance metrics
- **Cost Optimization**: Automatic cost-effective model selection
- **Smart Routing**: Route tasks to best-suited models
- **Token Management**: Automated token rotation and management
- **Model Comparison**: Side-by-side model performance testing

### 🔧 **Technical Improvements**

- **Encrypted Storage**: Secure token encryption
- **API Rate Limiting**: Intelligent rate limit handling
- **Connection Pooling**: Optimized connection management
- **Caching**: Response caching for faster performance
- **Monitoring**: Real-time model performance monitoring

---

**Version**: 1.0.0
**Integration**: Uses orchestrator agent with security-patterns skill
**Platform**: Cross-platform (Windows, Linux, Mac)
**Security**: Privacy-first with secure token management