macOS 菜单栏 AI 编程用量监控
了然于心，掌控全局。
🌐 官网 · ⬇️ 下载 · English
Tokei 是一款 macOS 菜单栏应用，实时追踪你在 9 款 AI 编程工具 上的用量、成本和性能——全部基于本地日志，零网络流量。
| 工具 | 追踪指标 |
|---|---|
| Claude Code | Token（输入/输出/缓存）、成本、配额、模型 |
| Codex CLI | Token、成本、配额、会话 |
| Gemini CLI | Token、思考量、成本、模型 |
| Grok CLI | Token、会话、上下文 |
| Hermes | Token、成本、缓存命中率、模型 |
| OpenClaw | Token、成本、任务、模型 |
| Pi Coding Agent CLI | Token、成本、缓存命中率、模型、项目 |
| OpenCode | Token、成本、缓存命中率、模型 |
| Qoder | Token、调用次数、配额 |
- 30 秒自动刷新，菜单栏直接显示配额/用量
- 按工具展示卡片，一眼掌握所有 AI 工具状态
- 基于 API 实际定价估算成本（非订阅费用）
- 317 个模型价格表（来源 OpenRouter），支持一键更新
- 本地价格覆盖（
pricing_overrides.json），更新不丢失 - 未知模型按家族关键词回退，兜底用 Opus 价格（保守上限）
- 每日成本折线图
- 每周热力图
- 工具用量占比分析
- 今天 / 昨天 / 本周 / 上周 / 本月 / 今年
- 随时切换，对比不同时段用量趋势
- 按项目维度查看 Claude Code / Pi / Grok 用量
- 了解每个项目消耗了多少 Token 和成本
- 基于 Git 的跨设备同步（Mac + Linux 服务器）
- Mac 端设置里一键开启
- 远程 Linux 服务器支持 crontab 自动采集和同步
- 也可以让 Claude Code 帮你自动完成全部配置
- 回顾你一整年的 AI 编程旅程
- 总用量、总成本、高峰日、工具偏好等统计
- 感知空闲状态，智能提醒休息
- 可自定义间隔时间
- 仅读取本地日志文件，从不联网上报
- 唯一的网络操作：手动执行
--update-prices更新价格表
- 从 GitHub Releases 下载最新 DMG
- 打开 DMG，将 Tokei.app 拖入 Applications 文件夹
- 首次打开如被 macOS 拦截，在终端运行：
sudo xattr -rd com.apple.quarantine /Applications/Tokei.app - 打开 Tokei 即可
从源码构建
git clone https://github.com/cclank/tokei.git
cd tokei/Tokei
bash package.sh
open Tokei.appTokei 支持通过私有 Git 仓库在多台机器间同步用量数据。
Mac 端： 打开设置 → 多设备同步 → 开启，选择一个 Git 仓库目录。
远程 Linux 服务器：
git clone <你的私有仓库> ~/.tokei/sync
curl -fsSL https://dl.lanshuagent.com/tokei/usage.30s.py -o ~/.tokei/usage.30s.py
echo '{"sync_dir":"~/.tokei/sync","device_id":"'$(hostname -s)'"}' > ~/.tokei/config.json
# 每 5 分钟自动采集并同步
(crontab -l 2>/dev/null; echo '*/5 * * * * cd ~/.tokei/sync && python3 ~/.tokei/usage.30s.py --json >/dev/null && git pull -q && git add -A && git diff --cached --quiet || git commit -qm sync && git push -q') | crontab -所有数据均来自 本地日志文件，无网络请求。
| 工具 | 日志路径 |
|---|---|
| Claude Code | ~/.claude/projects/<proj>/<session>.jsonl |
| Codex CLI | ~/.codex/sessions/YYYY/MM/DD/*.jsonl |
| Gemini CLI | ~/.gemini/gemini-cli/conversations/*.json |
| Grok CLI | ~/.grok/sessions/YYYY/MM/DD/*.jsonl |
| Hermes | ~/.hermes/state.db + ~/.hermes/profiles/*/state.db |
| OpenClaw | ~/.openclaw/agents/*/sessions/*.jsonl + SQLite |
| Pi Coding Agent CLI | ~/.pi/agent/sessions/<project>/*.jsonl |
| OpenCode | ~/.opencode/sessions/*.json |
| Qoder | ~/.qodo-ai/sessions/*.jsonl |
| 功能 | Tokei | CodexBar |
|---|---|---|
| 支持工具 | 9 | 40+ |
| Token 级用量分析 | ✅ | — |
| 成本估算（317 模型） | ✅ | 部分 |
| 数据面板（图表 + 热力图） | ✅ | — |
| 多时间维度 | 6 个 | — |
| 项目级追踪 | ✅ | — |
| 多设备同步 | ✅ | — |
| 年度回顾 | ✅ | — |
| 防休眠 / 久坐提醒 | ✅ | — |
| 需要联网 | 否 | 是 |
| 需要登录 | 否 | 是 |
| 数据来源 | 本地日志 | 远程 API |
CodexBar 在提供商覆盖和配额可见性上表现出色。Tokei 更深入——Token 级分析、成本趋势、项目维度拆分、跨设备同步——全部无需登录。
- feat: 久坐提醒语音播报
- feat: 按模型显示 token 总量 + 缓存命中率
- feat: Hermes 多 profile 支持（
~/.hermes/profiles/*/state.db） - feat: 设置页 GitHub 链接按钮
- fix: 菜单栏无配额时兜底显示今日总 token 或品牌图标
- fix: 3 处文件句柄泄漏（Claude/Gemini/Pi 扫描）
- fix: Hermes「上周」数据缺失
- fix: OpenCode 成本纳入每日汇总
- fix: Claude Code 按 message ID 去重，修复重复计数问题
- fix: Claude Code 扫描 subagent/workflow 日志（之前遗漏）
- fix: Codex 额度过期后自动归零，解决刷新不及时问题
- feat: 设置页增加「检查更新」按钮 + "已是最新"反馈
- fix: 应用内自动更新支持
Tokei is a macOS menu bar app that tracks usage, cost, and performance across 9 AI coding tools in real-time — all from local log files, with zero network traffic.
Features: Real-time monitoring (30s refresh) · Cost estimation (317 models, OpenRouter pricing) · Dashboard (daily chart, weekly heatmap) · Time ranges (today/week/month/year) · Project-level tracking · Multi-device sync (Git-based, Mac + Linux) · Annual Wrapped · Keep awake · Sit reminder · Privacy-first (local logs only) · Compare with CodexBar
Supported tools: Claude Code, Codex CLI, Gemini CLI, Grok CLI, Hermes, OpenClaw, Pi Coding Agent CLI, OpenCode, Qoder
For full documentation, visit tokei.lanshuagent.com.
MIT