getagentseal/codeburn

项目概览

支持通过本地 MCP 服务器将用量数据暴露给 AI 代理，使代理能够获取并参考这些数据进行后续优化。

项目类型

AI 编程 · 评测观测 · 基础设施

应用场景

编程开发

部署方式

查看项目说明

License

MIT

适合谁

• 希望在不改变现有工作流、不暴露 API 密钥的前提下，追踪 32 种主流 AI 编码工具成本的独立开发者或团队负责人。
• 需要量化评估 AI 编码实际产出效率，并据此优化模型选型和预算分配策略的技术团队。

核心能力

• 通过解析本地的会话记录文件，将 AI 编码过程中的 Token 消耗与对应成本按照具体任务、使用的模型、工具来源以及所属项目进行多维度拆解，帮助用户看清每一笔支出的去向。该功能已正式可用。
• 深度扫描历史会话记录和相关配置文件，自动识别导致 Token 浪费的模式，并提供交互式或自动化的修复方案。修复操作支持撤销机制，确保优化过程的安全可控。该功能已正式可用。
• 为 Claude Code 安装可选的钩子程序，在会话进行时实时监控成本消耗。支持设置软性提醒、硬性上限以及检查点拦截，有效防止预算超支。该功能已正式可用。
• 在本地通过标准输入输出（stdio）运行一个 MCP（模型上下文协议）服务器，将历史用量详情和节省数据开放给 AI 代理访问，使代理能够基于这些数据优化行为。该功能已正式可用。
• 在关键的效能指标上对比不同 AI 模型的表现，包括一次成功率、重试频率以及每次代码编辑的平均成本，为团队选择性价比最高的模型提供数据支撑。该功能已正式可用。
• 将 AI 编码会话与本地 Git 仓库的提交记录进行关联比对，自动把相关的支出归类为高效产出、被撤销或直接废弃，直观呈现 AI 编码的实际有效转化率。该功能已正式可用。
• 在本地浏览器中启动一个包含丰富图表的 Web 仪表盘，提供与终端界面（TUI）完全一致的详尽数据拆解视图，便于习惯图形化界面的用户进行深度分析。该功能已正式可用。
• 通过 macOS 菜单栏应用和 GNOME Shell 扩展，提供一个无需主动打开窗口即可随时查看实时 AI 开销的常驻视图，实现无感知的环境监控。该功能已正式可用。

限制与风险

• 如果要将支出准确关联到具体的代码提交并计算产出率，必须在 Git 仓库环境中运行；非 Git 管理的项目无法使用产出率追踪功能。
• 团队遥测数据同步目前仅为预览版，随着版本迭代，底层同步协议可能会发生变更，暂不建议直接用于关键生产链路。
• 工具给出的优化节省金额在最初阶段依赖系统估算，只有经过 3 天的实际运行与对比后，才能反映真实的成本节省情况。

如何开始

• 部署门槛低，仅需确保系统具备 Node.js 22.13+ 环境以及至少一个受支持工具的本地会话数据。无需复杂配置，直接使用 npx codeburn 命令即可瞬时运行并查看分析结果。

核验依据

• README: CodeBurn is a free, open-source, local-first tool that tracks AI coding token usage and cost across 32 tools and agents (Claude Code, Cursor, Codex, Gemini, Grok and more), broken…
• README: **Run it instantly**, no install needed: ```bash npx codeburn ``` That opens the interactive dashboard (last 7 days by default). Arrow keys switch periods, `q` quits.
• README: The bill tells you the total. It never tells you that half of it went to conversation instead of code, or that an expensive model burned your budget on work a cheaper one would ha…
• README: It reads the session files your tools already write to disk and breaks down every token and dollar by **task, model, tool, and project**, across **32 AI tools**.
• README: `codeburn optimize` scans your sessions and your `~/.claude/` setup for waste patterns

内容核验时间：