ccusage
活跃简介
ccusage 是一个用于分析编码 Agent CLI Token 使用量和成本的轻量工具,通过读取本地数据帮助开发者监控和优化 LLM API 消费。
核心特性
- 支持 15 种以上编码 Agent CLI 的统一报告,包括 Claude Code、Codex、OpenCode 和 Gemini
- 按日、周、月和会话聚合使用量,以 USD 追踪费用
- 支持 `--breakdown` 查看模型级别费用明细,追踪缓存 Token
- 通过 `--since`/`--until` 按日期筛选,支持按实例分组的项目级分析
- JSON 导出、紧凑模式适合截图,表格自动响应式布局
- 通过 `bunx ccusage` 或 `npx ccusage@latest` 零安装运行
适用场景
💡 监控和优化多个编码 Agent 的 LLM API 消费
💡 为使用 AI 辅助开发工具的团队生成月度费用报告
💡 追踪按项目分组的 Token 消耗,识别高成本工作负载
💡 比较不同 AI 编码 Agent 在相同任务上的费用效率
💡 通过将 JSON 输出集成到监控管道中设置预算告警
分类
快速开始
运行 `bunx ccusage`(无需安装)查看所有检测到的数据源。使用子命令如 `ccusage claude daily`、`ccusage weekly --since 2026-04-01` 或 `ccusage monthly --json` 生成筛选和结构化报告。