告别频繁切窗口!给 Windows 11 装一个 AI 编程状态悬浮球,Claude Code 必备
2026/9/16 9:05:07 网站建设 项目流程

凌晨3点,Claude Code 还在疯狂输出代码,你却陷入了"死等"的焦虑?

相信很多最近在玩 Vibe Coding 的朋友都有这样的体验:

给 Claude Code 下达了一个复杂的指令,然后就只能盯着终端发呆。为了知道 AI 有没有跑完,你是不是每隔几秒就要切回窗口看一眼?遇到需要授权或报错的情况,如果没及时看到,原本几分钟的活儿硬生生被拖成了半小时。

AI 在飞速进化,但我们的"状态反馈"还停留在盯着屏幕干的阶段。

作为一个每天被 Claude Code "折磨"的开发者,我决定把 AI 的"状态"从终端里拽出来,放到桌面上。于是,我开源了这个纯软件小工具——AI Status Light (status-indicator)

它是什么?

这是一个基于Tauri 2 (Rust) + Vue 3 + TypeScript打造的 Windows 桌面悬浮球,专门实时显示Claude Code会话的工作状态。

数据链路非常简单:Claude Code Hook 事件 → Status Hub(本机 HTTP 服务)→ 悬浮球。Hook 安装一次后无需任何干预,球就挂在桌面角落,余光即可感知 AI 在做什么、什么时候需要你。

它支持八种状态语义,颜色 + 动效双编码,一眼就能分辨 AI 当前在干嘛:

状态含义颜色动效
空闲 idle会话在,没在干活绿呼吸/流光(可切换)
思考中 thinking等模型响应慢呼吸
探索代码 exploring读文件/搜索慢呼吸
正在编码 coding编辑文件亮紫快呼吸
执行命令 executing跑命令/测试琥珀旋转光环
等待输入 waiting_input需要你确认、批准或回答闪烁
执行失败 error命令或任务失败常亮
任务完成 done完成(3s后回空闲)亮绿高亮闪现

除了主球体,它还支持卫星点——最多 4 个次要会话以彩点挂在球旁,各自按状态着色。鼠标悬停还会弹出胶囊,显示当前会话名称与详情(比如正在编辑的文件、执行的命令)。

为什么造这个轮子?

市面上没有专门针对 Claude Code 的桌面状态可视化工具。我做这个项目的初衷很简单:

  1. 零硬件成本:纯软件实现,下载即用,不需要买任何开发板或外设。
  2. Claude Code 深度集成:通过 Hook 机制监听 Claude Code 的 7 种会话事件(SessionStart、SessionEnd、UserPromptSubmit、PreToolUse、PostToolUse、Notification、Stop),实时推送状态。
  3. 细节拉满:空闲动效可在"呼吸"和"流光"之间切换并持久化;支持系统关闭动画(prefers-reduced-motion)自动降级;配置新旧版本混跑不丢设置。
  4. 极客浪漫:看着 AI 的进度化作桌上一颗会呼吸的球,那种"我在指挥千军万马"的掌控感,是纯终端给不了的。
1分钟快速上手

为了让大家少走弯路,部署做得非常简单:

  1. 下载:前往 代码仓库 Release 页面下载AI Status Light_x.y.z_x64-setup.exe(NSIS 安装包)。
  2. 安装运行:双击安装并启动,软件会安静地待在系统托盘里。
  3. 安装 Hook(关键一步):托盘图标右键 → 点击「安装 Claude Code Hook」。这会在你的 Claude Code 配置中写入 7 个 Hook 事件监听,完成后悬浮球就能实时收到状态了。
  4. 见证奇迹:打开 Claude Code 跑个任务,看看桌面的悬浮球是不是已经跟着变色了!

提示:Hook 上报是静默的,如果球没反应,把鼠标悬停在托盘图标上,tooltip 会显示实际监听端口和「最后收到事件时间」——后者长时间不更新,就说明事件没进来,可以据此排查。

开源共建

目前项目已在 GitHub 开源(MIT 协议),代码、文档、状态动效 GIF 都整理好了。技术栈是 Tauri 2 + Vue 3 + TypeScript,如果你想魔改 UI、增加新状态或者适配其他工具,欢迎提交 PR!

🔗 仓库地址:码云仓库 Github仓库

如果你在使用过程中遇到了 Bug,或者有什么脑洞大开的想法(比如增加自定义主题、支持更多 AI 工具?),欢迎在 Issue 区向我开炮,或者提交 PR 一起共建!

让我们一起,把 AI 编程的仪式感拉满!

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询