你的 AI 编码助手，到底花了你多少钱？
如果你每天都在用 Claude Code 或 Codex 写代码，你有没有想过一个问题：这个会话到底烧了多少 token？花了多少钱？
你并不是一个人。大多数开发者对 token 消耗只有一个模糊的感觉——"好像挺多的"——但具体多少、花在哪里、哪个项目最烧钱，一概不知。直到月底看到账单才惊觉。
Token Tracker（命令：tt）就是为了回答这个问题而生的。它是一个开源的 CLI 仪表盘，实时监控 Claude Code 和 Codex 的 token 消耗、费用、配额使用率和上下文窗口状态——所有数据都在本地，隐私优先。
交互式仪表盘——配额、token、费用、上下文一目了然
为什么你需要关注 token 用量？
AI 编码助手按 token 计费。一个看似简单的会话可能轻松消耗数十万 token——尤其是当你同时打开多个项目、频繁使用大上下文模型、或者开启了思考模式时。
问题在于：没有工具，你就是在盲飞。你并不知道：
- 当前会话已经花了多少钱？
- 哪个项目消耗了最多的 token？
- 你的配额还剩多少？什么时候重置？
- 上下文窗口快满了吗？
Token Tracker 把这些数据全部呈现在一个终端仪表盘上，一目了然。
快速安装
一行命令安装：
curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/install.sh | bash或者通过 pip：
pip install --force-reinstall token-tracker
tt setuptt setup 会自动配置 Claude Code 的状态栏和 Codex 的集成。tt unsetup 可以恢复原始配置。
使用实例
实例 1：实时仪表盘
什么都不加，直接运行 tt：
tt你会看到一个交互式仪表盘，左右键可以在 Claude Code 和 Codex 之间切换。顶部显示当前项目和 Git 分支，中间是配额使用进度条（5 小时滑动窗口 + 7 天滑动窗口），下面是累计 token、费用、模型信息和会话时长。
实例 2：查看每日消耗
tt daily按 token 消耗量排序，显示今天每个会话的详细信息——输入 token、输出 token、费用。也有 tt weekly 和 tt monthly，支持按项目分组。
tt daily——每日 token 消耗明细，一眼找出最贵会话
实例 3：最近会话记录
tt sessions显示最近 20 条会话详情，每条都包含项目名、模型、token 数、费用和持续时间。
实例 4：定制排序
tt daily --sort cost --desc按费用降序排列，一眼找出最烧钱的会话。支持按 tokens、cost、messages、time、input、output 排序。
核心特性
- 双 Agent 支持——同时监控 Claude Code 和 Codex，一键切换
- 自定义状态栏——三行信息：配额进度、token 明细、模型与时长。自动融入 Claude Code 界面
- 配额追踪——5 小时和 7 天滑动窗口，带重置倒计时
- 费用分析——基于官方定价的等价费用计算，按会话/天/周/月查看
- 上下文窗口——总大小和当前使用百分比
- 零配置——自动检测已安装的 Agent，直接读取本地数据
- 隐私优先——所有数据存储在本地，不采集不上传
Claude Code 状态栏——配额、token、模型信息直接嵌入编辑器
"你无法管理你无法衡量的东西。Token Tracker 让 AI 编码的成本变得透明——不是让你省钱的工具，而是让你知道自己花了多少钱的工具。有时候，知道就已经省了一半。"
仪表盘快捷键
在 tt 仪表盘中：
- ←/→——切换 Agent
- ↑/↓——滚动内容
- s——切换排序字段
- r——反转排序方向
- +/-——调整可见会话数
- q——退出
适用场景
- 预算管理——实时掌握 token 消耗，避免账单惊吓
- 多项目对比——看看哪个项目在吃最多的 token
- 配额监控——在达到速率限制之前收到预警
- 模型选型——对比不同模型的实际 token 消耗和费用
- 团队管理——了解团队成员的 AI 工具使用情况
总结
Token Tracker 是一个"早知道就好了"的工具。它不是帮你省钱的——而是让你知道自己花了多少钱。在 AI 编码成为日常的今天，这种透明度本身就是一种生产力。安装只需 10 秒，仪表盘一看就懂，数据全部在本地。如果你用 Claude Code 或 Codex，没有理由不装一个。
▶ 前往 GitHub 仓库 · 251 ★