██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗     ██████╗ ██████╗ ██████╗ ███████╗
██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝    ██╔════╝██╔═══██╗██╔══██╗██╔════╝
██║     ██║     ███████║██║   ██║██║  ██║█████╗      ██║     ██║   ██║██║  ██║█████╗  
██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝      ██║     ██║   ██║██║  ██║██╔══╝  
╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗    ╚██████╗╚██████╔╝██████╔╝███████╗
 ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝     ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝
                                                                                         
███████╗██╗    ██╗██╗████████╗ ██████╗██╗  ██╗                                        
██╔════╝██║    ██║██║╚══██╔══╝██╔════╝██║  ██║                                        
███████╗██║ █╗ ██║██║   ██║   ██║     ███████║                                        
╚════██║██║███╗██║██║   ██║   ██║     ██╔══██║                                        
███████║╚███╔███╔╝██║   ██║   ╚██████╗██║  ██║                                        
╚══════╝ ╚══╝╚══╝ ╚═╝   ╚═╝    ╚═════╝╚═╝  ╚═╝                                        

Claude Code Switch (CCS)

一个用于管理和切换 Claude Code 模型厂商配置的命令行工具。

🌟 功能特性

• 🔄 快速切换: 一键切换不同的 Claude Code 厂商
• 📁 配置管理: 统一管理多个厂商配置
• 🔒 安全存储: 安全的 API 密钥本地存储
• 🌍 跨平台: 支持 Windows/macOS/Linux
• 🎨 友好界面: 彩色命令行界面和交互式提示
• ⚡ 环境变量: 自动管理 Claude Code 所需的环境变量

📦 安装

方式一：全局安装（推荐）

npm install -g claude-code-switch

方式二：本地开发

git clone https://github.com/your-username/claude-code-switch.git
cd claude-code-switch
npm install
npm run global-install

🔧 Windows 用户前置设置

为了在 Windows 上无需重启终端即可应用环境变量更改，需要进行一次性设置：

1. 打开 PowerShell 配置文件

# 检查配置文件是否存在
Test-Path $PROFILE

# 如果不存在，创建配置文件
if (!(Test-Path $PROFILE)) {
    New-Item -ItemType File -Path $PROFILE -Force
}

# 打开配置文件进行编辑
notepad $PROFILE

2. 添加 source 函数

在配置文件中添加以下内容：

# Claude Code Switch - Environment Refresh Function
function source {
    Write-Host "Refreshing cmd.exe environment variables from registry. Please wait..." -NoNewline

    function Set-FromReg {
        param (
            [string]$regPath,
            [string]$name,
            [string]$varName
        )
        $value = Get-ItemProperty -Path $regPath -Name $name -ErrorAction SilentlyContinue
        if ($value) {
            Set-Item -Path Env:$varName -Value $value.$name
        }
    }

    function Get-RegEnv {
        param (
            [string]$regPath
        )
        $vars = Get-Item -Path $regPath
        foreach ($var in $vars.Property) {
            if ($var -ne "Path") {
                Set-FromReg $regPath $var $var
            }
        }
    }

    # Get system and user environment variables
    Get-RegEnv "HKLM:\System\CurrentControlSet\Control\Session Manager\Environment"
    Get-RegEnv "HKCU:\Environment"

    # Special handling for PATH - combine user and system paths
    $path_HKLM = (Get-ItemProperty -Path "HKLM:\System\CurrentControlSet\Control\Session Manager\Environment").Path
    $path_HKCU = (Get-ItemProperty -Path "HKCU:\Environment").Path
    $env:Path = "$path_HKLM;$path_HKCU"

    # Save original username and architecture
    $OriginalUserName = $env:USERNAME
    $OriginalArchitecture = $env:PROCESSOR_ARCHITECTURE

    # Reset username and architecture
    $env:USERNAME = $OriginalUserName
    $env:PROCESSOR_ARCHITECTURE = $OriginalArchitecture

    Write-Host "Done."
}

3. 重新加载配置文件

# 重新加载 PowerShell 配置文件
. $PROFILE

4. 验证设置

# 测试 source 命令是否可用
Get-Command source

完成以上设置后，每次使用 ccs use 切换厂商后，只需执行 source 命令即可立即应用环境变量更改，无需重启终端。

🚀 快速开始

1. 查看帮助信息

ccs help

2. 查看所有厂商

ccs list

