claude-usage-dashboard

中文文档
1.12.1发布于 2026/11/03ISCES Module构建来源已验证

克劳德代码使用仪表板-令牌成本,配额周期跟踪,缓存效率,跨所有设备的多机同步

中文使用文档
文档目录13 节
  1. 价值
  2. 周期
  3. 消费
  4. 会话
  5. 每台机器都有一个账本
  6. 规范
  7. 设计
  8. 安装
  9. 多机同步
  10. 它是如何工作的
  11. 测试
  12. 释放
  13. 许可证

克劳德使用率仪表盘

固定的费用不能告诉你你用了什么。

npm version npm downloads license no telemetry

npx claude-usage-dashboard

价值 · 周期 · 消费 · 会话 · 规范 · 安装

Dashboard

克劳德代码每次工作时都会写日志。这将读取这些日志并对其进行编号。

价值

Quota meters, subscription value and model mix

订阅是一个固定的号码。但它买的东西却不是。

一个人扛着栏杆; 每个订阅美元的api等价值,在配额充分利用时。一个200美元的套餐通常会在一个月内产生五位数的api当量流量。

在它上面,你实际上被配给的窗口- 5小时和7天-从Anthropic读取OAuth凭证已经放在你的机器上。检测到计划层,但未声明。

下面是交叉点:API账单将超过费用的配额窗口份额。它只在选定范围时绘制 是 那个窗口;90天的成本和7天的利用率不是同一个衡量标准,专家组宁愿什么都不说,也不愿把它们平均起来。


周期

Anthropic不发布令牌限制,限制的移动不需要公告。

Quota cycles

每7天的窗口在关闭时被记录下来——按种类消耗,上限意味着100%的利用率。保留10个周期,跨机器池化。

这个 Δ 列携带之前窗口中的更改。 当这个数字下降,而你的习惯没有下降时,你就有了记录。


消费

Token consumption

每小时到每月。代币或美元。四个波段在每个酒吧,按价格排序:缓存读,缓存写,输入,输出。

缓存读取通常是大部分的质量和一小部分的成本——堆栈的形状就是账单的形状。下面是你实际工作的时间,在整个范围内汇总。

api等效成本使用电流 克劳德标准API价格(包括历史日志),缓存写入时间为5分钟。当单个请求超过100,000个输入令牌(计算缓存读取和写入)时,Haiku 5.5使用更高的速率。不包括快速模式、1小时缓存写入、批量折扣和区域溢价。


会话

Sessions

条长度是会话大小;段是令牌组合。可按日期、成本或令牌排序,可按项目筛选。精确计数悬停。


每台机器都有一个账本

笔记本电脑,台式电脑,工作机器。每个人都只看到自己。

把它们都放在一个共享文件夹——Drive、Dropbox、OneDrive、NAS、rsync目标——日志就会集中到一个视图中。没有服务器,没有账户,没有API密钥。一个你已经有的文件夹。


规范

读取~/.claude/projects/**/*.jsonl
配额Anthropic API·本地OAuth凭证
刷新5秒日志重读,30秒仪表板,30秒同步拷贝,120秒配额
保留10个配额周期
粒度每小时·每日·每周·每月
范围配额窗口·7 / 30 / 90天·自定义
依然存在范围,粒度,计划,刷新- localStorage
字体仪表衬线,IBM Plex Sans, IBM Plex单色捆绑,未提取
堆栈Node·Express·D3没有构建步骤。
离开机器配额读取。什么都没有。

设计

近乎单色和温暖。一个单一的口音——克劳德的兵马俑——只花在重要的数字和任何超过门槛的东西上。健康的仪表保持中性:颜色是警报,而不是装饰。

数字的仪表衬线,界面的IBM Plex Sans, IBM Plex Mono,无论您在哪里比较一行与另一行。这三个都在包里,所以第一次渲染是离线的,没有请求去任何没有承诺的地方。一个页面,没有路由-标题锚点移动你而不重新加载你。


安装

npx claude-usage-dashboard

开放 localhost: 3000。

如果该端口被占用——或者被静默阻塞,Windows比您想象的更频繁地这样做——它会从8080开始,然后是8765,然后是操作系统发出的任何地址,并打印它实际获得的地址。

