claude-code-model-switch 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Claude Code Model Switch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# Claude Code Model Switch (CCMS)
+
+A CLI tool for switching between different AI models in Claude Code.
+
+## 🚀 Features
+
+- Quickly switch AI models used by Claude Code
+- Support for multiple pre-configured model environments
+- Automatic handling of model-related environment variables
+- Simple command-line interface
+- Secure configuration management - only modifies model-related settings
+- Reset to official models with unset command
+
+## 📦 Installation
+
+```bash
+npm install -g claude-code-model-switch
+```
+
+## 🛠️ Usage
+
+### Basic Commands
+
+```bash
+# Switch to specified model
+ccms deepseek-chat
+
+# Or use switch subcommand
+ccms switch deepseek-chat
+
+# List all available models
+ccms list
+
+# Show configuration file paths
+ccms config-path
+
+# Remove all model-related configuration and use official models
+ccms unset
+```
+
+### Model Configuration
+
+Edit the configuration file `~/.claude-code-model-switch/settings.json`:
+
+```json
+{
+  "models": {
+    "deepseek-chat": {
+      "ANTHROPIC_AUTH_TOKEN": "sk-your-token-here",
+      "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
+      "ANTHROPIC_MODEL": "deepseek-chat",
+      "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat",
+      "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
+      "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat",
+      "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
+      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
+    },
+    "claude-3-5-sonnet": {
+      "ANTHROPIC_AUTH_TOKEN": "your-anthropic-token-here",
+      "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
+      "ANTHROPIC_MODEL": "claude-3-5-sonnet-20241022",
+      "ANTHROPIC_SMALL_FAST_MODEL": "claude-3-haiku-20240307",
+      "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-3-5-sonnet-20241022",
+      "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-3-opus-20240229",
+      "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
+      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "0"
+    }
+  }
+}
+```
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `ANTHROPIC_AUTH_TOKEN` | ✅ | - | API authentication token |
+| `ANTHROPIC_BASE_URL` | ✅ | - | API base URL |
+| `ANTHROPIC_MODEL` | ✅ | - | Main model name |
+| `ANTHROPIC_SMALL_FAST_MODEL` | ❌ | Same as `ANTHROPIC_MODEL` | Small fast model |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ❌ | Same as `ANTHROPIC_MODEL` | Default Sonnet model |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ❌ | Same as `ANTHROPIC_MODEL` | Default Opus model |
+| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ❌ | `8192` | Maximum output tokens |
+| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | ❌ | `1` | Disable non-essential traffic |
+
+### Special Rules
+
+1. **Secure Configuration**: The tool only modifies model-related environment variables and won't touch other fields in the configuration file
+2. **Default Values**:
+   - `CLAUDE_CODE_MAX_OUTPUT_TOKENS` defaults to `8192`
+   - `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` defaults to `1`
+   - Unset model fields automatically use the value of `ANTHROPIC_MODEL`
+3. **Configuration File**: Empty configuration file `{"models": {}}` is automatically created on first run
+4. **Unset Command**: The `ccms unset` command removes only model-specific variables while preserving `CLAUDE_CODE_MAX_OUTPUT_TOKENS` and `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`
+
+## 📁 File Locations
+
+- Claude settings file: `~/.claude/settings.json`
+- Model configuration file: `~/.claude-code-model-switch/settings.json`
+
+## 🔧 Development
+
+```bash
+# Clone repository
+git clone https://github.com/musnows/claude-code-model-switch.git
+cd claude-code-model-switch
+
+# Install dependencies
+npm install
+
+# Global link (for development)
+npm link
+```
+
+## 📄 License
+
+MIT License
+
+## 🤝 Contributing
+
+Issues and Pull Requests are welcome!
+
+## 🔗 Repository
+
+https://github.com/musnows/claude-code-model-switch

package/README_CN.md

