Little Claude

让 Claude Code 从终端走进桌面。

Little Claude 是 Claude Code CLI 的原生桌面客户端，基于 Tauri 2 + React 19 + TypeScript 构建。它没有把终端输出简单地搬进一个窗口，而是通过 Claude Code 的 SDK 控制协议与之深度对话：权限请求变成一张张结构化卡片、计划变成可批准可修改的审查单、多轮问题变成可交互的表单——在保留 CLI 完整工具链（文件操作、Bash、MCP、Skills、Agent）的同时，给你一个真正"看得见、点得动"的桌面工作台。

功能亮点

• 多会话标签页，后台永不掉线 — 每个会话独立进程、并行运行，切换标签即时恢复完整上下文；后台会话的流式输出照常接收，回来后一条消息都不少
• 结构化权限交互（SDK 控制协议） — 工具调用权限渲染为允许 / 拒绝 / 修改输入的可视化卡片；计划模式一键批准或修改计划后执行；Claude 的提问（AskUserQuestion）以表单卡片呈现，选择即提交
• 文件浏览器与编辑器 — 内置文件树、Markdown / HTML / SVG / PDF / 图片预览、CodeMirror 代码编辑、拖拽附加到对话；文件变更实时监听
• Rewind 轮次回退 — 基于 Claude Code 原生检查点（checkpoint），回退到任意历史轮次并恢复当时的文件状态，改坏了随时反悔
• 斜杠命令与命令面板 — 内置命令 + 自定义命令 + Skills 技能面板，一键唤起
• MCP 服务器管理 — 自动扫描并管理 ~/.claude.json 等位置的 MCP 服务器配置
• 多 Provider API 配置 — Anthropic / OpenAI 兼容格式，内置预设（DeepSeek、智谱 GLM、通义千问 Coder、Kimi、MiniMax、Kimi Code、MiMo Token Plan、OpenRouter），支持自定义 Base URL、模型映射、环境变量注入与代理；连接可用性一键测试
• 运行时切换权限模式与模型 — 四种权限模式（标准自动 / 全自动 / 询问 / 计划）+ 会话中直接换模型，无需重启进程
• CLI 全生命周期管理 — 扫描发现所有已安装 CLI、分层显示（官方 / 系统 / 自部署 / 版本管理器）、一键切换与 Pin、注入 PATH、一键安装 / 更新 / 诊断
• 多模态工具扩展 — 视频分析（自动下载 → ASR 转写 → 多模态识图 → 交叉验证）、语音输入（自动选择核显 / 独显 / CPU 压缩）、动态壁纸；另有面试助手模块
• 性能与体验 — 消息虚拟化（长会话依旧顺滑）、内容模糊搜索（带关键词高亮与位置定位）、tok/s 实时速度显示、消息选中复制、中英双语、多主题
• 便携单 EXE — 免安装、免管理员、无临时解压、内置 WebView2 检测；JS 混淆闭源打包
• 前端资源热更新 — 设置页一键热更到最新版，免重装升级；多源检查（GitHub → CDN → 镜像）在 GitHub 卡住时自动降级

与市面同类产品的差异

独到之处，一句话：它是少数真正"接入"了 Claude Code 内部协议、而不是"包装"其输出的桌面客户端。

• 协议级而非画面级 — 通过 --permission-prompt-tool stdio 与 CLI 双向通信：权限、计划、提问都以结构化数据进入界面，而不是从终端文本里"抠"状态
• 多会话是真并发 — 每个会话独立进程 + stdin 管道复用，后台会话照常跑完；这是聊天壳的多 tab 给不了的
• 反悔有保险 — 用 CLI 原生检查点做轮次回退与文件恢复，不是快照模拟
• 一个客户端，全供应商 — 官方 API、OpenAI 兼容、国内大模型预设、代理直连，模型与权限模式会话中随时换
• 超出聊天的工具箱 — 视频分析、语音输入、动态壁纸、面试助手，把它从"对话工具"变成了"桌面工具台"
• 数据完全自主 — 会话以 JSONL 存于本地，可导出 Markdown / JSON，随时迁移，不绑定任何云账号

