zhongwei/gh-bejranonda-llm-autonomous-agent-plugin-for-claude
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c5931553a6d2a912d65193a92024e9c1a689f60a
gh-bejranonda-llm-autonomou…/commands/dev/model-switch.md
Zhongwei Li c5931553a6 Initial commit
2025-11-29 18:00:50 +08:00

8.8 KiB
Raw Blame History

name, description, delegates-to
name description delegates-to
dev:model-switch Switch between Claude and GLM AI models with secure token management 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

# 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:

{
  "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):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_anthropic_api_key",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

Cross-Platform Implementation

Windows (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):

# 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

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

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

Status and Information

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

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

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

Advanced Options

# 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

# 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

# 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

# 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:

# Check token format
/dev:model-switch --validate-token sk-xxxxxxxx

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

Configuration Not Applied:

# Check file permissions
/dev:model-switch --check-permissions

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

Model Not Responding:

# Test API connection
/dev:model-switch --test-connection

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

Platform-Specific Issues

Windows PowerShell:

# Check PowerShell execution policy
Get-ExecutionPolicy

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

Linux/macOS:

# 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

# 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:

{
  "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

Reference in New Issue View Git Blame Copy Permalink