3. 添加GLM-4.5厂商

ccs add glm45
# 按提示输入：
# Base URL: https://open.bigmodel.cn/api/anthropic
# API Key: 你的GLM API Key

4. 切换到GLM-4.5

ccs use glm45

5. 查看当前厂商

ccs current

📋 命令详解

| 命令 | 描述 | 示例 | |------|------|------| | ccs list | 列出所有配置的厂商 | ccs list | | ccs current | 显示当前活跃厂商 | ccs current | | ccs add <name> | 添加新厂商配置 | ccs add glm45 | | ccs use <name> | 切换到指定厂商 | ccs use kimi | | ccs remove <name> | 删除厂商配置 | ccs remove qwen | | ccs help | 显示帮助信息 | ccs help |

🏢 支持的厂商

内置厂商

• anthropic: Anthropic 官方 Claude API
  • 无需配置 Base URL
  • 直接使用官方端点

支持的厂商接入

1. GLM-4.5（智谱AI）

• 获取API Key: https://bigmodel.cn/usercenter/proj-mgmt/apikeys
• Base URL: https://open.bigmodel.cn/api/anthropic
• 配置示例:

  ccs add glm45
  # Base URL: https://open.bigmodel.cn/api/anthropic
  # API Key: 你的GLM API-key

2. Kimi（月之暗面）

• 获取API Key: https://platform.moonshot.ai/
• Base URL: https://api.moonshot.ai/anthropic
• 配置示例:

  ccs add kimi
  # Base URL: https://api.moonshot.ai/anthropic
  # API Key: 你的Kimi API Key

3. Qwen Coder（阿里云）

• 获取API Key: https://bailian.console.aliyun.com/
• Base URL: https://dashscope-intl.aliyuncs.com/api/v2/apps/claude-code-proxy
• 配置示例:

  ccs add qwen
  # Base URL: https://dashscope-intl.aliyuncs.com/api/v2/apps/claude-code-proxy
  # API Key: 你的DashScope API Key

4. 自定义厂商

• 任何兼容 Anthropic API 规范的服务

📁 配置文件

配置文件位置

• Windows: %USERPROFILE%\.claude\providers.json
• macOS/Linux: ~/.claude/providers.json

配置文件格式

{
  "glm45": {
    "base_url": "https://open.bigmodel.cn/api/anthropic",
    "api_key": "your-glm-api-key"
  },
  "kimi": {
    "base_url": "https://api.moonshot.ai/anthropic",
    "api_key": "your-kimi-api-key"
  },
  "qwen": {
    "base_url": "https://dashscope-intl.aliyuncs.com/api/v2/apps/claude-code-proxy",
    "api_key": "your-dashscope-api-key"
  }
}

🔧 环境变量

工具会自动管理以下环境变量：

• ANTHROPIC_BASE_URL: API 端点地址
• ANTHROPIC_AUTH_TOKEN: API 密钥

环境变量生效

使用 ccs use 切换厂商后，工具会提示相应的刷新命令：

• Windows: 执行 source 命令（需要完成前置设置）
• macOS/Linux: 执行 source ~/.bashrc 或 source ~/.zshrc

这样无需重启终端即可立即应用环境变量更改。

💡 使用场景

开发调试

# 开发时使用国内兼容服务
ccs use glm45

# 生产环境切换到官方服务
ccs use anthropic

🔒 安全说明

• API 密钥存储在本地配置文件中
• 配置文件权限设置为仅用户可读写（Unix系统）
• 不会上传任何配置信息到网络
• 环境变量仅在本地生效

🛠️ 开发

本地开发设置

git clone https://github.com/your-username/claude-code-switch.git
cd claude-code-switch
npm install
npm run global-install

卸载

npm run global-uninstall
# 或者
npm unlink -g claude-code-switch

🐛 故障排除

1. 命令找不到

# 确保全局安装成功
npm list -g claude-code-switch

# 重新安装
npm uninstall -g claude-code-switch
npm install -g claude-code-switch

2. 环境变量不生效

# Windows: 执行 source 命令
source

# macOS/Linux: 重新加载配置
source ~/.bashrc  # 或 ~/.zshrc

3. 权限错误

# Windows: 以管理员身份运行
# macOS/Linux: 检查文件权限
ls -la ~/.claude/

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License - 详见 LICENSE 文件

⭐ 如果这个工具对你有帮助，请给个 Star！