ccusage

活跃
GitHub Rust NOASSERTION

简介

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` 生成筛选和结构化报告。

相关项目