🚀 一款基于 Tauri 框架构建的现代化 Claude Code 配置管理桌面应用程序，为开发者提供便捷的 Claude API 配置管理解决方案。

✨ 最新更新 (v1.7.0)

• 📦 账号批量导入导出: 支持选择性导出、URL 筛选、自定义保存位置
• 🌐 宿主机 IP 功能: 账号切换时支持使用宿主机 IP
• 🛡️ CLAUDE.local.md 保护: 切换账号时自动检测并备份现有配置文件
• 🔧 环境变量增强: 自动添加隐私保护配置，拆分为独立环境变量
• 📁 Commands 目录支持: 自动打包和释放 commands 目录下的文件
• 🛠️ Rust 安装脚本: 国内镜像一键安装，支持多镜像源选择
• 🐛 Bug 修复: 修复批量导入导出、token 匹配、数据库迁移等多个问题
• ⚡ CLI 增强: 自动设置 onboarding、版本号同步、环境变量支持

• 智能账号管理: 创建、编辑、删除多个 Claude API 账号
• 账号状态追踪: 实时显示账号活跃状态和关联情况
• 批量操作: 支持批量管理和快速筛选
• 安全存储: Token 等敏感信息安全加密存储

• 目录关联: 管理项目目录与 Claude 配置的绑定关系
• 路径验证: 自动检测目录存在性，智能处理无效路径
• 配置预览: 实时查看目录当前的 Claude 配置状态
• 批处理: 支持多目录统一管理

• 快速切换: 在不同项目目录间一键切换 Claude 配置
• 智能关联: 自动建立账号与目录的最佳匹配关系
• 配置同步: 实时更新 .claude/settings.local.json 配置文件
• 沙盒模式: 支持沙盒环境配置管理

• 多端点支持: 管理不同的 Claude API 端点 URL
• 自定义 API Key: 为每个端点配置独立的环境变量名（如 ANTHROPIC_API_KEY、CLAUDE_API_KEY 等）
• 预设模板: 提供常用 API 端点的快速配置模板
• 默认配置: 支持设置默认 API 端点
• 连接测试: 内置 API 连接测试功能

• 多数据库支持: SQLite 本地数据库和 MySQL 远程数据库
• 连接管理: 灵活的数据库连接配置和切换
• 数据备份: 自动数据备份和恢复功能
• 性能监控: 实时显示数据库连接状态和性能指标

• 权限管理: 精细化的 Claude 工具权限控制
• 环境变量: 自定义环境变量配置管理
• 工具控制: 灵活的 Claude 工具启用/禁用设置
• 配置预览: JSON 格式的配置实时预览

• 多端同步: 支持坚果云、NextCloud 等 WebDAV 服务
• 配置备份: 自动备份账号、目录、Claude 配置到云端
• 版本管理: 远程文件列表查看和版本控制
• 自动同步: 可配置定时自动同步，保持数据最新
• 同步日志: 详细的同步历史记录和状态追踪

• 🦀 Tauri 2.x: 现代化跨平台桌面应用框架
• ⚡ SQLx 0.8: 高性能异步 SQL 工具包，支持 SQLite 和 MySQL
• 🚀 Tokio: 强大的异步运行时，确保高并发性能
• ☁️ Reqwest-DAV: WebDAV 协议客户端，支持云端同步
• 📦 Serde: 高效的序列化/反序列化库
• ⏰ Chrono: 完整的日期时间处理解决方案
• 📝 Tracing: 结构化日志记录和性能追踪
• 🔧 Anyhow: 优雅的错误处理机制

• 🎨 Bootstrap 5: 响应式现代化 UI 框架
• 🎯 Font Awesome: 丰富的图标库
• ⚡ 原生 JavaScript (ES6+): 高效的前后端通信
• 🎪 现代化组件: 模态框、分页、搜索等交互组件

