什么是toll
toll 是一个专为 Claude Code 和 Codex CLI 用户设计的命令行工具，用于追踪和统计 AI 编程会话中的 Token 使用情况，并估算对应的美元成本。它通过解析本地日志文件，汇总用户的输入、输出以及缓存命中情况，提供清晰的使用报告。该工具支持多种查询模式，包括总览、单日统计、指定天数范围等，满足不同场景下的分析需求。
与简单的日志查看器不同，toll 不仅展示原始数据，还自动计算缓存命中率、净输入量及费用预估，帮助用户理解模型调用的实际开销。尤其对于频繁使用 AI 辅助开发的团队或个人开发者而言，这一功能有助于控制 API 支出并优化提示词设计。此外，toll 支持 JSON 和 CSV 格式导出，便于进一步处理或集成到自动化流程中。
工具的安装方式灵活，既可通过 curl 脚本一键部署（适用于 Linux/macOS），也可通过 Rust 的 cargo 包管理器安装。其核心逻辑是读取 ~/.claude/projects/**/*.jsonl 和 ~/.codex/sessions/ 目录下的日志文件，提取每条会话的 token 消耗信息，并结合预设的模型价格表进行成本核算。所有数据均基于真实会话记录生成，确保统计结果准确可靠。
核心功能特点
- 聚合 Claude Code 和 Codex CLI 的 Token 使用日志，生成统一统计报告
- 支持按时间范围筛选（今日、最近 N 天）和按来源拆分（仅 Claude 或仅 Codex）
- 显示输入/输出 Token 数、缓存命中率、净输入量和预估 USD 成本
- 提供每日明细、JSON/CSV 导出及模型价格列表查询功能
- 自动检测是否已安装，未安装时引导用户完成快速部署
适用场景
当开发者需要监控自己使用 Claude Code 或 Codex 产生的 API 费用时，toll 能快速给出当前账户的总花费和趋势概览。例如，在项目收尾阶段，项目经理可以通过运行 toll --days 30 查看过去一个月的成本分布，判断是否需要调整提示策略以降低成本。对于习惯用 AI 重构代码或生成文档的技术人员来说，定期查看缓存命中率也有助于识别哪些提示词重复率高，从而提升效率。
另一个典型应用场景是在团队协作环境中共享资源配额管理。若公司限制每位工程师的月度 AI 调用预算，成员可使用 toll --today 实时检查当日消耗，避免超额。此外，配合 CI/CD 流程，将 toll --csv 输出写入报表系统，可实现自动化审计与成本控制。无论是个人开发者还是企业运维人员，toll 都能提供透明、可量化的 AI 使用洞察。
值得注意的是，toll 特别关注缓存机制带来的成本差异——相同提示词若被缓存命中，费用仅为原始价格的约10%。因此，它不仅是一个计费工具，更是优化开发工作流的实用助手。结合 --by-day 参数生成的日粒度报告，用户还能发现某些日期异常高耗费的会话，进而回溯具体操作内容，找出问题根源。