CodeBurn 评测：本地解析会话文件，把 41 个 AI 工具的 token 账单拆到任务级
免费的本地工具，可按模型、项目和任务跟踪 31 个工具和代理（Claude Code、Cursor、Codex、Gemini 等）中 AI 编码令牌的使用情况和成本。 npx 代码烧录。
秒懂
- 它是什么？
- CodeBurn 是一个免费、本地优先的 token 用量与成本追踪工具，支持 41 个 AI 编码工具。它直接读取本机会话文件，不经过代理，不收集数据，但定价依赖 LiteLLM 的每日刷新。
- 适合谁用？
- CodeBurn 适合那些已经重度使用多个 AI 编码工具、且对账单明细不满意的人。它把分散在会话文件里的 token 数据统一成按任务、模型、项目维度的报表，这是官方账单做不到的。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 1 天前。
- 用什么语言写的？
- 主要是 TypeScript（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月14日）和我们的分析，不构成法律意见。
开源项目深度解析
账单只告诉你总额，CodeBurn 告诉你钱花在哪
你用 Claude Code、Cursor、Codex 这些工具，月底账单只给一个总数字。它不会告诉你一半的钱花在了对话而不是写代码上，也不会告诉你一个昂贵模型浪费了预算，而便宜模型本来能一次完成。CodeBurn 解决的就是这个问题：它读取你的 AI 工具已经写到磁盘上的会话文件，把每个 token 和每一美元按任务、模型、工具、项目拆开。这是一个本地优先的工具，没有包装层，没有代理，不需要 API 密钥，数据不出你的机器。定价来自 LiteLLM，每天刷新。
四种界面，同一个数据源
CodeBurn 提供四种使用方式：终端交互面板、Web 界面、桌面应用和菜单栏应用。终端里运行 npx codeburn 会打开一个交互式仪表盘，默认显示今天的数据，如果今天没有用量则显示最近 7 天。方向键切换时间段，q 退出。Web 界面用 npx codeburn web 启动，桌面应用有 macOS、Windows 和 Linux 的安装包，菜单栏应用在 macOS 上显示常驻花费，Windows 上安装为托盘应用，Linux 则是一个 GNOME Shell 扩展。关键点是，四种界面读取的是同一份数据，都来自你磁盘上的会话文件。这种设计避免了多端数据不一致的问题，但也意味着如果会话文件不完整，所有界面都会显示不完整。
从会话文件到成本报告，数据流是怎样的
README 明确说明，CodeBurn 读取的是工具已经写入磁盘的会话文件。这意味着它不做代理拦截，不修改你的工具配置，只是被动地解析文件。对于 Cursor 和 OpenCode，它需要 better-sqlite3 来读取 SQLite 数据库，这个依赖会自动安装。具体的数据流是：工具在使用时生成会话文件，CodeBurn 解析这些文件，提取 token 数量、模型名称、时间戳和任务信息，然后结合 LiteLLM 的定价表计算成本。定价表每天刷新，所以即使模型价格变动，报告也会相对及时。这里有个值得注意的点：CodeBurn 依赖工具本身是否把会话数据完整写到磁盘。如果某个工具只保留部分会话，或者格式变化，CodeBurn 的解析就可能不完整。
快速上手：npx codeburn 就够了
最简单的启动方式是不安装，直接运行 npx codeburn。这会打开交互式仪表盘，30 秒内你就能看到自己的 AI 预算花在哪。如果想永久使用，可以 npm install -g codeburn，或者用 bunx、pnpm dlx，macOS 上还能 brew install codeburn。环境要求是 Node.js 22.13+，并且至少有一个支持的工具有会话数据在磁盘上。菜单栏应用在 macOS 上通过 codeburn menubar 安装，同样的命令在 Windows 上安装托盘应用。安装后可以运行 codeburn overview 查看本月概览，输出是纯文本表格，可以复制到 PR 或 Slack。支持 --from 和 --to 指定日期范围，-p all 查看最近 6 个月，-p lifetime 查看全部历史。
优化命令：找出浪费的根源
codeburn optimize 是另一个核心命令，它扫描最近 30 天的会话和 ~/.claude/ 配置，找出浪费模式。对于 Claude Code，它会分析用户启动的主会话，排除子代理的侧链转录。这意味着优化报告只关注真正由你发起的会话，而不是那些自动产生的子任务。你可以用 -p today 或 -p week 限制时间范围，用 --provider claude 只分析一个提供商，用 --format json 输出结构化结果。这个命令的价值在于，它不只是报告数字，还给出改进建议，比如哪些任务用了过贵的模型，哪些会话可以合并。但注意，优化功能目前明确针对 Claude Code，其他工具的优化支持可能有限。
一个真实的限制：依赖会话文件的完整性
CodeBurn 的整个机制建立在会话文件可解析这个前提上。如果某个工具不写会话文件，或者文件格式不公开，CodeBurn 就无法追踪。README 提到支持 41 个工具，但并没有详细列出每个工具的解析方式。对于 Cursor 和 OpenCode，它需要 better-sqlite3 自动安装，这暗示这两个工具使用 SQLite 存储，但其他工具可能使用 JSON 或日志文件。另一个限制是，定价来自 LiteLLM，如果某个小众模型不在定价表中，成本计算就会不准。还有，CodeBurn 计算的是 token 成本，不包含订阅费或固定费用，所以它反映的是边际成本，而不是你的真实账单。如果你用的是按座位收费的企业版，CodeBurn 的数字可能和账单对不上。
对比：账单页面 vs 本地解析器
最直接的替代方案是各工具自带的账单页面，比如 Claude 的 usage 页面或 Cursor 的 billing 页面。这些页面提供官方的总额和部分明细，但它们是按工具隔离的，无法跨工具比较。CodeBurn 的优势在于统一视图，把 Claude Code、Codex、Cursor 等所有工具的 token 和成本放在一张表里。另一种替代是使用代理或网关，比如 LiteLLM 本身，它可以作为代理记录所有请求，但那样你需要改变工具的网络配置，把流量路由到代理，这引入了额外的故障点和延迟。CodeBurn 走的是被动读取路线，不改变你的工作流，但代价是它只能看到工具主动写入的数据。如果你的工具不写会话文件，代理方案反而更可靠。
维护与升级：MIT 许可，但版本节奏很快
CodeBurn 采用 MIT 许可证，这意味着你可以自由使用、修改和分发，没有法律上的限制。项目最近一次提交在 2026 年 8 月 29 日，发布了 v0.9.23，同时还有 Windows 和 macOS 的菜单栏版本。版本号 0.9.x 表明项目还在快速迭代，API 和命令可能有变化。升级成本取决于你如何使用：如果你用 npx codeburn，每次运行都会获取最新版，这是最省心的方式；如果你全局安装，需要手动 npm update -g codeburn。菜单栏应用和桌面应用需要手动下载新版本。由于定价表每天刷新，即使你不升级，成本计算也会更新，但新工具的支持和 bug 修复需要升级才能获得。考虑到项目活跃，升级频率可能较高，但 npx 方式可以减轻负担。
编辑结论
CodeBurn 适合那些已经重度使用多个 AI 编码工具、且对账单明细不满意的人。它把分散在会话文件里的 token 数据统一成按任务、模型、项目维度的报表，这是官方账单做不到的。但它的价值完全取决于你本机是否有可解析的会话文件，以及 LiteLLM 的定价是否覆盖你用的模型。若你只用单一工具且每月花费不大，手动看账单就够了，没必要引入这个工具。若你决定采用，先验证 Node.js 22.13+ 环境，确认你的工具（尤其是 Cursor 和 OpenCode）的会话文件能被正确读取，并检查 LiteLLM 定价表中你所用模型的价格是否准确。
社区笔记