版本历程

v1.1.6 (2026-08-14) — 全面检修：上下文对齐 DSH + 安全加固

• 上下文计算修复：修复 cache-creation 双算（Ctx 条虚高最多 28 倍、auto-compact 提前触发），与 DeepSeek Harness 的 1M 窗口口径完全对齐
• token 统计对齐 cc-switch：递归扫描含 subagent/workflow 会话、全局去重、缓存归一，统计误差 <50 tokens
• 安全加固：默认模式改为 code（不再默认 --dangerously-skip-permissions）、file-chip 工作区校验、CLI 删除白名单、注入防护、PID 复用防护、task 泄漏修复等
• 性能：统计扫描移入 spawn_blocking，不再阻塞 UI

v1.1.5 (2026-08-13) — 闪退修复 + 面试系统语音识别

• 修复 v1.1.4 启动闪退 — 模型窗口预取在事件循环线程裸启 Tokio 协程触发 "there is no reactor running" panic，部分环境点开即闪退；改走 Tauri 异步运行时，启动不阻塞也不再崩溃。v1.1.4 用户请立即升级
• 面试模块系统语音识别修复 — 微信电话 / 腾讯会议的系统音频（远场弱信号）被麦克风阈值误判为静音：新增系统音频专用阈值（0.001）与麦克风阈值（0.01）分离判定，「系统音频有输入即转写」恢复老版本行为；静音裁切阈值放宽，弱语音不再被裁光
• 面试健壮性加固 — 音频累积上限（超时强制分段判句）；系统音频采集失败自动重启（5 秒退避最多 3 次）；本机 ASR 推理移出锁区（转写期间采集不阻塞、音频不丢）；缓冲上限双保险 + 丢弃日志
• 桌宠系统通知 — 任务完成 / 出错发送 Windows 系统通知（带冷却去重），宠物被遮挡也不错过任务结果
• 桌宠状态氛围 — 引擎级覆盖效果（思考点点 / 写作光标 / 工具扫描线 / 完成彩带 / 失败泪滴 / 睡眠浮 Z / 闲逛爱心），导入的皮肤即使只有 idle 帧也能看到当前状态
• 会话列表状态点四态 — 运行中脉冲绿点 / 对话完成静态绿点 / 出错红点，以普通文本回复结尾的对话完成后也有绿点

v1.1.4 (2026-08-12) — 滚动追踪全面修复 + 轮次历史展开

