Repolode
提交项目
JingbiaoMei

JingbiaoMei/Tokdash

本地运行的仪表盘，汇总 Claude Code、Codex、OpenCode 等 AI 编程工具的 token 用量、费用与订阅配额。

在 GitHub 查看官网
Star
92
Fork
21
未关闭 Issue
8
最近提交
昨天

这是什么？

Tokdash 是一个本地运行的 token 与费用仪表盘，面向 AI 编程工具。它直接读取 Claude Code、Codex、OpenCode、Gemini CLI 等工具在本机生成的会话日志，展示输入、缓存和输出的精确 token 拆分、单次会话明细以及估算费用。

同一份本地数据可通过四种方式查看：基于 FastAPI 的 WebUI（含热力图和周、月、年报告）、`tokdash tui` 终端仪表盘、macOS 菜单栏与 Windows 通知区的伴随应用，以及可嵌入智能体状态栏的实时用量项。费用依据内置的定价数据库计算，也可在本地覆盖。

配额追踪为可选功能。Codex 的滚动窗口根据本地日志估算，其他服务商的订阅窗口需要主动开启实时查询，并使用 CLI 已有的登录凭证。通过 pipx 安装后执行 `tokdash setup` 即可注册本地后台服务。

核心功能

  • 01按会话、工具和模型精确拆分输入、缓存与输出 token。
  • 02提供贡献热力图，以及可导出 PNG 的周、月、年用量报告。
  • 03配额页展示多个服务商的订阅窗口进度条与重置倒计时。
  • 04终端仪表盘包含概览、会话、统计、报告、速度、配额和定价七个面板。
  • 05支持嵌入智能体状态栏，并提供 macOS 与 Windows 伴随应用。
  • 06可汇总多台机器上运行的 Tokdash 实例的用量。

适用场景

  • 查看每天或每月 AI 编程工具的费用支出。
  • 在同一界面对比 Claude Code、Codex 等工具的 token 用量。
  • 不打开浏览器即可掌握订阅配额的重置时间。
  • 避免客户端的历史保留策略删除本地会话记录。

快速上手

  1. 1

    使用 pipx 安装软件包

    pipx install tokdash
  2. 2

    运行安装向导以注册本地服务并获取仪表盘地址

    tokdash setup

使用前须知

  • 配额跟踪为可选功能，每个服务商可能需要额外配置。
  • 需要 Python 3.10 或更高版本。

收录于专题

Claude Code 工具、技能与插件AI 编程助手与编码 Agent命令行与终端工具仪表盘与商业智能工具OpenTelemetry 与可观测性平台

标签

#token-usage#ai-coding#dashboard#cost-tracking#claude-code#codex#observability#cli#agent#analytics

常见问题

Tokdash 是什么？
本地运行的仪表盘，汇总 Claude Code、Codex、OpenCode 等 AI 编程工具的 token 用量、费用与订阅配额。 Tokdash 是一个本地运行的 token 与费用仪表盘，面向 AI 编程工具。它直接读取 Claude Code、Codex、OpenCode、Gemini CLI 等工具在本机生成的会话日志，展示输入、缓存和输出的精确 token 拆分、单次会话明细以及估算费用。
Tokdash 可以免费使用吗？用的什么许可证？
Tokdash 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
Tokdash 还在维护吗？
活跃维护中。Tokdash 最近一次提交是在 2026年11月6日。
Tokdash 适合用来做什么？
查看每天或每月 AI 编程工具的费用支出。 在同一界面对比 Claude Code、Codex 等工具的 token 用量。 不打开浏览器即可掌握订阅配额的重置时间。 避免客户端的历史保留策略删除本地会话记录。
Tokdash 怎么安装和运行？
使用 pipx 安装软件包: pipx install tokdash 运行安装向导以注册本地服务并获取仪表盘地址: tokdash setup
在哪里获取 Tokdash？
源代码和安装说明在 GitHub 上：https://github.com/JingbiaoMei/Tokdash

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目