一键把 CodexBar 用量数据导出成 JSON 与 CSV
【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar
月底要交成本报告，用量却散落在 Codex 和 Claude 两个后台里，手动截图拼表能熬掉一晚上。CodexBar 把这两家的用量统计收进同一个菜单栏，也支持把数据导出成 JSON，再顺手转成 CSV 喂给表格软件。下面直接给你一条最短路径。
先跑通：5 步拿到第一份数据
不用读源码，先把数据落盘，顺序如下：
- 打开终端，确认
codexbar可用 - 执行导出命令，生成 JSON 文件
- 用文本编辑器打开，确认字段齐全
- 用
jq把需要的列转成 CSV - 拖进 Excel 或 Google Sheets 验证
导出命令只有一行：
codexbar usage --format json --pretty > usage_data.json建议先jq 'keys' usage_data.json看一眼顶层结构，再写转换表达式。数据到手后，后面几节再聊它从哪来、怎么扩展。
数据是从哪来的？
说白了，CodexBar 里有一个统一的数据中枢 UsageStore.swift，各家的用量快照都由它抓取、缓存并推送给界面。你在终端看到的 JSON，本质就是这份快照的序列化结果。
命令行侧由 CLIUsageCommand.swift 负责渲染：同一个快照可以输出为 text、json 或 toon 三种格式，--provider all能一次拉取所有已启用的服务。所以不存在"界面一套数、命令行另一套数"的问题，两边读的是同一份缓存。
换个姿势：原始 JSON 怎么抓
如果 CLI 的快照粒度不够，想拿接口返回的原始报文，可以走 App 内置的调试日志。打开 CodexBar 设置里的 Debug 面板，选中目标 provider 后点 Debug Log，输出里会有一段以Raw API Response:开头的内容，那就是未经裁剪的原始 JSON。
这段内容来自 UsageStore 的调试日志逻辑：快照里若带有rawJSON字段，就会原样追加到日志末尾。你把它复制出来存成.json文件即可，适合做字段比对或留档。
三个场景，三种用法
个人复盘：把月度 JSON 转成 CSV 后，在表格里做两张图就够用——一张按天的折线图看趋势，一张按 provider 的饼图看占比。注意 CSV 里的数字列先转成数值类型，否则求和会失败。
团队汇报：把导出挂成定时任务，每天凌晨自动追加到共享目录，成员早上打开就是增量数据：
0 2 * * * /Applications/CodexBar.app/Contents/MacOS/CodexBarCLI usage --format json >> ~/CodexBar/usage_$(date +\%Y\%m\%d).json建议按天分文件而不是无限追加，单文件过大后jq解析会明显变慢。
自动化集成：JSON 天生适合喂给脚本。用 Python 读进来后，可以推 Grafana、灌 Notion 数据库，或者触发飞书机器人播报。换句话说，CodexBar 在这里扮演的角色是"数据源"，下游想接什么都行。
绕开这四个高频坑
| 现象 | 原因 | 解法 |
|---|---|---|
| JSON 里夹着彩色乱码 | 输出带 ANSI 颜色码 | 命令加--no-color |
| Excel 打开 CSV 乱码 | 编码或分隔符不识别 | 存成 UTF-8 BOM，或走"数据→从文本导入" |
| 缺了某个 provider | CLI 跟随 App 内开关 | 改用--provider all或在设置里启用 |
| 提示 command not found | 可执行文件不在 PATH | 用完整路径/Applications/CodexBar.app/Contents/MacOS/CodexBarCLI |
下一步做什么
导出只是起点。跑通codexbar usage之后，建议接着试试codexbar cost，它能把本地会话的 token 成本也拉出来——两份数据拼在一起，你的月度报告就齐了。
【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
