codexU

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

codexU v1.3.0 在 AI 领导力模型之外新增本机推理性能监测：从最近 28 天 Codex rollout 中按模型与推理强度聚合完整调用耗时、P50/P90、有效吞吐和 reasoning token 占比。所有数据仍在本机处理，并与既有额度、用量和任务口径保持独立。

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

[!IMPORTANT] 建议升级到 v1.3.0 或更高版本。 v1.3.0 新增本机推理性能监测，可查看模型 × 推理强度的平均耗时、P50、P90 和有效吞吐。下载最新版本。

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

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

界面截图

适合谁

• 经常使用 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 用量，并细分未缓存输入、命中缓存输入和输出。
• 按 OpenAI API token 价格估算本月 API 等效价值，并在 Plus、Pro 100、Pro 200 和满额月价值之间展示进度刻度。
• 在顶部概览最左侧用“等级徽章 + 指挥半径轨道”展示滚动 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、线程或账户数据到第三方服务。

羊毛进度

“羊毛进度”是 codexU 对本月 Codex 使用量的 API 等效价值估算。它把本机解析到的普通输入、cache write、命中缓存输入和输出 token，按对应模型及实际 service tier 的 OpenAI API token 单价折算成美元金额，并和 Plus、Pro 100、Pro 200 以及参考月上限做对比。这个指标解决的问题是：Codex 额度本身通常只显示百分比和重置时间，token 数量也不容易直观看出“用了多少价值”；羊毛进度提供一个统一的金额口径，帮助你判断本月订阅成本大致回收到了哪个区间。

单次 token 用量的估算公式为：

API 等效价值 =
  普通未缓存输入 tokens / 1,000,000 * 模型输入单价
+ cache write tokens / 1,000,000 * 模型 cache write 单价
+ 缓存输入 tokens / 1,000,000 * 模型缓存输入单价
+ 输出 tokens / 1,000,000 * 模型输出单价

其中 cache write 和缓存命中都按不超过输入 tokens 的数量计入，避免重复计价。解析到 service_tier = priority/fast 时使用官方 Fast mode API 单价；支持长上下文计价的模型在单次输入超过 272K tokens 时使用官方长上下文单价。推理强度不会被额外乘一次，因为 reasoning tokens 已包含在输出 token 中。价格来源以 OpenAI 的实时 API 定价页和对应模型页为准。

本月羊毛进度会累计当月所有本机 session 的 API 等效价值。GPT-5.3-Codex-Spark 仍是 research preview，官方尚未公布最终费率；这类模型及未知模型继续按 GPT-5.5 参考价折算，并用 ≈ 明确标记为参考估算，而不会冒充官方价格。进度条的参考终点使用 2 亿 tokens/天 * 30 天 估算，并按 30% 未缓存输入、50% 缓存输入、20% 输出的参考 token mix 折算；当前参考价约为 $7.75 / 1M tokens，参考月上限约 $46,500。进度条采用分段非线性刻度：Plus / Pro 节点保留在前段，超过 Pro 200 后用对数比例映射到参考终点，因此条宽用于扫视阶段进展，不等同于线性美元占比。该金额只是基于 API 价格的等效估算，不代表实际账单或官方返现金额。

快捷键和操作

• 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、线程和自动化任务信息。

安装

从 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 页面，安装仍由你手动完成。可以在设置窗口的系统区关闭自动检查，或手动点击“检查更新”。

运行要求

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

从源码构建

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.3.0-mac-arm64.dmg
dist/codexU-1.3.0-mac-arm64.dmg.sha256
dist/codexU-1.3.0-mac-x86_64.dmg
dist/codexU-1.3.0-mac-x86_64.dmg.sha256

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

数据来源

• 账户与额度：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 天窗口的剩余百分比。

支持 Intel Mac 吗？

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

License

MIT. See LICENSE.

关注公众号

如果你关注 AI 工具、Codex 使用经验和独立产品构建，欢迎扫码关注我的公众号。

用户交流群

扫码加入 codexU 用户交流群，交流使用经验、反馈问题，也欢迎一起参与开源共建。