claude-code-model-switch 2.1.0 → 2.2.1

package/README.md

@@ -7,6 +7,7 @@ A CLI tool for switching between different AI models in Claude Code.
 - Launch Claude Code with a preconfigured model in one command (yolo mode)
 - Support for multiple pre-configured model environments
 - `start` injects model config as env vars; `config` persists to settings.json
+- `shared` env vars apply to all models (model-specific values override shared)
 - Automatic handling of model-related environment variables and defaults
 - Simple command-line interface
 - `unset` removes model-related entries from settings.json
@@ -39,6 +40,11 @@ ccms config-path
 
 # Remove model-related configuration from settings.json
 ccms unset
+
+# Manage shared environment variables for all models
+ccms shared list
+ccms shared set API_TIMEOUT_MS 600000
+ccms shared unset API_TIMEOUT_MS
 ```
 
 ### Model Configuration
@@ -47,6 +53,10 @@ Edit the configuration file `~/.claude-code-model-switch/settings.json`:
 
 ```json
 {
+  "shared": {
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+    "API_TIMEOUT_MS": "600000"
+  },
   "models": {
     "deepseek-chat": {
       "ANTHROPIC_AUTH_TOKEN": "sk-your-token-here",
@@ -91,11 +101,12 @@ Edit the configuration file `~/.claude-code-model-switch/settings.json`:
 
 1. **start command**: `ccms start <model>` injects model config as environment variables and launches `claude` with `--dangerously-skip-permissions` (yolo mode)
 2. **config command**: `ccms config <model>` writes model config to `~/.claude/settings.json` for persistent configuration
-3. **Default Values**:
+3. **shared env vars**: variables in `shared` apply to every model; model-specific values override shared ones
+4. **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`
-4. **Configuration File**: Empty configuration file `{"models": {}}` is automatically created on first run
+4. **Configuration File**: Empty configuration file `{"shared": {}, "models": {}}` is automatically created on first run
 5. **Unset Command**: `ccms unset` removes only model-specific variables from `settings.json` and restores official models
 
 ## 📁 File Locations

package/README_CN.md

@@ -7,6 +7,7 @@
 - 一条命令启动 Claude Code 并加载指定模型配置（yolo 模式）
 - 支持多个预配置模型环境
 - `start` 将模型配置注入环境变量，`config` 可持久化写入 settings.json
+- 支持 `shared` 公共环境变量，所有模型自动继承（模型配置可覆盖）
 - 自动处理模型相关环境变量及默认值
 - 命令行界面，操作简单
 - `unset` 可清除 settings.json 中的模型相关配置
@@ -39,6 +40,11 @@ ccms config-path
 
 # 清除 settings.json 中的模型相关配置，恢复使用官方模型
 ccms unset
+
+# 管理所有模型共享的环境变量
+ccms shared list
+ccms shared set API_TIMEOUT_MS 600000
+ccms shared unset API_TIMEOUT_MS
 ```
 
 ### 配置模型
@@ -47,6 +53,10 @@ ccms unset
 
 ```json
 {
+  "shared": {
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+    "API_TIMEOUT_MS": "600000"
+  },
   "models": {
     "deepseek-chat": {
       "ANTHROPIC_AUTH_TOKEN": "sk-your-token-here",
@@ -91,11 +101,12 @@ ccms unset
 
 1. **start 命令**：`ccms start <model>` 将模型配置注入环境变量并启动 `claude`，默认附带 `--dangerously-skip-permissions`（yolo 模式）
 2. **config 命令**：`ccms config <model>` 将模型配置写入 `~/.claude/settings.json`，适合需要持久化配置的场景
-3. **默认值处理**：
+3. **shared 公共变量**：`shared` 中的环境变量会应用到所有模型；单个模型里同名变量会覆盖 shared
+4. **默认值处理**：
    - `CLAUDE_CODE_MAX_OUTPUT_TOKENS` 默认为 `8192`
    - `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 默认为 `1`
    - 未设置的模型字段会自动使用 `ANTHROPIC_MODEL` 的值
-4. **配置文件**：首次运行时会自动创建空的配置文件 `{"models": {}}`
+4. **配置文件**：首次运行时会自动创建空的配置文件 `{"shared": {}, "models": {}}`
 5. **Unset 命令**：`ccms unset` 只删除 `settings.json` 中的模型相关变量，恢复使用官方模型
 
 ## 📁 文件位置

package/example-config.json

@@ -1,4 +1,8 @@
 {
+  "shared": {
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+    "API_TIMEOUT_MS": "600000"
+  },
   "models": {
     "deepseek-chat": {
       "ANTHROPIC_AUTH_TOKEN": "sk-caf695360e7f4b018bb1b308cbf992eb",
@@ -7,8 +11,7 @@
       "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_CODE_MAX_OUTPUT_TOKENS": "8192"
     },
     "claude-3-5-sonnet": {
       "ANTHROPIC_AUTH_TOKEN": "your-anthropic-token-here",
@@ -21,4 +24,4 @@
       "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "0"
     }
   }
-}
+}

package/index.js

@@ -61,7 +61,7 @@ function loadModelConfig() {
   ensureConfigDir();
 
   if (!fs.existsSync(MODEL_CONFIG_PATH)) {
-    const defaultConfig = { models: {} };
+    const defaultConfig = { shared: {}, models: {} };
     fs.writeFileSync(MODEL_CONFIG_PATH, JSON.stringify(defaultConfig, null, 2));
     return defaultConfig;
   }
@@ -118,9 +118,25 @@ function reportUnknownModel(model) {
   process.exit(1);
 }
 
-function getModelConfig(modelName) {
-  const config = loadModelConfig();
+function saveModelConfig(config) {
+  ensureConfigDir();
+  try {
+    fs.writeFileSync(MODEL_CONFIG_PATH, JSON.stringify(config, null, 2));
+  } catch (error) {
+    console.error('Error: Failed to save model configuration file');
+    process.exit(1);
+  }
+}
 
+function getSharedEnv(config = loadModelConfig()) {
+  const shared = config.shared;
+  if (!shared || typeof shared !== 'object' || Array.isArray(shared)) {
+    return {};
+  }
+  return shared;
+}
+
+function getRawModelConfig(modelName, config = loadModelConfig()) {
   if (!config.models || !config.models[modelName]) {
     reportUnknownModel(modelName);
   }
@@ -136,6 +152,14 @@ function getModelConfig(modelName) {
   return modelConfig;
 }
 
+function mergeModelConfig(modelName) {
+  const config = loadModelConfig();
+  const shared = getSharedEnv(config);
+  const modelConfig = getRawModelConfig(modelName, config);
+
+  return { ...shared, ...modelConfig };
+}
+
 function normalizeModelConfig(modelConfig) {
   const normalized = { ...modelConfig };
 
@@ -154,9 +178,9 @@ function buildModelEnv(modelConfig) {
   const normalized = normalizeModelConfig(modelConfig);
   const env = { ...process.env };
 
-  for (const key of MODEL_ENV_VARS) {
-    if (normalized[key] !== undefined) {
-      env[key] = String(normalized[key]);
+  for (const [key, value] of Object.entries(normalized)) {
+    if (value !== undefined && value !== null) {
+      env[key] = String(value);
     }
   }
 
@@ -234,11 +258,11 @@ function launchClaude(env, claudeArgs = []) {
 }
 
 function startClaudeWithModel(modelName) {
-  const modelConfig = getModelConfig(modelName);
+  const modelConfig = mergeModelConfig(modelName);
   const env = buildModelEnv(modelConfig);
   const claudeArgs = buildStartArgs(getStartArgsFromArgv());
 
-  console.log(`[ccms] starting claude code with model: ${env.ANTHROPIC_MODEL} (yolo mode)\n`);
+  console.log(`[ccms] model: ${env.ANTHROPIC_MODEL}, endpoint: ${env.ANTHROPIC_BASE_URL} (yolo mode)\n`);
   launchClaude(env, claudeArgs);
 }
 
@@ -250,9 +274,9 @@ function applyModelConfig(modelConfig) {
     settings.env = {};
   }
 
-  for (const key of MODEL_ENV_VARS) {
-    if (normalized[key] !== undefined) {
-      settings.env[key] = normalized[key];
+  for (const [key, value] of Object.entries(normalized)) {
+    if (value !== undefined && value !== null) {
+      settings.env[key] = String(value);
     }
   }
 
@@ -276,10 +300,51 @@ function applyModelConfig(modelConfig) {
 }
 
 function configModel(modelName) {
-  const modelConfig = getModelConfig(modelName);
+  const modelConfig = mergeModelConfig(modelName);
   applyModelConfig(modelConfig);
 }
 
+function listSharedEnv() {
+  const shared = getSharedEnv();
+  const keys = Object.keys(shared);
+
+  if (keys.length === 0) {
+    console.log('No shared environment variables configured');
+    return;
+  }
+
+  console.log('Shared environment variables:');
+  keys.forEach((key) => {
+    console.log(`  ${key}=${shared[key]}`);
+  });
+}
+
+function setSharedEnv(key, value) {
+  const config = loadModelConfig();
+
+  if (!config.shared || typeof config.shared !== 'object' || Array.isArray(config.shared)) {
+    config.shared = {};
+  }
+
+  config.shared[key] = value;
+  saveModelConfig(config);
+  console.log(`[ccms] shared env set: ${key}=${value}`);
+}
+
+function unsetSharedEnv(key) {
+  const config = loadModelConfig();
+  const shared = getSharedEnv(config);
+
+  if (!Object.prototype.hasOwnProperty.call(shared, key)) {
+    console.log(`No shared environment variable found: ${key}`);
+    return;
+  }
+
+  delete config.shared[key];
+  saveModelConfig(config);
+  console.log(`[ccms] shared env removed: ${key}`);
+}
+
 function unsetModelConfig() {
   const settings = loadClaudeSettings();
 
@@ -325,7 +390,7 @@ function listModels() {
 program
   .name('ccms')
   .description('Claude Code Model Switch - Manage and launch Claude Code with configured models')
-  .version('2.1.0');
+  .version('2.2.0');
 
 program
   .command('start <model> [claude-args...]')
@@ -365,6 +430,41 @@ program
     unsetModelConfig();
   });
 
+program
+  .command('shared')
+  .description('Manage shared environment variables for all models')
+  .argument('[action]', 'list, set, or unset')
+  .argument('[key]', 'Environment variable name')
+  .argument('[value]', 'Environment variable value')
+  .action((action, key, value) => {
+    if (!action || action === 'list') {
+      listSharedEnv();
+      return;
+    }
+
+    if (action === 'set') {
+      if (!key || value === undefined) {
+        console.error('Usage: ccms shared set <key> <value>');
+        process.exit(1);
+      }
+      setSharedEnv(key, value);
+      return;
+    }
+
+    if (action === 'unset') {
+      if (!key) {
+        console.error('Usage: ccms shared unset <key>');
+        process.exit(1);
+      }
+      unsetSharedEnv(key);
+      return;
+    }
+
+    console.error(`Unknown shared action: ${action}`);
+    console.log('Usage: ccms shared [list|set <key> <value>|unset <key>]');
+    process.exit(1);
+  });
+
 program.parse();
 
 if (!process.argv.slice(2).length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-model-switch",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Launch Claude Code with preconfigured model environments",
   "main": "index.js",
   "bin": {