综合介绍

Claudia是一款开源的桌面图形用户界面（GUI）应用程序，专为配合Anthropic公司推出的命令行工具Claude Code而设计。 这款工具旨在解决开发者直接使用命令行操作Claude Code时可能遇到的“终端混乱”问题，例如，在多个会话之间切换管理的复杂性、缺少项目历史和会话的可视化浏览方式，以及难以跟踪API使用情况和成本等。 Claudia通过提供一个直观、美观的图形化界面，让开发者可以更轻松地管理AI编程项目、创建和复用自定义的AI代理、并通过可视化的图表来监控不同项目的token消耗和费用。 该应用使用Tauri 2.0、React 18和Rust等现代技术构建，确保了其跨平台兼容性和本地应用的性能。 目前，Claudia支持在Windows、macOS和Linux系统上通过源码构建安装，未来计划推出预编译的安装程序。

功能列表

• 可视化项目管理: 提供美观的图形界面，用于集中浏览和管理所有Claude Code项目和会-话。
• 自定义AI代理: 用户可以创建具有特定系统提示和在沙盒环境中执行的可复用AI代理。
• AI开销追踪: 通过清晰的图表来监控和分析token使用量、项目成本以及会话数据。
• 内置Markdown编辑器: 支持语法高亮的内置编辑器，用于编辑系统提示（CLAUDE.md），并提供实时预览。
• MCP服务器管理: 提供图形化界面，用于配置和管理模型上下文协议（MCP）服务器。
• 会话时间旅行: 具备类似于Git的会话管理功能，可以创建会话快照、建立分支以及查看不同版本之间的差异。
• 隐私优先: 所有用户数据都存储在本地计算机上，不依赖任何云服务或外部追踪。
• 集成Claude Code: 用户可以直接在Claudia应用内部运行Claude Code会话，无需切换到终端。

使用帮助

Claudia的定位是作为Claude Code的图形化桌面伴侣，因此在使用Claudia之前，你的系统上必须已经安装并配置好了Claude Code命令行工具。

安装流程

目前，Claudia需要从源代码进行构建安装，未来会提供适用于Windows, macOS和Linux的原生安装程序。 以下是从源码构建的基本步骤：

1. 环境准备:
   • 确保你的系统已经安装了Rust和Bun。
   • 根据你的操作系统，可能需要安装特定的依赖，例如在Linux上需要WebKit，在macOS上需要Xcode命令行工具。
   • 你的计算机至少需要4GB内存和1GB的存储空间。
   • 当然，最重要的是需要安装Claude Code CLI。
2. 克隆并构建:
   • 打开终端，从GitHub克隆Claudia的仓库：

     git clone https://github.com/asterisk-org/claudia.git
     

   • 进入项目目录：

     cd claudia
     

   • 安装项目依赖：

     bun install
     

   • 构建并运行应用：

     bun run tauri dev
     

主要功能操作

启动Claudia后，它会自动检测你本地的Claude Code项目目录。如果你之前已经通过命令行创建过项目或代理，它们会直接显示在主界面上。

1. 项目和会话管理:
   • 在主界面（Projects标签页），你可以看到所有Claude Code项目的列表。
   • 点击“New Session”按钮，选择一个项目文件夹，然后选择要使用的Claude模型（例如Sonnet或Opus），即可开始一个新的编码会话。
   • 你也可以在这里看到并恢复过去的所有会话，包括会话的初始消息、时间戳等元数据。
2. 创建自定义AI代理 (CC Agents):
   • 这是Claudia的核心功能之一。切换到CC Agents标签页。
   • 在这里，你可以创建专用的AI代理。例如，你可以创建一个专门用于代码重构的代理，并为其配置特定的系统提示（system prompt），告诉它在重构时需要遵循的规则。
   • 创建的代理可以在沙盒环境中运行，这意味着它们的操作权限会受到限制，从而保证了执行的安全性。
3. 查看开销 (Usage Dashboard):
   • 点击顶部的Usage Dashboard图标，可以进入一个可视化的监控面板。
   • 这个面板会展示你的总花费、会话数量，以及各个项目的具体开销排行，帮助你实时了解Claude API的使用成本。
4. 会话时间旅行与差异比对 (Timeline & Checkpoints):
   • 在一个活动的会话中，Claudia允许你创建“快照”（Checkpoints）。
   • 这就像是代码版本控制中的commit，你可以随时将对话回滚到某个快照的状态。
   • 应用内置了一个差异查看器（Diff Viewer），可以清晰地展示不同快照之间的具体内容变化，非常适合需要反复调试和修改AI指令的场景。
5. 编辑CLAUDE.md:
   • Claudia内置了一个Markdown编辑器，专门用于编辑CLAUDE.md文件。
   • 当你需要为代理或项目编写复杂的系统提示时，这个带语法高亮和实时预览功能的编辑器会非常有用。应用会自动扫描并列出项目中的所有CLAUDE.md文件。

应用场景

1. AI辅助编程与调试对于日常使用Claude Code进行编程、代码生成或调试的开发者，Claudia将命令行操作转化为直观的点击和输入。开发者可以轻松管理多个并行的AI对话，而不会在多个终端窗口中迷失方向。当需要调试一个复杂的bug时，可以创建一个专门的“调试代理”，并使用“时间旅行”功能反复测试不同的提示，直到找到最佳解决方案。
2. 团队协作与知识共享在团队中，可以通过共享CLAUDE.md配置文件来共享高效的AI代理。例如，一位高级工程师可以创建一个用于代码审查的代理，并将其分享给团队成员。其他成员通过Claudia导入后，即可使用这个经过优化的代理来辅助自己完成代码审查任务，从而统一团队的代码质量标准。
3. API成本控制与项目管理对于需要严格控制API预算的个人开发者或公司，Claudia的开销仪表盘提供了一个透明的成本视图。 项目经理或开发者可以定期检查各个项目的token消耗情况，识别出成本异常的会话或代理，并及时进行优化，避免不必要的开销。

QA

1. Claudia是免费的吗？是的，Claudia是完全免费且开源的软件，它使用AGPL许可证分发。你可以从其GitHub仓库下载源代码并自行构建。
2. 使用Claudia是否需要拥有Claude API密钥？是的。Claudia是Claude Code的图形界面，它本身不提供AI功能，而是通过调用你本地安装的Claude Code CLI来与Anthropic的API进行交互。因此，你需要拥有一个有效的Claude API密钥，并已在Claude Code CLI中配置好。
3. 我的数据安全吗？Claudia在设计上遵循“隐私优先”的原则。所有数据，包括你的项目文件、会话历史和API密钥配置，都存储在你的本地计算机上。Claudia不会将这些信息发送到任何外部服务器。
4. Claudia支持哪些操作系统？Claudia支持Windows 10及以上版本、macOS 10.15及以上版本，以及Ubuntu 20.04及以上版本的Linux发行版。