Claudia:把 Claude Code 装进桌面 GUI,会话、代理与成本一次看清
【免费下载链接】opcodeA powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.项目地址: https://gitcode.com/GitHub_Trending/claudia1/opcode
Claudia 是一款 Claude Code GUI 桌面应用,基于 Tauri 2 + Rust + Rust 后端的 React 前端构建,负责把 Claude Code 的会话管理、AI 编码代理、用量成本和时间线检查点搬进图形界面。如果你已经熟悉命令行版 Claude Code,只是觉得多项目来回切换太累、成本算不清,这篇 Claude Code 桌面应用的介绍可以直接看。
一、命令行用久了,这三个场景最磨人
先说场景。你手上同时有三个项目,每个项目各开一个终端窗口跑 Claude Code,改着改着发现自己在 A 项目里问了 B 项目的问题,上下文全乱了。
再比如你昨天调试到一半,今天重新起会话,--continue能接上最近一次,但更早的关键上下文只能靠翻聊天记录,没有任何可视化的手段回到"昨天那个改对了的节点"。
还有一个更隐蔽的损耗:你跑一个耗时任务,前台终端被占住,想干点别的就得再开窗口;跑完后那次任务花了多少 token、多少钱,终端里只有一行干巴巴的 usage 提示,月底对账全靠猜。
二、Claudia 是什么:Claude Code 的图形化指挥中心
Claudia 的定位一句话讲清:它不替换你的 Claude Code CLI,而是在上面盖一层桌面应用,负责可视化项目与会话、创建并运行自定义代理、跟踪 token 与成本、管理 MCP 服务器,并对会话打检查点做版本回溯。技术上是 Tauri 2 打包,React + TypeScript 负责界面,Rust 负责进程管理、文件操作和 SQLite 存储。打开应用后,左侧是项目与历史会话,右侧是当前会话,顶部标签在"项目 / 代理 / 仪表盘 / 设置"之间切换。
三、上手后的第一周:你先管会话,再跑代理,最后回看时间线
先说一条典型的工作流。你先用"项目 → 会话"把日常对话管起来,再把重复性的活儿沉淀成代理后台跑,最后用时间线回看关键节点。
先管理项目与会话。启动后 Claudia 会自动识别本地的~/.claude目录,把所有 Claude Code 项目列出来;点进某个项目能看到它的全部历史会话,每条会话带首条消息、时间和条数,点一下就能续上,也能直接开新的。对日常编码的意义很直接:上下文切换从"找终端窗口"变成"点一下"。
再创建并运行代理。在代理页面你可以定义专门的 AI 助手:写系统提示词、选模型、设置文件读写与网络权限,然后在任意项目上执行。代理跑在独立子进程里,不阻塞前台会话,执行历史带完整日志和性能指标,随时可以查某一次跑得好不好。对日常编码的意义是:你终于敢在跑长任务的时候去写别的代码了。
最后用时间线回看关键节点。Claude Code 前端组件(时间线导航,负责会话历史的时间轴展示与跳转)让每个检查点都可见,Rust 端的检查点模块(检查点管理,负责检查点的创建、存储与恢复)支持任意检查点间做差异对比,也可以从某个节点直接分叉出新会话。对日常编码的意义是:模型某一步走偏时,你不必从头再来,回退到上一个正确的检查点继续就行。
四、进阶能力:分析仪表盘与 MCP 服务器管理
先说使用分析仪表盘。它按模型、项目、时间维度统计 token 消耗和 API 成本,图表展示趋势,数据可以导出做报表。前端入口在 使用分析面板,Rust 端的成本与 token 统计命令在 usage 命令模块。对你日常编码的意义:月底报销或团队分账时,"这个项目这周花了多少钱"从一句模糊的话变成了一个数字。
再说 MCP 服务器管理。你可以在界面里新增服务器、导入 Claude Desktop 的既有配置,连接前先做连通性测试,避免配置错了到用的时候才报错。前端入口在 MCP 管理器。对你日常编码的意义:给 Claude 接数据库、接文件系统这类扩展,不再需要手改 JSON 配置文件。一份典型的服务器配置长这样:
{ "mcpServers": { "filesystem": { "command": "claude-filesystem-server", "args": ["--root", "/projects"], "env": { "LOG_LEVEL": "info" }, "enabled": true } } }五、技术底座:为什么选 Tauri 2 + Rust + React
选桌面框架基本只有两条路线:Electron 和 Tauri。决定性的考量有三个:包体大小、进程模型、以及后端与 Claude Code CLI 的集成方式。Rust 后端直接负责启动和监控 Claude Code 子进程、读写~/.claude目录、操作 SQLite 存检查点和运行记录,这些系统级活儿用 Rust 写比套一层 Node 更省心,也更快;前端用 React 18 + TypeScript + Zustand 管状态,Tauri 通过 IPC 桥接两端。量级对比大致如下(常见实现的量级,非本仓库实测):
| 维度 | Tauri 2 路线 | Electron 路线 |
|---|---|---|
| 安装包大小 | 十几 MB | 上百 MB |
| 系统 UI 复用 | 原生 WebView | 自带 Chromium |
| 后端语言 | Rust | Node.js |
| IPC 延迟量级 | 毫秒级 | 毫秒级(略高) |
一句话总结这个选型:界面用前端技术栈快速迭代,系统层用 Rust 保证轻和稳,正好覆盖"GUI 要好看、进程要可控"这两头需求。
六、安全模型:三句话讲完
每个代理在独立子进程中执行,崩溃或失控不会拖垮主应用;每个代理的文件读写与网络权限单独配置,前端表单和 Tauri 的 capabilities 清单(默认能力)共同做配置校验;所有会话、检查点、运行记录都存在本机 SQLite 里,官方说明中明确无遥测。对你日常编码的意义:后台代理即使跑飞,也被关在权限配置的笼子里。
七、Claudia 与命令行的差异
一张表收束:
| 维度 | 命令行 Claude Code | Claudia(Claude Code 桌面应用) |
|---|---|---|
| 会话管理 | 终端历史,续接有限 | 可视化列表,一键恢复 |
| 长任务 | 占用前台终端 | 后台独立进程执行 |
| 成本追踪 | 单次 usage 提示 | 按模型/项目/时间统计 |
| 状态回溯 | 手动 git 兜底 | 检查点 + 时间线 + 分叉 |
| CLI 本身 | — | 继续可用,Claudia 在其上层增强 |
注意最后一行:Claudia 没有削弱命令行能力,claude命令该怎么用还怎么用,它只是把"看得见、管得住"的部分补上了。
八、适合谁,以及三步上手
适合的人群比较具体:日常用 Claude Code 且同时维护两个以上项目的开发者、需要给团队核算 API 成本的负责人,以及希望把重复性提示词沉淀成可复用代理的人。如果你一周只开一次 Claude Code,命令行就够了。
三步开始:
- 确保已安装 Claude Code CLI,终端里能跑
claude --version。 - 克隆源码并安装依赖:
git clone https://gitcode.com/GitHub_Trending/claudia1/opcode cd opcode bun install- 构建并启动:开发模式
bun run tauri dev(带热重载),生产构建bun run tauri build,产物在src-tauri/target/release/。首次打开应用会自动识别~/.claude目录,选一个已有项目,就可以开始管理会话了。
Claudia 做的事说到底就是给 Claude Code CLI 补上它缺的那半层:会话、代理、成本、检查点,从"终端里看不见"变成"界面上管得住"。CLI 依然是干活的那只手,Claudia 是放在手边的那块仪表盘——源码全部开放,装在本机,数据也不出门。
【免费下载链接】opcodeA powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.项目地址: https://gitcode.com/GitHub_Trending/claudia1/opcode
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考