claude-code-session-tracker

什么是 claude-code-session-tracker？

claude-code-session-tracker 是一个用于 Claude Code 的本地仪表板。它将活跃会话和最近会话集中在一个界面中，显示剩余的五小时和七天使用窗口，并提供会话级别的令牌详情。该工具旨在帮助 Claude Code 用户了解当前正在运行的内容、令牌消耗情况，以及距离使用限额还有多远。

它还提供历史记录视图，可按天、小时、项目和模型查看计费令牌。会话详情包括上下文窗口用量，以及 CLAUDE.md、技能、工具、代理和 MCP 指令等静态上下文来源。

claude-code-session-tracker 能做什么？

实时会话仪表板

列出活跃和最近的 Claude Code 会话，并显示项目、路径、任务、状态、模型、输入/输出/总令牌数、运行时长和最近活动信息。

使用限额监控

显示 Claude Code 的五小时会话窗口和七天周窗口，包括已用时间、剩余时间、使用百分比、重置时间，以及基于近期使用速度的估算。

会话级令牌和上下文详情

打开会话后可查看输入、输出、总量、缓存读取和缓存写入数据，以及剩余上下文和首次交互前加载的估算静态上下文。

静态上下文明细

区分 CLAUDE.md、技能、延迟加载工具、代理和 MCP 指令等上下文贡献，帮助识别填充会话窗口的内容。

令牌历史和报告

按本地日期绘制计费令牌图表，并支持按天、小时、项目和模型查看；提供可选时间范围、汇总总量、导出和可分享的可视化内容。

可选桌面提醒

可在预计会话或周窗口将超过限额前通知用户。通知默认关闭，并为两个窗口使用不同的间隔。

使用场景

“监控多个活跃项目”

使用会话视图查看哪个 Claude Code 项目正忙、正在等待输入或处于空闲状态，无需在不同的终端工作流之间切换。

“调查令牌消耗较高的会话”

打开运行时间较长或消耗较高的会话，对比输入、输出、缓存活动、交互轮次和静态上下文，然后找出可能影响窗口用量的上下文来源。

“围绕使用限额重置安排工作”

开始更多 Claude Code 工作前，查看当前五小时和七天用量、重置时间以及基于使用速度的预测。

“查看历史用量”

使用历史记录页面比较不同日期、小时、项目和模型的令牌活动，并导出报告以便单独留存。

“提前获取限额警告”

在后台浏览器标签页或编辑器中工作时启用桌面通知，当使用窗口预计会超过限额时接收提醒。

常见问题

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

运行 `npx claude-code-session-tracker`，然后打开输出的本地地址；网站显示的地址为 `http://127.0.0.1:3099`。

支持哪些平台和运行时？

网站列出 Node 20 或更高版本，并支持 macOS、Linux 和 Windows。

应用会将数据发送到计算机外部吗？

该产品被描述为本地且只读，绑定到回环地址，并声明不会有任何内容离开本机。

它跟踪哪些使用窗口？

它显示五小时会话窗口和七天周窗口，包括剩余时间、重置时间、用量和基于使用速度的预测。

可以启用通知吗？

可以。两个窗口都支持桌面通知，但通知默认关闭。设置中为会话限额和周限额提供了单独的通知间隔。

什么是 claude-code-session-tracker？