⏱ Tokei 時計

macOS 菜单栏 AI 编程用量监控
_{了然于心，掌控全局。}

🌐 官网 · ⬇️ 下载 · English

## 什么是 Tokei？ 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 帮你自动完成全部配置 ### 年度回顾（Wrapped） - 回顾你一整年的 AI 编程旅程 - 总用量、总成本、高峰日、工具偏好等统计 ### 久坐提醒 - 感知空闲状态，智能提醒休息 - 可自定义间隔时间 ### 隐私优先 - 仅读取本地日志文件，从不联网上报 - 唯一的网络操作：手动执行 `--update-prices` 更新价格表 ## 快速开始 1. 从 [GitHub Releases](https://github.com/cclank/tokei/releases/latest) 下载最新 DMG 2. 打开 DMG，将 Tokei.app 拖入 Applications 文件夹 3. 首次打开如被 macOS 拦截，在终端运行：`sudo xattr -rd com.apple.quarantine /Applications/Tokei.app` 4. 打开 Tokei 即可

从源码构建

git clone https://github.com/cclank/tokei.git cd tokei/Tokei bash package.sh open Tokei.app

## 多设备同步配置 Tokei 支持通过私有 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//.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//*.jsonl` | | OpenCode | `~/.opencode/sessions/*.json` | | Qoder | `~/.qodo-ai/sessions/*.jsonl` | ## 对比 CodexBar | 功能 | Tokei | [CodexBar](https://github.com/steipete/CodexBar) | |------|:-----:|:---------:| | 支持工具 | 9 | 40+ | | Token 级用量分析 | ✅ | — | | 成本估算（317 模型） | ✅ | 部分 | | 数据面板（图表 + 热力图） | ✅ | — | | 多时间维度 | 6 个 | — | | 项目级追踪 | ✅ | — | | 多设备同步 | ✅ | — | | 年度回顾 | ✅ | — | | 防休眠 / 久坐提醒 | ✅ | — | | 需要联网 | 否 | 是 | | 需要登录 | 否 | 是 | | 数据来源 | 本地日志 | 远程 API | ## 更新日志 ### v1.0.2 - feat: 久坐提醒语音播报 - feat: 按模型显示 token 总量 + 缓存命中率 - feat: Hermes 多 profile 支持（`~/.hermes/profiles/*/state.db`） - feat: 设置页 GitHub 链接按钮 - fix: 菜单栏无配额时兜底显示今日总 token 或品牌图标 - fix: 3 处文件句柄泄漏（Claude/Gemini/Pi 扫描） - fix: Hermes「上周」数据缺失 - fix: OpenCode 成本纳入每日汇总 ### v1.0.1 - fix: Claude Code 按 message ID 去重，修复重复计数问题 - fix: Claude Code 扫描 subagent/workflow 日志（之前遗漏） - fix: Codex 额度过期后自动归零，解决刷新不及时问题 - feat: 设置页增加「检查更新」按钮 + "已是最新"反馈 - fix: 应用内自动更新支持 ## English 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](https://tokei.lanshuagent.com#compare) **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](https://tokei.lanshuagent.com). ## License MIT

标签：AI编程, Python, Swift, 成本追踪, 无后门, 用量监控, 菜单栏应用, 逆向工具