@@ -0,0 +1,126 @@
+# Claude Code Model Switch (CCMS)
+
+一个用于 Claude Code 的模型切换器，可以轻松在不同 AI 模型之间切换。
+
+## 🚀 功能特性
+
+- 快速切换 Claude Code 使用的 AI 模型
+- 支持多个预配置模型环境
+- 自动处理模型相关环境变量
+- 命令行界面，操作简单
+- 安全的配置管理，只修改模型相关设置
+- 使用 unset 命令重置为官方模型
+
+## 📦 安装
+
+```bash
+npm install -g claude-code-model-switch
+```
+
+## 🛠️ 使用方法
+
+### 基本命令
+
+```bash
+# 切换到指定模型
+ccms deepseek-chat
+
+# 或者使用 switch 子命令
+ccms switch deepseek-chat
+
+# 列出所有可用模型
+ccms list
+
+# 查看配置文件路径
+ccms config-path
+
+# 清除所有模型相关配置，恢复使用官方模型
+ccms unset
+```
+
+### 配置模型
+
+编辑配置文件 `~/.claude-code-model-switch/settings.json`：
+
+```json
+{
+  "models": {
+    "deepseek-chat": {
+      "ANTHROPIC_AUTH_TOKEN": "sk-your-token-here",
+      "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
+      "ANTHROPIC_MODEL": "deepseek-chat",
+      "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat",
+      "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
+      "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat",
+      "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
+      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
+    },
+    "claude-3-5-sonnet": {
+      "ANTHROPIC_AUTH_TOKEN": "your-anthropic-token-here",
+      "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
+      "ANTHROPIC_MODEL": "claude-3-5-sonnet-20241022",
+      "ANTHROPIC_SMALL_FAST_MODEL": "claude-3-haiku-20240307",
+      "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-3-5-sonnet-20241022",
+      "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-3-opus-20240229",
+      "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
+      "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "0"
+    }
+  }
+}
+```
+
+## ⚙️ 配置说明
+
+### 环境变量说明
+
+| 变量名 | 必填 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `ANTHROPIC_AUTH_TOKEN` | ✅ | - | API 认证令牌 |
+| `ANTHROPIC_BASE_URL` | ✅ | - | API 基础 URL |
+| `ANTHROPIC_MODEL` | ✅ | - | 主模型名称 |
+| `ANTHROPIC_SMALL_FAST_MODEL` | ❌ | 同 `ANTHROPIC_MODEL` | 小型快速模型 |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ❌ | 同 `ANTHROPIC_MODEL` | 默认 Sonnet 模型 |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ❌ | 同 `ANTHROPIC_MODEL` | 默认 Opus 模型 |
+| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ❌ | `8192` | 最大输出令牌数 |
+| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | ❌ | `1` | 禁用非必要流量 |
+
+### 特殊规则
+
+1. **安全配置**：工具只会修改与模型相关的环境变量，不会触及配置文件中的其他字段
+2. **默认值处理**：
+   - `CLAUDE_CODE_MAX_OUTPUT_TOKENS` 默认为 `8192`
+   - `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 默认为 `1`
+   - 未设置的模型字段会自动使用 `ANTHROPIC_MODEL` 的值
+3. **配置文件**：首次运行时会自动创建空的配置文件 `{"models": {}}`
+4. **Unset 命令**：`ccms unset` 命令只删除模型特定的变量，同时保留 `CLAUDE_CODE_MAX_OUTPUT_TOKENS` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`
+
+## 📁 文件位置
+
+- Claude 设置文件：`~/.claude/settings.json`
+- 模型配置文件：`~/.claude-code-model-switch/settings.json`
+
+## 🔧 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/musnows/claude-code-model-switch.git
+cd claude-code-model-switch
+
+# 安装依赖
+npm install
+
+# 全局链接（开发用）
+npm link
+```
+
+## 📄 许可证
+
+MIT License
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 🔗 开源地址
+
+https://github.com/musnows/claude-code-model-switch

package/index.js

@@ -73,6 +73,7 @@ function getModelConfig(modelName) {
   if (!config.models || !config.models[modelName]) {
     console.error(`Error: Model "${modelName}" not found`);
     console.log('Available models:', Object.keys(config.models || {}).join(', ') || 'None');
+    console.log('Run "ccms --help" to see available commands');
     process.exit(1);
   }
 
@@ -81,6 +82,7 @@ function getModelConfig(modelName) {
   // Check if model configuration is empty
   if (Object.keys(modelConfig).length === 0) {
     console.error(`Error: Model "${modelName}" configuration is empty`);
+    console.log('Run "ccms --help" to see available commands');
     process.exit(1);
   }
 
@@ -184,7 +186,7 @@ function isValidModel(modelName) {
 program
   .name('ccms')
   .description('Claude Code Model Switch - Switch Claude Code models')
-  .version('1.0.0')
+  .version('1.0.2')
   .argument('[model]', 'Model name to switch to')
   .action((model) => {
     if (model) {
@@ -206,6 +208,7 @@ program
           config.models[name] && Object.keys(config.models[name]).length > 0
         );
         console.log('Available models:', validModels.join(', ') || 'None');
+        console.log('Run "ccms --help" to see available commands');
         process.exit(1);
       }
     } else {
@@ -229,12 +232,60 @@ program
     listModels();
   });
 
+// Unset all model-related configuration
+function unsetModelConfig() {
+  const settings = loadClaudeSettings();
+
+  // Ensure env object exists
+  if (!settings.env) {
+    settings.env = {};
+  }
+
+  // Model-related environment variables to remove (excluding some settings)
+  const modelEnvVars = [
+    'ANTHROPIC_AUTH_TOKEN',
+    'ANTHROPIC_BASE_URL',
+    'ANTHROPIC_MODEL',
+    'ANTHROPIC_SMALL_FAST_MODEL',
+    'ANTHROPIC_DEFAULT_SONNET_MODEL',
+    'ANTHROPIC_DEFAULT_OPUS_MODEL'
+  ];
+
+  let removedCount = 0;
+  const removedVars = [];
+
+  // Remove only existing model-related environment variables
+  for (const key of modelEnvVars) {
+    if (settings.env.hasOwnProperty(key)) {
+      delete settings.env[key];
+      removedCount++;
+      removedVars.push(key);
+    }
+  }
+
+  saveClaudeSettings(settings);
+
+  if (removedCount > 0) {
+    console.log(`Removed ${removedCount} model-related configurations: ${removedVars.join(', ')}`);
+    console.log('Restored to use claude official models');
+  } else {
+    console.log('No model-related configurations found to remove');
+  }
+}
+
 program
   .command('config-path')
   .description('Display configuration file paths')
   .action(() => {
     console.log('Model configuration file path:', MODEL_CONFIG_PATH);
-    console.log('Claude settings file path:', CLAUDE_SETTINGS_PATH);
+    console.log('Claude Code settings file path:', CLAUDE_SETTINGS_PATH);
+  });
+
+program
+  .command('unset')
+  .description('Remove all model-related configuration and use official models')
+  .action(() => {
+    unsetModelConfig();
   });
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-model-switch",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A CLI tool to switch Claude Code models",
   "main": "index.js",
   "bin": {
@@ -9,10 +9,15 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "keywords": ["claude", "code", "model", "switch"],
+  "keywords": [
+    "claude",
+    "code",
+    "model",
+    "switch"
+  ],
   "author": "",
   "license": "MIT",
   "dependencies": {
     "commander": "^11.1.0"
   }
-}
+}