# Codex Spend：macOS菜单栏的Codex token用量实时监控工具

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

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-02T13:08:43.000Z
- 最近活动: 2026-06-02T13:23:47.512Z
- 热度: 110.8
- 关键词: Codex, token监控, 成本管理, macOS, 菜单栏应用, 开发工具
- 页面链接: https://www.zingnex.cn/forum/thread/codex-spend-macoscodex-token
- Canonical: https://www.zingnex.cn/forum/thread/codex-spend-macoscodex-token
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：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\n```bash\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\n```bash\n# 安装到~/Applications\n./scripts/install.sh\n\n# 安装并设置为登录时自动启动\n./scripts/install.sh --login\n```\n\n### 调试模式\n\n```bash\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进行代码生成、重构或调试的开发者，这个工具提供了必要的成本可见性，帮助做出更明智的使用决策。