CC Switch

🚀 Claude Code 配置切换器 - 轻松管理多个 Claude Code 配置

CC Switch 是一个命令行工具，帮助您轻松管理和切换多个 Claude Code 配置。支持存储多组 URL 和 Token，并可一键切换，提升开发效率。

✨ 特性

• 🔧 多配置管理 - 存储和管理多个 Claude Code 配置
• 🔄 一键切换 - 快速切换不同的 URL 和 Token
• 🛡️ 安全存储 - Token 安全遮蔽显示，配置文件权限保护
• 💾 自动备份 - 切换前自动备份，支持手动备份和恢复
• 🔍 智能检测 - 自动检测 Claude Code 配置文件位置
• 🌐 多语言界面 - 支持中英文界面，交互式语言切换

📦 安装

npm 全局安装

npm install -g claude-settings-switch

安装完成后，您可以直接使用 ccs 命令。

⚠️ 注意：npm全局安装虽然方便，但建议优先使用源码安装以确保代码安全性

从源码安装

macOS / Linux

git clone https://github.com/songunity/ClaudeCode-Switch.git
cd ClaudeCode-Switch
npm install
./install.sh

Windows

git clone https://github.com/songunity/ClaudeCode-Switch.git
cd ClaudeCode-Switch
npm install
install.bat

🚀 快速开始

1. 检查系统状态

ccs diagnostics

2. 添加配置

# 添加开发环境配置
ccs add dev https://api.anthropic.com sk-ant-api03-xxxxxxxxxxxxxxxx

# 添加生产环境配置  
ccs add prod https://api.anthropic.com sk-ant-api03-yyyyyyyyyyyyyyyy

3. 切换配置

# 切换到开发环境（推荐使用简写）
ccs sw dev

# 切换到生产环境
ccs sw prod

4. 语言切换

# 交互式语言切换（推荐）
ccs la

# 或使用完整命令
ccs lang

# 直接切换到中文
ccs la zh

# 直接切换到英文  
ccs la en

5. 查看状态

# 查看所有配置
ccs list

# 查看当前配置
ccs current

📋 命令参考

基础命令

• ccs add|a <name> <url> <token> - 添加新配置
• ccs list|ls - 显示所有配置
• ccs switch|sw <name> - 切换到指定配置（无参数时进入交互模式）
• ccs remove|rm <name> - 删除配置
• ccs current|cur - 显示当前配置

界面与语言

• ccs language|lang|la [lang] - 语言切换（无参数时进入交互模式）
  • ccs la - 交互式选择语言
  • ccs la zh - 切换到中文界面
  • ccs la en - 切换到英文界面

管理命令

• ccs backup - 创建手动备份
• ccs restore <backup-file> - 从备份恢复
• ccs diagnostics|diag - 系统诊断

帮助命令

• ccs --help - 显示帮助信息
• ccs --version|-v - 显示版本信息
• ccs help <command> - 显示特定命令帮助

🛡️ 安全特性

• Token 安全: 根据 token 类型智能遮蔽显示，配置文件权限设置为 600
• 自动备份: 每次切换前自动创建备份，保留最近 5 个备份文件
• 权限保护: 自动检查和设置适当的文件权限

📁 配置文件

• CCS 配置: ~/.ccswitcher/configs.json - 存储所有 CCS 配置
• Claude 配置: 自动检测 ~/.claude/settings.json、.claude/settings.json 等位置

🔧 使用流程

# 1. 初次设置
ccs diagnostics                         # 检查系统状态
ccs add dev https://dev-api.com sk-dev   # 添加开发配置
ccs add prod https://api.com sk-prod     # 添加生产配置

# 2. 日常使用
ccs list                                # 查看所有配置
ccs sw dev                              # 切换到开发环境（推荐简写）
ccs sw prod                             # 切换到生产环境
ccs current                             # 检查当前状态
ccs la                                  # 交互式语言切换

🐛 故障排除

常见问题

配置文件不存在

ccs diagnostics  # 运行诊断检查

权限被拒绝

chmod 755 ~/.claude
chmod 644 ~/.claude/settings.json

切换后配置不生效

ccs current                # 检查当前状态
ccs switch <config-name>   # 重新切换

错误代码

• CONFIG_NOT_FOUND - 配置不存在，使用 ccs list 查看可用配置
• CONFIG_EXISTS - 配置名称已存在，选择不同名称或删除现有配置
• CLAUDE_CONFIG_NOT_FOUND - Claude 配置文件不存在，请先运行 Claude Code
• PERMISSION_DENIED - 权限不足，检查并修复文件权限

🆘 获取帮助

• 内置帮助: ccs --help 或 ccs diagnostics
• 问题报告: GitHub Issues

报告问题时请包含：

1. CCS 版本：ccs --version
2. 系统诊断：ccs diagnostics
3. 具体错误信息

📝 许可证

此项目基于 ISC 许可证开源。

Happy Coding with CC Switch! 🚀