• 对话滚动追踪全面修复 — 提交后等待首个 token、思考与工具调用阶段不再误判为「用户滚走」，自动跟随不再中断；思考阶段不再上下抖动，随时可以拉到底；「最新」按钮一键到底并自动收尾
• 滚动跟随不再被抢占 — 排队消息 / 自动重试 / 自动压缩触发的新轮次不会把正在读历史的你拉回底部；滚动条拖动、触控板惯性、键盘滚动与输入区滚轮都能正确暂停自动跟随；切换会话标签恢复原阅读位置，图片加载、卡片展开收起后自动补滚到底
• 轮次历史展开预览 — 点击右侧轮次序号向左展开面板，查看该轮次的完整用户提问（当前轮优先倒序展示），可滚动浏览全部历史
• 工具执行期绿点保持 — 侧栏「活跃中」绿点在工具执行期间不再熄灭，模型以工具调用结尾的一轮也会保持绿点，直到该轮真正结束
• 桌宠修复 — 默认关闭双保险（窗口创建即隐藏，不再被历史设置意外唤起）；右键菜单水平/垂直双向钳制 + 窗口宽度下限，宠物缩到最小时菜单也完整显示；气泡左侧锚定并让出右上角徽章区，多会话运行时汇报不再被遮挡
• 桌宠 token 合计与持久化汇报 — token 面板显示该后端全部任务的合计用量（输入/输出/缓存），多会话并行时一眼看到总消耗；任务完成 / 出错汇报持久显示在气泡中，直到新任务替换或手动隐藏，后台任务跑完不再错过
• 联网搜索能力检测式兜底 — 启动时探测主 API 是否原生支持搜索：支持则直连，不支持才自动切换到兜底端点执行搜索，失败自动重试、状态自愈（原先无条件转发兜底的固定行为，现按实际能力分流）
• 安全与稳定性修复批次 — 命令注入防护（默认应用打开、Git 调用加固）、zip 解压路径穿越加固、API 密钥明文导出确认改为原生对话框、预发布版本更新提示修复、含括号/逗号文件名的打开修复、运行环境安装后立即生效（无需重启）
• Ctx bar 修复（重新构建追加） — 重新打开会话后上下文进度条不再恒 0%：从会话历史恢复真实 token 统计，进度百分比立即正确显示
• Ctx bar 双倍计数修复（再次重新构建追加） — DeepSeek 等 input_tokens 已含缓存份额的端点，不再把缓存 token 重复计入上下文（语义感知公式自动识别 Anthropic 官方「三字段之和」与 DeepSeek「单字段即全量」两种语义，实测 96/96 条用量记录验证）；进度条回归真实占用，自动压缩不再提前一倍触发
• 自动压缩时机对齐官方 SDK — 压缩触发判定与 Claude CLI 官方逻辑完全一致（input + 缓存写入/读取 + output 对阈值），不再晚一轮或早一轮
• 会话状态点四态常驻（再次重新构建追加） — 侧栏会话列表新增完成态标记：运行中=脉冲绿点、对话完成=静态绿点、出错=红点；以普通文本回复结尾的对话完成后也有绿点，不再只有工具执行期间才亮

v1.1.3 (2026-08-11) — 新手向导 + 百炼兼容

• 新手教学向导 — 首次进入时逐模块介绍功能（会话 / 输入 / 斜杠命令 / 模式 / 模型 / Rewind / Agent / 文件 / 技能等 15 项），勾选想了解的模块即可，可「以后不再提示」；设置 → 通用 可随时重新体验
• 运行环境手动下载兜底 — Git / Node.js 自动安装失败时显示官网下载链接，手动装完点「重新检测」即可，不再卡在报错上
• 百炼（阿里云 MaaS）平台兼容 — 激活 provider 时注入 --settings 覆盖环境变量：外部 ~/.claude/settings.json 的 env 污染（如 AMD Radeon 工具写入的 ANTHROPIC_BASE_URL / 模型变量）不再劫持请求；模型名按百炼列表填写（如 qwen3.8-max）
• CLI / Node 下载健壮性 — 校验和解析支持裸 64-hex 单段行（华为云镜像格式）、坏行跳过不中断下载、错误提示不再暴露完整 URL
• 系统代理残留清除 — 进程 env 与 settings env 双保险清空 HTTP(S)_PROXY，Clash 全局代理不再导致 502 / 超时
• 上下文窗口声明生效 — 声明 1M 上下文时注入 CLAUDE_CODE_MAX_CONTEXT_TOKENS，绕过 CLI 200K 窗口上限，第三方模型不再被按 80K 窗口提前压缩
• 桌宠增强 — 舞台渲染 / 引擎 / 桥接优化，点击有进化关系的皮肤切换形态（金流苏进化特效）

v1.1.2 (2026-08-10) — 联网搜索兜底 + 前端资源热更新

