KechuAI

CodeBurn：给 AI 编码账单做明细的开源成本看板

AI
FinOps
成本
Claude Code
开发者工具
开源
2026/9/29
·

阅读时间: 大约 7 分钟

CodeBurn：给 AI 编码账单做明细的开源成本看板

CodeBurn 仪表板：今日 $26.81、效率分 82、缓存命中 81%、月预测 $11,715，按模型/活动拆分花费

用 Claude Code、Cursor、Codex 这类 AI 编码工具越久，「这个月到底花了多少钱、花得值不值」就越成问题——各家只在订阅到期时给一个总数。CodeBurn 是一个开源的成本追踪工具，口号是「Your AI Bill, Itemized（你的 AI 账单，逐笔列清）」。它不接入任何云，只读本地会话日志，把花出去的钱按模型、项目、会话、甚至 MCP 服务器拆开。本文基于其官网做分析。

一、它解决什么问题

AI 编码工具的计费是个黑盒：你知道订阅月费，但不知道——

  • 钱花在了哪个模型上（Opus 还是 Sonnet）；
  • 哪个项目/分支/PR 烧得最多；
  • 有多少 token 被浪费在重试、超长工具输出上；
  • 缓存命中率多少、一次成功率多少。

CodeBurn 的回答：npx codeburn 一跑，整个账单变成一张地图。它目前支持 41 种工具（Claude、Codex、Cursor、Copilot、Gemini、Goose、OpenCode、Kiro、Qwen 等，比 Koala 条目里说的 18+ 已经翻了一倍多），并且只读本机会话日志——「no account, no config, no changes to how your tools run」。

二、三种形态：菜单栏、桌面 App、终端

CodeBurn 的团队/多机汇总视图

  • 菜单栏 App（原生 Swift）：当天花费常驻时钟旁，一眼看到；监控每个订阅计划的用量窗口剩余时间。macOS 原生，Linux 上对应 GNOME 顶栏；
  • 桌面 App：把账单从「一个数字」变成「一张地图」——哪个模型花进了哪个 repo、效率分多少、本月预计落到多少、花费归属到哪个分支和 PR；
  • 终端：npx codeburn 或 Homebrew 装，今日/周/月/半年/全生命周期任意切换，project/model/activity/core tools/shell/skills/agents 一屏全拆。

新增的 Capacity Dock 还能给每个已登录的 AI 计划（Claude、Codex、Kimi 等）挂一个实时用量环，绿到红显示每周或 5 小时窗口烧了多少、何时重置。

三、它算的「效率分」是什么

CodeBurn 不是简单求和 token，而是把成本转成效率指标：

  • 一次成功率（one-shot rate）：任务一次跑通的比例；
  • 缓存命中率（cache hit rate）：命中缓存的比例，直接关系到实际费用；
  • 重试税（retry tax）：失败重试多花的钱；
  • 由这三项合成一个效率分（截图里今日是 82 分），并给项目打 A–F 等级；
  • 还能「Optimize」扫描浪费模式。

官网上一条用户口碑很典型：有人用 CodeBurn 发现工具输出占了某些大会话 76.8% 的上下文 token，根源是测试输出太啰嗦，于是决定把完整输出落日志、只保留最小 STDIO——「小节省积少成多」。另一条 Reddit 用户说它发现 Claude 在「没发任何消息」时开了上千个终端会话偷偷烧 token。

四、必须自己想清楚的边界

  1. 它是「计量表」不是「控制开关」。CodeBurn 只读取本地日志、展示花费，不会帮你自动限流或切换模型；要省钱还得靠你自己改行为。Koala 把它类比成「AI 版 FinOps」是准确的——FinOps 也只是让成本可见、可优化，不是自动省钱。

  2. 数字来自本地日志解析，口径取决于上游。各工具的 token 计费口径（缓存读写、上下文截断、失败请求是否计费）不完全透明，CodeBurn 是按日志里的字段估算，账单数字是「估算」而非对账结果，和供应商实际扣款可能有出入。

  3. 隐私是它的卖点，也是边界：「nothing leaves your Mac」是优点，但意味着它不做多机/团队的真实账单合并——官网说的「local or combined across machines」是你本机多工具的合并，不是公司层面的团队成本分摊。

  4. 年轻项目：版本 0.9.25，工具适配随各家更新而漂移；某家客户端改了日志格式，对应统计就可能不准。

五、适用与不适用场景

适合： 重度使用 AI 编码工具、想知道钱花在哪的个人开发者；被订阅周期黑盒困扰、想优化缓存命中与重试率的团队负责人；macOS 上想在菜单栏实时盯花费的人；做 AI 工具 FinOps、需要导出 CSV/JSON 做分析的人。

不适合： 想要自动成本治理/强制预算开关的（它只是看板）；需要企业级多账号对账与发票的场景；不装这些客户端、只想看 API 账单的人（它读的是工具会话日志）。

六、客观分析：优势与意义

优势： 只读本地日志、零侵入、隐私不出机；41 种工具覆盖广；把花费从「一个总数」拆到模型/项目/PR/MCP/子代理粒度；一次成功率、缓存命中、重试税这套指标把「花得值不值」量化了；菜单栏实时提醒很顺手。

局限： 数字是日志估算而非对账；不做自动限流；团队/企业级合并能力有限；随上游日志格式漂移；仍在 0.9.x。

CodeBurn 的意义在于它踩中了一个真实拐点：当 AI 编码从「偶尔用」变成「每天烧几十上百美元」，成本可视化就从可选变成刚需。它把云成本管理（FinOps）那套「先看见、再优化」的方法论，搬到了个人开发者的 AI 工具账单上。对每个月看着 Claude/Cursor 订阅账单心里没数的人，这是一个值得今晚就 npx codeburn 跑一遍的工具。

参考来源