codexU

codexU 是一个使用 Swift 构建的 macOS 菜单栏与桌面应用，用来查看 OpenAI Codex / ChatGPT Codex 和 Claude Code 的额度窗口、token 用量、今日任务和本机 AI 领导力。它把常用信息放在菜单栏和主窗口里，帮助你快速判断剩余额度、重置时间、当天工作进展，以及一个人正在调动多少 AI 劳动力。

项目另提供基于 Tauri + Rust 的 Windows 适配版，覆盖 macOS 版中 Codex 相关功能的子集。下文功能与操作说明以 macOS 版为主。

全网首推：AI 领导力评估模型

• 一眼看懂 AI 组织规模：主视觉同时展示领导力得分、28 天领导 Agent 数、AI 工时和峰值并发；轨道节点随今日 Agent 动态运行。
• 不是靠 token 刷分：只使用本机可验证或可推导的 Agent 生命周期、父子关系、并发与自主运行证据；不可靠的成本、交付和估算区间不进入得分。
• Codex + Claude Code 合并评估：AI 领导力衡量的是你调动的完整 AI 劳动力，不按 Runtime 拆分，也不把跨项目峰值简单相加。
• 从“碳基牛马”到“人类最强者”：七级徽章、固定 0–100 等级进度与指挥半径动效，让得分既可解释，也有鲜明的个人成长标识。
• 本地优先、隐私优先：评分全程在 Mac 本机完成，不上传 usage、线程、路径、日志或账户数据。

产品官网 · 下载最新版本 · English

界面截图

适合谁

• 经常使用 OpenAI Codex、Codex CLI 或 Codex 桌面应用的开发者。
• 同时使用 Codex 和 Claude Code 做开发，希望在一个入口查看两边本机用量的人。
• 需要快速查看 5 小时/7 天额度、token 用量和重置时间的 ChatGPT Pro / Team 用户。
• 想在桌面查看 Codex 使用状态、减少反复打开浏览器或终端的人。

功能

