CodeBurn：AI 编程工具的"费用透明化"利器

当你的 Claude Code 账单突然爆炸时

想象这样一个场景：你正在开发一个重要项目，Claude Code 跑了一整天，晚上打开账单一看——今天烧掉了 12 美元。但你不确定：这钱花得值不值？是哪个任务消耗最大？是哪个模型最贵？

你打开项目里的所有会话日志，几十个文件，密密麻麻的 token 数字……

CodeBurn 正是为解决这个痛点而生。它像给你的 AI 编程工具装上了一块"实时电表"，让你对每一分钱花在哪里一目了然。

背景：AI 编程工具的"黑暗森林"

2024-2025 年，以 Claude Code、Cursor、GitHub Copilot、OpenCode 为代表的 AI 编程工具迅速普及。但这些工具的 token 计费对用户来说几乎是"黑箱"——你只能事后收到账单，却无法实时感知消耗。

开发者社区里常有这样的困惑："我用 Cursor 写代码，为什么这个月账单是上个月的两倍？"、"Claude Code 和 OpenAI Codex 哪个性价比更高？"

CodeBurn 由独立开发者 Toruk（@iamtoruk）发起，GitHub Stars 超过 7300，是目前 AI 编程成本追踪领域最受欢迎的开源工具。其官网 codeburn.app 提供了更完整的文档和社区支持。

它是怎么工作的？——不需要 API Key，不需要代理

CodeBurn 最核心的设计哲学是"零侵入"。它不要求你提供任何 API Key，不充当中间代理，不修改任何工具本身。它直接读取各 AI 编程工具在本地磁盘上存储的会话数据文件（JSON/SQLite），然后用 LiteLLM 的定价表来计算成本。

这种"无代理"的架构带来了几个关键优势：

• 隐私安全：所有数据处理都在本地完成，不会经过第三方服务器
• 无需配置：装完即用，不需要申请任何 Key 或配置服务地址
• 可持续性强：只要工具的会话格式不变，CodeBurn 就能持续工作

图1：CodeBurn 的主仪表盘，显示今日/7天/30天/本月的 token 消耗与费用概览

核心功能：不是简单记账，而是深度洞察

1. 多工具聚合追踪

CodeBurn 支持追踪超过 25 种 AI 编程工具，涵盖：

• 主流工具：Claude Code、Cursor、Windsurf、Copilot
• 新兴工具：OpenCode、Pi、Codebuff、Kimi Coding
• 国产工具：Kimi（字节的 Kimi 编程助手）

这意味着如果你在团队中混用多种工具，CodeBurn 可以统一归口展示全平台的成本分布。

2. 多维度成本拆解

CodeBurn 不仅仅告诉你"花了多少钱"，还能按以下维度拆分：

• 按任务类型：功能开发、代码审查、调试修复……
• 按模型：GPT-4o、Claude 3.5 Sonnet、Gemini 2.5……
• 按工具：Cursor vs Claude Code 谁更贵
• 按项目：哪个仓库消耗最大
• 按时间段：今天、本周、本月、自定义日期范围

图2：CodeBurn 支持的 AI 编程工具生态一览

3. 优化建议（Optimize）

最有特色的功能之一：codeburn optimize 会扫描你的会话数据，自动识别浪费：

• 哪些会话产生了大量 token 但最终代码被回滚（被废弃的消耗）
• 哪些任务用了更贵的模型但效果和便宜模型差不多
• 哪些会话的上下文窗口用得最奢侈

它还会给你提供可以直接复制的修复建议，告诉你如何调整使用习惯来省钱。

图3：Optimize 功能会标注浪费来源并提供具体修复方案

4. 模型对比（Compare）

codeburn compare 可以对不同模型进行横向比较：同样完成一个功能，Claude 3.5 Opus vs GPT-4o 谁的吞吐量更高、成本更低？这对于需要选型的团队非常有参考价值。

图4：Compare 功能支持多个模型横向性能/成本对比

5. Yield 分析（收益追踪）

codeburn yield 专门追踪"有效消耗"与"浪费消耗"的比例：你的 token 花费中，有多少最终进入了代码库，有多少被回滚、废弃或浪费？这个指标对评估 AI 编程工具的实际 ROI 至关重要。

