stormzhang/token-tracker

解决的问题

Token Tracker 为多个本地 AI 代理（如 Claude Code、Codex 和 Kimi Code）提供了一种统一的方式来监控和分析令牌消耗与成本。它通过将成本、配额和会话详情整合到一个仪表板中，解决了使用数据分散的问题，防止“账单冲击”，并帮助用户实时跟踪配额限制。

工作原理

该工具以只读方式读取代理配置目录中的本地会话日志（JSONL 和 SQLite 文件）。它通过官方 StatusLine API（适用于 Claude Code 和 Kimi Code）或自定义的“伪状态行”钩子（适用于 Codex）直接集成到代理界面中，显示实时指标。此外，还包含一个 CLI 用于生成报告，以及一个使用本地 FIFO 和终端自动化（iTerm2/Ghostty 的 AppleScript）的侧边栏工具，提供活跃会话的实时概览。

适用人群

使用多个 AI 编码代理（Claude Code、Codex、Kimi Code）并需要在不手动检查多个平台的情况下追踪其令牌使用量、财务成本和剩余 API/订阅配额的开发者和高级用户。

主要亮点

• 统一追踪：将 Claude Code、Codex 和 Kimi Code 的数据集中到一处。
• 实时状态条：直接将实时的令牌、成本和配额指标注入代理的终端界面。
• 多维度报告：生成日度热力图、周报和月报，包含成本与令牌分析。
• 交互式侧边栏：一个常驻面板，显示所有活跃会话、状态灯和“下一步”建议，支持一键跳转至特定终端窗格。
• 零配置：自动检测已安装的代理并读取本地数据，无需 API 密钥或云端上传。
• 隐私优先：所有数据均在本地存储和处理。