AI Token Meter + Task Bar：macOS 上的 Codex 与 Claude Code 用量监控工具

两个免费、开源、原生的 macOS 状态栏工具，面向 OpenAI Codex / Codex CLI 和 Anthropic Claude Code 工作流。AI Token Meter 是 Codex 与 Claude Code 的 token 用量、5 小时/每周额度、重置时间、缓存命中率和成本追踪器；Task Bar 用来集中查看正在运行、等待回复和已完成未读的 AI 编程任务。

中文详细说明 · 普通用户安装教程 · English · 下载最新版

• AI Token Meter：查看 Codex / Claude Code 的本地 token 用量、缓存命中率、实时剩余额度、模型统计、仓库洞察和订阅价值估算。
• Task Bar：把正在运行、等待输入、已完成但未读的 Codex / Claude Code 任务，以及 Claude Desktop Home 最近对话集中到一个轻量状态栏列表里，方便快速回到任务。

两者都只读取本机数据，不上传会话日志。

适合正在搜索 Codex token usage tracker、Claude Code usage monitor、Codex quota meter、Claude Code token counter、AI coding agent task monitor 或 macOS menu bar token tracker 的用户。

下载

最新版 GitHub Release 会同时提供两个 DMG：

如果只安装 AI Token Meter，就只会得到 token / 额度面板；Task Bar 是独立状态栏 app，需要下载并安装 Task-Bar-*.dmg。

普通用户请查看 DMG 拖拽安装、首次启动、macOS 安全拦截、权限与安装验证完整教程。两个应用安装后都显示在屏幕顶部菜单栏，不会出现在 Dock 中。

截图与交互

详情页截图使用内置的 --redact 渲染模式生成，仓库名和目录均替换为演示数据。

Task Bar 总览

Task Bar 把 Codex、Claude Code 和 Claude Desktop Home 最近对话合在一个小面板里，支持 All / Running / Waiting / Done 筛选。行内会显示任务状态、来源、标题、最近摘要和未读/等待状态，适合在多个 Codex 线程和 Claude 会话之间快速切换。Home 对话只使用本地缓存的更新时间显示为最近/未读，不会推断运行状态。

Task Bar Hover

任务行 hover 会显示该任务的可解释 token 摘要：状态、输入、输出、缓存率、对话轮次、压缩次数和模型。只有日志里能拆出来的字段才会展示；如果来源只提供总量，不会伪造输入/输出拆分。

AI Token Meter 总览

AI Token Meter 的状态栏面板支持 全部 / Codex / Claude / API 和 24h / 7d / 30d 切换。顶部显示当前窗口总 token，环形图显示订阅剩余额度，表格对比 Codex、Claude 与 API 的输入输出和状态，底部汇总会话/轮次/事件数与 API 成本。

API 来源表示所有非订阅、按量计费的使用。Token Meter 优先读取 rollout 的 model_provider，并识别 OpenRouter 风格的 厂商/模型 ID，因此 DeepSeek、OpenRouter 和其他自定义 provider 都会从 Codex 订阅统计中移出，避免重复。模型价格每天从 OpenRouter 公共 Models API 更新并只缓存模型 ID 与价格。可选的 ~/Library/Application Support/Codex Token Meter/api-usage.json（可在 externalAPICostPath 偏好中改路径）用于补充 Codex 之外的直接 API 调用；要获得准确的时间窗口和模型成本，建议在 by_day 中同时提供每日 usage 与 models。Token Meter 不读取或保存 API Key，也不会上传请求内容。

AI Token Meter Hover

日历柱状图 hover 会显示单日拆分：Codex、Claude、输入、输出、缓存、新输入、占月额度、当日订阅价值估算和 API 等价成本。Profile API 可用时，30 天窗口会优先展示 Profile API 聚合总量；本地日志仍用于补充日历、模型和成本拆分。

详情窗口 · 概览

过去 365 天按来源（全部 / Codex / Claude / API）和模型统计的总量、输入/输出拆分、缓存命中率、API 成本，以及全年活动热力图。

详情窗口 · 仓库洞察

Repo 会话体检：按项目和文件夹定位长会话，统计会话长度分布、上下文压缩分布和活跃天数强度，并给出「新 bug 单独窗口」这类拆分建议。支持 使用习惯 / 使用时间 两种视角和 7 / 30 / 90 天 窗口。

详情窗口 · 活动日历

点击某一天查看单日明细：输入/输出/缓存拆分、Codex 与 Claude 占比圆环、当日订阅价值和逐模型 API 等价成本；点击格子上方的圆点可看整周汇总。

详情窗口 · 模型

按模型聚合的长期 token 用量、占比条、会话/事件数和逐模型 API 等价成本。

详情窗口 · 空间

按来源、项目和类型追踪本地日志磁盘占用：来源分布、最大项目排行、近 14 天增长曲线和清理风险构成，每一类都标注「可安全清理 / 需确认 / 不建议清理」，并支持导出报告和在访达中打开。

详情窗口 · 设置

界面语言、数字单位、日志目录、状态栏显示与来源、额度样式（圆环/子弹图）、首页圆环口径（5 小时/周额度）、开机启动、额度提醒和 Profile API 总量等都可配置。

当前版本

数据来源

AI Token Meter 读取：

~/.codex/sessions/**/rollout-*.jsonl
~/.codex/archived_sessions/rollout-*.jsonl
$CODEX_HOME/sessions/**/rollout-*.jsonl
$CODEX_HOME/archived_sessions/rollout-*.jsonl
设置中添加的额外 Codex rollout 目录
~/.claude/projects/**/*.jsonl
~/Library/Application Support/Codex Token Meter/

