Claudia
访问网站
扫码查看
复制链接

一个为Claude Code打造的图形化桌面应用

标签：AI编程 , Claude Code , Claudia , GUI , 人工智能 , 开发工具 , 开源软件 , 桌面应用

Claudia

AI工作效率 / 编程/开发30 次浏览

综合介绍

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发行版。

综合介绍

Claudia 是一个强大的桌面应用程序，它为 Anthropic 公司出品的AI编码工具 Claude Code 提供了一个图形用户界面（GUI）。Claude Code 本身是一个在命令行终端中运行的“智能体”，可以通过自然语言指令来帮助开发者完成编码、调试、Git操作等任务。而 Claudia 的作用，就是将这些命令行的交互过程变得可视化。它提供了一个用户友eth好的界面，让开发者可以像使用普通软件一样，通过点选窗口和按钮来管理与AI的编码会话、创建和定制不同用途的AI智能体、以及实时追踪 Claude API 的使用情况和费用。你可以把 Claudia 看作是 Claude Code 的一个可视化指挥中心，它降低了使用门槛，让开发者能更直观、更高效地利用AI辅助编程。

功能列表

  • 项目和会话管理：提供一个可视化的项目浏览器，可以清晰地看到所有 Claude Code 项目的历史会话、上下文和时间戳，并且可以快速搜索和恢复任意一次会话。
  • 自定义AI智能体 (CC Agents)：允许用户创建具有特定系统提示和行为的专属AI智能体。你可以建立一个用于处理特定任务（如“代码审查”、“修复Bug”）的智能体库，并在后台进程中运行它们。
  • 用量分析仪表盘：实时监控和追踪你使用 Claude API 所产生的费用。它通过图表直观展示不同模型、不同项目的Token消耗情况，并支持导出数据用于分析。
  • 时间线与检查点：可以为你的编码会話在任何时间点创建“检查点”（版本快照）。通过一个可视化的分支时间线，你可以轻松地在不同检查点之间跳转、恢复，甚至创建分支进行不同的尝试。
  • CLAUDE.md 文件管理：内置一个编辑器，可以直接在应用内修改项目中的 CLAUDE.md 配置文件，并支持语法高亮和实时预览。
  • MCP服务器管理：提供一个统一的界面来管理和配置模型上下文协议（MCP）服务器，并可以测试服务器的连接状态。

使用帮助

Claudia 目前没有提供预编译的安装包，因此需要用户从源代码自行构建。这需要你具备一些基础的开发环境配置知识。

第一步：安装先决条件

在开始构建之前，你的电脑上必须安装好以下工具：

  1. Claude Code CLI：这是 Claudia 运行的基础，你必须先从 Anthropic 的官方渠道下载并安装它。安装完成后，请确保 claude 命令在你的系统终端中可用。你可以通过运行 claude --version 来检验。
  2. Rust 环境：Claudia 的后端是使用 Rust 语言编写的。
    • 打开终端，运行以下命令来安装 Rust 管理工具 rustup： 
      curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  3. Bun 环境：项目的前端依赖 Bun 作为包管理器和运行环境。
    • 在终端中运行以下命令安装 Bun： 
      curl -fsSL https://bun.sh/install | bash
  4. Git：用于从 GitHub 克隆源代码。大部分系统中已预装。

特定平台的额外依赖：

  • Linux (Ubuntu/Debian 系统): 
    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:
    • 需要安装 Xcode 命令行工具： 
      xcode-select --install
  • Windows:
    • 需要安装 Microsoft C++ Build Tools。
    • 系统通常已自带 WebView2，如果没有，需要手动安装。

第二步：从源代码构建 Claudia

  1. 克隆代码仓库
    • 打开终端，使用 git 命令将项目代码克隆到你的本地电脑： 
      git clone https://github.com/getAsterisk/claudia.git
cd claudia
  2. 安装前端依赖
    • 在项目根目录下，运行 bun 命令来安装所有前端所需的库文件： 
      bun install
  3. 编译应用程序
    • 运行以下命令来编译生成可用于生产环境的应用程序： 
      bun run tauri build
    • 编译过程需要一些时间。成功后，你可以在 src-tauri/target/release/bundle/ 目录下找到对应你操作系统的可执行文件（如 claudia.exe 或 .dmg 安装包）。