• 提供默认、青花瓷、故宫红、千里江山、敦煌飞天和兰亭晨曦六套受控配色，可在独立 Liquid Glass 配色图库中即时预览和切换；社区配色通过仓库审核、许可证检查和 CI 渲染验证后随应用内置，不支持用户侧任意安装。
• 展示 Codex 5 小时和 7 天额度的剩余比例、已用比例和重置时间；按协议返回的实际窗口时长识别额度类型，并根据可信响应自适应单环/双环、单进度条/双进度条布局。
• Codex 返回可用额度重置次数时，在主界面额度环下方固定展示总数和最早到期的两条明细；其余信息可悬停查看与用量趋势同款的完整 tip。若服务端只返回总数，会明确提示部分到期时间未提供。字段缺失、次数为 0 或 Claude Code 不支持时不显示。
• 新增状态栏 Runtime 菜单：点击菜单栏图标后先展示 Codex / Claude Code 卡片、5 小时和 7 日剩余、今日 token 与总 token。
• 状态栏支持简约、经典、丰富三档透明显示：简约保留加粗额度环，经典在独立进度环内显示额度数字，丰富展示完整标签、进度条和重置时间；只有一个有效额度窗口时会自动收敛为单额度布局。
• 环形额度保留完整粒子效果；默认只在主窗口可见、置前且聚焦时渲染，省电模式只在鼠标悬停额度环时渲染，后台、低电量、温控或“减少动态效果”状态下自动停用。
• 状态栏额度可切换“已用量 / 剩余量”口径，并可选择显示 5 小时、7 天或月额度、今日 token 和重置倒计时；5h/7d/月 进度色与主界面蓝紫双环一致。Team 账号的月额度窗口（如 43800 分钟）会正确归类并显示，不再提示未识别。
• 状态栏用进度方向区分口径：已用为顺时针/左到右，剩余为逆时针/右到左，不额外占用文字空间。
• 状态栏 Runtime 使用从原始 Logo 精确派生的单色模板，文字与图标按菜单栏实际深浅自动切换黑白；彩色品牌图标继续用于主窗口和浮窗。
• 今日总 token 在状态栏中只显示垂直居中的总量数字，不增加 T 标签。
• 今日总量使用系统菜单栏正文尺寸；5h/7d 标签与重置时间使用更易读、仍弱于主数值的动态辅助前景色。
• 主界面顶部新增 Codex | Claude Code 全局开关，可手动切换所有面板的数据范围。
• 支持 Claude Code 本机 transcript 用量统计、最近 7 日趋势、项目排行、工具/Skill TOP 和任务看板基础能力。
• 汇总今日、近 7 天和累计 token 用量，并细分未缓存输入、命中缓存输入和输出。
• 展示本月用量的 API 等效价值估算与进度。
• 在顶部概览最左侧用“等级徽章 + 指挥半径轨道”展示滚动 28 天 AI 领导力：徽章固定在圆心，得分、近 28 天领导 Agent、近 28 天 AI 工时和峰值并发使用 2×2 指标矩阵；轨道节点仍按今日 Agent 动态变化。双环紧随其右并保持原尺寸，左上角明确标注“用量”。
• 下方仪表盘支持今日任务、AI 领导力、用量趋势、项目排行和 Skill 使用视图。AI 领导力始终评估 Codex 与 Claude Code 的合计表现；详情顶部用完整徽章路径展示全部等级节点，分值直接标在进度条上，再以四个核心指标、四维能力、每日 AI 工时/Agent/峰值组合趋势和项目贡献解释得分。
• 今日任务按事实源自适应组织：Codex 使用“最近活跃、待继续、定时、今日归档”，Claude Code 使用本机 task 的“进行中、待处理、计划中、已完成”；近期活动与归档都不会被包装成仍在执行或成功完成。
• Codex 今日任务顶部按“模型 × 推理强度”展示本机实测散点图，并可在右上角切换今日（默认）、7 日均和 28 日均。横轴为所选窗口内完整调用耗时 P50、横线延伸到 P90，横轴上限为所有组合最大 P90 的 1.4 倍；纵轴为输出 tokens 除以完整调用耗时。今日气泡大小代表模型调用数，7/28 日气泡使用记录覆盖期内的日均调用数，避免周期长度放大气泡；它们都不是 Session、线程或工具调用数。样本会持久化到本机 Application Support，并从最近 28 天 rollout 回填，不记录 prompt、回复或路径。悬停气泡可查看总调用数、日均调用数、平均/P50/P90、有效吞吐、吞吐计算口径，以及 reasoning tokens 在全部输出中的数量和占比。该指标用于持续比较客观体感，不冒充 TTFT 或可见文本解码 TPS。
• 任务卡片优先展示标题、工作区、事实时间和可信状态；可确定时显示 automation 下次运行时间，只有存在有效 Session Deep Link 的卡片才提供整卡点击、hover、手型和键盘焦点反馈。
• Codex 用量趋势展示最近半年的每日 token 热力图和模型活动概览，概览包含当前范围内的用量最高模型、活跃日期数、活跃模型数和范围日均用量；Claude Code 暂不支持模型归因，保留原有近 7 日摘要。
• 在 Codex 用量趋势下方展示按模型分色的时间序列面积图，默认显示最近 30 天，可切换最近 60/90/180 天；图中同时显示总用量虚线、近 7 日总量、日均和较前 7 日变化。默认显示 Top 8 模型并将其余模型合并为“其他模型”。纵轴可切换 Token 或 API 等效估算费用；模型没有独立价格时明确显示为按 GPT-5.5 价格折算的参考费用。粗略线程口径没有费用拆分时，费用模式会明确标记为不可用。
• 展示最近 7 天与全部项目排行，包含 token、估算价值、线程数和最近活跃时间。
• 展示工具调用 TOP 列表和 Skill 使用 TOP 列表，帮助判断本地 Codex 工作结构。
• 以标准 macOS 窗口运行，主窗口默认保持紧凑布局，也可在 820–1280pt 范围内调整宽度；增加宽度不会改变卡片顺序和信息结构，并会恢复上次窗口尺寸。支持 Dock、系统窗口控制、最小化和关闭主窗口后继续后台运行，关闭主窗口会隐藏 Dock 图标并保留菜单栏图标。
• 默认使用 Command + U 显示或隐藏主窗口，并可在设置中自定义；菜单栏 Runtime 菜单也可以快速打开主窗口、设置或退出。
• 设置窗口支持中文/英文界面、自动/浅色/深色外观、状态栏内容与实时预览、主窗口置顶、关闭行为、系统状态和更新检查配置。
• 默认自动检查 GitHub Release 新版本并接收 beta 版本，发现新版时提供匹配当前 Mac 架构的 DMG 下载入口；不会静默下载安装，自动检查可关闭。
• 本地读取数据，不上传 usage、线程或账户数据到第三方服务。

