Claudia
强大的 Claude Code GUI 应用程序和工具包
创建自定义智能体，管理交互式 Claude Code 会话，运行安全的后台智能体等更多功能。
🇺🇸 English | 🇨🇳 中文
https://github.com/user-attachments/assets/bf0bdf9d-ba91-45af-9ac4-7274f57075cf
> [!TIP]
> **⭐ 为仓库点星并关注 [@getAsterisk](https://x.com/getAsterisk) 获取 `asteria-swe-v0` 的早期访问权限**。
## 🌟 概述
**Claudia** 是一款功能强大的桌面应用程序，它彻底改变了您与 Claude Code 的交互方式。基于 Tauri 2 构建，它为管理 Claude Code 会话、创建自定义智能体、跟踪使用情况等提供了美观的 GUI。
将 Claudia 视为您的 Claude Code 指挥中心——连接命令行工具与可视化体验，让 AI 辅助开发更加直观和高效。
## 📋 目录
- [🌟 概述](#-概述)
- [✨ 特性](#-特性)
- [🗂️ 项目和会话管理](#️-项目和会话管理)
- [🤖 CC 智能体](#-cc-智能体)
- [📊 使用分析仪表板](#-使用分析仪表板)
- [🔌 MCP 服务器管理](#-mcp-服务器管理)
- [⏰ 时间线和检查点](#-时间线和检查点)
- [📝 CLAUDE.md 管理](#-claudemd-管理)
- [📖 使用](#-使用)
- [入门指南](#入门指南)
- [管理项目](#管理项目)
- [创建智能体](#创建智能体)
- [跟踪使用情况](#跟踪使用情况)
- [使用 MCP 服务器](#使用-mcp-服务器)
- [🚀 安装](#-安装)
- [🔨 从源码构建](#-从源码构建)
- [🛠️ 开发](#️-开发)
- [🔒 安全性](#-安全性)
- [🤝 贡献](#-贡献)
- [📄 许可证](#-许可证)
- [🙏 致谢](#-致谢)
## ✨ 特性
### 🗂️ **项目和会话管理**
- **可视化项目浏览器**：在 `~/.claude/projects/` 中导航浏览所有 Claude Code 项目
- **会话历史**：查看并恢复具有完整上下文的过往编码会话
- **智能搜索**：通过内置搜索快速查找项目和会话
- **会话洞察**：一览首条消息、时间戳和会话元数据
### 🤖 **CC 智能体**
- **自定义 AI 智能体**：创建具有自定义系统提示和行为的专业化智能体
- **智能体库**：为不同任务构建专用智能体集合
- **后台执行**：在独立进程中运行智能体，实现非阻塞操作
- **执行历史**：跟踪所有智能体运行，提供详细日志和性能指标
### 📊 **使用分析仪表板**
- **成本跟踪**：实时监控您的 Claude API 使用情况和成本
- **令牌分析**：按模型、项目和时间段详细分解
- **可视化图表**：显示使用趋势和模式的精美图表
- **导出数据**：导出使用数据用于会计和分析
### 🔌 **MCP 服务器管理**
- **服务器注册表**：从中央 UI 管理模型上下文协议服务器
- **轻松配置**：通过 UI 添加服务器或从现有配置导入
- **连接测试**：在使用前验证服务器连接性
- **Claude Desktop 导入**：从 Claude Desktop 导入服务器配置
### ⏰ **时间线和检查点**
- **会话版本控制**：在编码会话的任何时点创建检查点
- **可视化时间线**：通过分支时间线导航会话历史
- **即时恢复**：一键跳转到任何检查点
- **分叉会话**：从现有检查点创建新分支
- **差异查看器**：查看检查点之间的确切变化
### 📝 **CLAUDE.md 管理**
- **内置编辑器**：直接在应用内编辑 CLAUDE.md 文件
- **实时预览**：实时查看 markdown 渲染结果
- **项目扫描器**：查找项目中的所有 CLAUDE.md 文件
- **语法高亮**：完整的 markdown 支持和语法高亮
## 📖 使用
### 入门指南
1. **启动 Claudia**：安装后打开应用程序
2. **欢迎界面**：在 CC 智能体或 CC 项目之间选择
3. **首次设置**：Claudia 将自动检测您的 `~/.claude` 目录
### 管理项目
```
CC 项目 → 选择项目 → 查看会话 → 恢复或开始新会话
```
- 点击任何项目查看其会话
- 每个会话显示首条消息和时间戳
- 直接恢复会话或开始新会话
### 创建智能体
```
CC 智能体 → 创建智能体 → 配置 → 执行
```
1. **设计您的智能体**：设置名称、图标和系统提示
2. **配置模型**：在可用的 Claude 模型中选择
3. **设置权限**：配置文件读写和网络访问
4. **执行任务**：在任何项目上运行您的智能体
### 跟踪使用情况
```
菜单 → 使用仪表板 → 查看分析
```
- 按模型、项目和日期监控成本
- 导出数据用于报告
- 设置使用警报（即将推出）
### 使用 MCP 服务器
```
菜单 → MCP 管理器 → 添加服务器 → 配置
```
- 手动添加服务器或通过 JSON
- 从 Claude Desktop 配置导入
- 使用前测试连接
## 🚀 安装
### 前置要求
- **Claude Code CLI**：从 [Claude 官方网站](https://claude.ai/code) 安装
### 发布版本即将发布
## 🔨 从源码构建
### 前置要求
在从源码构建 Claudia 之前，请确保已安装以下工具：
#### 系统要求
- **操作系统**：Windows 10/11、macOS 11+ 或 Linux（Ubuntu 20.04+）
- **内存**：最小 4GB（推荐 8GB）
- **存储**：至少 1GB 可用空间
#### 必需工具
1. **Rust**（1.70.0 或更高版本）
```bash
# 通过 rustup 安装
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
2. **Bun**（最新版本）
```bash
# 安装 bun
curl -fsSL https://bun.sh/install | bash
```
3. **Git**
```bash
# 通常预装，但如果没有：
# Ubuntu/Debian: sudo apt install git
# macOS: brew install git
# Windows: 从 https://git-scm.com 下载
```
4. **Claude Code CLI**
- 从 [Claude 官方网站](https://claude.ai/code) 下载并安装
- 确保 `claude` 在您的 PATH 中可用
#### 特定平台依赖
**Linux (Ubuntu/Debian)**
```bash
# 安装系统依赖
sudo apt update
sudo apt install -y \
libwebkit2gtk-4.1-dev \
libgtk-3-dev \
libayatana-appindicator3-dev \
librsvg2-dev \
patchelf \
build-essential \
curl \
wget \
file \
libssl-dev \
libxdo-dev \
libsoup-3.0-dev \
libjavascriptcoregtk-4.1-dev
```
**macOS**
```bash
# 安装 Xcode 命令行工具
xcode-select --install
# 通过 Homebrew 安装额外依赖（可选）
brew install pkg-config
```
**Windows**
- 安装 [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
- 安装 [WebView2](https://developer.microsoft.com/microsoft-edge/webview2/)（通常在 Windows 11 上预装）
### 构建步骤
1. **克隆仓库**
```bash
git clone https://github.com/getAsterisk/claudia.git
cd claudia
```
2. **安装前端依赖**
```bash
bun install
```
3. **构建应用程序**
**开发环境（热重载）**
```bash
bun run tauri dev
```
**生产构建**
```bash
# 构建应用程序
bun run tauri build
# 构建的可执行文件将位于：
# - Linux: src-tauri/target/release/bundle/
# - macOS: src-tauri/target/release/bundle/
# - Windows: src-tauri/target/release/bundle/
```
4. **特定平台构建选项**
**调试构建（编译更快，二进制文件更大）**
```bash
bun run tauri build --debug
```
**不打包构建（仅创建可执行文件）**
```bash
bun run tauri build --no-bundle
```
**macOS 通用二进制（Intel + Apple Silicon）**
```bash
bun run tauri build --target universal-apple-darwin
```
### 故障排除
#### 常见问题
1. **"cargo not found" 错误**
- 确保已安装 Rust 且 `~/.cargo/bin` 在您的 PATH 中
- 运行 `source ~/.cargo/env` 或重启终端
2. **Linux: "webkit2gtk not found" 错误**
- 安装上面列出的 webkit2gtk 开发包
- 在较新的 Ubuntu 版本上，您可能需要 `libwebkit2gtk-4.0-dev`
3. **Windows: "MSVC not found" 错误**
- 安装支持 C++ 的 Visual Studio Build Tools
- 安装后重启终端
4. **"claude command not found" 错误**
- 确保已安装 Claude Code CLI 且在您的 PATH 中
- 使用 `claude --version` 测试
5. **构建失败，"out of memory" 错误**
- 尝试使用较少的并行作业构建：`cargo build -j 2`
- 关闭其他应用程序以释放内存
#### 验证构建
构建后，您可以验证应用程序是否正常工作：
```bash
# 直接运行构建的可执行文件
# Linux/macOS
./src-tauri/target/release/claudia
# Windows
./src-tauri/target/release/claudia.exe
```
### 构建产物
构建过程创建几个产物：
- **可执行文件**：主要的 Claudia 应用程序
- **安装包**（使用 `tauri build` 时）：
- `.deb` 包（Linux）
- `.AppImage`（Linux）
- `.dmg` 安装程序（macOS）
- `.msi` 安装程序（Windows）
- `.exe` 安装程序（Windows）
所有产物位于 `src-tauri/target/release/bundle/`。
## 🛠️ 开发
### 技术栈
- **前端**：React 18 + TypeScript + Vite 6
- **后端**：Rust with Tauri 2
- **UI 框架**：Tailwind CSS v4 + shadcn/ui
- **数据库**：SQLite（通过 rusqlite）
- **包管理器**：Bun
### 项目结构
```
claudia/
├── src/ # React 前端
│ ├── components/ # UI 组件
│ ├── lib/ # API 客户端和工具
│ └── assets/ # 静态资源
├── src-tauri/ # Rust 后端
│ ├── src/
│ │ ├── commands/ # Tauri 命令处理器
│ │ ├── checkpoint/ # 时间线管理
│ │ └── process/ # 进程管理
│ └── tests/ # Rust 测试套件
└── public/ # 公共资源
```
### 开发命令
```bash
# 启动开发服务器
bun run tauri dev
# 仅运行前端
bun run dev
# 类型检查
bunx tsc --noEmit
# 运行 Rust 测试
cd src-tauri && cargo test
# 格式化代码
cd src-tauri && cargo fmt
```
## 🔒 安全性
Claudia 优先考虑您的隐私和安全：
1. **进程隔离**：智能体在独立进程中运行
2. **权限控制**：为每个智能体配置文件和网络访问
3. **本地存储**：所有数据保留在您的机器上
4. **无遥测**：无数据收集或跟踪
5. **开源**：通过开源代码实现完全透明
## 🤝 贡献
我们欢迎贡献！请查看我们的[贡献指南](CONTRIBUTING.md)了解详情。
### 贡献领域
- 🐛 错误修复和改进
- ✨ 新功能和增强
- 📚 文档改进
- 🎨 UI/UX 增强
- 🧪 测试覆盖
- 🌐 国际化
## 📄 许可证
本项目采用 AGPL 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
## 🙏 致谢
- 使用 [Tauri](https://tauri.app/) 构建 - 构建桌面应用的安全框架
- [Claude](https://claude.ai) by Anthropic
---