第三步：如何使用 Claudia

成功构建并启动 Claudia 后，你可以开始使用它的核心功能。

  1. 项目管理 (CC Projects)
    • 启动 Claudia 后，应用会自动检测并加载位于你用户目录 ~/.claude/projects/ 下的所有 Claude Code 项目。
    • 在主界面的 “CC Projects” 视图中，你会看到一个项目列表。
    • 点击任意一个项目，右侧会展示该项目的所有历史会话。每个会话都会显示初始的提问信息和时间戳。
    • 你可以选择一个旧会话点击 “Resume” 来恢复它，或者开始一个新的会话。
  2. 创建和使用智能体 (CC Agents)
    • 切换到 “CC Agents” 视图，这里是你管理自定义AI助手的地方。
    • 点击 “Create Agent” 按钮来创建一个新的智能体。
    • 你需要为它配置几个关键信息：
      • 名称和图标：给你的智能体起一个容易识别的名字。
      • 系统提示 (System Prompt)：这是智能体的核心。你需要在这里输入一段详细的指令，告诉它扮演什么角色、遵循什么规则、完成什么目标。例如，一个用于生成Git提交信息的智能体，它的提示可能是“你是一个专业的Git工程师，请根据下面的代码变更，生成一段符合Conventional Commits规范的提交信息。”
      • 模型选择：选择驱动这个智能体运行的 Claude 模型（如 Opus 或 Sonnet）。
      • 权限设置：配置该智能体是否有权限读取或写入文件、访问网络等，以保证安全。
    • 创建完成后，你就可以在任何项目上运行这个智能体来自动执行特定任务。
  3. 查看用量仪表盘
    • 从顶部菜单栏进入 “Usage Dashboard”。
    • 这里会以图表的形式清晰展示你的 Claude API Key 在不同模型、不同项目上的花费和Token消耗量。
    • 这对于控制成本非常有用，可以让你清楚地知道哪部分开销最大。

应用场景

  1. 可视化管理代码会话对于经常使用 Claude Code 但不习惯纯命令行界面的开发者来说，Claudia 提供了一个直观的替代方案。你可以方便地浏览、搜索和恢复过去与AI的任何一次对话，而不需要在终端历史记录里费力地翻找。每个项目的上下文和历史记录都一目了然。
  2. 构建个人专属的AI工具箱开发者可以利用“CC Agents”功能，为日常工作中重复性高的任务创建专门的AI智能体。例如，创建一个“文档生成器”智能体，用于为代码自动编写注释和文档；或者创建一个“测试用例编写器”智能体，根据函数功能自动生成测试代码。这能极大地提升个人开发效率。
  3. 团队或个人的API成本监控对于需要严格控制API预算的个人开发者或小型团队，Claudia 的用量仪表盘是一个关键功能。它能实时追踪通过 Claude Code 产生的所有API费用，并提供详细的分类视图，帮助用户了解成本构成，避免意外的超支。

QA

  1. Claudia 和 Claude Code 有什么关系？Claude Code 是由 Anthropic 公司开发的一款在终端（命令行）里运行的AI代码辅助工具。Claudia 则是一个独立的第三方开源项目，它为 Claude Code 提供了一个图形用户界面（GUI）。你可以将 Claudia 理解为 Claude Code 的一个“可视化控制中心”，它让你能通过点击图形界面的方式来使用 Claude Code 的强大功能，而无需手动输入命令行指令。
  2. 使用 Claudia 需要付费吗？Claudia 项目本身是开源免费的。 但是，它在工作时需要调用 Claude Code，而 Claude Code 与AI模型交互会消耗 Anthropic 公司的API用量，这部分服务是需要按照 Anthropic 的官方定价付费的。Claudia 内置的“用量分析仪表盘”功能，正是为了帮助你清晰地监控这部分的开销。
  3. 我是编程初学者，应该如何安装 Claudia？目前，Claudia 还没有发布可直接下载安装的软件包。用户需要从源代码自行编译安装。这个过程要求用户预先在电脑上安装一些开发工具，例如 Rust、Bun 和 Claude Code CLI 工具本身。详细的步骤在上面的“使用帮助”部分有说明，这个过程需要一定的技术背景和动手能力。
微信微博Email复制链接