Tidewatch
一个 macOS 菜单栏应用,在一个地方盯着你所有 AI 编码订阅的额度——多个 Claude(Pro/Max)、Codex(ChatGPT Plus/Pro)、GLM(z.ai 海外版 Coding Plan)账号,随时知道还剩多少、什么时候重置。
界面中文,自动适配浅色/深色。
官网:zhimahang.com/tidewatch(智码航出品)
💡 先看看 CodexBar——同类里功能更强的那个,我们更推荐它。
同样是 macOS 菜单栏额度应用,但覆盖的提供方比 Tidewatch 多得多(据其 README 已支持 60+ 家),
已做 Apple 公证、可 brew install --cask codexbar 一行装、自带自动更新,还有 CLI 版。
如果你只是想把各家 AI 编码额度看明白,直接用 CodexBar。
Tidewatch 仍然开源可用、会继续修,但功能上不与它比,自己按需选。
⚠️ Claude 明确不允许接入自动化工具，监控claude额度可能会导致封号。
⚠️ Tidewatch 读取的是各家 CLI / 网页端的非官方、未公开文档接口(逆向自 Claude Code、Codex CLI、z.ai 网页版)。只用来看你自己账号的用量。接口随时可能变动失效,详见 重要说明。
截图
功能一览
- 多提供方、多账号:Claude / Codex / GLM,每家可加多个账号,一屏汇总。
- 额度可视化:每个时间窗口(5 小时 / 本周 / 本月等)显示已用百分比、进度条(绿 → 橙 → 红)、重置倒计时,以及套餐档徽章(如
MAX / PRO / LITE)。
- 按模型细分:Claude 的 Fable / Opus / Sonnet 周额度、Codex 的附加模型额度,都会分行列出。
- 订阅到期日:Codex 自动显示(来自 id_token);其它账号可手动填写。
- 付款方式备忘:给每个账号记 Apple Pay(Apple ID)/ Google Pay(邮箱)/ 信用卡(只存后四位,绝不保存完整卡号)。
- Claude Design 项目:登录后可列出该账号的 Design 项目(名称 + 打开链接)。
- 自动刷新:3 / 5 / 15 / 30 分钟可选,也可手动刷新。
- 本地优先:token 存本机钥匙串,账号列表存本机文件,不向任何第三方上传数据。
安装
要求 macOS 14+。通用包(Apple 芯片 + Intel)。
想省事的话:CodexBar 已公证、brew install --cask codexbar 一行装完,不用下面这些绕 Gatekeeper 的步骤。
下载 .dmg(推荐)
到 Releases 页下载最新的 Tidewatch-*.dmg,打开后把 Tidewatch 拖进「应用程序」。
Tidewatch 尚未做 Apple 公证(我们是零预算的开源独立项目,代码全部公开可自查),所以首次打开 macOS 可能会拦:
-
macOS 15(Sequoia)及以上常会提示 「"Tidewatch" 已损坏,应移到废纸篓」——这是未公证 App 的正常表现,不是你电脑或下载有问题。打开「终端」粘贴执行(作用:解除下载隔离标记):
xattr -dr com.apple.quarantine /Applications/Tidewatch.app
-
或者:系统设置 → 隐私与安全性 → 下拉到底 →「仍要打开」,再确认一次。(注意:macOS 15+ 已经不能靠"右键→打开"绕过 Gatekeeper 了。)
首次导入账号时,系统会弹「Tidewatch 想访问 Claude Code / Codex 凭据」——这是读取本机 CLI 自用的用量凭据,只在你本机、不上传。点始终允许。
因为未签名,每次发版签名身份都会变,所以更新后可能需要重新授权钥匙串——这是未签名导致的、非异常。(做 Apple 公证能根治,但零预算暂不排。)
或者自己编译
不想信任二进制?从源码构建(什么都不出你的机器):
git clone https://github.com/ZhiMaHang/tidewatch.git
cd tidewatch
./scripts/build-app.sh # 生成 dist/Tidewatch.app(当前架构)
cp -R dist/Tidewatch.app /Applications/
open /Applications/Tidewatch.app
使用
打开面板
启动后,菜单栏出现波浪图标。点它就弹出额度面板;各账号额度都在这里看。(应用不占程序坞,只在菜单栏。)
添加账号
面板右上角 ⋯ → 添加 Claude / Codex / GLM 账号(或首次的空状态按钮)。
Claude(Pro / Max)
两种方式,任选:
- 应用内登录(推荐,支持多账号):
- 点「在浏览器中打开授权页」→ 用要添加的那个 Claude 账号登录并授权;
- 把回调页显示的授权码(形如
xxxx#yyyy)粘回输入框 → 完成登录。
- 导入本机 Claude Code CLI 凭据:如果你已在终端
claude 登录过,一键导入即可。
Codex(ChatGPT Plus / Pro)
- 导入
auth.json(推荐):填 Codex CLI 登录后的 ~/.codex/auth.json 路径;多账号可指向不同 CODEX_HOME 目录(如 ~/.codex-work/auth.json)。
- 浏览器登录:点「在浏览器中登录」,授权后自动回调完成。
GLM(z.ai 海外版)
- 贴入 z.ai 的 API key——就是你在 Claude Code 里设为
ANTHROPIC_AUTH_TOKEN 的那个值。
- key 在 z.ai 控制台获取:z.ai/manage-apikey。
看懂卡片
每个账号一张卡片:
- 左上服务标(C / X / G)、账号名、套餐徽章;
- 下方每个额度窗口:标题、已用百分比、进度条、重置于 … 倒计时;
- 有的还显示:订阅到期日、付款方式、Design 项目入口、额外 Credits。
每个账号的操作(卡片右侧 ⋯)
| 菜单项 | 说明 |
|---|
| 重命名… | 改这个账号在 Tidewatch 里显示的名字 |
| 设置订阅到期日… | 手填订阅到期/续订日(接口拿不到时用) |
| 设置付款方式… | Apple Pay / Google Pay / 信用卡(信用卡只留后四位) |
| 登录 Claude Design…(仅 Claude) | 授权后即可看该账号的 Design 项目 |
| 刷新 | 立即刷新这个账号 |
| 移除账号 | 删除账号并清掉其本机凭据 |
Claude Design 项目
⋯ 菜单 → Claude Design 项目…,打开独立窗口,按账号列出项目(名称 + 可点开的链接 + 首次发现时间)。
Claude Design 接口不返回项目的创建/修改时间,所以"时间"是 Tidewatch 首次看到该项目的时间,非项目真实时间。
刷新间隔 / 退出
都在 ⋯ 菜单里:刷新间隔可选 3 / 5 / 15 / 30 分钟;退出 Tidewatch 也在这。
数据与隐私
- 凭据(各账号 token、GLM API key)存本机 钥匙串(service
com.zhimahang.tidewatch.credentials),不写进普通文件。
- 账号列表(不含密钥)存
~/Library/Application Support/Tidewatch/accounts.json。
- Tidewatch 只读你自己账号的额度,不向任何第三方服务器上传数据;所有请求都直连对应官方接口。
- 信用卡只保存后四位(
•••• 1234),完整卡号永不落盘。
重要说明(必读)
Tidewatch 依赖的都是非官方、未公开文档的接口(逆向自 Claude Code / Codex CLI / z.ai 网页版):
- 这些接口随时可能变更或下线,届时对应额度会读不到——属预期,不是 bug。
- 复用官方 CLI 的 OAuth 客户端 / 私有端点属于灰色地带,请自行评估并遵守各服务条款,风险自负。
- 本项目仅供查看你自己账号的订阅用量,不做任何越权或规避用途。
开发
纯 Swift Package Manager,无 Xcode 工程。
swift build # 编译
swift run Tidewatch # 直接运行(菜单栏)
.build/debug/Tidewatch --check # 无头自检,打印各账号额度(脚本化验证用)
源码在 Sources/Tidewatch/(Providers/ 各家接口、Auth/ 登录流、Store/ 钥匙串与持久化、UI/ 界面)。
消除本机构建的钥匙串重复弹框
build-app.sh 默认 ad-hoc 签名,签名标识随每次构建变化,macOS 会把每次重构建都当成"新应用",反复弹「Tidewatch 想要访问你的钥匙串中的密钥」。跑一次:
./scripts/dev-cert.sh
它会在登录钥匙串创建一个稳定的自签名身份 Tidewatch Dev(幂等,已存在则直接复用),之后 build-app.sh 检测到该身份就自动改用它签名。换身份后仍有一次性弹框(都只弹一次,点「始终允许」后重构建不再弹):
- 脚本设置证书信任时,系统可能要求输一次登录密码;
- 首次用该身份构建时,可能弹「codesign 想访问密钥」;
- 换新身份后首次运行 App,每个钥匙串条目各弹一次授权。
该身份只用于本机 dev 构建;发行链路(build-dmg.sh)保持 ad-hoc 不变,「更新后需重新授权钥匙串」的口径见安装一节。
License
MIT © 2026 智码航,详见 LICENSE。