• 联网搜索兜底模型 — API 提供商底部新增兜底端点配置（如 DeepSeek Anthropic 兼容端点），请求携带 web_search 服务端工具时由本地代理自动转发执行搜索，主提供商无需支持服务端搜索（解决 opencode 等网关 401 "Model not supported"）
• 工具名自动改写 — 代理把 web_search 规范化为版本化 web_search_20250305 + name 字段，兼容 DeepSeek 等版本化端点；密钥支持直接输入或环境变量（二选一），TENC1 加密存储
• 代理层架构扩展 — 现有 Anthropic→OpenAI 转换代理扩展为分发器：Anthropic 格式主端点走 SSE 字节流透传，OpenAI 格式维持转换，搜索请求独立路由到兜底端点
• 热更新免重装升级 — 设置页"更新至新版本"一键应用：下载前端资源包（SHA256 校验防篡改）→ 解压完整性校验（index.html + manifest 版本匹配）→ 原子切换版本目录并提交指针，无需重新安装
• 版本指针与回滚 — 热更资源存于 ~/.tokenicode/web-resources/，版本化目录 dist-vX.Y.Z + current.json 指针；仅当指针存在时磁盘资源生效（优先于内嵌），保留最近 2 版可回滚；重启不丢
• 多源检查与降级 — 检查清单 latest.json（仓库根目录，非 release 资产）由 raw.githubusercontent.com → jsdelivr CDN → ghproxy 镜像 依次读取（Gitee 预留），单源超时 5s 自动切换；GitHub 全挂时保留上次结果不误报
• 完整语义化版本比较 — 支持 v 前缀与预发布后缀（1.2.0-alpha.1 < 1.2.0）；本地预发布可升正式版，正式版不降级到预发布
• 引擎变更自动引导安装包 — 资源包清单 rustChanged: true 时 UI 改为"下载安装包"，热更路径不适用于 Rust 引擎变更
• 联网兜底持久化修复 — 兜底模型的启用开关 / 密钥 / 端点保存后重启不丢失（渲染循环饿死防抖保存的根因修复）
• 本地设置防丢 — 热更协议切换改变了窗口 origin，WebView2 按 origin 隔离 localStorage 会清空字号 / 主题 / 模型 / 头像等全部设置；现将 localStorage 镜像到 ~/.tokenicode/localstorage.json（启动灌回 + 运行时异步落盘），并在首次启动时用隐藏窗口一次性迁移旧 origin 数据，今后任何 origin 变更都不丢设置
• 自动压缩修复 — 此前触发条件与上下文条只统计非缓存 input_tokens，带提示词缓存的会话（缓存占 95%+）永远到不了阈值，功能形同虚设；现按完整请求上下文（input + cache_read + cache_creation）判断。另修复：多会话共享标志互相阻断（改 per-tab）、大上下文压缩被 15s 固定超时误报（改基于流活动判断）、后台会话无自动压缩

8月11日完整版发布：

• 动态壁纸卡顿修复 — 带虚拟显示适配器 / 混合显卡的机器上 WebView2 会回退软件渲染，全屏视频壁纸拖垮整个界面；现强制 GPU 硬件加速，并内置帧率自检：掉帧自动降低壁纸透明度，仍卡则切换静态画面，帧率恢复后自动还原
• API 请求 502 修复 — Clash 等系统代理劫持导致请求超时 / 空 body；启动 CLI 时强制直连（清空 HTTP(S)_PROXY 并 NO_PROXY=*），修复 Clash Verge 全局模式下到部分 API 端点的 502
• 完整便携版发布 — 单文件 EXE 以 tauri-cli 标准流程重新构建（53.9 MB，含全部上述修复），已替换 release 中旧构建产物，下载链接不变

v1.1.1 (2026-08-02) — 交付形态的里程碑

• 便携单 EXE 正式发布 — 单文件、免安装、免管理员、无临时解压，JS 混淆闭源（控制流扁平化 / 字符串数组 / 死代码注入），双击即用
• 消息选中复制 — 正文、思考过程、工具调用全部可选中复制，引用代码不再手敲
• 版本号构建时注入 — 修复设置页与更新检查显示旧版本号的漂移问题
• 发布链路迁移 — 自动更新检查与发布目标统一指向公开仓库，更新链路由 CI 全自动维护

8月3日修复批次：

