brink

这是什么？适合谁？

Brink（semihtalii/brink）是一个AI 编程用量限额的边缘提醒器：在 Mac/Windows 屏幕边缘实时显示 Claude Code、Codex、Cursor 的用量边界，避免 Agent 长会话中途耗尽额度。

核心价值：把「还剩多少用量」直接显示在屏幕边缘，防止长时间 Agent 会话跑到一半因额度耗尽而前功尽弃。

适合人群：

• 重度使用 Claude Code / Codex / Cursor 的开发者
• 同时跑多个 Agent 会话的人
• 想控制订阅成本、避免意外超额的用户

使用前提：Mac 或 Windows 桌面，以及 Claude Code / Codex / Cursor 任一账号

准备工作

1. 安装：从 GitHub Releases 下载桌面应用
2. 订阅：Claude Code / Codex / Cursor 任一账号
3. 环境：macOS 或 Windows 桌面
4. 成本：MIT 开源免费
5. 时间：安装 + 接入用量显示约 10 分钟

快速上手（3 步）

第一步：安装桌面应用

git clone https://github.com/semihtalii/brink
# 或从 Releases 下载安装包

从 GitHub Releases 下载安装

第二步：接入用量数据

授权读取 Claude Code / Codex / Cursor 的用量

第三步：设置提醒边界

在屏幕边缘设置用量阈值，到边界即提醒

成功判定：在屏幕边缘看到用量边界，并在达到阈值时收到提醒。

初级用法

屏幕边缘用量显示

在 Mac/Windows 屏幕边缘常驻显示当前用量剩余。

多工具用量聚合

把 Claude Code、Codex、Cursor 的用量集中到一处查看。

阈值提醒

自定义用量阈值，到边界时给出提醒。

高级玩法

自定义边界样式

调整边缘显示的颜色、透明度与位置。

同时监控多个会话

并行跟踪多个 Agent 会话的用量消耗。

用量历史回看

回看一段时间的用量趋势，辅助成本规划。

小技巧

1. 阈值设低一点，给收尾留缓冲
2. 开始长任务前先看剩余额度
3. 多会话时按项目区分额度来源
4. 关注免费档的每日重置时间
5. 与官方用量页核对，避免只依赖第三方显示

常见踩坑

踩坑 1：显示不更新

• 现象：屏幕边缘用量停滞
• 原因：未授权或会话断开
• 解决：重新授权并确认后台进程在运行

踩坑 2：部分工具读不到

• 现象：某工具用量无数据显示
• 原因：工具接口差异或未支持
• 解决：以 README 支持列表为准

踩坑 3：显示与官方不符

• 现象：边缘显示与实际额度不一致
• 原因：缓存或计费延迟
• 解决：以官方用量页为准

踩坑 4：系统权限缺失

• 现象：macOS 无显示/辅助功能权限
• 原因：系统安全策略拦截
• 解决：按系统提示授予必要权限

踩坑 5：项目较新

• 现象：功能覆盖有限
• 原因：2026-08 新建项目
• 解决：以 README 为准，关注后续更新

常见问题 FAQ

Q1: 支持哪些平台？

A: A: 面向 Mac 与 Windows 桌面，具体系统要求见 Releases 说明。

Q2: 免费吗？

A: A: MIT 开源免费。

Q3: 我的用量数据会传出去吗？

A: A: 数据仅用于本地显示，具体以 README 的隐私说明为准。

Q4: 支持哪些工具？

A: A: 针对 Claude Code、Codex、Cursor 的用量限额，以 README 支持列表为准。

Q5: 显示准确吗？

A: A: 以工具官方用量数据为来源，存在缓存延迟时以官方页面为准。

进阶学习建议

掌握基础后，建议深入：

1. 把用量检查纳入长任务开始前的 checklist

2. 研究各工具用量 API 的差异与限制

3. 结合订阅档位做月度成本规划

参考链接

• 官方仓库

最后更新：2026-08-31 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成