Task Bar 读取：

~/.codex/logs_2.sqlite
~/.codex/state_5.sqlite
~/.codex/sessions/**/rollout-*.jsonl
~/.codex-api/logs_2.sqlite
~/.codex-api/state_5.sqlite
~/.codex-api/sessions/**/rollout-*.jsonl
设置中添加的额外 Codex 文件夹下的 logs_2.sqlite / state_5.sqlite / sessions / archived_sessions
~/.claude/projects/**/*.jsonl
~/Library/Application Support/Claude/IndexedDB/https_claude.ai_0.indexeddb.blob

实时额度通过现有本机 ChatGPT 登录直接只读请求正常的 Codex 用量接口，不会启动 codex app-server；成功时仍按 15 秒刷新并缓存，失败后按 1、5、15 分钟退避。Codex 服务状态 chip 会只读请求 https://status.openai.com/api/v2/summary.json。

功能概览

AI Token Meter

• 额度视图：支持 All / Codex / Claude / API 来源筛选，以及 24h / 7d / 30d 时间窗口。
• 剩余额度：读取 Codex live rate limits 和 Claude statusline，可显示 5 小时、周/月剩余额度与重置时间。
• token 明细：汇总 input、output、cached input、fresh input、total、cache hit rate、会话数和轮次。
• 详情窗口：概览、日历、仓库洞察、思考分析、模型、成本、空间和诊断均支持 API 来源。
• 仓库洞察：按项目定位长会话和上下文压缩压力，附会话长度/压缩分布和拆分建议。
• API 成本：使用 OpenRouter 公共模型目录和内置官方价格回退估算按量费用；未知模型保持未定价并降低价格覆盖率，不会默认套用其他模型价格。
• 空间管理：追踪 Codex / Claude 本地日志磁盘占用、近 14 天增长和清理风险构成，可导出报告。
• 截图渲染：--render-dashboard / --render-details 命令行渲染任意页面，--redact 把仓库名和目录替换为演示数据。
• 启动体验：状态栏和详情窗口会先显示上次完整聚合结果，再后台刷新本机日志。
• 多语言：支持 English、简体中文、繁体中文、日本語、Français、Deutsch、Español、한국어。

Task Bar

• 任务收件箱：在状态栏显示需要关注的任务数量，减少在多个窗口里找线程。
• 状态分组：按 All / Running / Waiting / Done 过滤，区分运行中、等待输入、已完成未读和长时间运行。
• 多来源合并：读取 Codex 本地状态、Codex rollout logs、Claude Code JSONL，并尽量合并同一任务的状态。
• 行内摘要：展示来源、标题、最近输出摘要、运行时间和未读状态。
• hover 详情：能显示 token、缓存率、轮次、压缩次数和模型，字段以本机日志实际可解释的数据为准。
• 快速清理：任意状态的任务悬停时可点按垃圾桶移除，也支持滑动移除；仅从 Task Bar 本地列表隐藏，不会删除原对话或日志。后续有新活动时会重新显示。
• 视觉一致性：使用和 AI Token Meter 接近的深色 AppKit 样式、紧凑行距、状态色和 hover card。

构建

要求：

• macOS 13 或更新版本
• Xcode Command Line Tools
• swiftc

构建 AI Token Meter：

./build.sh

构建 Task Bar：

./build_petbar.sh

从源码安装（开发者）

普通用户不需要运行下面的命令，请直接使用 DMG 安装教程。

从源码构建、安装并启动 AI Token Meter：

./install.sh

从源码构建、安装并启动 Task Bar：

./install_petbar.sh

打包 DMG

打包 AI Token Meter：

./package_dmg.sh

输出：

dist/AI-Token-Meter-0.2.19.dmg

打包 Task Bar：

./package_petbar_dmg.sh

输出：

dist/Task-Bar-0.1.20.dmg

命令行检查

AI Token Meter：

"./build/AI Token Meter.app/Contents/MacOS/CodexTokenMeter" --print --window=week --quota=all
"./build/AI Token Meter.app/Contents/MacOS/CodexTokenMeter" --print-live
"./build/AI Token Meter.app/Contents/MacOS/CodexTokenMeter" --print-service-status

Task Bar：

"./build/Task Bar.app/Contents/MacOS/TaskBar" --print

渲染 README 截图（--redact 会把仓库名和本机目录替换为演示数据，-appLanguage / -numberUnitStyle 可临时指定语言，不会改动应用设置）。渲染输出 PNG，入库前用 cwebp 压缩成 WebP：

"./build/AI Token Meter.app/Contents/MacOS/CodexTokenMeter" -appLanguage zh -numberUnitStyle chinese --render-dashboard=/tmp/ai-token-meter-release.png
"./build/AI Token Meter.app/Contents/MacOS/CodexTokenMeter" -appLanguage zh -numberUnitStyle chinese --render-details=/tmp/zh-details-insights.png --section=insights --redact
"./build/Task Bar.app/Contents/MacOS/TaskBar" --render-taskbar=/tmp/task-bar-release.png
cwebp -q 90 /tmp/zh-details-insights.png -o docs/images/zh-details-insights.webp

隐私

这个仓库不包含你的 Codex 日志、Claude Code 日志、token 数据、构建产物或 DMG。应用运行时只在本机读取日志和缓存；不会上传会话内容。为了兼容旧版本，AI Token Meter 继续使用 ~/Library/Application Support/Codex Token Meter/ 保存本地设置和派生缓存。