codeburn

环境要求

• Node.js 22.13 或更高版本
• 本机至少装有一款受支持工具（如 Claude Code、Cursor、Codex、Gemini 等）并留有会话数据
• 需要联网下载 npm 包（首次运行 npx 时）
• 多设备合并统计时，设备需处于同一局域网

安装与启动步骤

1. 1检查 Node 版本

   先确认本机 Node 版本不低于 22.13，版本过低会导致命令无法运行，需先升级 Node。

   node -v

   复制

2. 2免安装直接运行

   无需安装，直接打开交互式仪表盘；默认显示今天，今天无用量则显示最近 7 天。

   npx codeburn

   复制

3. 3全局安装命令

   想让 codeburn 成为常驻命令时执行全局安装，之后可直接输入 codeburn 使用。

   npm install -g codeburn

   复制

4. 4macOS 快捷安装

   macOS 用户也可以用 Homebrew 安装，效果与 npm 全局安装一致。

   brew install codeburn

   复制

5. 5开启菜单栏应用

   在 macOS 菜单栏常驻显示花费；Windows 用同一条命令安装托盘应用，Linux 需 GNOME 扩展。

   codeburn menubar

   复制

6. 6共享本机用量

   在其他设备上执行，弹出配对窗口并打印 PIN，供主设备配对使用。

   codeburn share --pair

   复制

7. 7主设备配对设备

   在主设备上搜索附近设备并配对，输入 PIN 完成授权，之后可查看合并总额。

   codeburn devices add

   复制

8. 8查看合并总额

   按机器维度查看所有已配对设备的合计用量；不再需要某台设备时用 devices rm 移除。

   codeburn devices

   复制

如何确认成功

执行 npx codeburn 后出现交互式仪表盘即成功；方向键可切换统计周期，按 q 退出。

常见问题

注意事项

• Cursor 与 OpenCode 所依赖的 better-sqlite3 会自动安装，无需手动处理。
• Windows 使用与 macOS 相同的 codeburn menubar 命令安装托盘应用。
• Linux（GNOME）通过 GNOME Shell 扩展在顶部面板显示，需参考 README 的 Linux (GNOME) 一节。
• 首次执行 npx 会临时下载包，网络较慢时请耐心等待。