claude-code-config-manage-gui/
├── 📁 src/                           # 前端界面
│   ├── 📄 index.html                 # 主页面 - 现代化界面布局
│   ├── 🎨 styles.css                 # 样式文件 - 自定义主题和动画
│   └── ⚡ main.js                    # 核心逻辑 (2400+ 行)
│       ├── 🔐 账号管理功能
│       ├── 📁 目录管理功能  
│       ├── 🔄 配置切换功能
│       ├── 🌐 URL管理功能
│       ├── 🗄️ 数据库管理功能
│       └── 🛠️ Claude设置管理功能
├── 📁 src-tauri/                     # Rust 后端
│   ├── 📁 src/
│   │   ├── 🚀 main.rs               # 应用程序入口点
│   │   ├── 📚 lib.rs                # Tauri 命令集合和核心接口
│   │   ├── 📊 models.rs             # 数据模型定义
│   │   ├── 🗄️ database.rs           # 数据库操作层 (SQLite/MySQL)
│   │   ├── ⚙️ config_manager.rs     # Claude 配置文件管理
│   │   ├── 🛠️ claude_config.rs      # Claude 设置处理
│   │   ├── ⚙️ settings.rs           # 应用设置管理
│   │   ├── ☁️ webdav.rs             # WebDAV 云同步功能
│   │   ├── 💾 database_backup.rs    # 数据库备份功能
│   │   └── 📝 logger.rs             # 日志记录系统
│   ├── 📁 resources/                # 应用资源
│   │   ├── 📄 config.json           # 默认配置文件
│   │   ├── 🗄️ init_db.sql          # 数据库初始化脚本
│   │   └── 📁 config/               # 配置模板
│   ├── 🔧 Cargo.toml                # Rust 依赖和元信息
│   └── ⚙️ tauri.conf.json           # Tauri 应用程序配置
├── 🔧 package.json                   # Node.js 项目配置
├── 🔨 build.bat / build.sh          # 构建脚本 (Windows/Linux)
├── 🧹 cleanup.bat                   # 清理脚本
└── 📖 README.md                     # 项目文档

为了加速 Rust 安装和依赖下载，我们提供了国内镜像一键安装脚本：

使用自动化安装脚本（推荐）：

# 使用 Node.js 运行安装脚本
node scripts/install-rust.mjs

脚本特性：

• ✅ 多镜像源支持: 中科大、清华、上交、字节跳动等镜像源可选
• ✅ 跨平台: 支持 Windows / Linux / macOS
• ✅ 自动配置: 自动配置 Cargo 镜像和环境变量
• ✅ 交互式: 友好的命令行交互界面
• ✅ 智能检测: 自动检测已安装的 Rust 版本

手动配置（可选）：

如果你更喜欢手动配置，可以按照以下步骤操作：

# Ubuntu/Debian
sudo apt update && sudo apt install -y \
    libwebkit2gtk-4.0-dev \
    build-essential \
    curl \
    wget \
    libssl-dev \
    libgtk-3-dev \
    libayatana-appindicator3-dev \
    librsvg2-dev

# Fedora/CentOS
sudo dnf install -y \
    webkit2gtk4.0-devel \
    openssl-devel \
    curl \
    wget \
    libappindicator-gtk3-devel \
    librsvg2-devel

• 安装 Microsoft C++ Build Tools
• 安装 WebView2 Runtime

# 使用 Homebrew
xcode-select --install

# 1. 克隆仓库
git clone https://github.com/ronghuaxueleng/claude-code-config-manage-gui.git
cd claude-code-config-manage-gui

# 2. 安装前端依赖
npm install

# 3. 启动开发服务器 (支持热重载)
npm run dev

# 构建生产版本 (包含安装包)
npm run tauri build

# 构建输出位置:
# Windows: src-tauri/target/release/bundle/msi/
# Linux: src-tauri/target/release/bundle/deb/ 或 AppImage
# macOS: src-tauri/target/release/bundle/dmg/

# 仅构建可执行文件 (不打包)
cargo build --release --manifest-path src-tauri/Cargo.toml

# 使用中国镜像加速构建 (推荐)
./build.bat    # Windows
./build.sh     # Linux/macOS

1. 启动应用: 双击 claude-config-manager.exe 或从命令行运行
2. 自动初始化: 应用会自动创建数据库文件和必要的目录结构
3. 添加账号: 在"账号管理"页面添加您的 Claude API Token
4. 添加目录: 在"目录管理"页面添加您的项目目录路径
5. 配置切换: 在"配置切换"页面关联账号和目录，一键切换配置
6. 云端备份 (可选): 在"WebDAV 同步"页面配置云存储，实现多设备同步

💡 提示: 首次启动时，应用会显示空白的账号和目录列表，这是正常的。您需要手动添加自己的配置数据。

应用会在项目目录下创建 .claude/settings.local.json：

{
  "permissions": {
    "defaultMode": "bypassPermissions",
    "allow": ["*"],
    "deny": []
  },
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxx...",
    "ANTHROPIC_AUTH_TOKEN": "sk-ant-xxx...",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "CLAUDE_CODE_BUBBLEWRAP": "1",
    "DISABLE_AUTOUPDATER": 1
  }
}

💡 提示: v1.5.0 开始支持为不同的 Base URL 配置不同的 API Key 环境变量名。例如，官方 API 使用 ANTHROPIC_API_KEY，第三方 API 可使用 CLAUDE_API_KEY 等自定义名称。

• SQLite (默认): 本地文件数据库，无需额外配置
• MySQL: 支持远程数据库，适合团队共享