快捷键和操作

• Command + U：默认用于显示或隐藏主窗口，可在设置中自定义；如果窗口已最小化，会恢复并唤到前台。
• 自定义组合至少需要两个修饰键，并包含 Command 或 Control；已知的高风险系统快捷键和辅助功能快捷键不可使用。
• 录制快捷键时按退格键可清空、按 Esc 可取消；之后可恢复默认值或重新录制。
• 应用会检测其他应用的独占快捷键注册冲突；macOS 不提供非独占注册的完整查询能力，如仍与其他应用冲突，请改用其他组合。
• 菜单栏仪表图标：点击后打开 Runtime 菜单；点击 Codex 或 Claude Code 卡片会打开主界面并切到对应 Runtime。
• 菜单栏 Runtime 菜单：展示 Codex / Claude Code 快速状态，并提供打开主窗口、打开设置和退出。
• 设置窗口：配置语言、外观、状态栏展示模式/额度口径/可见指标、主窗口置顶及关闭行为，并在系统区控制自动检查、查看状态或手动检查 GitHub Release 更新。
• 主窗口顶部刷新按钮：立即刷新额度、token 统计、趋势图和任务看板。
• 系统红黄绿窗口按钮：关闭、最小化或缩放主窗口；关闭后可通过菜单栏图标或快捷键唤回，退出请使用菜单栏 Runtime 菜单或 App 菜单。

首次安装：隐私与安全

codexU 目前通过 GitHub Release 的 DMG 安装包分发，不经过 Mac App Store。第一次打开时，macOS 可能会拦截，需要手动允许：

1. 打开 codexU.app 一次。如果系统提示无法打开，先取消弹窗。
2. 打开 系统设置 > 隐私与安全性。
3. 在 安全性 区域找到 codexU.app，点击 仍要打开。
4. 使用 Touch ID 或密码确认，然后点击 打开。

也可以在 Finder 中右键点击 codexU.app，选择 打开，再确认系统安全提示。

codexU 需要读取本机 ~/.codex/ 下的 Codex 数据；如果启用 Claude Code 统计，还会读取 ~/.claude/ 下的本机 transcript、任务和状态缓存。如果 macOS 弹出文件或文件夹访问授权，请允许访问，否则小组件无法读取本机 usage、线程和自动化任务信息。

安装

macOS

从 GitHub Release 下载与你的 Mac 芯片匹配的安装包：

• Apple Silicon：codexU-<version>-mac-arm64.dmg
• Intel：codexU-<version>-mac-x86_64.dmg

1. 打开 DMG。
2. 将 codexU.app 拖到 Applications 文件夹。
3. 从 Applications 打开 codexU。
4. 按上面的 首次安装：隐私与安全 步骤完成手动放行。

