用途：CodeBurn 用于统计和展示 AI 编程工具的 token 花费与用量分布，可按任务、模型、工具、项目维度拆解，覆盖 Claude Code、Codex、Cursor、Gemini CLI、Cline 等 31 种工具。适合回答“在 Claude Code 上花了多少”“token 用量的构成”“哪些任务最贵”“模型选得是否合适”“如何优化 AI 支出”等问题，也可用于任何与 AI 工具成本、预算、token 用量相关的提问。
主要能力：提供交互式 TUI 面板、纯文本报告、JSON/CSV 导出、模型对比、优化扫描与网页图表看板。内置任务分类（编码、调试、功能开发、重构、测试、探索、规划、委派、Git 操作、构建部署、头脑风暴、对话、通用），依据工具调用与关键词自动归类；报告可按时间窗口或起止日期、按 provider 与 project 过滤。
使用方式：
npx codeburn 运行交互式面板（默认最近 7 天）；或全局安装：
npm install -g codeburn codeburn
常用命令：codeburn today / month / status；codeburn overview；codeburn report -p 30days 或 -p all，也可 --from 2026-04-01 --to 2026-04-30，加 --format json；codeburn export（CSV）或 export -f json；codeburn optimize 扫描浪费与修改建议；codeburn compare 模型对比；codeburn web 打开 http://localhost:4747。支持 codeburn report --provider claude 与 --project my-app 过滤。
数据来源与限制：读取 Claude Code 会话文件 ~/.claude/projects/<sanitized-path>/<session-id>.jsonl，包含模型名、输入/输出/缓存读写 token、tool_use 块与时间戳；数据不离开本机。多 Claude 配置目录可通过 CLAUDE_CONFIG_DIRS 设置（POSIX 用冒号，Windows 用分号）。文档列举了一些面板信号（如缓存命中低于 80%、每会话大量 Read 调用、低一次成型率、Opus 占用小任务成本、Conversation 类占比过高、未显示 MCP 使用），但这些只是提示性解读，并非诊断结论。安装可用 setup.sh 或 npm；用 codeburn --version 验证，升级用 npm install -g codeburn@latest。其他平台支持范围、具体价格与更多限制暂未提供。