帮助与信息

连接你的账户。
读数含义看清楚。

从添加第一个账户，到理解保存的读数，了解如何在 Mac 上使用 AIUsageWatch。

系统要求与发布信息

AIUsageWatch 是一款免费的原生菜单栏应用，适用于 macOS 14 或更高版本。公开发布正在准备中。可下载时，本网站会添加经过验证的下载链接。服务商账户及其套餐费用与本应用各自独立。

先将正式发布的应用移至“应用程序”文件夹，再启用 登录时打开。应用驻留在菜单栏，无需 Dock 图标。在访达中打开已运行的应用，会将偏好设置窗口带到前台。

连接服务商

Codex： 安装并登录 Codex CLI。将账户指向对应配置目录，通常是 ~/.codex。应用通过本地 CLI app-server 使用该目录保存的登录。
Claude： 默认的 ~/.claude 账户使用你在 Safari 中的 claude.ai 会话。在偏好设置中，授予 Safari 的 Cookies.binarycookies 文件访问权限。若使用独立的 Claude 配置目录，请通过对应的 CLAUDE_CONFIG_DIR登录 Claude Code；应用会读取其中的 .credentials.json.
Cursor： 在 Safari 中登录 cursor.com，并在偏好设置中授予 Safari cookie 文件访问权限。Cursor 读取用量时不使用账户目录。
Grok： 选择 Grok 目录，其中应包含 logs/unified.jsonl。运行 Grok 可更新该日志中的计费用量读数。

应用读取各来源可提供的额度信息。Claude 和 Codex CLI 来源需要对应的已保存登录。网站预览不会访问你的账户。

个人与工作账户一起看

在菜单中打开 偏好设置… ，或按 ⌘,。每个账户都有标签、服务商、目录、颜色和字母。使用 + 添加目录；应用会根据目录内容推测服务商。使用新账户前，请确认服务商是否正确。

要添加另一个 Codex 登录，请选择其独立的 CODEX_HOME。要添加另一个 Claude 登录，请使用独立的 CLAUDE_CONFIG_DIR ，并保存它自己的凭据。默认 Claude Safari 会话包含多个组织时，账户选择可能不明确；此时请使用独立配置目录。Cursor 读取器使用可用的 Safari 会话，因此重复添加 Cursor 行不会创建独立登录。

账户增多时会增加列，每列最多三行。自定义字母和颜色帮助区分账户。通用设置包括刷新间隔、百分比标记、字母，以及针对受支持 Codex 储备重置机会到期信息的提醒。

了解额度条

填充部分表示 剩余额度。剩余 0% 时没有填充条。颜色用于区分账户。菜单显示百分比、可获取的重置时间、相关用量窗口详情及读数状态。

Claude 包括每周额度及可获取的 5 小时详情；Codex 选择主要每周上限。Cursor 使用自身的套餐内用量数值，其源数据未注明用量周期。Grok 使用 CLI 日志中的每周积分数值。不同服务商的百分比不代表等量的 token、提示次数或金额。

在 Codex 储备重置机会到期前及时留意

当 Codex 提供可用的储备重置机会及其到期日期时，AIUsageWatch 可在下一次储备重置机会到期前，在账户旁显示提醒圆点。打开菜单可查看可用数量和到期信息。未使用的储备重置机会到期时可能失效；这与常规每周额度重置时间不同。

在偏好设置中启用 重置前提醒 ，并选择 提前 1–14 天。默认提前两天，提醒圆点为红色；你可以更改颜色。关闭账户字母显示后，圆点仍会显示。提醒依赖于应用正在运行、已启用提醒，以及到期数据可获取且为最新。它不会自动使用储备重置机会，也不会发送系统通知。

Codex 的自动启动请求

当 Codex 实时每周读数显示剩余 100%时，AIUsageWatch 会发送一次小型 codex exec 请求，使用该目录保存的 CLI 登录，目的是启动原本可能尚未开始的每周用量周期。它使用 Codex 默认可用模型，并 消耗该账户的少量额度.

请求进行中或失败时，账户会显示红色圆点。菜单说明状态，并提供手动重试。应用在内存中记住该每周用量周期的尝试。重复轮询不会为已记住的尝试发送更多请求；重新启动会清除这段记录，如果实时读数仍为 100%，可能再次发送请求。

历史会话记录备用来源不会发送启动请求。当前版本未启用 Claude 自动启动请求。这一行为与读取用量不同，当前偏好设置也未提供 Codex 启动请求开关。

数值过时、缺失或异常

保存的读数： 最近一次有效读数缓存在你的 Mac 上，并在启动时恢复。刷新失败时，菜单会说明它距今多久。
限流或连接失败： 遇到限流后，重试会等待 15 分钟；其他错误后等待 2 分钟。 立即刷新 可跳过这段等待时间。
Safari 连接： 检查是否已登录正确的服务商，核对 cookie 文件授权，并确认会话能明确对应账户。
Grok： 运行 CLI 记录新的用量读数。已结束的用量周期或较旧日志会显示为历史数据，而非实时余额。
Codex： 确认 CLI 可用，并且已配置目录包含你想使用的登录。如果 app-server 不可用，会话记录备用来源可能显示较旧信息。

服务商接口和返回数据可能变化。读数不能保证服务商会接受下一次请求。余额或重置时间看起来不对时，请查看服务商自己的账户页面。

本地设置与服务商连接

偏好设置和缓存读数保存在 ~/Library/Application Support/AiUsageWatch/。应用不直接读取钥匙串。服务商 CLI 自行管理登录行为。实时读取器通过已有会话或凭据联系相关服务商。请阅读隐私政策，了解应用本地存储、服务商连接和支持消息之间的区别。

报告问题

联系 AIUsageWatch 支持，并提供应用版本、macOS 版本、服务商、读数状态及重现问题的步骤。如果使用诊断 --dump 模式，请在发送前检查输出内容。移除访问令牌、cookie 值、私有账户路径及其他敏感信息。不要上传凭据文件。