# cc-config-switch

**Repository Path**: duosl/cc-config-switch

## Basic Information

- **Project Name**: cc-config-switch
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-09
- **Last Updated**: 2025-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code 配置切换工具

# Claude Code 配置切换工具

一个用于管理 Claude Code 多个配置文件的跨平台命令行工具。

> 支持命令别名：`cc-config` 和 `ccc` 功能完全相同

## 平台支持

✅ **macOS** - 完全支持，自动复制命令到剪切板  
✅ **Windows** - 完全支持，自动复制命令到剪切板  
✅ **Linux** - 完全支持，需要安装 `xclip` 或 `xsel` 以启用剪切板功能

## 特性

- 🌐 **跨平台支持** - macOS、Windows、Linux 全平台支持
- 🔧 管理多个 Claude Code 配置
- 🔄 快速导出不同配置的环境变量
- 📝 交互式添加新配置
- 📋 列出所有配置信息
- 🔍 **智能配置检测** - 查看当前配置并检测环境变量一致性
- 📁 直接编辑配置文件
- 📤 导出环境变量设置
- 📋 **智能剪切板** - 自动检测剪切板可用性并复制环境变量命令
- ⚠️ **配置验证** - 检测环境变量与配置文件的一致性，提供修复建议

## 安装

### 环境要求

- **Node.js**: 16.0.0 或更高版本
- **操作系统**: macOS、Windows、Linux

### 剪切板功能要求

- **macOS**: 内置 `pbcopy` 支持（无需额外安装）
- **Windows**: 内置 `clip` 支持（无需额外安装）
- **Linux**: 需要安装 `xclip` 或 `xsel`
  ```bash
  # Ubuntu/Debian
  sudo apt-get install xclip
  # 或者
  sudo apt-get install xsel
  
  # CentOS/RHEL/Fedora  
  sudo yum install xclip
  # 或者
  sudo dnf install xclip
  ```

### 全局安装

> 需要先 clone 当前项目，在根目录下执行

```bash
npm install -g .
```

### 开发模式

```bash
npm install
npm run build
```

## 使用方法

### 列出所有配置

```bash
cc-config list
# 或
cc-config ls
```
### 添加新配置

```bash
cc-config add [配置名称]
```

如果不提供配置名称，将会交互式地要求输入。

### 删除配置

```bash
cc-config remove <配置名称>
# 或
cc-config rm <配置名称>
```

### 导出配置环境变量

```bash
cc-config export <配置名称>
```

此命令会：
- 生成适合当前操作系统的环境变量设置命令
- 自动检测并复制到剪切板（支持 macOS/Windows，Linux 需安装 xclip/xsel）
- 提供详细的操作指引和注意事项

### 查看当前配置

```bash
cc-config current
# 或
cc-config cur
```

此命令会：
- 显示当前环境变量中的配置信息
- 检测环境变量与配置文件是否一致
- 提供配置不匹配时的修复建议

### 清空相关环境变量

```bash
cc-config reset
```

此命令会：
- 生成适合当前操作系统的环境变量设置命令
- 自动检测并复制到剪切板（支持 macOS/Windows，Linux 需安装 xclip/xsel）


### 打开配置文件

```bash
cc-config open
```

## 配置文件

配置文件位于 `~/.cc-config/profiles.json`，格式如下：

```json
{
  "profiles": {
    "default": {
    },
    "bigmodel": {
      "ANTHROPIC_AUTH_TOKEN": "sk-******************************r",
      "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
      "ANTHROPIC_MODEL": "glm-4.5"
    },
    "kimi": {
      "ANTHROPIC_AUTH_TOKEN": "sk-******************************r",
      "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
      "ANTHROPIC_MODEL": "kimi-k2-turbo-preview"
    }
  }
}
```

## 环境变量

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

- `CC_CONFIG_NAME`: 当前使用的配置名称
- `ANTHROPIC_AUTH_TOKEN`: Anthropic API Token
- `ANTHROPIC_BASE_URL`: API Base URL (https://api.anthropic.com)
- `ANTHROPIC_MODEL`: 使用的模型

### 配置检测功能

`cc-config current` 命令会自动检测环境变量与配置文件中的设置是否一致：
- ✅ **匹配**: 显示绿色成功消息
- ⚠️ **不匹配**: 显示黄色警告并提供修复建议
- 💫 **未设置**: 检测到使用官方配置时的提示

### 跨平台命令格式

**Unix/Linux/macOS:**
```bash
export CC_CONFIG_NAME="your-config" && export ANTHROPIC_AUTH_TOKEN="your-token" && export ANTHROPIC_BASE_URL="https://api.anthropic.com" && export ANTHROPIC_MODEL="claude-4-sonnet"
```

**Windows 命令提示符:**
```cmd
set "CC_CONFIG_NAME=your-config" && set "ANTHROPIC_AUTH_TOKEN=your-token" && set "ANTHROPIC_BASE_URL=https://api.anthropic.com" && set "ANTHROPIC_MODEL=claude-4-sonnet"
```

工具会根据您的操作系统自动生成正确的命令格式。

## 开发

### 构建

```bash
npm run build
```

### 开发模式运行

```bash
npm run dev -- [命令]
```

### 清理构建文件

```bash
npm run clean
```

## 示例

### 基本操作流程

```bash
# 列出所有配置
cc-config list

# 添加新配置
cc-config add personal

# 导出 kimi 的环境变量配置
cc-config export kimi

# 查看当前配置并检测一致性
cc-config current

# 打开配置文件进行编辑
cc-config open

# 删除配置
cc-config remove personal
```

### export 命令输出示例

当您执行 `cc-config export kimi` 时，会看到类似下面的输出：

```
复制并执行以下命令来应用环境变量 (macOS):
--------------------------------------------------
export CC_CONFIG_NAME="kimi" && export ANTHROPIC_AUTH_TOKEN="sk-***" && export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic" && export ANTHROPIC_MODEL="kimi-k2-turbo-preview"
--------------------------------------------------
正在尝试自动复制到剪切板...
✓ 已自动复制到剪切板，直接粘贴执行即可！
--------------------------------------------------
⚠️ 环境变量仅在当前终端会话中有效
⚠️ 请重启 Claude Code 以使配置生效
```

### current 命令输出示例

当您执行 `cc-config current` 时，可能看到：

```
当前配置: kimi
--------------------------------------------------
Base URL: https://api.moonshot.cn/anthropic
Token: sk-***preview
Model: kimi-k2-turbo-preview
--------------------------------------------------
环境变量检测中...
✓ 所有相关环境变量与配置文件中的配置匹配~
```

或者在配置不匹配时：

```
当前配置: kimi
--------------------------------------------------
Base URL: https://api.moonshot.cn/anthropic
Token: sk-***preview
Model: kimi-k2-turbo-preview
--------------------------------------------------
环境变量检测中...
⚠️ 环境变量 ANTHROPIC_BASE_URL 与配置不符
⚠️ 环境变量 ANTHROPIC_MODEL 与配置不符
检测到当前环境变量与配置文件中的配置不匹配，建议使用 "cc-config export kimi" 重新获取设置命令
```

## 许可证

[MIT LICENSE](./LICENSE)