CodexBar 使用统计导出：2 种方式把数据存成 JSON，附 CLI 自动化脚本

CodexBar 使用统计导出：2 种方式把数据存成 JSON，附 CLI 自动化脚本

【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar

如果你想知道 CodexBar 记录的那些 token 和花费数据能不能带出应用、离线分析，本文直接给答案：能。通过"用量与支出"面板的 Export JSON 按钮，或者终端里的codexbar dashboard命令，你可以把 CodexBar 使用统计导出成 JSON 文件，再丢进 Excel、脚本或自己的报表里。全程不需要登录任何账号，数据都来自本地已抓取的内容。

最快路径：设置面板里点两下拿到 JSON

打开 CodexBar，进入 设置 → 用量与支出（Settings → Usage & Spend）。这个页面汇总了所有启用的支持成本统计的提供商，比如 Codex、Claude，按"7 天 / 30 天 / 全部"分档展示。

这张图展示的是"用量与支出"面板的典型样子：顶部是时间范围切换，下方是按订阅和按模型的明细。确认你选对了时间范围（比如 7 天），页面右上角就有 Copy JSON 和 Export JSON 两个按钮。

• Export JSON：弹出 macOS 保存对话框，默认文件名是codexbar-spend-last-7-days.json（选"全部"则是codexbar-spend-all-time.json），保存完成，文件就落盘了。
• Copy JSON：直接把同样的内容复制到剪贴板，适合粘贴给同事或写进脚本。

这是上一步点 Export JSON 后弹出的保存对话框，可以看到默认文件名已经按所选范围（7 天）生成好了，直接选目录点 Save 即可。相关实现见 SpendDashboardJSONExporter。

注意一个细节：导出的按钮在数据为空时是灰的。如果面板显示"无数据"，先点右上角"刷新"，等本地扫描跑完再导出（排错提示见下文）。

文件里有什么：先认识 JSON 再谈 CSV

导出的文件是美化排版过的 JSON（缩进 + 键排序 + ISO8601 日期），顶层按groups[]组织：每个订阅一组，组内包含 token 总量、tokenMix（输入/缓存/输出构成）、provenance（数据来源）和coverage（成本覆盖率），时间范围以requestedDays标识。

想转成 CSV 给 Excel 用？最省事的是用脚本把daily明细拍平成表格：

python3 -c "import json,sys,csv;d=json.load(open('codexbar-spend-last-30-days.json'));[print(r) for r in d['groups']]"

先用jq '.groups[0] | keys' codexbar-spend-last-7-days.json看一眼实际字段名，再按需拼列，比死记字段可靠。如果你要的是模型维度的完整 CSV，CodexBar 内部已有专门的 CSV 导出器（CodexModelsCSVExporter，32 列，含 token 分项和成本状态），但主界面的常规导出走的是 JSON 这条路，脚本转换更通用。

脚本党路线：用 codexbar dashboard 在终端导出

不想点界面？CLI 可以。先在 设置 → 高级 里点 Install CLI（把CodexBarCLI软链到/usr/local/bin/codexbar），或者手动：

ln -sf "/Applications/CodexBar.app/Contents/Helpers/CodexBarCLI" /usr/local/bin/codexbar

然后一行命令拿到仪表板快照并落盘：

codexbar dashboard > spend-snapshot.json

dashboard输出的是 dashboard-v1 格式的单份 JSON，包含各提供商的用量窗口和错误状态，适合直接进 jq。两个排错提示：

• 别拿它和 Export JSON 混用：CLI 的 JSON 把tokenMix、provenance、coverage放在各提供商自己的totals下，而界面导出把它们嵌在groups[]里（详见 docs/cli.md）。解析脚本要分清两者。
• usage命令也能出 JSON（codexbar usage --format json），但它是"每次查询即取"的快照，字段结构与上面两个又不一样，建议固定用dashboard做存档。

常见卡点：导出按钮是灰的、文件打不开、想定时导

1. 按钮置灰 / 无数据：面板里的数字来自本地会话扫描和缓存，不是实时拉取。点刷新等它跑完；Codex 账号刚切换过时要等补算完成。持续无数据就检查对应提供商在 设置 → 提供商 里是否启用。
2. Excel 打开乱码：用 VS Code 打开 JSON 确认内容正常后，用"另存为 → UTF-8 编码"再打开；或直接转成 CSV 再进 Excel。
3. 想每天自动导一份：crontab 加一行即可，注意%要转义：

0 2 * * * /usr/local/bin/codexbar dashboard >> ~/CodexBar/spend_$(date +\%Y\%m\%d).json

4. 文件太大：jq '.groups[] | select(.id == "codex")' spend-snapshot.json先筛出关心的订阅再处理。

下一步：让导出数据真正用起来

• 导出一份codexbar-spend-last-30-days.json，用jq数一遍你上周最烧钱的模型。
• 用codexbar dashboard > file.json把导出接进你自己的周报表脚本。
• 配好上面的 crontab，攒一周数据后对比每日成本曲线。
• 数据对不上时，先看provenance和coverage两个字段——它们直接告诉你哪些数字是精确值、哪些是估算。

CodexBar 的数据源和 CLI 行为细节可参考仓库内 docs/codex.md 与 docs/cli.md，遇到导出内容疑问时对着字段名查文档最快。

【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar