Claudia：为 Claude Code 提供图形界面的开源工具

项目地址：https://github.com/getAsterisk/claudia

项目简介

Claudia[1] 是由 YC 支持的 Asterisk 团队开发的一款开源跨平台桌面应用，旨在为 Anthropic 的 Claude Code 提供直观、美观、可视化的图形界面。

它可以理解为 Claude Code 的“可视化 IDE”，帮助开发者更高效地与 Claude 模型交互，无需频繁使用命令行。同时支持多会话管理、自定义代理、使用统计、多模态输入等功能。

Claudia 跨平台（Windows/macOS/Linux），采用 AGPL-3.0 协议，完全开源免费，数据存储在本地，注重隐私和控制。

核心功能与特点

Claudia UI

•项目/会话管理器：集中管理 Claude Code 项目与历史对话，可一键恢复、搜索、复制或删除。

•自定义 Claude 智能体（Agent）：设置系统提示、使用模型、权限范围等，为不同任务打造专属 AI 代理。

•会话版本控制（Checkpoint）：可对会话打快照，生成分支并对比，像使用 Git 一样管理对话演进。

•使用统计仪表盘：显示 token 消耗、模型使用频率、花费估算等，支持项目级和全局统计图表。

•多模态输入支持：支持拖拽本地图片、网页截图，Claude 会自动识别图像内容。

•内置 CLAUDE.md 编辑器：管理项目上下文、笔记与说明。

•MCP 支持：图形界面快速注册和管理 Model Context Protocol 服务端。

•隐私与安全：所有数据本地存储，智能体运行于受限沙箱中，无需担心隐私泄露。

使用场景

Claudia 适用于开发者、团队协作、教育机构、AI 初学者等多类用户，常见应用包括：

•开发辅助：代码重构、测试生成、文档补全、Bug 查找。

•项目管理：集中管理多个 Claude Code 项目和历史记录。

•智能问答助手：自定义知识型 AI 代理或个人助理。

•教学训练：构建交互式课程、AI 教学机器人。

•内容创作：写作提纲、摘要、语言风格转换等。

安装与使用指南

前置要求：

•已安装 Node.js[2]

•已安装 Bun[3]

•已安装 Rust[4]（用于构建 Tauri 应用）

•已安装 Claude Code CLI：

npm install -g @anthropic-ai/claude-code

开发模式运行（推荐开发者使用）

1.克隆项目仓库：

git clone https://github.com/getAsterisk/claudia.git

cd claudia

1.安装依赖：

bun install

1.启动开发版本（本地桌面程序）：

bun run tauri dev

如果你首次使用 Tauri，可能会提示你安装一些平台依赖项：

•macOS：需要安装 Xcode 命令行工具：xcode-select --install

•Windows：需要安装 WebView2 和 MSVC Build Tools

•Linux：需要 GTK3、Webkit2GTK 等依赖

运行成功后将会启动 Claudia 桌面客户端开发版。

构建生产安装包（可分发）

若你希望将 Claudia 打包为本地可执行文件（安装包），可执行以下命令：

bun run tauri build

构建完成后，安装包会输出到：

src-tauri/target/release/bundle/

支持格式：

•.app（macOS）

•.msi / .exe（Windows）

•.deb / .AppImage（Linux）

你可以双击打开本地构建的桌面程序进行体验。

项目文件结构说明

Claudia 启动后默认会读取 ~/.claude 目录作为项目和 Agent 的工作空间，并自动列出：

•~/.claude/projects/：你的 Claude Code 项目

•~/.claude/agents/：你的智能体（Agent）配置

启动提示

•若 claude CLI 命令不可用，请检查环境变量是否设置正确。

•可通过 Claude Code 创建 .claude 项目目录，然后在 Claudia 中加载和可视化使用。

快速测试

如果你已经安装完成，执行：

claude init my-demo

然后在 Claudia 中打开 my-demo 项目，即可开始图形化使用 Claude 模型进行代码开发与辅助对话。

技术架构简述

设计目标是：本地优先、快速响应、隐私保护

与其他工具的对比

社区与贡献

Claudia 是一个社区友好的项目，你可以：

•🌟 给项目加 Star：https://github.com/getAsterisk/claudia

•🐛 提交 Issue：反馈 Bug 或提出新需求

•🔧 提交 Pull Request：贡献代码、文档或翻译

•💬 加入讨论：Twitter @getAsterisk[5]

总结

Claudia 不只是一个 Claude Code 的 GUI，它是你打造 AI 助理工作流的理想中枢工具。无论是日常开发、文档管理、还是构建多智能体协作环境，Claudia 都可以让 AI 开发流程更直观、高效、可控。

如果你正在使用 Claude 或计划集成 Claude 相关能力，不妨尝试一下 Claudia，它可能会成为你 AI 工作流中最称手的“中控台”。

立即体验开源 AI 助理平台：

GitHub 项目：https://github.com/getAsterisk/claudia

References

[1] Claudia: https://github.com/getAsterisk/claudia

[2] Node.js: https://nodejs.org/

[3] Bun: https://bun.sh/

[4] Rust: https://www.rust-lang.org/

[5] Twitter @getAsterisk: https://twitter.com/getAsterisk

文章来自于微信公众号“麦奇派”，作者是“麦奇”。