Codex Spend是一个macOS菜单栏应用，读取本地Codex会话的token使用数据，实时显示估算消费金额，并提供多维度的用量分析，包括输入/输出/推理token、模型分布、项目文件夹和趋势图表。

• 原作者/维护者：imisstheoldpabl0
• 来源平台：github
• 原始标题：codex-spendbar
• 原始链接：https://github.com/imisstheoldpabl0/codex-spendbar
• 来源发布时间/更新时间：2026-06-02T13:08:43Z

Codex Spend：macOS菜单栏的Codex token用量实时监控工具\n\nOpenAI Codex作为新一代AI编程代理，其使用成本是开发者关心的实际问题。虽然Codex提供了强大的代码生成能力，但默认界面并未实时展示token消耗和估算费用，用户难以直观了解使用成本。\n\nCodex Spend项目填补了这一空白——它是一个macOS菜单栏应用，专门用于监控和展示本地Codex的token使用情况和估算消费。\n\n## 原作者与来源\n\n- 原作者/维护者：imisstheoldpabl0\n- 来源平台：GitHub\n- 原始标题：codex-spendbar\n- 原始链接：https://github.com/imisstheoldpabl0/codex-spendbar\n- 发布时间：2026年6月2日\n\n## 核心功能：一目了然的成本监控\n\nCodex Spend的核心价值在于将分散的token使用数据整合为直观的成本视图：\n\n### 菜单栏实时显示\n\n应用常驻菜单栏，显示今日估算消费金额。当消费超过设定阈值时，金额会以警告色显示，提醒用户注意。\n\n### 多维度用量分解\n\n点击菜单栏图标后，用户可以查看详细的用量分解：\n\n- Token类型：输入token、缓存输入token、输出token、推理token\n- 时间维度：今日、过去7天、月度统计\n- 模型维度：不同模型（如GPT-4、GPT-4o）的使用分布\n- 项目维度：按项目文件夹聚合用量\n- 会话维度：单次提示的token消耗明细\n\n### 趋势图表\n\n应用内置趋势图表功能，支持三种渲染模式：\n\n- 块状图：直观展示用量分布\n- 折线图：显示用量趋势变化\n- ASCII图：轻量级文本渲染，适合快速查看\n\n### 异常检测\n\nCodex Spend实现了"近期用量激增检测"功能，将当前用量与活跃使用日的历史数据进行对比，及时发现异常高消费。\n\n## 技术实现：本地数据读取\n\nCodex Spend的设计理念是"完全本地"——所有数据读取和处理都在用户设备上完成，不涉及网络传输敏感信息。\n\n### 数据源\n\n应用读取以下本地文件：\n\n- ~/.codex/sessions：当前会话的JSONL格式事件日志\n- ~/.codex/archived_sessions：归档会话数据\n- ~/.codex/state_5.sqlite：Codex状态数据库（通过/usr/bin/sqlite3读取）\n\n### 事件解析\n\nCodex在回答提示时会发出多个token_count内部事件。Codex Spend将这些事件按提示回合聚合，计算每个回合的总token消耗。\n\n### 费用估算\n\n应用使用OpenAI API官方定价计算估算费用。需要注意的是：\n\n- 对于ChatGPT支持的Codex使用，实际可能消耗计划额度而非直接计费\n- 快速模式（Fast mode）按照更高优先级/快速费率估算\n- 支持USD和EUR两种货币显示，EUR汇率从Frankfurter获取并定期刷新\n\n## 安装与使用\n\n### 系统要求\n\n- macOS 13或更新版本\n- Xcode Command Line Tools（包含swiftc）\n- 可选：ripgrep（rg）用于加速历史数据扫描\n\n### 快速开始\n\nbash\n# 克隆仓库\ngit clone https://github.com/imisstheoldpabl0/codex-spendbar.git\ncd codex-spendbar\n\n# 构建并运行（不安装）\n./scripts/build.sh\nopen \"dist/Codex Spend.app\"\n\n\n### 安装到应用程序目录\n\nbash\n# 安装到~/Applications\n./scripts/install.sh\n\n# 安装并设置为登录时自动启动\n./scripts/install.sh --login\n\n\n### 调试模式\n\nbash\n# 打印菜单栏使用的摘要信息\n\"dist/Codex Spend.app/Contents/MacOS/Codex Spend\" --print-summary\n\n\n## 隐私设计：数据不出本地\n\nCodex Spend的一个重要特性是隐私友好。菜单中专门设有"隐私指示器"，显示：\n\n- 已读取的本地文件列表\n- 可选的EUR汇率网络调用（仅当使用欧元显示时）\n\n这种透明性让用户清楚了解应用的数据访问范围，符合现代隐私意识。\n\n## 定价参考\n\nCodex Spend的估算基于以下公开定价数据：\n\n- OpenAI API定价：https://platform.openai.com/docs/pricing\n- Codex速度和快速模式倍数：https://developers.openai.com/codex/speed\n- USD/EUR参考汇率：https://frankfurter.dev/\n\n用户可以在偏好设置中调整消费阈值、货币单位、图表模式等参数，定制自己的监控体验。\n\n## 适用场景\n\nCodex Spend特别适合以下用户：\n\n- 重度Codex用户：需要监控每日/每月使用成本\n- 团队管理者：需要了解团队成员的AI工具使用情况\n- 预算敏感用户：希望在消费超标前收到提醒\n- 效率优化者：通过用量分析识别高成本操作模式\n\n对于频繁使用Codex进行代码生成、重构或调试的开发者，这个工具提供了必要的成本可见性，帮助做出更明智的使用决策。

