CodexBar数据导出30秒搞定：快速保存使用统计为JSON/CSV的完整实用指南
【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar
CodexBar数据导出可以把 OpenAI Codex 和 Claude Code 的花费、token 用量存成本地文件。这篇教程带你一步步拿到这份数据：界面上点两个按钮得到 JSON，终端一行命令得到机器可读输出，最后告诉你 JSON 和 CSV 分别该在什么时候用。
什么时候你会需要导出使用统计
菜单栏上的数字看着方便，但三个月后你根本记不住哪个月烧了多少 token。
常见触发场景：月底要给团队交一份 AI 成本小结；你想对比"换模型之后花销降没降"；或者你只是怕换电脑后本地统计记录丢失，想留一份备份。这些情况光靠肉眼截图解决不了——你得把数据变成文件，丢进 Excel、jq 或者你的报告脚本里。
CodexBar 把 Codex 和 Claude Code 的用量都缓存在本地，导出功能就是直接读这份本地数据，不需要你再登录任何账户。
动手前确认这3件事
- 已安装并运行 CodexBar（macOS 菜单栏应用），且至少扫描过一次 Codex 或 Claude 的用量。
- 想要花费数据的话，确认设置里开了成本追踪开关（"Track costs"），否则支出面板是空的，导出按钮也会灰掉。
- 想用终端方式导出，确认
codexbar命令可用，参数细节见 CLI 文档。
如何快速导出：按3个目标走查
📊 目标 A：把支出面板存成 JSON 文件
- 打开 CodexBar 设置，进入 Usage & Spend 面板，这就是应用内数据导出的入口。
- 面板顶部有三个按钮：Copy JSON、Export JSON、Share Stats…，选 Export JSON。
- 系统弹出保存对话框，默认文件名按你选的时间范围自动定好：选 7/30 天会得到
codexbar-spend-last-7-days.json这类名字，选"全部时间"则是codexbar-spend-all-time.json。 - 选位置、点保存，文件以 pretty-print 格式落盘，日期统一为 ISO 8601。
文件里的结构值得看一眼：顶层是requestedDays、selectedDay，然后是groups——按币种分组，每组含totalTokens、totalCost、meteredCost、tokenMix，再往下是providers和models两级明细。也就是说，一个文件里既有汇总也有按模型拆的数据。实现可以看 SpendDashboardJSONExporter。
目标 B：不落地文件，直接复制
同一个面板点 Copy JSON，内容进剪贴板，粘进任意编辑器或聊天窗口即可。适合临时发给同事核对数字。
目标 C：终端拿机器可读的 JSON
打开终端。
运行一行命令：
codexbar usage --format json --pretty需要落盘时在命令末尾加
> 文件名.json重定向即可；想只看数据不带任何说明文字，加--json-only。
补充一个 CSV 路线：如果你要的是"按模型逐行对比花费"，CodexBar 核心库自带模型分析 CSV 导出器，输出 35 列的扁平表格，含tokens、input_tokens、output_tokens、known_cost、cost_coverage、session_references等字段，详见 CodexModelsCSVExporter。列全是平铺的，天生适合做透视表。
JSON 和 CSV 该选哪个
| 格式 | 拿法 | 优点 | 缺点 |
|---|---|---|---|
| JSON（面板导出） | 设置里点 Export JSON | 保留完整层级：币种分组 → provider → model；字段名自解释 | 不能直接拖进 Excel |
| JSON（CLI） | --format json | 一行命令，可重定向、可进 cron | 每次是即时快照，无面板的分组口径 |
| CSV（模型导出器） | 核心库生成 | 35 列扁平结构，Excel/Sheets 秒开，能做透视 | 一行一个模型，没有时间序列层级 |
一句话结论：要进电子表格选 CSV，要交给程序或数据库选面板 JSON，要每天自动跑选 CLI JSON。
常见坑与解决
⚠️ 现象：Export JSON 按钮是灰的，点不动 原因：支出面板当前没有任何分组数据，多半是成本追踪没开或本地还没扫描到用量记录。 解决：在同面板打开 "Track costs" 开关，等一次扫描完成，按钮即恢复。
现象：导出的花费带~前缀，或标注 Partial estimate 原因：部分订阅缺价格信息，数字是按目录价做的估算。面板里也写明了这是 list-price 估算、不是账单。 解决：按估算口径使用，对外汇报时注明"估算值"。
现象：codexbar usage的输出粘进脚本报解析错误 原因：默认是给人看的 text 格式，混着标题和分隔线。 解决：加--format json，需要缩进再加--pretty。
现象：CSV 用 Excel 打开乱码 原因：文件是 UTF-8，直接双击打开时 Excel 猜错了编码。 解决：先让 Excel 走"数据 → 从文本/CSV 导入"并指定 UTF-8，或用文本编辑器另存后再打开。
进阶：自动化与跨工具集成
- 定时导出：给 crontab 加一行即可每天自动留档，例如
0 3 * * * codexbar usage --format json --pretty >> ~/codexbar-usage/$(date +\%m\%d).json。 - 只取你要的字段：面板导出的 JSON 是标准结构，用
jq '.groups[]'之类的过滤就能抽出单个币种分组。 - 一键分享图：面板的 Share Stats… 按钮能把当前统计渲染成卡片图片，适合直接贴群。
- 跨工具：JSON 可以喂给 Notion 数据库、Make 工作流或 Grafana，配合每天定时导出，就能做出持续更新的用量看板。
现在就打开 CodexBar 设置，点一次 Export JSON，30 秒后你手里就有第一份可分析的 AI 使用数据文件。更多参数与配置细节见 CLI 参考和 配置文档。
【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