📁 应用目录/
├── 📁 resources/               # 应用资源目录
│   ├── 🗄️ claude_config.db    # SQLite 数据库 (新位置)
│   ├── 📄 config.json         # 应用配置
│   └── 📁 config/             # 配置模板
├── 📁 logs/                   # 应用日志
│   ├── 📄 app.log            # 应用日志
│   └── 📄 error.log          # 错误日志
└── 🗄️ claude-config-manager.exe  # 应用程序

# 1. 更新 Rust 工具链
rustup update

# 2. 清理缓存并重新安装依赖
rm -rf node_modules package-lock.json
cargo clean
npm install

# 3. 重新构建
npm run tauri build

# Ubuntu/Debian
sudo apt install libwebkit2gtk-4.0-dev libayatana-appindicator3-dev

# Fedora/CentOS  
sudo dnf install webkit2gtk4.0-devel libappindicator-gtk3-devel

支持创建、编辑、删除多个 Claude API 账号，实时显示账号状态

管理项目目录，支持路径验证和配置预览

一键切换不同项目的 Claude 配置，智能关联管理

管理 API 端点，支持自定义 URL 和默认配置

数据库连接状态监控，支持 SQLite 和 MySQL

精细化的权限控制和环境变量配置

支持坚果云、NextCloud 等 WebDAV 服务，实现配置云端备份和多设备同步

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   前端界面      │    │   Tauri 接口    │    │   Rust 后端     │
│                 │    │                 │    │                 │
│  • Bootstrap 5  │◄──►│  • 命令处理     │◄──►│  • 数据库操作   │
│  • JavaScript   │    │  • 事件管理     │    │  • 文件操作     │
│  • 组件化设计   │    │  • 错误处理     │    │  • 配置管理     │
└─────────────────┘    └─────────────────┘    └─────────────────┘

# 1. 安装开发工具
cargo install tauri-cli
npm install -g @tauri-apps/cli

# 2. 启用开发模式
export RUST_LOG=debug
export TAURI_DEBUG=true

# 3. 热重载开发
npm run tauri dev

#[derive(Debug, Serialize, Deserialize, sqlx::FromRow)]
pub struct NewFeature {
    pub id: i32,
    pub name: String,
    pub created_at: chrono::DateTime<chrono::Utc>,
}

pub async fn create_feature(pool: &SqlitePool, name: &str) -> Result<NewFeature> {
    // 实现数据库操作逻辑
}

#[tauri::command]
async fn create_feature(name: String, state: State<'_, AppState>) -> Result<NewFeature, String> {
    // 调用数据库操作
}

async function tauriCreateFeature(name) {
    return await invoke('create_feature', { name });
}

// 使用 tracing 进行结构化日志
use tracing::{info, warn, error};

#[tauri::command]
async fn debug_command() {
    info!("命令开始执行");
    // ... 业务逻辑
    warn!("发现潜在问题");
}

// 开发模式下启用详细日志
if (window.__TAURI__.app.getName) {
    console.log('Tauri 环境已就绪');
}

// 错误处理最佳实践
try {
    const result = await tauriCommand();
    console.log('操作成功:', result);
} catch (error) {
    console.error('操作失败:', error);
    showError(`操作失败: ${getErrorMessage(error)}`);
}

# 格式化代码
cargo fmt

# 静态检查
cargo clippy

# 运行测试
cargo test

• 使用 ES6+ 语法
• 遵循函数式编程原则
• 统一错误处理机制
• 模块化设计

1. 数据库查询优化

   • 使用索引加速查询
   • 避免 N+1 查询问题
   • 合理使用连接池

2. 前端性能优化

   • 延迟加载大量数据
   • 使用分页减少内存占用
   • 防抖搜索输入

3. 打包优化

   • 移除未使用的依赖
   • 启用 LTO 优化
   • 压缩静态资源

本项目采用 MIT 许可证，详见 LICENSE 文件。

1. 🍴 Fork 项目 到你的 GitHub 账户
2. 🌿 创建功能分支 (git checkout -b feature/amazing-feature)
3. 💾 提交更改 (git commit -m 'Add some amazing feature')
4. 📤 推送分支 (git push origin feature/amazing-feature)
5. 📋 创建 Pull Request

• 🐛 Bug 修复: 修复现有问题
• ✨ 新功能: 添加新的功能特性
• 📚 文档: 改进项目文档
• 🎨 界面: 优化用户界面和体验
• ⚡ 性能: 提升应用性能
• 🧪 测试: 添加或改进测试用例

• ✅ 代码符合项目规范
• ✅ 包含适当的错误处理
• ✅ 添加必要的注释和文档
• ✅ 通过所有现有测试
• ✅ 不破坏现有功能

• 🐛 Bug 报告: GitHub Issues
• 💡 功能建议: GitHub Discussions