Misaka

Misaka

  Claude Code 桌面 GUI 客户端
  用原生桌面体验释放 Claude Code 的全部潜力

  中文 · English

完全开源，欢迎 Star 和贡献！ 项目正在快速迭代中，期待与你一起共建。

这是什么？

Misaka 是一个基于 Python + Flet（Flutter）构建的 Claude Code 桌面 GUI 客户端。它解决了 Claude Code 仅有命令行界面的痛点，将多轮流式对话、会话管理、文件浏览、MCP 服务器集成、技能市场等能力整合进一个精致的 Material Design 3 原生桌面应用中。

一句话概括： 让你像使用 VS Code 一样使用 Claude Code，但更轻量、更专注。

为什么选择 Misaka？

解决的核心问题

- 没有官方 GUI：Claude Code 只提供 CLI，Misaka 提供完整的图形化操作界面
- 多配置切换困难：手动编辑配置文件切换 API 提供商和模型？Misaka 的 Router 一键搞定
- 环境配置繁琐：首次使用不知从何下手？引导式设置向导自动检测并配置一切
- 缺乏运行状态可视化：Token 用量、MCP 服务器状态、会话统计——仪表板一目了然

独有亮点

功能全景

对话与交互

- 流式响应 — 实时逐 token 渲染，支持随时中止
- 三种对话模式 — Code（编码）· Plan（规划）· Ask（问答），一键切换
- 多模型切换 — 通过 /model 在 Sonnet、Opus、Haiku 之间自由切换
- Thinking Block — 实时展示 AI 推理过程，可折叠查看
- 快捷命令 — /init、/doctor 等斜杠命令直接发送
- 权限控制 — 文件编辑或 Shell 命令执行前弹出交互式审批对话框
- 消息复制 — 用户消息和 AI 回复均支持右键复制

会话管理

- 创建 / 重命名 / 删除 / 搜索 会话
- 按项目分组 — 会话列表支持按工作目录分组或按日期分组，侧栏一键切换
- 会话归档 — 右键归档不需要的会话，随时恢复，保持列表整洁
- 导入 CLI 会话 — 将 Claude Code CLI 的历史会话一键导入，支持分页加载与搜索

智能诊断

- 环境检查 — 启动时自动检测 Claude Code CLI、Node.js、Python、Git，缺失时提供一键安装
- 版本检查 — 自动检测 CLI 新版本，支持一键升级
- Provider Doctor — 结构化诊断探针：CLI 存在性、API Key 有效性、环境变量完整性，分级报告 + 修复建议
- 结构化错误分类器 — 16 类错误自动分类（网络 / 认证 / 限流 / 解析 / 权限 / 超时等），友好的错误提示 + 建议操作

数据与可视化

- 统一仪表板 — 环境状态、MCP 健康、会话统计、技能统计、Token 累计概览
- 每日统计图表 — 按天聚合 Token 用量，柱状图可视化输入 / 输出 Token
- 上下文用量指示器 — 聊天底栏实时显示 Token 消耗和上下文窗口使用进度
- 运行时日志 — 内存环形缓冲（200 条），自动脱敏，设置页面可直接查看

扩展生态

- MCP 服务器管理 — 支持 stdio / http / sse 三种传输类型，UI 添加或配置文件编辑
- MCP 在线市场 — 搜索官方 MCP Registry，一键生成远程或 npm / PyPI stdio 配置
- 项目级 MCP 配置 — 自动加载项目目录下的 .mcp.json，按项目隔离 MCP 工具
- 技能管理 — 查看全局 / 项目 / 已安装 / 插件四类技能来源
- 技能在线市场 — 搜索并安装 skills.sh 社区技能
- 技能编辑器 — 双窗格布局：左侧 SKILL.md 编辑器 + 右侧文件夹浏览器

个性化

- 多语言 — English · 简体中文 · 繁體中文
- 主题切换 — 浅色 / 深色 / 跟随系统，支持自定义强调色
- 数据目录自定义 — 通过环境变量 MISAKA_DATA_DIR…