6. macOS 菜单栏模式

CodeBurn 还提供 macOS 菜单栏应用（Menu Bar App），让你在系统托盘实时看到今日消耗，无需打开 TUI 界面。

图5：macOS 菜单栏实时显示今日 token 消耗

技术架构解析

CodeBurn 的技术栈非常精炼：

层级	技术选型	说明
运行时	Node.js 22+	要求 Node.js 22.13.0 及以上
UI 渲染	Ink + React 19	Ink 是专为 CLI 设计的 React 渲染引擎，支持富文本 TUI
构建工具	tsup（Go语言编写的高速打包器）	产出 dist/cli.js 作为全局可执行文件
定价计算	LiteLLM（bundled）	内嵌 LiteLLM 定价表，支持实时更新
会话解析	TypeScript 原生解析器	针对每种工具的会话文件格式编写专属解析器
测试	Vitest	快速单元测试框架
国际化	多语言支持	文档覆盖多种语言

核心解析模块位于 src/ 目录，按工具分类：

• cursor-cache.ts：Cursor 会话缓存解析
• codex-cache.ts：OpenAI Codex 解析
• sqlite.ts：better-sqlite3（SQLite 解析，Cursor 和 OpenCode 的会话数据存在 SQLite）
• parser.ts：通用解析器框架

代码质量评估：项目代码结构清晰，使用 TypeScript 严格模式，模块划分合理（classifier 分类器、aggregator 聚合器、models 报告生成器）。测试覆盖率较好（vitest），文档完善（CHANGELOG 超过 61KB）。代码质量评分：85/100。

上手门槛：几乎为零

CodeBurn 的安装和运行极其简单：

# 方式一：npm 全局安装（最常用）
npm install -g codeburn

# 方式二：Homebrew（macOS 用户）
brew install codeburn

# 方式三：不安装直接跑
npx codeburn

安装完成后，CodeBurn 会自动扫描常见平台的会话数据位置，无需任何配置。首次运行会展示最近 7 天的数据概览。

codeburn                    # 默认 7 天仪表盘
codeburn today              # 今日数据
codeburn report -p 30days   # 滚动 30 天报告
codeburn optimize           # 启动优化扫描
codeburn export -f json    # JSON 格式导出

局限与争议

1. 非实时监控

CodeBurn 依赖读取本地会话文件，无法做到真正的"实时"计费——你需要运行命令才会刷新数据。对于需要持续监控的团队，建议配合 cron 定时任务使用。

2. 不支持 Web 界面

目前只有 TUI（终端界面）和 macOS 菜单栏，没有 Web Dashboard。对于团队共享数据场景，需要额外导出 JSON/CSV 再处理。

3. 会话格式脆弱性

各工具的会话文件格式随时可能变化，CodeBurn 需要持续跟进维护。一旦工具更新了会话存储格式，解析器可能失效。

4. 仅支持本地数据

CodeBurn 无法接入企业内部的 API 计费系统，只能追踪开发者本机上的会话。如果在团队中推广，需要每个成员都安装。

行业意义：从"盲目烧钱"到"理性使用"

CodeBurn 的出现代表了 AI 编程工具生态走向成熟的一个信号：当工具从"实验性玩具"变成"日常工作流"，成本控制就成了刚需求。

它让开发者能够回答一个过去无法量化的问题：AI 编程的 ROI 到底怎么样？ 通过 yield 分析和 optimize 功能，用户可以量化 AI 辅助编程的真正价值，而不仅仅凭感觉判断"贵不贵"。

这个领域的竞争也在加剧：GitHub Copilot Analytics、Cursor 的内置统计、以及新兴的第三方工具都在争夺"AI 编程成本可视化"这个细分市场。CodeBurn 作为开源方案，凭借透明、无锁定、多工具支持的特性，占据了先发优势。

---

总结：CodeBurn 是一个专注于 AI 编程工具 Token 成本追踪的本地 TUI 工具，支持 25+ 工具、无需 API Key、纯本地处理数据，安装简单、分析深入。对于频繁使用 Claude Code、Cursor 等工具的开发者，它是你优化 AI 使用成本、评估工具 ROI 的必备利器。