有人发布了一个免费开源的 Windows 小部件，用于显示 Claude 用量限额和 Claude Code 会话状态

→ 它每分钟刷新一次，显示会话和每周用量限额，数据通过运行 Claude Code 的 /usage 命令获取 → 它列出正在运行的 Claude Code 会话以及 Anthropic 的服务状态 → 一个像素风的 Clawd 角色会根据会话活动和剩余额度改变动画 → 该小部件需要 Windows 10 或 11 以及已登录的 Claude Code 安装，与 Anthropic 无关

仓库：

Enhed/clawd-usage-winwidget

来源：https://github.com/Enhed/clawd-usage-winwidget

clawd-usage-winwidget

一个面向 Windows 的迷你浮动窗口 + 托盘图标，用来显示你的 Claude 套餐限额已用了多少——数字与 Claude Code 中的 /usage 完全一致，每分钟刷新一次。里面还住着一只像素 Clawd，它会对你的会话动静做出反应。

会话开始工作、完成，然后等待你

English · Русский

• 只用官方数字。 百分比来自 claude -p "/usage"——该斜杠命令以无头模式运行，使用你现有的登录凭据与 Anthropic 通信，不会调用模型或消耗 token。
• 零依赖。 只用 Windows 自带的普通 Windows PowerShell 5.1 + WPF。不需要 Node、不需要 npm、不需要安装程序。你只需要 Claude Code 本身。
• Clawd。 来自 Claude Code 欢迎界面的那只螃蟹，用同样的方块字符搭建，动画也完全相同。没事干时它睡觉，会话工作时它到处跑，会话等你时它挥手，接近限额时它冒汗，用光了它就四脚朝天。

安装

要求：Windows 10/11，且已安装并登录 Claude Code（https://docs.claude.com/en/docs/claude-code）（claude 在 PATH 上）。

git clone https://github.com/Enhed/clawd-usage-winwidget.git

也可以下载 ZIP 并解压到任意位置。然后双击 start-widget.vbs（它会在没有控制台窗口的情况下静默启动小部件）。

开机自启 —— 在小部件文件夹中用 PowerShell 运行一次：