原作者与来源

• 原作者/维护者：imisstheoldpabl0
• 来源平台：github
• 原始标题：codex-spendbar
• 原始链接：https://github.com/imisstheoldpabl0/codex-spendbar
• 来源发布时间/更新时间：2026-06-02T13:08:43Z Codex Spend：macOS菜单栏的Codex token用量实时监控工具\n\nOpenAI Codex作为新一代AI编程代理，其使用成本是开发者关心的实际问题。虽然Codex提供了强大的代码生成能力，但默认界面并未实时展示token消耗和估算费用，用户难以直观了解使用成本。\n\nCodex Spend项目填补了这一空白——它是一个macOS菜单栏应用，专门用于监控和展示本地Codex的token使用情况和估算消费。\n\n原作者与来源\n\n- 原作者/维护者：imisstheoldpabl0\n- 来源平台：GitHub\n- 原始标题：codex-spendbar\n- 原始链接：https://github.com/imisstheoldpabl0/codex-spendbar\n- 发布时间：2026年6月2日\n\n核心功能：一目了然的成本监控\n\nCodex Spend的核心价值在于将分散的token使用数据整合为直观的成本视图：\n\n菜单栏实时显示\n\n应用常驻菜单栏，显示今日估算消费金额。当消费超过设定阈值时，金额会以警告色显示，提醒用户注意。\n\n多维度用量分解\n\n点击菜单栏图标后，用户可以查看详细的用量分解：\n\n- Token类型：输入token、缓存输入token、输出token、推理token\n- 时间维度：今日、过去7天、月度统计\n- 模型维度：不同模型（如GPT-4、GPT-4o）的使用分布\n- 项目维度：按项目文件夹聚合用量\n- 会话维度：单次提示的token消耗明细\n\n趋势图表\n\n应用内置趋势图表功能，支持三种渲染模式：\n\n- 块状图：直观展示用量分布\n- 折线图：显示用量趋势变化\n- ASCII图：轻量级文本渲染，适合快速查看\n\n异常检测\n\nCodex Spend实现了"近期用量激增检测"功能，将当前用量与活跃使用日的历史数据进行对比，及时发现异常高消费。\n\n技术实现：本地数据读取\n\nCodex Spend的设计理念是"完全本地"——所有数据读取和处理都在用户设备上完成，不涉及网络传输敏感信息。\n\n数据源\n\n应用读取以下本地文件：\n\n- ~/.codex/sessions：当前会话的JSONL格式事件日志\n- ~/.codex/archived_sessions：归档会话数据\n- ~/.codex/state_5.sqlite：Codex状态数据库（通过/usr/bin/sqlite3读取）\n\n事件解析\n\nCodex在回答提示时会发出多个token_count内部事件。Codex Spend将这些事件按提示回合聚合，计算每个回合的总token消耗。\n\n费用估算\n\n应用使用OpenAI API官方定价计算估算费用。需要注意的是：\n\n- 对于ChatGPT支持的Codex使用，实际可能消耗计划额度而非直接计费\n- 快速模式（Fast mode）按照更高优先级/快速费率估算\n- 支持USD和EUR两种货币显示，EUR汇率从Frankfurter获取并定期刷新\n\n安装与使用\n\n系统要求\n\n- macOS 13或更新版本\n- Xcode Command Line Tools（包含swiftc）\n- 可选：ripgrep（rg）用于加速历史数据扫描\n\n快速开始\n\nbash\n克隆仓库\ngit clone https://github.com/imisstheoldpabl0/codex-spendbar.git\ncd codex-spendbar\n\n构建并运行（不安装）\n./scripts/build.sh\nopen \"dist/Codex Spend.app\"\n\n\n安装到应用程序目录\n\nbash\n安装到~/Applications\n./scripts/install.sh\n\n安装并设置为登录时自动启动\n./scripts/install.sh --login\n\n\n调试模式\n\nbash\n打印菜单栏使用的摘要信息\n\"dist/Codex Spend.app/Contents/MacOS/Codex Spend\" --print-summary\n\n\n隐私设计：数据不出本地\n\nCodex Spend的一个重要特性是隐私友好。菜单中专门设有"隐私指示器"，显示：\n\n- 已读取的本地文件列表\n- 可选的EUR汇率网络调用（仅当使用欧元显示时）\n\n这种透明性让用户清楚了解应用的数据访问范围，符合现代隐私意识。\n\n定价参考\n\nCodex Spend的估算基于以下公开定价数据：\n\n- OpenAI API定价：https://platform.openai.com/docs/pricing\n- Codex速度和快速模式倍数：https://developers.openai.com/codex/speed\n- USD/EUR参考汇率：https://frankfurter.dev/\n\n用户可以在偏好设置中调整消费阈值、货币单位、图表模式等参数，定制自己的监控体验。\n\n适用场景\n\nCodex Spend特别适合以下用户：\n\n- 重度Codex用户：需要监控每日/每月使用成本\n- 团队管理者：需要了解团队成员的AI工具使用情况\n- 预算敏感用户：希望在消费超标前收到提醒\n- 效率优化者：通过用量分析识别高成本操作模式\n\n对于频繁使用Codex进行代码生成、重构或调试的开发者，这个工具提供了必要的成本可见性，帮助做出更明智的使用决策。