Claude Code Status：Windows桌面悬浮窗，实时掌握Claude Code运行状态

阅读时间约 5 分钟

一句话总结

Claude Code Status 是一个 Windows 桌面悬浮窗工具，通过 Claude Code 原生 hooks 实时显示 AI 的运行状态——空闲、思考、执行命令、等待确认、已完成或出错——让你无需盯着命令行就能掌握一切。

功能概览

6种状态实时显示

悬浮窗会根据 Claude Code 的当前状态自动切换颜色和文字：

工作原理

Claude Code CLI 生命周期事件
        ↓ （hooks 触发）
  write-status.js （Node.js）
        ↓ （写入 JSON）
  claude-status.json （状态文件）
        ↓ （每 500ms 轮询）
  status-monitor.ps1 （PowerShell + WinForms）
        ↓ （渲染）
  悬浮窗（180×44px 胶囊形窗口）

项目利用 Claude Code 的 9 个 hooks（SessionStart、UserPromptSubmit、PreToolUse、PostToolUse 等），在关键节点自动写入状态。监控窗口每 500ms 读取一次状态文件，更新文字和指示灯动画。

窗口特性

• 尺寸： 180×44px，胶囊形无边框，小巧不占地
• 置顶： 始终在最上层，不被其他窗口遮挡
• 可拖拽： 点击任意位置即可拖动到屏幕任意角落
• 动画： 活跃状态（thinking/executing/waiting）下有呼吸脉冲动画
• 主题： 深色背景 #1e1e2e，高对比度状态色
• 低开销： 500ms 轮询，几乎不占 CPU

安装方式

一键安装（推荐）

双击 install.bat，自动完成三件事：

1. 将脚本复制到 %USERPROFILE%\.claude\scripts\
2. 在 settings.json 中配置 9 个 hooks
3. 启动监控窗口

手动安装

1. 将 write-status.js 和 status-monitor.ps1 复制到 ~/.claude/scripts/
2. 手动在 Claude Code 的 settings.json 中添加 hooks 配置
3. 运行 launch-monitor.bat 启动悬浮窗

价格

完全免费，MIT 开源协议。代码量极少（约 300 行），可自由修改和分发。

适合谁

• 在 Windows 上使用 Claude Code CLI 进行长时间任务（代码生成、批量处理）的开发者
• 喜欢多任务并行、不想频繁切换窗口查看 AI 进度的用户
• 想为 Claude Code 添加自定义状态指示器的二次开发者（代码结构清晰，易于魔改）

用户评价摘要

项目处于早期阶段，GitHub 上暂无用户评价。但从设计思路来看：

• 正面预期： 解决真实痛点，安装简单，视觉设计用心
• 潜在槽点： 仅支持 Windows，macOS/Linux 用户无法使用
• 社区期待： 跨平台支持、更多自定义选项（如窗口大小、颜色主题）

免费替代方案

• Claude Code 内置状态栏： CLI 自带的状态显示，但需要盯着命令行
• HUD 插件： 部分社区插件提供类似功能，但安装配置更复杂
• 自己写脚本： Claude Code 的 hooks 机制足够灵活，可以自己定制