用途：CodeBurn 用于查看 AI 编码花费去向，统计 40 种工具与智能体（Claude Code、Cursor、Codex、Gemini、Grok、OpenCode 等）的 token 用量与成本，按模型、项目、任务拆分。它读取这些工具已写入磁盘的会话文件，无需包装器、代理或 API 密钥，并用 LiteLLM 每日刷新的价格数据为每次调用计价。终端 TUI、浏览器仪表盘、macOS 菜单栏/GNOME 面板和 MCP 服务器四个入口共享同一份磁盘数据。
主要能力：快速查看本周/本月预算去向（overview、status、report）；发现浪费（optimize 扫描重读文件、臃肿的 CLAUDE.md、未使用的 MCP 服务器、幽灵智能体/技能等，并给出预估节省与修复方案及 A–F 评级）；应用修复并撤销（optimize --apply、act list/undo/report）；预防超支（guard install/status/allow，软上限默认 $5 警告，硬上限默认 $15 终止会话）；模型比价（compare）；验证 AI 辅助工作是否真正交付（yield）；向智能体暴露实时用量/节省数据（mcp）；诊断 $0 或无数据（doctor）。
使用方式：可即用 npx codeburn 打开交互式 TUI（最近 7 天）；永久安装 npm install -g codeburn（macOS 可用 brew install codeburn），需 Node.js 22.13+。常用命令包括 codeburn overview、codeburn status、codeburn report --format json、codeburn optimize、codeburn guard install、codeburn compare、codeburn yield、codeburn doctor；多数命令支持 --provider、--project/--exclude 与周期参数（-p today|week|30days|month|all|lifetime）或 --from/--to。MCP 接入：claude mcp add codeburn -- npx -y codeburn mcp，暴露 get_usage 与 get_savings，除非调用方指定 include_project_names: true，项目名会做假名化。
限制：CodeBurn 只测量和报告花费，不设定价格或限流 API 调用（guard 的上限只终止会话，不改计费）；团队云端分析需自备 URL 的预览版推送通道，不是托管 SaaS 仪表盘；yield 需在 git 仓库中运行；optimize --apply 会写入真实配置文件，应先 --dry-run 预览；doctor 为只读离线诊断，用于排查路径或环境变量不匹配而非真实零花费。