Claudia
扫码查看

一个用来可视化操作Claude Code智能体的图形工具

Claudia

综合介绍

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复制链接