开源免费！Claude Code用量监控Windows小组件：像素Clawd实时反馈

对于重度使用 Claude Code 的开发者来说，最怕的不是写不出代码，而是写到一半突然被限流。官方虽然提供了 /usage 命令查看额度，但每次手动敲一遍显然不够优雅。最近，一位开发者在 Reddit 上分享了自己用 Claude Code 亲手打造的一款 Windows 桌面小组件——clawd-usage-winwidget，不仅能实时显示额度，还配了一只像素风的吉祥物 Clawd 陪你写代码。

零 Token 消耗的实时额度监控

这款小组件最核心的功能，是在不消耗任何 Token 的前提下，实时监听你的 Claude 套餐余量。

据作者介绍，其原理相当巧妙：组件在后台以无头模式运行 claude -p "/usage" 命令。这个命令直接向服务端请求你当前登录账号的用量百分比，包括当前会话额度、每周限额以及 Fable 限额，数据每分钟自动刷新一次。由于它只是查询账户状态而非调用模型推理，因此完全不会产生额外的 Token 费用。

除了额度显示，小组件还集成了开发者非常需要的几项信息：当前所有正在运行的 Claude Code 会话状态（工作中 / 等待输入 / 空闲）、Anthropic 服务健康状态，以及 Claude Code 是否有新版本可更新。所有数据都来自于 Claude Code 自身维护的注册表 ~/.claude/sessions，无需额外安装任何依赖，只要有 PowerShell 5.1 和一个已登录的 Claude Code 即可运行。

什么是无头模式（headless mode）？

无头模式指的是命令行工具在不需要人工交互界面的情况下自动执行任务。对于 Claude Code 而言，claude -p "..." 中的 -p 即 --print 参数，表示以「非交互式」的方式运行：程序接收一段提示词后直接执行并把结果打印到标准输出，然后退出，全程无需打开交互式终端界面。这种模式非常适合被脚本、定时任务或其他程序调用。clawd-usage-winwidget 正是利用这一点，在后台静默执行 claude -p "/usage"，把额度查询变成了一次可被程序解析的「函数调用」，从而实现了零 Token 消耗的实时监控。理解无头模式，也就理解了这款工具为何能既省钱又自动刷新。

WPF 是什么？为什么它与 PowerShell 5.1 搭配有坑？

WPF（Windows Presentation Foundation）是微软随 .NET Framework 推出的桌面 UI 框架，支持矢量渲染、动画和数据绑定，常被用来构建外观现代的 Windows 应用。它可以通过 PowerShell 脚本直接调用，无需额外安装 Visual Studio 或编译环境——这正是 clawd-usage-winwidget 能做到「双击即用」的关键。但 PowerShell 5.1 是 Windows 10/11 自带的旧版本，属于 .NET Framework 时代，功能上落后于 PowerShell 7：它不支持 ?? 空合并运算符、处理 UTF-8 文件时容易被 BOM 干扰、某些现代语法也无法识别。因此作者才会在 CLAUDE.md 中专门记录这些坑，避免后续开发踩雷。

会撒娇的像素吉祥物 Clawd

这款工具最吸引眼球的，是那个住在窗口里的像素风小生物——Clawd。它不是单纯的装饰，而是会根据你的使用状态做出实时反应。

当没有任何会话运行时，Clawd 会钻进地洞里呼呼大睡；当有会话正在工作时，它会跟着忙碌奔跑；当某个会话在等待你输入时，它会举起问号向你招手；当额度接近上限时，它会紧张得满头大汗；而一旦额度达到 100%，它就会四脚朝天躺平。窗口标题栏上的爱心数量，则直观代表了当前剩余的会话额度。

据作者透露，Clawd 的所有姿态和动画，都是 Claude Code 根据自身欢迎界面的艺术图逐格复刻出来的，因此终端里和桌面上的 Clawd 形象完全一致。这种“自己画自己”的趣味性，让一个原本枯燥的监控工具多了不少情感连接。

Claude Code 全程参与构建

值得一提的是，这款工具本身就是用 Claude Code 完成的。作者坦言，以 PowerShell + WPF 的体量（约 3000 行代码），他本人根本不可能手写完成。</pp>

在整个开发过程中，Claude Code 扮演了多个关键角色：它将原始的单文件脚本拆分为约 18 个模块化文件，并撰写了 CLAUDE.md 说明文件，记录模块加载顺序和 PowerShell 5.1 的各种坑（如 UTF-8 BOM 问题、不支持 ?? 运算符等），确保后续会话不会破坏已有功能；在公开发布阶段，它又添加了英文界面和即时语言切换功能，翻译了所有代码注释，并编写了一个录制脚本，用脚本化的假数据直接从 WPF 渲染出 README 所需的 GIF 动图。

正是通过录制 GIF，作者才发现了一个英文文本与标题栏重叠的布局 Bug。此外，Claude Code 还帮作者定位了一个隐蔽问题：从 Git Bash 运行 claude -p "/usage" 时，/usage 会被解析为文件路径并作为提示词发送给模型——因此小组件被限制为只能从 PowerShell 调用该命令。

CLAUDE.md 与「会话持久化」的意义

CLAUDE.md 是 Claude Code 约定俗成的一个项目级说明文件，放在仓库根目录，会被 Claude Code 在每次会话开始时自动读取。它相当于给 AI 助手的「项目备忘录」，用来记录代码结构、模块加载顺序、已知的兼容性问题和开发规范。由于 Claude Code 的会话上下文是有限的，长时间、多轮次的开发很容易遗忘早期约定；有了 CLAUDE.md，后续每次会话都能自动「回忆」起这些关键信息，从而保证约 3000 行、18 个模块的项目不会因为跨会话而互相破坏。可以说，它正是这款工具能被 AI 稳定迭代的隐性基础设施。

如何获取与使用

这款工具完全免费且开源，采用 MIT 协议。想要体验的开发者可以直接从 GitHub 克隆或下载 ZIP 包，双击 start-widget.vbs 即可启动。

运行环境要求为 Windows 10/11 系统，并且已经安装了 Claude Code 并完成登录。作者特别声明，该工具与 Anthropic 官方无关联，属于社区个人作品。项目地址：https://github.com/Enhed/clawd-usage-winwidget

对于每天都要和 Claude Code 打交道的 Windows 用户来说，这或许是一款能实实在在提升幸福感的桌面小工具。