安装后，codexU 默认每天最多自动检查一次 GitHub Release 是否有新版本，并接收 beta 版本。该检查只读取公开 Release 元数据；发现新版时会打开浏览器下载 DMG 或查看 Release 页面，安装仍由你手动完成。可以在设置窗口的系统区关闭自动检查，或手动点击“检查更新”。

Windows

从 v1.4.0 Release 下载 Windows x86_64 安装包：

• MSI：codexU-<version>-windows-x86_64.msi
• NSIS：codexU-<version>-windows-x86_64-setup.exe

两种安装包任选其一，双击后按向导完成安装。安装前请先在本机安装并使用 Codex，以便生成用量数据。

当前 Windows 安装包未进行代码签名，首次运行时可能出现系统安全提示。每个安装包都提供对应的 .sha256 校验文件；校验方式见 DISTRIBUTION.md。

适配范围与贡献入口见 Windows 说明。

运行要求

macOS

• macOS 13 或更新版本。
• 本机已安装 Codex。
• 已登录 Codex 账户，额度信息才会显示。
• Codex 至少使用过一次，以便生成 ~/.codex/state_5.sqlite。
• Claude Code 统计为可选能力；历史 token 来自 ~/.claude/projects/**/*.jsonl，额度需要本地 statusLine snapshot cache。
• 从源码构建时需要 Xcode Command Line Tools。

Windows

• Windows 10/11（x86_64）；已在 Windows 11 验证，Windows 10 尚未实机验证。
• 本机已安装 Codex，并且已经生成 %USERPROFILE%\.codex\ 下的本机数据。
• Windows 版本当前只支持 Codex；Windows ARM64 当前不在发布范围内。

从源码构建

make build

运行：

make run

安装到 /Applications：

make install

检查本机数据源输出：

make probe

打包 DMG

make release

make release 会按当前构建机器的架构输出安装包。也可以显式打包指定架构：

make release-arm64
make release-intel
make release-all

产物会写入 dist/，例如：

dist/codexU-1.4.0-mac-arm64.dmg
dist/codexU-1.4.0-mac-arm64.dmg.sha256
dist/codexU-1.4.0-mac-x86_64.dmg
dist/codexU-1.4.0-mac-x86_64.dmg.sha256

Developer ID 签名和 Apple notarization 流程见 DISTRIBUTION.md。

数据来源