• 回退不丢上下文 — Rewind 回退后保留 CLI 会话上下文（截断会话历史而非丢弃），回退到任意轮次续聊，Claude 都记得回退点之前的内容
• 头像持久化 — 修复重启后自定义头像丢失的问题（zustand persist 恢复时机缺陷，名字/主题正常而头像缺失的根因）
• 发布链路全线打通 — CI 自动构建、签名、发布安装包并维护 latest.json，修复资产名 sanitize 匹配、stable 构建缺图标、alpha 预发布标记等发布链问题
• 会话删除清理 — 删除会话后关联标签页自动解绑，不再尝试恢复已删除的会话
• 个人统计头像显示 — 个人统计弹窗头像与全局一致显示（data URL → blob URL 转换补齐）

v1.1.0-alpha.1 (2026-08-02) — 自动更新就位

• 全新的更新签名密钥，CI 自动为安装包签名并维护 latest.json，应用内一键升级

v1.1.0 (2026-07-31) — 速度可见

• tok/s 实时速度显示 — 生成快慢一目了然，感知模型"呼吸"
• 安全漏洞与展示优化；修复切换 API 提供商时的错误

v1.0.9 (2026-07-30) — 面试助手进化

• 面试模块支持模型直接识别答案 + 本地识别转文本发送，双通道兜底

v1.0.8 (2026-07-29) — 性能越级

• 消息虚拟化 — 130 轮长对话依旧顺滑，可关闭流式渲染换取极高性能
• 面试模块语音识别自动出答案

v1.0.7 (2026-07-25) — 打磨

• 修复附件上传；优化 Agent 运行时的对话框卡顿

v1.0.6 (2026-07-24) — 搜得到，装得上

• 历史搜索重构 — 按对话内容 / 时间 / CLI 后端搜索，命中位置蓝光闪烁定位
• 一键安装前置依赖 — 设置 → 环境设置，环境部署傻瓜化

v1.0.5 (2026-07-24) — 双引擎

• 新增 codex CLI 支持，Claude / Codex 双后端会话可相互转换

v1.0.4 (2026-07-24) — 稳定版

• 动态壁纸透明度调节；语音识别优化，支持直接语音输入

v1.0.3 (2026-07-24) — 纯净内核

• 修复设置页视觉问题；ccswitch 内核隔离，不再受外部环境配置影响

v1.0.2 (2026-07-23) — 语音与壁纸

• 语音输入 — 自动选择核显 / 独显 / CPU 压缩方案，可点击修改
• 动态壁纸上传，桌面与 AI 共生

v1.0.1 (2026-07-22) — 起点

• 第一版 Little Claude，基于 TOKENICODE 深度重构
• 修复 Bash 与 websearch 链路问题
• 内置 video-analysis 技能 — 视频链接 → 自动下载 → ASR 转写 → 多模态识图 → 交叉验证生成分析内容

下载

请到 GitHub Releases 下载安装包：

• Windows：便携版（x64，单文件免安装免管理员，JS 混淆闭源打包）：Little Claude v1.1.4.exe

快速开始

1. 从 Releases 下载并安装对应平台的安装包。
2. 打开 Little Claude，在设置中配置 API Provider（或使用本机已安装的 Claude Code CLI）。
3. 选择项目文件夹，开始对话。

本地开发

环境要求：

• Node.js、pnpm、Rust（Tauri 2 构建环境）
• Windows 打包需要 MSVC Build Tools

常用命令：

pnpm install        # 安装依赖
pnpm build          # 前端类型检查 + Vite 构建
pnpm tauri dev      # 开发模式（Vite dev server + Tauri 应用）
pnpm tauri build    # 构建生产应用

Rust 侧检查：

cd src-tauri && cargo check && cargo clippy

许可证

本项目基于 Apache License 2.0 授权，请阅读 LICENSE 与 NOTICE。

致谢

• TOKENICODE（TinyZ / yiliqi78）：本项目的代码基础，感谢原作者的辛勤付出与开源贡献
• Tauri、React 与 Claude Code 生态