$a = New-ScheduledTaskAction -Execute "wscript.exe" -Argument "`"$PWD\start-widget.vbs`""
$t = New-ScheduledTaskTrigger -AtLogOn
Register-ScheduledTask -TaskName "clawd usage widget" -Action $a -Trigger $t -RunLevel Limited

同时只会运行一个实例，所以手动启动和自启并存也不会有问题。

Windows 会把新的托盘图标藏到溢出区（^）里。想让它一直可见：设置 → 个性化 → 任务栏 → 其他系统托盘图标 → clawd-usage-winwidget。

显示内容

• 大数字 —— 当前会话（5 小时窗口）的用量，直接来自服务器。进度条从绿色 → 黄色（60%）→ 红色（85%）。
• resets in 3h 03m —— 距离窗口重置的时间，来自 /usage 中的精确重置时刻。
• WEEK —— 每周限额及重置时间。FABLE · WEEK —— 独立的每周 Fable 限额；如果 /usage 没有报告则隐藏。
• SESSIONS —— 有多少个 Claude Code 会话在运行、其中多少在工作、多少在等你。悬停可看列表：▶ 工作中，? 等待中（权限、问题、对话框——方括号里写明具体是什么），○ 空闲，外加所在文件夹。方便揪出忘了关的 agent 在悄悄烧你的额度。另一台机器上的会话（家用服务器、虚拟机）可以通过 config.json 里的 remoteSessions 添加——一个 URL 或文件路径列表，每个都返回那台机器的实时会话，格式与 ~/.claude/sessions/.json 相同：

{
  "generatedAt": "2026-10-17T03:41:47+00:00",
  "host": "unraid",
  "sessions": [
    {
      "name": "api",
      "status": "busy",
      "waitingFor": "",
      "kind": "interactive",
      "sessionId": "4b8ca9ab-..."
    }
  ]
}

发布方只列活跃会话；cwd 可选。这些会话会计入统计行和 Clawd 的反应，悬停列表里会显示 host。失败、卡住或 generatedAt 超过两分钟的源不会计入任何数据。

• 服务状态 —— 绿色“All Claude systems operational“，或黄/红并显示进行中的事故和受影响组件。点击打开 status.claude.com。
• 托盘图标 —— 同样的百分比，以彩色数字显示；工具提示还会加上每周和 Fable 的数据。
• 底部一行 —— 你的套餐和账户邮箱（认证过期时红色显示“未登录“），以及最近一次 /usage 应答的时间，过旧会标注“stale“。标题栏中的 ▾ 可展开详情（在多次运行之间保留）：
• LAST 24 HOURS / LAST 7 DAYS —— 请求数、会话数，以及 /usage 中的“What’s contributing to your limits usage?“分解：大上下文占比、常驻上下文、子代理密集型会话、Top MCP 服务器、技能和子代理。Claude Code 自己也称其为近似值，且只统计这台电脑。
• LIMITS · 7 DAYS（默认关闭，showHistory）—— 过去一周的 5 小时（绿色）和每周（蓝色）百分比，各占一行。悬停可查看光标位置的时刻：时间、两个百分比，以及该小时内花费最多的项目。首次运行时，图表会由早期版本 /usage 检查过的、留在 ~/.claude/projects 中的转录文件填充；此后每次 /usage 应答都会作为样本记入 usage-history.json。
• PROJECTS · 7 DAYS —— 本周花费最多的项目，按其运行所在文件夹统计。数据来自这台电脑上的 Claude Code 转录文件：token 按模型价格加权，所以占比是对进入限额部分的估算，不是官方数字。
• Version —— 你的 Claude Code 版本。如果有更新版本可用，该行会变黄：悬停查看你当前版本与最新版本之间的官方 CHANGELOG，点击则在单独窗口中运行 claude update；否则点击打开 Claude Code 的更新日志。旁边是小部件自身的版本：悬停查看新内容，点击打开其 GitHub 上的 CHANGELOG.md。当小部件有新版本发布时，该行会变成黄色“Clawd X is out“（每个版本弹一次 Windows 通知）：悬停查看新内容，点击下载，替换文件后重启——config.json 和其他本地文件都会保留。在 git 克隆中，点击改为打开更新日志。如果新版本五分钟内没有生效，旧版本会被恢复并重新启动，小部件会说明这一点（且不会再推荐该版本）。
• 左键点击托盘图标显示/隐藏窗口；右键打开菜单：显示/隐藏、刷新、设置、退出。把窗口拖到任意位置——位置会被保存。
• 设置 —— 窗口头部的齿轮（或托盘菜单）：语言、主题、Clawd 的皮肤（从带实时预览的卡片中挑选，鼠标移到上面他会举起手臂）、尺寸、透明度、始终置顶、窗口显示哪些区块、提示、聊天、定时任务以及 Clawd 的会话。所有改动立即生效；其余键值在 config.json 中，链接在底部。
• Claude Code 选项卡是 Claude Code 自己的 ~/.claude/settings.json，从中挑出一组容易被忽略的设置：新会话的模型、快速模式、应答语言、启动时的权限模式、自动压缩、自动记忆、/rewind 的检查点、提交署名、会话保留时长、更新通道、终端主题与渲染器、应答风格、转录视图、提示、推送到手机等等——每项悬停都有说明。只有改动过的键会被重写，文件其余部分保持原样；首次修改前的文件会保留为 settings.json.clawd-bak。改动在新会话中生效，Clawd 的聊天也使用这些设置。

Clawd

没有 Claude Code 在运行 —— 钻进沙子里睡觉 点击他 —— 随机播放一个 Claude Code 动画，外加一颗心 会话限额用完 —— 四脚朝天；点击后他的灵魂会飘出来 5 小时窗口重置 —— 庆祝并撒纸屑 心心代表他的生命值 —— 即会话限额的剩余量 天空跟随真实时间与实时天气

标题栏里的三颗心是他的生命值，电子宠物式：会话限额还剩多少。每半颗心约等于 16.7%；只有到 100% 时心才全空。生命值会在上述所有表现之外影响他的行为——精力充沛时走得更快、还会蹦跳，累了会打哈欠、动作变慢，快不行了会踉跄、冒汗、偶尔绊倒。

右键点击 Clawd 进入开发者模式：强制任意状态、播放任意动画、设置心数、选择时段和天气，或者把所有内容作为演示播放一遍。选“Auto“即恢复实时数据。

天空

数字背后是一片淡淡的天空，向窗口边缘渐隐。它按照你所在位置的真实日出日落变化：太阳沿弧线移动，夜晚出现真实月相的月亮和闪烁的星星。天气会带来随风飘移的云、毛毛雨、雨、阵雨、雪（会落在 Clawd 脚下堆积）、雾和雷暴。悬停可查看城市、温度、天气、风、日出日落以及月相（“上弦月，被照亮 42%”）。天气数据来自 Open-Meteo（https://open-meteo.com），在 Open-Meteo 被屏蔽时回退到 met.no（https://api.met.no），两者都不需要 API key。位置每次运行时通过 IP 用 ipwho.is（https://ipwho.is）查询一次——设置 weatherLat / weatherLon 可跳过该查询。没有网络时天空仍会跟随时钟。用 showSky 关闭。

主题与皮肤

主题 —— 设置 → 外观：Halloween、Classic、Midnight、Mocha、OLED 黑、Forest；切换立即生效。Halloween 有小南瓜、蝙蝠和幽灵组成的壁纸。默认的“按季节“模式在 9–11 月使用 Halloween，一年中其余时间使用 Classic。config.json 中的 accent（"#F472B6"）可在主题之上为链接和每周进度条设置你自己的颜色。进度条的等级颜色、天空和 Clawd 的颜色保持不变。

Clawd 的皮肤 —— 设置 → 外观，每种都有预览。皮肤是他的配色加上会随他一起移动的像素配饰：帽子只在头部处于画面中时显示，四脚朝天时会掉下来。你自己的皮肤：最后一张卡片“你自己的“会打开文件夹；往里放一个 .txt（文件名即 id；与内置同名会替换它），然后选择它的卡片。编辑几秒钟内就能看到效果：

---
name: Top hat
body: #D77757
eyes: #141416
k: #4B5563
r: #DC2626
---
......kkkkkkk.....
......kkkkkkk.....
......kkkkkkk.....
......rrrrrrr.....
...kkkkkkkkkkkkk..

body 和 eyes 可选。下面图案中的每个单字母键都代表该字母对应的颜色；. 表示空白。图案宽 18 个像素，与 Clawd 一致，正好戴在他头顶；top: 1（任意行号）会把它放在别处，行号从他的顶部行算起。Clawd 本身的图案，# —— 身体，o —— 眼睛：

0 ...#############..
1 ...#############..
2 ...##o#######o##..
3 ...##o#######o##..
4 .#################
5 .#################
6 ...#############..
7 ...#############..
8 ...#.#.......#.#..
9 ...#.#.......#.#..

内置皮肤在 skins 文件夹中——shades.txt 展示了一个脸上的配饰（top: 1）。

Clawd 的面板：提示与聊天

头部的一个图标会在小部件旁边打开一个面板；它会保持打开，直到你用叉号或图标关闭，并且只有在小部件置顶（topmost）时才保持置顶。图标会提示有什么在等待：铃铛——有提醒响了；蓝色聊天——Clawd 回答了；带数字的灯——有提示（紧急时为黄色）；灰色聊天——没什么，只是聊天。

提示。 每半小时，Clawd 会悄悄检查一遍电脑：

• 磁盘空间快满的驱动器，以及 Temp、Downloads、回收站、崩溃转储和 npm / pip / Yarn / scoop 缓存里各占多少；
• 自启动项中的新条目（首次运行时已有的视为已知）；
• 超过 90 天没有启动过的应用——依据 Windows 自己记录的来自开始菜单、任务栏和资源管理器的启动记录；在 PATH 中的应用或作为服务运行的应用算作已使用；
• Windows Update 在等待的重启、过长的运行时长、占用大量内存或连续两次检查都占满 CPU 的程序。

每条提示都链接到正确的位置，并有执行（Clawd 会回复一个脚本供你批准）、调整（你的下一条消息会连同提示一起发给他，例如“除了 scoop 都清理“）和忽略；如果情况仍然存在，过一段时间会再次出现（一天；未使用应用为一个月）。检查是本地且只读的——不上网、不花 token。设置 → Clawd 中的“现在检查一遍电脑“可立即运行一次。用 showAdvisor 关闭。

聊天。 向 Clawd 询问任何关于电脑的问题，回答一条提示（“全部清理掉，但 Redis 别动”），或者要求一个提醒（“周一大 10 点提醒我给客户打电话”、“20 分钟后——去晾衣服”）。每条消息都是各自独立会话中的一次无头 claude -p 调用（不会动到你的 Claude Code 会话），并附带当前的提示、时间和提醒。Clawd 可以四处查看，但自己不能改动任何东西：没有写入工具，MCP 服务器关闭，只允许只读命令。改动会以脚本形式呈现给你完整查看，带运行、调整（写出要改什么——脚本会被替换）和暂不。

面板标题栏中的 AUTO（chatAutoRun，默认关闭）可跳过点击：脚本一发出就立即运行，连续最多三个之后才会再等你确认；Clawd 会被告知这一点，并在做任何破坏性操作之前先用文字询问。提醒由小部件保存，到点准时触发，附带一张可以推迟的卡片、标题栏中的铃铛和 Clawd 的一次跳跃——即使面板关闭也有效。聊天使用你套餐的额度；模型为 chatModel（默认 Sonnet），showChat 可关闭它。

提醒与清单。 到点的提醒会以卡片形式显示在右下角，像手机通知一样：推迟 —— +15m、+1h、+3h、明天 9:00 或任意时间 —— 或者标记为完成；它会一直等你回应。面板有三个选项卡：聊天、提醒和清单。提醒显示即将到来的（修改、+1 小时、删除）以及添加表单：“时间“字段能理解 18:30、tomorrow 10、+20m、in a week、mon 9:00、19.10 14:00 并显示它的解析结果；其他写法（“next Friday evening”、“1 November”）会在保存时交给一个小模型（quickModel，默认 Haiku）处理，只有连它也无法确定时才报错。清单用来保存购物清单和任何带勾选框的其他清单——用逗号一次添加多项、勾选、移除已勾选项、用“+“开始新清单。两者都是 Clawd 家中的普通文件，所以聊天（“把牛奶加进购物清单”）和手机上的 Clawd（“我要买什么？”）操作的是同一份数据。

Clawd 的家和他自己的会话。 聊天在 Clawd 的主文件夹（clawdHome）中工作。提醒是那里的普通文件（清单也在，放在 lists\）——reminders\2026-11\2026-11-16 10-00 Pay the taxes.md 带一行 at: ——所以任何人都可以创建：聊天、Clawd 的会话，或者你手动；已触发的会移到 reminders\done。一行 repeat:（daily、weekly、monthly、yearly）可以让提醒重复：到点时，小部件会写好下一次的文件——所以“每月 17 号提醒我“就是一个文件，在提醒选项卡中标有 ↻。每次检查后，提示会写入该目录下的 tips.md。

开启 clawdSession 后，小部件还会在该文件夹中用 Remote Control 保持 Clawd 自己的交互式 Claude Code 会话运行——在手机上的 Claude 应用里和他聊天：他会读取 tips.md，创建提醒，并保持