claude-code-session-tracker

claude-code-session-tracker 是一款本地开源仪表盘，用于监控 Claude Code 会话、使用限额、Token 历史和上下文窗口详情，帮助用户在浏览器中跟踪并发项目与 Token 消耗。

在本地仪表盘中监控 Claude Code 使用情况

claude-code-session-tracker 是一款本地开源仪表盘，用于监控 Claude Code 会话和使用情况。它将活跃会话、项目和模型详情、Token 总量，以及五小时和七天使用窗口集中在一个浏览器界面中。

该跟踪器还提供详细的会话分析和历史报告。用户可以检查上下文窗口构成，按日或小时查看 Token 活动，比较项目和模型，导出报告，并可选择在使用窗口接近限额时接收桌面通知。网站将该应用描述为只读、绑定回环地址，并且除 Node 20 或更高版本外无需其他依赖即可运行。

核心功能

实时会话仪表盘

在一个仪表盘中显示活跃的 Claude Code 会话，包括项目、状态、模型、Token 总量、运行时长和近期活动。

使用限额监控

显示 Anthropic 的五小时会话和七天每周使用情况、重置时间、已用百分比，以及按当前使用速度估算的达到限额时间。

会话检查

打开详细的会话视图，查看输入、输出、总 Token 数和缓存 Token 数、上下文窗口使用情况、静态上下文来源、提示词以及恢复命令。

Token 历史与报告

按本地日期、半小时区间、项目和模型提供 Token 历史记录，并支持范围筛选、图表、年度视图、导出和可分享的图像。

桌面提醒

可在预计会话或每周窗口将超过限额前通知用户。通知为可选功能，默认关闭，并可按窗口配置。

使用情况分析

突出显示长会话和持续上下文等较高使用量模式，帮助用户识别 Token 的消耗位置。

适用人群与场景

管理并发的 Claude Code 工作
从一个页面查看多个活跃项目，了解哪些会话正忙或正在等待输入，并在需要处理工作时重新打开会话。
避免使用限额带来的意外
将当前消耗与五小时和七天窗口进行比较，以决定是继续任务、调整使用速度，还是等待重置。
减少上下文开销
打开会话的上下文分解，找出占用窗口较大的 CLAUDE.md 文件、技能、工具、代理、MCP 指令或对话历史。
回顾一段时间内的使用情况
使用日、小时、项目和模型视图，了解 Token 在一个月或更长时间内的累积位置，然后导出生成的报告以供进一步参考。
后台监控
在使用其他应用工作时启用桌面提醒，以便在使用窗口接近限额、尚未达到限额前收到提示。

Pros and Cons

Pros

将实时会话、使用限额、Token 历史和会话详情整合在一个界面中。
同时显示计费 Token 活动和缓存读取，并通过上下文窗口分解说明哪些内容会计入会话。
提供按本地日期、小时、项目、模型和年度查看的历史记录，并支持导出和分享。
在本地运行；根据网站说明为只读，并采用 MIT 许可证。
支持 macOS、Linux 和 Windows，并提供基于浏览器的本地界面。

Cons

该产品面向本地单机监控；现有证据无法证明其提供团队仪表盘、共享账户或托管访问。
需要 Node 20 或更高版本，并且提醒默认关闭，必须手动启用。
现有页面内容未说明除 Claude Code 跟踪工作流之外的集成功能。

FAQ

如何启动 claude-code-session-tracker？

运行 `npx claude-code-session-tracker`，然后在浏览器中打开输出的本地地址 `http://127.0.0.1:3099`。

跟踪器会显示哪些内容？

仪表盘显示活跃的 Claude Code 会话、会话和每周使用窗口、Token 详情、会话上下文以及恢复命令。单独的“历史记录”页面提供 Token 视图和导出选项。

它能在达到使用限额前提醒我吗？

可以。在“设置”中可为五小时会话限额和七天每周限额启用桌面通知。通知默认关闭，并且每个配置的时间间隔最多发送一次。

跟踪器会向远程服务发送数据吗？

该产品以本地运行并绑定回环地址的方式呈现。页面说明它是只读的，数据不会离开设备。

平台和许可要求是什么？

网站列出了 Node 20 或更高版本，并支持 macOS、Linux 和 Windows。它采用 MIT 许可证，并被描述为开源软件。

Quick Facts

类别: 开发者工具
主要工作流: Claude Code 会话和 Token 监控
运行环境: Node 20 或更高版本
平台: macOS、Linux 和 Windows
许可证: MIT 许可证；开源
本地地址: http://127.0.0.1:3099