# claude-code-switche

**Repository Path**: open_source_base/claude-code-switche

## Basic Information

- **Project Name**: claude-code-switche
- **Description**:  # claude-switcher
     一个灵活的 Claude Code 中转站配置管理工具，用于快速切换不同的 API 配置。
     ## 功能特点
     - 支持多个中转站配置管理
     - 一键切换配置文件
     - 备份和恢复配置
     - 环境变量管理
     - 跨平台支持
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-02
- **Last Updated**: 2025-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# claude-code-switcher

中文 | [English](README_EN.md)

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

## 🚀 功能特点

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

### 命令行版本
- ⚡ **轻量快速** - 无依赖，直接运行
- 📝 **简单命令** - 直观的命令行操作
- 🔄 **配置切换** - 快速切换不同配置
- 🌐 **多语言支持** - 中英文界面切换

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

## 🚀 快速开始

### 方式一：Web UI（推荐）
```bash
# 克隆项目
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:5300

# 启动英文界面
python app.py --lang en_US

# 自定义主机和端口
python app.py --lang en_US --host 0.0.0.0 --port 8080
```

### 方式二：命令行
```bash
# 直接运行
python claude-switcher.py help

# 英文界面
python claude-switcher.py --lang en_US 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 目录中

### 4. 语言切换
- 点击界面右上角的"中文"或"English"按钮
- 语言偏好自动保存在浏览器中
- 所有界面文本和消息都支持双语切换

## 📁 文件结构
```
claude-code-switcher/
├── app.py                 # Web UI主程序
├── claude-switcher.py     # 命令行版本
├── server_config.json     # 服务器配置文件
├── locales/               # 国际化文件
│   ├── zh_CN.json         # 中文翻译
│   └── en_US.json         # 英文翻译
├── templates/
│   └── index.html         # Web界面模板
├── requirements.txt       # Python依赖
├── README.md             # 中文使用说明
├── README_EN.md          # 英文使用说明
└── .gitignore            # Git忽略文件
```

## 🔧 技术栈
- **后端**：Python + Flask
- **前端**：HTML5 + TailwindCSS + Alpine.js
- **图标**：Font Awesome
- **JSON处理**：Python标准库

## ⚙️ 服务器配置
项目支持通过 `server_config.json` 文件自定义服务器启动参数：

```json
{
    "debug": true,
    "host": "0.0.0.0", 
    "port": 5300,
    "language": "zh_CN",
    "messages": {
        "startup": "正在启动 Claude Config Web UI...",
        "address": "访问地址: http://localhost:5300",
        "stop_hint": "按 Ctrl+C 停止服务"
    }
}
```

### 配置选项说明
- `debug`: 是否开启调试模式
- `host`: 服务器监听地址（0.0.0.0表示所有接口）
- `port`: 服务器端口号
- `language`: 默认界面语言（zh_CN/en_US）
- `messages`: 自定义启动时显示的消息文本

如果配置文件不存在，程序会使用默认设置运行。

## ⚙️ 配置说明

### 默认配置路径
- **Windows**: `C:\Users\{用户名}\.claude`
- **Linux/Mac**: `~/.claude`

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

## 🌐 国际化支持

### Web界面
- 支持中英文界面切换
- 无需刷新页面的实时语言切换
- 语言偏好保存在浏览器localStorage中
- 可通过 `--lang` 参数设置启动语言

### 命令行工具
- 支持 `--lang` 参数切换语言
- 所有帮助信息、错误消息、成功提示都支持双语
- 使用示例：
  ```bash
  python claude-switcher.py --lang en_US help
  python claude-switcher.py --lang zh_CN list
  ```

## 🐛 常见问题

### Q: 启动时提示缺少依赖
A: 运行 `pip install -r requirements.txt` 安装所有依赖

### Q: 无法访问配置目录
A: 确保配置路径存在且有读写权限

### Q: 配置切换后无效
A: 重启Claude客户端以应用新配置

### Q: 如何修改默认语言？
A: 使用 `--lang en_US` 参数或在 `server_config.json` 中修改 `language` 配置

## 🤝 贡献
欢迎提交Issue和Pull Request！

## 💖 支持项目
如果这个项目对您有帮助，请考虑支持我们：

- ⭐ 在GitHub上给项目点Star
- 🐛 报告问题和建议改进
- 📖 帮助完善文档
- 💰 赞助项目（Web界面中提供捐赠选项）

### 捐赠方式
项目已集成捐赠功能，您可以通过以下方式支持我们：

- **微信支付**：
- <img src="donation/webchat_donation.jpg" alt="微信捐赠二维码" width="200">


感谢您的支持！

## 📄 许可证
MIT License - 详见LICENSE文件

## 🔗 项目链接
- **GitHub**: https://github.com/viaco2ove/claude-code-switche
- **Gitee**: https://gitee.com/open_source_base/claude-code-switche

---

### 仓库同步
项目已成功同步到两个平台：

- Gitee: origin (https://gitee.com/open_source_base/claude-code-switche.git)
- GitHub: github (https://github.com/viaco2ove/claude-code-switche.git)

后续同步时，可以使用：
- `git push origin master` 推送到Gitee
- `git push github master` 推送到GitHub