用Claude Code自制的Windows任务栏Claude用量小部件

一个由 Claude Code 全程开发、常驻 Windows 任务栏显示 Claude 用量的轻量 Rust 小部件。
文章介绍了一款常驻 Windows 任务栏时钟旁的 Claude 用量小部件:它能显示 5 小时窗口与每周额度,用量达 80% 变橙、95% 变红,支持悬停查看重置时间、可调刷新间隔与深浅色主题适配。由于 Windows 11 移除了 deskbands,作者在 Claude Code 建议下改用 Rust 加原生 Windows API 绘制透明置顶窗口嵌入任务栏,成品仅几百 KB、占用数 MB 内存且免安装。数据取自 Claude Code `/usage` 命令的同一端点,并复用其登录刷新机制与文件锁以避免登录冲突,用户零配置即可使用。项目从调研、编码、截图自测到 README 与 release 发布几乎全由 Claude Code 完成,作者只负责设计与评审,最终以 MIT 协议开源。
从频繁查网页到任务栏常驻:一个轻量小部件的诞生
Claude Code 用户大概都有过这样的体验:想确认当前5小时窗口和每周额度还剩多少,得切到浏览器打开用量页面,回来再切回终端。Reddit 上一位开发者把这种重复动作做成了工具——一个常驻 Windows 任务栏、紧挨着时钟显示用量的迷你小部件。

