把Codex额度显示在macOS菜单栏或Windows任务栏:Codex Tools桌面驻留功能完整指南

原创2026-10-15 23:32:541,359 阅读

把Codex额度显示在macOS菜单栏或Windows任务栏:Codex Tools桌面驻留功能完整指南

Codex Tools 主界面

Codex Tools 是一款面向多账号场景的 Codex 管理工具,除了账号导入、快速切换和 API 反代之外,它还能把 Codex 额度常驻显示在 macOS 菜单栏、Windows 任务栏和系统托盘中。不用打开应用,抬眼就能看到当前账号还剩多少额度,适合同时管理多个 Codex 账号、又时刻关注用量窗口(5h / 1 周)的用户。

本文带你从零配置这套桌面驻留额度展示:macOS 菜单栏文字额度栏、Windows 任务栏额度组件、系统托盘额度图标,一次讲清楚。

为什么需要桌面常驻的 Codex 额度显示

如果你同时持有多个 Codex 账号,最常见的痛点是:额度什么时候用完、什么时候恢复,心里没底。每次都要切到应用窗口查看,既打断思路,也容易忽略窗口切换时机。

Codex Tools 的额度数据本身就支持 5h(5小时窗口)和 1week(周窗口)两个维度,配合账号预热、智能切换等能力(详见 README.md 的 Highlights 部分)。而桌面驻留展示解决的是"随时可见"这一环:

  • macOS:菜单栏文字额度栏 + 紧凑额度图标,双入口可独立开关;
  • Windows:任务栏左侧/右侧额度组件(实验性)+ 系统托盘额度图标;
  • 额度数据每 60 秒自动刷新一次,菜单栏、任务栏、托盘与应用窗口始终显示同一份最新结果。

Codex Tools 账号列表与用量主界面

上图为 Codex Tools 主界面:每个账号都会展示 5 小时用量率与周用量率,右侧是当前账号的使用概览。

如何安装 Codex Tools

方式一:下载桌面应用(推荐)

Codex Tools 是跨平台的桌面应用,支持 macOS Apple Silicon / Intel 和 Windows x64。从 Releases 下载对应平台的安装包即可,安装完成后直接运行。

方式二:安装命令行入口 ctc

习惯终端的用户可以额外安装 npm 命令行包,与桌面应用共享同一数据目录:

npm i -g @170-carry/ctc

之后可以用 ctc ui 直接拉起本机已安装的 Codex Tools 桌面应用,用 ctc list --refresh 刷新并查看账号额度。

方式三:源码构建

需要参与开发时,克隆仓库后本地运行:

git clone https://gitcode.com/gh_mirrors/cod/codex-tools
cd codex-tools
npm install
npm run tauri dev

构建要求 Node.js 20+、Rust stable,运行环境为 macOS 或 Windows。

macOS 菜单栏额度显示:三步完成配置

第 1 步:跟随首次启动引导选择展示方式

macOS 首次运行新版本时,会弹出"设置 macOS 额度栏"引导页。它把两个互相独立的展示入口放在一起配置,未添加账号的新用户也能先看到临时的 100% 菜单栏预览,选完效果立即可见:

  • 文字额度栏:可选择"Codex Tools 图标"或"进度环图标"两种样式;
  • 额度图标:五种紧凑样式任选其一,也可以关闭。

macOS 首次启动的额度栏设置引导页

两个入口可以分别启用、同时启用或同时关闭,点击"完成设置"即可进入主界面,菜单栏立刻开始显示额度。

第 2 步:认识五种紧凑额度图标样式

macOS 与 Windows 共享同一套紧凑样式:方形数字卡、横向数字卡、渐变数字、数字进度条、图标进度环。图标始终按"剩余额度"绘制——即使文字栏选择了"已用"口径,图标仍显示剩余比例,保证一眼可懂(见 src-tauri/src/tray/quota_mode.rs)。

第 3 步:在设置页实时微调

之后随时可以打开应用"设置"页的额度展示区域调整:图标与文字栏可以独立显隐,切换样式实时生效,无需重启应用。对应前端组件为 QuotaSettings.tsx,设置项会自动持久化,重启后保持不变。

💡 小提示:如果不想用菜单栏,也可以只保留应用主窗口;但常驻展示的最大价值就在于"不切窗口也能看到额度"。

Windows 任务栏额度显示:三种常驻方案

