一个现代化的 Claude AI 配置管理工具
Claude Code Switcher 是一个专为 Claude AI 开发者设计的配置管理工具。它提供了直观的图形界面，让你能够轻松管理多个 Claude AI 配置环境，实现一键切换，提高开发效率。
- 一键切换：快速在不同 Claude AI 配置间切换
- 自动同步：自动同步到 Claude 的活动配置文件 (
~/.claude/settings.json) - 默认配置：设置和管理默认配置文件
- CRUD 操作：创建、编辑、重命名、删除配置文件
- 实时保存：自动保存编辑内容，防止数据丢失
- 备份恢复：安全的配置文件管理机制
- 双主题支持：深色/浅色主题自由切换
- 语法高亮：内置 JSON 编辑器，支持语法高亮
- 响应式设计：适配不同屏幕尺寸
- 实时反馈：操作状态和进度提示
- 自定义目录：可配置配置文件存储位置
- 持久化设置：应用设置自动保存
- 跨平台兼容：支持 macOS、Windows、Linux
- 下载
Claude Code Switcher.app - 拖拽到
/Applications文件夹 - 首次运行可能需要在"系统偏好设置 > 安全性与隐私"中允许
- 下载对应平台的可执行文件
- 直接运行或添加到系统 PATH
- Rust: 1.70+ (安装指南)
- 系统: macOS 10.15+ / Windows 10+ / Linux
# 1. 克隆仓库
git clone https://github.com/jiji262/Claude-Code-Switcher.git
cd Claude-Code-Switcher
# 2. 构建应用
cargo build --release
# 3. 运行应用
cargo run --release🍎 macOS (Apple Silicon)
# 使用构建脚本 (推荐)
./build-macos.sh
# 手动构建
rustup target add aarch64-apple-darwin
cargo build --release --target aarch64-apple-darwin生成文件：
dist/claude-code-switcher-macos- 独立可执行文件dist/Claude Code Switcher.app- macOS 应用包
🪟 Windows
# 使用构建脚本
./build.bat
# 手动构建
cargo build --release🐧 Linux
# 使用构建脚本
./build.sh
# 手动构建
cargo build --release📁 默认配置目录: ~/.claude-code-switcher/settings/
📄 Claude 配置文件: ~/.claude/settings.json
🔄 自动同步: 选中配置自动同步到 Claude
- 左侧面板: 配置文件列表和操作按钮
- 右侧面板: JSON 编辑器和工具栏
- 状态栏: 实时状态和字符计数
| 操作 | 按钮 | 功能描述 |
|---|---|---|
| 新建配置 | [+] 新增 |
创建新的配置文件 |
| 重命名 | [R] 重命名 |
重命名选中的配置文件 |
| 删除配置 | [-] 删除 |
删除选中的配置文件 |
| 设为默认 | [*] 设为默认 |
将配置设为默认并同步到 Claude |
| 保存文件 | [S] 保存 |
保存当前编辑内容 |
| 格式化 | [F] 美化JSON |
格式化 JSON 内容 |
| 重新加载 | [R] 重新加载 |
重新加载文件内容 |
| 应用设置 | [⚙] 设置 |
打开应用设置面板 |
{
"env": {
"ANTHROPIC_API_KEY": "sk-ant-your-api-key-here",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com"
}
}- 零依赖运行时: 单文件可执行，无需额外安装
- 跨平台兼容: 统一代码库支持多平台
- 高性能渲染: GPU 加速的现代 UI
- 内存安全: Rust 语言级别的安全保证
| 平台 | 最低版本 | 推荐配置 |
|---|---|---|
| macOS | 10.15 (Catalina) | Apple Silicon (M1/M2/M3) |
| Windows | Windows 10 | Windows 11 |
| Linux | Ubuntu 18.04+ | 现代发行版 |
| 内存 | 2GB | 4GB+ |
| 存储 | 50MB | 100MB+ |
🍎 macOS 权限问题
如果遇到"无法打开，因为无法验证开发者"的错误：
方法一：系统设置
- 打开"系统偏好设置" > "安全性与隐私" > "通用"
- 点击"仍要打开"或"允许从以下位置下载的应用"
方法二：命令行
# 移除隔离属性
xattr -d com.apple.quarantine "Claude Code Switcher.app"
# 或针对可执行文件
xattr -d com.apple.quarantine ./claude-code-switcher-macos📁 配置文件问题
默认路径:
- 应用配置:
~/.claude-code-switcher/ - Claude 配置:
~/.claude/settings.json
自定义路径: 如果 Claude 使用不同路径，可在应用设置中修改配置目录。
🐛 常见问题
Q: 应用无法启动 A: 检查系统版本是否满足最低要求，确保有足够的内存空间。
Q: 配置切换不生效 A: 确认 Claude 配置文件路径正确，检查文件权限。
Q: JSON 格式错误 A: 使用内置的"美化JSON"功能检查语法，或参考配置示例。
我们欢迎社区贡献！请查看 贡献指南 了解详情。
# 1. Fork 并克隆仓库
git clone https://github.com/your-username/Claude-Code-Switcher.git
# 2. 安装依赖
cargo check
# 3. 运行开发版本
cargo run
# 4. 运行测试
cargo test本项目采用双许可证：
- 应用程序: MIT OR Apache-2.0
- 字体文件: SIL Open Font License 1.1
Claude Code Switcher - 让 Claude AI 配置管理变得简单高效 🚀