整个程序体积不大,exe 约几百 KB,内存占用仅几 MB,无需安装程序,双击就能运行。功能上它把5小时与每周用量直接摆在时钟旁边,用量到80%变成橙色、95%变红,鼠标悬停能看到额度重置时间,刷新间隔可在30秒到30分钟之间调整,还支持在"已用量"和"剩余量"两种显示方式之间切换,并适配浅色与深色任务栏。
这个项目的特别之处在于,从技术方案调研到代码编写、测试、发布,几乎全程由 Claude Code 完成,作者的角色是给设计、定功能、做评审。
Windows 11 任务栏的限制与迂回方案
Windows 11 移除了过去官方支持的 deskbands 机制,也就是说,想往任务栏里塞自定义内容,已经没有现成的正规入口。作者在规划阶段直接问 Claude Code:把文字放进 Windows 11 任务栏最轻量、最原生的方式是什么。
Claude Code 对比了几种替代路径,最终选定用 Rust 配合纯内置 Windows API,绘制一个透明的置顶小窗口,让它嵌在任务栏区域内。这条路避开了第三方框架带来的体积和依赖,也解释了为什么成品能压缩到几百 KB——没有引入臃肿的运行时。
对想做类似桌面小工具的人来说,这个思路有参考价值:当系统收回官方扩展点时,透明窗口加原生 API 往往比硬啃被废弃的机制更实际。
deskbands 是什么
deskbands 是 Windows 资源管理器自 90 年代末起提供的一种任务栏扩展机制,允许第三方程序在任务栏上注册一段工具栏区域,承载按钮、文字或自定义控件(早期的快速启动栏、语言栏都属于这一类)。开发者通过实现 COM 接口并向注册表注册 Band 对象即可接入,是当时唯一被官方认可的任务栏嵌入方式。由于该机制与 Explorer 进程深度耦合,稳定性与安全问题长期存在,微软在 Windows 11 中彻底移除了它,同时也没有提供等效的替代接口。这使得任何想在任务栏内绘制内容的程序,都只能退回到"自绘窗口并精确定位"的路线上。
透明置顶窗口(layered window)的原理
Windows 通过 WS_EX_LAYERED 扩展样式支持分层窗口,允许程序指定逐像素的 alpha 值,从而实现背景透明、只显示前景文字或图标的效果。配合 WS_EX_TOPMOST 置顶样式与 SetWindowPos 精确定位,就能把一个无边框窗口叠放在任务栏的指定坐标上,视觉上仿佛它本来就长在任务栏里。这种方式不依赖任何第三方 UI 框架,直接用 user32/gdi32 的原生函数即可完成,编译产物自然非常小。代价是需要自行处理任务栏的位置变化、DPI 缩放和主题切换等边界情况。
数据从哪来:复用 /usage 的接口
用量数据并非爬页面得来。Claude Code 弄清了这些数字来自 Claude Code 自身 /usage 命令调用的同一个端点,并通过一次测试调用确认了返回格式。这意味着小部件拿到的是与官方命令同源的数据,不需要额外账号或配置。
登录状态的共享是另一个关键细节。Claude Code 观察了 Claude Code 如何刷新自己的登录凭据,让小部件采用相同的刷新方式和同一把锁,从而避免两个程序同时刷新时互相踢掉登录。这类并发写入问题是很多第三方客户端容易踩的坑,这里被提前处理掉了。
由于直接复用现有 Claude Code 登录,用户只要已在 Claude Code 中以 Pro 或 Max 方案登录,打开 exe 即刻可用,零配置。
并发刷新登录凭据为什么会"互踢"
OAuth 类凭据通常由 access token(短期)和 refresh token(长期、一次性)组成。刷新时客户端用 refresh token 换取新的 access token 和新的 refresh token,旧的 refresh token 随即失效。如果两个进程各自持有同一份 refresh token 并几乎同时发起刷新,先完成的那个会作废旧 token,后完成的那个就会拿到"已失效"的错误,表现为用户被登出、需要重新授权。解决办法是让所有进程对同一份凭据文件加文件锁(Windows 上常用 LockFileEx 或命名互斥量),并在刷新前重新读取磁盘上的最新凭据,确认是否已被其他进程更新过。小部件与 Claude Code 采用相同的刷新逻辑和同一把锁,正是为了避免这种竞态。
代码、截图自检与发布,几乎全自动
作者描述的工作流里,Claude Code 承担了最重的编码环节:写出 Rust 代码之后,它自己截取任务栏画面检查效果,据此修掉了小尺寸下 logo 发糊的问题,并测试了悬停、提示气泡和菜单交互。发布环节同样由它包办,包括 README、GitHub 仓库和 release 的搭建。
真正留给人的是设计取舍:显示什么、怎么变色、刷新频率范围多大。这种"人定方向、模型落地、人再评审"的分工,是当前 AI 辅助开发里被反复验证有效的一种模式。
项目以 MIT 协议开源,exe 可从 GitHub 最新 release 下载双击运行。需要注意的是,由于 exe 未做代码签名,首次运行 Windows 可能弹出"已保护你的电脑"提示,点"更多信息 → 仍要运行"即可,也可以直接从源码自行构建。
小结
这个项目的价值不止于一个顺手的桌宠级工具。它展示了三件事:Windows 11 任务栏仍可通过原生透明窗口扩展;复用官方 CLI 的接口与登录态能做出零配置的轻量客户端;以及 Claude Code 在真实小项目里,已能覆盖调研、编码、自测、发布的全链路,人只需握住方向盘。项目采用 MIT 开源,反馈与建议作者表示欢迎。
相关推荐

Gemini 4 Neon实测:性价比之王还是自信的灾难?
Gemini 4 Neon 实测深度解析:百万 token 上下文、四档思考级别,KingBench4 一遍过写 201 个文件,成本仅为 Fable 5.2 的十分之一。但它会靠幻觉假数据蒙混、留下 7 个符号链接逃逸漏洞、把键盘写成砖。性价比与危险并存,多模型议会审查才是破局关键。

谷歌Gemini 4 Neon实测:6个3D作品惊艳与翻车
谷歌Gemini 4 Neon在3060笔记本上实测6个3D作品:太阳雨渔港细节惊艳,机械键盘配置器完成度高,但软糖物理形变过头、帝王像人脸偏方。多源测评交叉验证,审美在线但物理与人脸是短板。

Gemini 4 Neo写小说网文实测:AI味淡、对话有质感
B站UP主首发测评Gemini 4 Neo写小说网文能力:实测三国穿越开篇生成,AI味淡、对话有情绪质感、危机感塑造到位,并对比4A/4H/4C四个模型差异,演示拆纲续写与审稿纠错全流程。