Token Usage 接入说明 在需要统计的机器上,以运行 coding agent 的同一个用户执行。支持 macOS 和使用 cron 的 Linux,需要 Python 3、Node.js 22+ 和 npm。使用看板登记的机器名。 setup_script=$(mktemp) curl -fsS https://ziming-token-usage.arunningstar.com/collect.py -o "$setup_script" && python3 "$setup_script" install --machine MACHINE_NAME rm -f -- "$setup_script" 让用户在安装提示中粘贴看板生成的上报 Key。不要把 Key 放进命令参数、聊天、 日志或 URL。采集器将 Key 保存在当前用户私有配置文件中。 安装会先验证一次上报,然后注册每 5 分钟的用户任务。第一次同步读本机 保留的全部历史,平时同步近期数据,每天重新扫描历史。如发生失败, 查看采集器的错误日志并重跑一轮。 python3 ~/.local/share/ziming-token-usage/collect.py status python3 ~/.local/share/ziming-token-usage/collect.py run 文件位置:~/.local/share/ziming-token-usage/,错误日志 errors.log。 macOS 任务:com.arunningstar.ziming-token-usage(LaunchAgent)。 Linux 任务:crontab -l 中标记为 ziming-token-usage 的一行。 ccusage 在本机离线读取使用记录。只上传机器名、日期、Agent、总 Token、 缓存读取 Token、估算 USD、采样时间和 ccusage 版本。API Key 只用于 HTTPS 请求认证。服务每台机器各用一个 Key,可在看板撤销或换发。 采集器独立管理 ccusage 20.x。每天检查新版本,把候选版的实际报表成功 上传后才切换。模型定价随 ccusage 自带的价格表更新。如需要补价,可按 ccusage 配置文档使用 pricingOverrides。status 会列出最近一轮的待定价模型。 https://ccusage.com/guide/config-files#pricing-overrides