项目地址: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
文章来自于微信公众号“麦奇派”,作者是“麦奇”。