claude-switcher

一个灵活的 Claude Code 中转站配置管理工具，支持Web界面和命令行两种使用方式。

🚀 功能特点

Web UI 版本

• 🖥️ 现代化Web界面 - 基于Flask的响应式设计
• 📁 自定义配置路径 - 支持任意路径的Claude配置目录
• 🔄 一键配置切换 - 下拉框选择，实时应用配置
• 💾 多配置管理 - 创建、编辑、删除多个settings.json配置
• ✏️ 实时编辑 - JSON格式验证和高亮显示
• 🔄 自动备份 - 切换配置时自动备份当前配置

命令行版本

• ⚡ 轻量快速 - 无依赖，直接运行
• 📝 简单命令 - 直观的命令行操作
• 🔄 配置切换 - 快速切换不同配置

📋 使用场景

• 🌐 多中转站切换 - 在不同API中转站间快速切换
• 🔧 配置测试 - 测试不同配置的性能表现
• 🔑 多API Key管理 - 管理多个API密钥配置
• 💾 配置备份 - 快速备份和恢复配置

🚀 快速开始

方式一：Web UI（推荐）

# 克隆项目
git clone https://gitee.com/open_source_base/claude-code-switche.git
cd claude-code-switche

# 安装依赖
pip install -r requirements.txt

# 启动Web服务
python app.py

# 浏览器访问 http://localhost:5000

方式二：命令行

# 直接运行
python claude-switcher.py help

# 常用命令
python claude-switcher.py list          # 列出所有配置
python claude-switcher.py save myconfig # 保存当前配置
python claude-switcher.py use myconfig  # 使用指定配置

🎯 Web界面使用指南

1. 配置路径设置

• 在顶部输入框中设置Claude配置目录路径
• 默认路径：C:\Users\{用户名}\.claude
• 点击"应用"按钮确认路径

2. 配置管理

• 查看配置：下拉框查看所有已保存的配置
• 应用配置：选择配置后点击"应用"立即生效
• 保存配置：编辑后点击"另存为"创建新配置
• 删除配置：选择配置后点击"删除"

3. 实时编辑

• 在编辑器中直接修改settings.json内容
• 支持JSON格式验证
• 实时保存到当前配置
• 所有保存的配置都在 .claude-profiles 目录中

📁 文件结构

claude-switcher/
├── app.py                 # Web UI主程序
├── claude-switcher.py     # 命令行版本
├── templates/
│   └── index.html         # Web界面模板
├── requirements.txt       # Python依赖
├── README.md             # 使用说明
└── .gitignore            # Git忽略文件

🔧 技术栈

• 后端：Python + Flask
• 前端：HTML5 + TailwindCSS + Alpine.js
• 图标：Font Awesome
• JSON处理：Python标准库

⚙️ 配置说明

默认配置路径

• Windows: C:\Users\{用户名}\.claude
• Linux/Mac: ~/.claude

配置文件

• settings.json: Claude的主要配置文件
• profiles/: 保存的配置备份目录

🐛 常见问题

Q: 启动时提示缺少依赖

A: 运行 pip install -r requirements.txt 安装所有依赖

Q: 无法访问配置目录

A: 确保配置路径存在且有读写权限

Q: 配置切换后无效

A: 重启Claude客户端以应用新配置

🤝 贡献

欢迎提交Issue和Pull Request！

📄 许可证

MIT License - 详见LICENSE文件