从源
git clone https://github.com/ludengz/claude-usage-dashboard.git
cd claude-usage-dashboard
npm install
npm start
选择的端口
PORT=8080 npx claude-usage-dashboard

如果显式设置,则不会回退。它失败了,并告诉你原因。

多机同步

每台机器有两个环境变量,然后正常启动。

# ~/.bashrc, ~/.zshrc, etc.
export CLAUDE_DASH_SYNC_DIR="$HOME/Google Drive/claude-sync"
export CLAUDE_DASH_MACHINE_NAME="MacBook"   # optional — defaults to hostname
Windows和内联

作为用户环境变量:

[Environment]::SetEnvironmentVariable('CLAUDE_DASH_SYNC_DIR', 'C:\Users\you\Google Drive\claude-sync', 'User')
[Environment]::SetEnvironmentVariable('CLAUDE_DASH_MACHINE_NAME', 'Desktop', 'User')

或者内联,每次运行:

CLAUDE_DASH_SYNC_DIR="/path/to/shared" CLAUDE_DASH_MACHINE_NAME="MacBook" npx claude-usage-dashboard

将本地日志复制到 <sync_dir>/<machine_name>/ 启动时和之后每30秒。然后仪表板读取该目录中的每个机器文件夹。指向同一文件夹的任何机器都对聚合有贡献。

适用于任何同步文件夹:谷歌驱动器,Dropbox, OneDrive, iCloud驱动器,synthing, NAS,一个普通的rsync cronjob。

它是如何工作的

数据已经存在。Claude Code将JSONL会话日志写入 ~/.claude/projects/ 当它运行时;它读取它们,在服务器端对每个记录进行定价,并根据请求进行聚合。日志每5秒重新读取一次,并且只会再次解析大小或mtime发生变化的文件——不需要重新启动就会出现新的使用情况。

配额来自Anthropic API,使用OAuth凭证进行身份验证 claude CLI已经存储在本地。这个请求是唯一离开你的机器的东西。

测试

npm test

释放

推马厩 vX.Y.Z 标签匹配 package.json 在一个已经提交的文件上 main 运行 发布. 它在Windows上运行测试,单独打包和安装包,并检查npx是否保留在前台。只有经过验证的tarball才会使用OIDC发布到npm。工作流程验证注册表版本, latest 标签,并在创建GitHub发布之前下载tarball完整性。

npm可信发布器被绑定到 ludengz/claude-usage-dashboard、工作流 publish.yml,以及GitHub环境 npm,直接 npm publish 许可。不需要npm令牌保密。帐户2FA仍然为交互式帐户和包管理启用。

使用 操作→发布→运行工作流 在 main 用于仅验证的运行。对于失败的版本,在同一标记上重新运行其工作流;只有当已经发布的版本的完整性与已验证的工件相匹配时,才会接受它。

许可证

ISC。捆绑的字体是SIL开放字体许可证1.1 -参见 public/fonts/OFL.txt。

版本与发布记录

claude-usage-dashboard 共发布 48 个版本,首次发布于 2026/03/16;过去 12 个月发布了 48 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.12.1latest2026/11/03今天
1.12.02026/11/03今天
1.11.02026/09/261 个月前
1.10.02026/09/061 个月前
1.9.12026/07/253 个月前
1.9.02026/07/253 个月前

关于 claude-usage-dashboard 的常见问题

claude-usage-dashboard 是什么?

克劳德代码使用仪表板-令牌成本,配额周期跟踪,缓存效率,跨所有设备的多机同步

如何安装 claude-usage-dashboard?

在项目目录运行 npm install claude-usage-dashboard,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 claude-usage-dashboard,可以用 npx claude-usage-dashboard 直接运行。

claude-usage-dashboard 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/claude-usage-dashboard 是否存在。

claude-usage-dashboard 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

claude-usage-dashboard 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

claude-usage-dashboard 可以商用吗?

claude-usage-dashboard 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

claude-usage-dashboard 还在维护吗?

最新版本 1.12.1 发布于 2026/11/03(今天);至今共发布 48 个版本,其中过去 12 个月发布了 48 个;首次发布于 2026/03/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。