# claude-usage-dashboard 中文文档

规范地址：https://npmcn.com/package/claude-usage-dashboard/

版本：1\.12\.1
npm 元数据更新时间：2026-11-03T07:37:19.904Z
中文译文更新时间：2026-11-03T08:09:00.826Z
软件包许可：ISC

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/claude-usage-dashboard
原文对照：https://npmcn.com/package/claude-usage-dashboard/?lang=original
项目主页：https://github.com/ludengz/claude-usage-dashboard#readme
源码仓库：https://github.com/ludengz/claude-usage-dashboard

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：543 kB，47 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：2 个
- 首次发布：2026-03-16T04:07:08.881Z
- 最新版本发布：2026-11-03T07:37:19.602Z
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

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

## 安装

```sh
npm install claude-usage-dashboard
```

也可以使用：`pnpm add claude-usage-dashboard`、`yarn add claude-usage-dashboard`、`bun add claude-usage-dashboard`

## README

# 克劳德使用率仪表盘

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

[![npm version](https://img.shields.io/npm/v/claude-usage-dashboard?color=D97757&labelColor=1E1D1A)](https://www.npmjs.com/package/claude-usage-dashboard) [![npm downloads](https://img.shields.io/npm/dm/claude-usage-dashboard?color=A5A099&labelColor=1E1D1A)](https://www.npmjs.com/package/claude-usage-dashboard) ![license](https://img.shields.io/badge/license-ISC-A5A099?labelColor=1E1D1A) ![no telemetry](https://img.shields.io/badge/telemetry-none-7C9A76?labelColor=1E1D1A)

`npx claude-usage-dashboard`

[价值](https://npmcn.com/package/claude-usage-dashboard/#readme-value) · [周期](https://npmcn.com/package/claude-usage-dashboard/#readme-cycles) · [消费](https://npmcn.com/package/claude-usage-dashboard/#readme-consumption) · [会话](https://npmcn.com/package/claude-usage-dashboard/#readme-sessions) · [规范](https://npmcn.com/package/claude-usage-dashboard/#readme-specification) · [安装](https://npmcn.com/package/claude-usage-dashboard/#readme-install)

![Dashboard](https://npmcn.com/package/claude-usage-dashboard/docs/screenshots/dashboard.png?v=5)

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

* * *

### 价值

<table><tbody><tr><td><img alt="Quota meters, subscription value and model mix" src="https://npmcn.com/package/claude-usage-dashboard/docs/screenshots/panel-rail.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"></td><td><p>订阅是一个固定的号码。但它买的东西却不是。</p><p>一个人扛着栏杆； <strong>每个订阅美元的api等价值</strong>，在配额充分利用时。一个200美元的套餐通常会在一个月内产生五位数的api当量流量。</p><p>在它上面，你实际上被配给的窗口- 5小时和7天-从Anthropic读取OAuth凭证已经放在你的机器上。检测到计划层，但未声明。</p><p>下面是交叉点：API账单将超过费用的配额窗口份额。它只在选定范围时绘制 <em>是</em> 那个窗口;90天的成本和7天的利用率不是同一个衡量标准，专家组宁愿什么都不说，也不愿把它们平均起来。</p></td></tr></tbody></table>

* * *

### 周期

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

![Quota cycles](https://npmcn.com/package/claude-usage-dashboard/docs/screenshots/panel-cycles.png)

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

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

* * *

### 消费

![Token consumption](https://npmcn.com/package/claude-usage-dashboard/docs/screenshots/panel-trend.png)

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

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

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

* * *

### 会话

![Sessions](https://npmcn.com/package/claude-usage-dashboard/docs/screenshots/panel-sessions.png)

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

* * *

### 每台机器都有一个账本

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

把它们都放在一个共享文件夹——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，无论您在哪里比较一行与另一行。这三个都在包里，所以第一次渲染是离线的，没有请求去任何没有承诺的地方。一个页面，没有路由-标题锚点移动你而不重新加载你。

* * *

## 安装

```bash
npx claude-usage-dashboard
```

开放 **[localhost: 3000](http://localhost:3000/)**。

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

**从源**

```bash
git clone https://github.com/ludengz/claude-usage-dashboard.git
cd claude-usage-dashboard
npm install
npm start
```
**选择的端口**

```bash
PORT=8080 npx claude-usage-dashboard
```

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

## 多机同步

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

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

**Windows和内联**

作为用户环境变量：

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

或者内联，每次运行：

```bash
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已经存储在本地。这个请求是唯一离开你的机器的东西。

## 测试

```bash
npm test
```

## 释放

推马厩 `vX.Y.Z` 标签匹配 `package.json` 在一个已经提交的文件上 `main` 运行 [发布](https://npmcn.com/package/claude-usage-dashboard/.github/workflows/publish.yml)． 它在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`](https://npmcn.com/package/claude-usage-dashboard/public/fonts/OFL.txt)。

## 常见问题

### 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 和提交记录判断。