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 输出集成到监控管道中设置预算告警
优势与不足
✅ 优势
- • 活跃维护，近期持续更新
- • 社区热度高（18.0k stars）
- • Issue 响应及时，积压少
⚠️ 不足
- • 缺少明确的开源许可证
分类
快速开始
运行 `bunx ccusage`（无需安装）查看所有检测到的数据源。使用子命令如 `ccusage claude daily`、`ccusage weekly --since 2026-04-01` 或 `ccusage monthly --json` 生成筛选和结构化报告。