Windows 侧的额度展示能力更丰富,首次运行新版时同样会弹出"选择额度显示方式"引导页,提示至少启用一种展示,并说明 Windows 天气小组件对左侧位置的影响:

Windows 首次启动的额度显示方式选择页

方案一:任务栏额度组件(实验性功能)

这是最醒目的展示方式:在主任务栏最左侧或右侧直接渲染额度组件,额度左侧显示 Codex Tools 原图,背景透明、直接透出任务栏的真实颜色与材质。

Windows 任务栏常驻额度显示效果预览

使用任务栏组件时需要注意两点:

  • 组件固定在主任务栏,把 Codex Tools 窗口移到副屏时组件不会跟随或复制;
  • 如果左侧位置与 Windows 天气小组件冲突,可以在设置页或引导页一键打开 Windows 任务栏设置,关闭天气小组件即可。

关闭天气小组件后的 Windows 任务栏效果

方案二:系统托盘额度图标

不想改动任务栏的用户,可以直接使用托盘额度图标:在通知区显示一枚紧凑图标(如带剩余百分比的数字卡),与系统 Wi-Fi、电池图标并列,低调且常驻。托盘图标同样支持五种样式,设置实时生效。

方案三:两者组合

任务栏组件与托盘图标可以同时启用。Windows 侧提供四种额度口径:剩余、已用、5 小时剩余、1 周剩余(默认"一周剩余");历史数据中的 hidden 模式会自动回退为默认的"一周剩余",避免出现"选了位置却看不到内容"的情况。

额度显示口径:Remaining / Used / 5h / 1 周怎么选

口径 适合场景
剩余(Remaining) 想直观看到"还能用多少"
已用(Used) 关注本周/本窗口已经消耗的比例
5 小时剩余(fiveHourRemaining) 高频使用、盯紧短窗口恢复节奏
1 周剩余(oneWeekRemaining) 按周订阅计划,关注周额度

选择建议:日常开发推荐 5 小时剩余,因为它是触发"冷却"和需要切换账号的最关键窗口;多账号轮询的用户则可以选 1 周剩余,配合主界面的智能切换一起看。

刷新机制上,启动、手动刷新与周期刷新共用同一个协调器:重叠请求不会重复发起网络访问,仅时间戳变化最多每 5 分钟落盘一次,额度、授权与错误变化则立即保存——这也是菜单栏/任务栏数字始终与应用窗口一致的原因。

常见问题(FAQ)

Q1:macOS 菜单栏为什么显示 100%? 未添加账号的新用户在引导完成前会看到临时的 100% 预览值,导入账号并刷新用量后即显示真实额度。

Q2:Windows 任务栏左侧组件被天气挡住怎么办? 在引导页或设置页点击打开 Windows 任务栏设置,关闭天气小组件即可恢复左侧位置。

Q3:Explorer 重启后任务栏组件还在吗? 在。正在显示的组件会在 Explorer 重建后回到此前主任务栏位置;如果之前主动隐藏,重启后保持隐藏,在设置中重新选择左侧/右侧即可再次显示。

Q4:额度数字多久更新一次? 固定 60 秒调度刷新,窗口可见或最小化都在刷新范围内,菜单栏、任务栏、托盘与主窗口同步更新。

Q5:想同时把额度接入其他工具怎么办? Codex Tools 内置 OpenAI 兼容的本地 API 反代(默认 http://127.0.0.1:8787/v1),可以把账号池暴露给 Cursor、本地脚本等客户端,链路说明见 docs/api-proxy.md。

相关文件与延伸阅读

资料 路径
项目总览与安装说明 README.md
使用手册 how to use.md
额度设置前端组件 src/components/settings/QuotaSettings.tsx
托盘额度图标口径逻辑 src-tauri/src/tray/quota_mode.rs
跨平台额度展示与首次设置说明 docs/pr-assets/quota-status-visuals/PR_BODY.md
API 反代文档 docs/api-proxy.md
更新日志 changelog.md

总结:通过首次启动引导选择展示方式,再在设置页按 60 秒自动刷新的额度数据实时调整口径与样式,你就可以把 Codex 额度"钉"在 macOS 菜单栏或 Windows 任务栏上——多账号用量状态从此抬眼可见,切号、预热、恢复时机一目了然。

登录后查看全文
codex-tools