两个免费、开源、原生的 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：
| App | 安装包 | 安装位置 |
|---|---|---|
| AI Token Meter | AI-Token-Meter-*.dmg |
/Applications/AI Token Meter.app |
| Task Bar | Task-Bar-*.dmg |
/Applications/Task Bar.app |
如果只安装 AI Token Meter，就只会得到 token / 额度面板；Task Bar 是独立状态栏 app，需要下载并安装 Task-Bar-*.dmg。
普通用户请查看 DMG 拖拽安装、首次启动、macOS 安全拦截、权限与安装验证完整教程。两个应用安装后都显示在屏幕顶部菜单栏，不会出现在 Dock 中。
详情页截图使用内置的 --redact 渲染模式生成，仓库名和目录均替换为演示数据。
Task Bar 把 Codex、Claude Code 和 Claude Desktop Home 最近对话合在一个小面板里，支持 All / Running / Waiting / Done 筛选。行内会显示任务状态、来源、标题、最近摘要和未读/等待状态，适合在多个 Codex 线程和 Claude 会话之间快速切换。Home 对话只使用本地缓存的更新时间显示为最近/未读，不会推断运行状态。
任务行 hover 会显示该任务的可解释 token 摘要：状态、输入、输出、缓存率、对话轮次、压缩次数和模型。只有日志里能拆出来的字段才会展示；如果来源只提供总量，不会伪造输入/输出拆分。
AI Token Meter 的状态栏面板支持 全部 / Codex / Claude 和 24h / 7d / 30d 切换。顶部显示当前窗口总 token，环形图显示剩余额度，表格对比 Codex 与 Claude 的 5h 剩余额度、输入输出和服务状态，底部汇总会话/轮次/事件数与 API 等价成本。
日历柱状图 hover 会显示单日拆分：Codex、Claude、输入、输出、缓存、新输入、占月额度、当日订阅价值估算和 API 等价成本。Profile API 可用时，30 天窗口会优先展示 Profile API 聚合总量；本地日志仍用于补充日历、模型和成本拆分。
过去 365 天按来源（全部 / Codex / Claude）和模型统计的总量、输入/输出拆分、缓存命中率、API 等价成本，以及全年活动热力图。
Repo 对话体检：按项目和文件夹定位长线程，统计对话长度分布、上下文压缩分布和活跃天数强度，并给出「新 bug 单独窗口」这类拆线程建议。支持 使用习惯 / 使用时间 两种视角和 7 / 30 / 90 天 窗口。
点击某一天查看单日明细：输入/输出/缓存拆分、Codex 与 Claude 占比圆环、当日订阅价值和逐模型 API 等价成本；点击格子上方的圆点可看整周汇总。
按模型聚合的长期 token 用量、占比条、会话/事件数和逐模型 API 等价成本。
按来源、项目和类型追踪本地日志磁盘占用：来源分布、最大项目排行、近 14 天增长曲线和清理风险构成，每一类都标注「可安全清理 / 需确认 / 不建议清理」，并支持导出报告和在访达中打开。
界面语言、数字单位、日志目录、状态栏显示与来源、额度样式（圆环/子弹图）、首页圆环口径（5 小时/周额度）、开机启动、额度提醒和 Profile API 总量等都可配置。
| App | Version | Build | Bundle |
|---|---|---|---|
| AI Token Meter | 0.2.17 |
31 |
/Applications/AI Token Meter.app |
| Task Bar | 0.1.18 |
19 |
/Applications/Task Bar.app |
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。
- 额度视图：支持
All / Codex / Claude平台筛选，以及24h / 7d / 30d时间窗口。 - 剩余额度：读取 Codex live rate limits 和 Claude statusline，可显示 5 小时、周/月剩余额度与重置时间。
- token 明细：汇总 input、output、cached input、fresh input、total、cache hit rate、会话数和轮次。
- 详情窗口：包含概览、日历、仓库洞察、模型、空间、设置、诊断和关于页面。
- 仓库洞察：按项目定位长线程和上下文压缩压力，附对话长度/压缩分布和拆线程建议。
- API 等价成本：估算同样的本地用量若直接按 API 计价的花费，覆盖首页、日历、模型和概览。
- 空间管理：追踪 Codex / Claude 本地日志磁盘占用、近 14 天增长和清理风险构成，可导出报告。
- 截图渲染：
--render-dashboard/--render-details命令行渲染任意页面，--redact把仓库名和目录替换为演示数据。 - 启动体验：状态栏和详情窗口会先显示上次完整聚合结果，再后台刷新本机日志。
- 多语言：支持 English、简体中文、繁体中文、日本語、Français、Deutsch、Español、한국어。
- 任务收件箱：在状态栏显示需要关注的任务数量，减少在多个窗口里找线程。
- 状态分组：按
All / Running / Waiting / Done过滤，区分运行中、等待输入、已完成未读和长时间运行。 - 多来源合并：读取 Codex 本地状态、Codex rollout logs、Claude Code JSONL，并尽量合并同一任务的状态。
- 行内摘要：展示来源、标题、最近输出摘要、运行时间和未读状态。
- hover 详情：能显示 token、缓存率、轮次、压缩次数和模型，字段以本机日志实际可解释的数据为准。
- 快速清理：支持滑动移除已处理项，并在设置里调整分组顺序和显示偏好。
- 视觉一致性：使用和 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打包 AI Token Meter：
./package_dmg.sh输出：
dist/AI-Token-Meter-0.2.17.dmg
打包 Task Bar：
./package_petbar_dmg.sh输出：
dist/Task-Bar-0.1.18.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-statusTask 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/ 保存本地设置和派生缓存。