• 可执行程序：按应用标识定位 ChatGPT/Codex，兼容新版内嵌 codex-cli/CodexCLI.app、codex-cli/bin/codex、旧版内嵌程序和常规 CLI 安装路径。macOS 保留这些路径的既有选择顺序，仅在它们都不可用时补查 ~/.local/bin/codex。
• 账户与额度：codex app-server 的 account/read、account/rateLimits/read、account/usage/read。
• 本机 token 总量：~/.codex/state_5.sqlite。
• 精细 token 拆分：~/.codex/sessions/**/rollout-*.jsonl 和 ~/.codex/archived_sessions/*.jsonl 中的 token_count 事件。
• 今日任务看板：本机 SQLite 中未归档和今日归档的 Codex 线程；两小时活动窗口只表达“最近活跃”，归档只表达记录归档，不代表运行或成功。
• 实测推理表现：从最近 28 天本机 Codex rollout 中识别带 model、reasoning_effort 和增量输出 token 的完整模型调用，排除低于 100ms 的时间戳噪声后，按模型与推理强度聚合今日、7 日、28 日的 P50、P90、平均调用耗时和有效吞吐。去重样本有界保存在 ~/Library/Application Support/codexU/inference-performance-v1.json，即使原 rollout 后续移出线程列表也可继续进入滚动窗口；不保存 prompt、回复或路径，也不把该口径标为 TTFT 或可见文本解码 TPS。
• 用量趋势和项目排行：本机 session token_count 事件聚合；模型曲线优先按同一 session 中、位于 token 事件之前最近的 turn_context.model 归因。该 turn context 未记录模型时不会沿用上一轮，而是回退到线程模型。缺失精细事件时，日归因整体回退到线程更新时间的粗略口径；模型面积图在 Codex runtime 中按 Top 8 + 其他模型展示，并叠加全局总用量虚线，费用口径始终是本地 API 等效估算。Claude Code 暂不提供模型归因或模型面积图。
• 工具和 Skill 使用：本机 session 事件中的工具调用与 Skill 加载记录。
• 定时任务：~/.codex/automations/**/automation.toml 中启用的 automation 元数据；周期、时区和时间足够明确时在本机计算下次运行，规则不完整时不猜测。
• AI 领导力：Codex 只读取本机线程关系与 task_started / task_complete 结构事件；Claude Code 只读取 turn_duration 与 Subagent 生命周期。ScoreModel v1.3 只让事实或可推导区间进入管理半径、劳动力杠杆、编排能力、自主运行四维得分，估算区间不计分；证据可信度独立展示，不乘入得分。
• Claude Code 历史 token：~/.claude/projects/**/*.jsonl 中 assistant message 的 message.usage 字段。
• Claude Code 工具、Skill 和任务：transcript 中的 tool_use.name / 显式 Skill attribution，以及 ~/.claude/tasks/**/*.json；Skill 路径缺失时按 Claude Code 的个人、项目、嵌套、插件和旧版 command 路径在当前文件系统中回退推断，无法确认时显示“当前未定位”。
• Claude Code active 额度：可选读取 ~/Library/Caches/codexU/claude-code/statusline-snapshot.json；缺失时 5 小时/7 日额度显示为 --。
• 更新检测：默认访问 GitHub Releases API，读取 shanggqm/codexU 的公开 release 元数据，并把检查结果缓存到 ~/Library/Caches/codexU/update-check.json。

当前 Codex 额度 API 暴露的是滚动窗口百分比和重置时间，不暴露绝对配额数量；Claude Code 首版只读取本地历史记录和可选 active snapshot，不代表 Claude.ai 官方账单。更完整的数据口径和回退策略见 RESEARCH.md。

常见问题

codexU 是官方 OpenAI 产品吗？

不是。codexU 是一个非官方的本地 macOS 工具，用于读取本机 Codex app-server 和本机 ~/.codex/ 数据。

codexU 会上传我的 Codex 线程或 usage 数据吗？

不会。codexU 只在本机读取 Codex 账户额度、本机 SQLite usage 和 automation 元数据，不把这些数据上传到第三方服务。自动更新检测只请求 GitHub Release 的公开版本元数据，不携带本机 usage、线程、路径、日志或账户数据。

为什么显示的是剩余百分比，而不是绝对额度？

当前 Codex 本地 API 暴露的是滚动窗口已用百分比和重置时间，不暴露绝对额度数量，所以 codexU 展示的是 5 小时和 7 天窗口的剩余百分比。

为什么打开后部分统计仍在补全？

首页会先恢复同一统计日、时区和数据来源的本地摘要，额度、任务分别刷新；“上次结果”表示缓存值。完整历史仍在后台整理，缓存摘要不包含完整图表明细。历史读取现使用本地 SQLite 增量索引：首次后台整理，后续从检查点处理追加内容，按统计日保存可修订的归档。完整清单尚未覆盖、文件暂时不可读或记录超出可处理边界时，会保留上次结果并标记补全中，不把缺失伪造成 0。过期且未发布的中间报告会分批回收，保留当前发布结果和使用中的版本；缓存满、索引占用或读取失败会显示具体状态。窗口 5 秒目标仍需在可操作的真实桌面环境逐项验收，不能用后台或模型计时代替。

支持 Intel Mac 吗？

支持。Intel Mac 下载 codexU-<version>-mac-x86_64.dmg。从源码打包时使用 make release-intel，或在支持对应 target 的机器上使用 TARGET_TRIPLE="x86_64-apple-macos13.0"。

License

MIT