Usage Bar 用量横条
输入框上方实时显示限额、上下文、花费、Git 与 PR。
示意。实际效果取决于 Mod、终端和运行环境。
安装
/plugin marketplace add abyigiter/claude-usage-bar
/plugin install usage-bar@abyigiter-mods
/reload-plugins在 Claude Code 会话里逐行执行这些命令。
claude plugin marketplace add abyigiter/claude-usage-bar
claude plugin install usage-bar@abyigiter-mods然后在会话里执行 /reload-plugins,或开一个新会话。
请帮我安装 Claude Code Mod「Usage Bar 用量横条」(https://github.com/abyigiter/claude-usage-bar)。安装前先阅读仓库 README 的 Security 和 Requirements 部分,告诉我它会读写哪些内容、运行什么命令、是否联网,以及对 Claude Code 版本、系统和终端的要求。确认没有问题后,运行 claude plugin marketplace add abyigiter/claude-usage-bar 和 claude plugin install usage-bar@abyigiter-mods 完成安装,最后提醒我在会话里执行 /reload-plugins。把这段话发给 Claude Code,它会先读原作者说明再安装。
git clone https://github.com/abyigiter/claude-usage-bar
cd claude-usage-bar
claude --plugin-dir ./usage-bar克隆仓库后用 --plugin-dir 在本地会话中试用。
它会碰什么
据原作者说明,收录时核对;可用 claude plugin validate 自行检查。
读取
有读取 Claude Code 自身的用量、花费与本地 /context 估算,以及 git/gh 返回的计数与 PR 状态。
写入文件
有把预算和每日花费累计(保留 35 天)写入插件自己的存储。
运行命令
有在会话目录运行 git status、git diff --shortstat 和 gh pr view。
联网
有自身不调 API、无遥测;PR 查询经你自己的 gh 登录访问 GitHub。
介绍
Usage Bar 是 Claude Code 的 function hooks Mod(v1.1.0),在输入框上方放一条实时横条,用一排彩色胶囊显示本次会话的关键数字,需要注意时变黄或变红。
- 5H / 7D 限额:进度条、按窗口已过时间画的节奏刻度和重置倒计时;按当前节奏会在重置前用满时变黄,超过 150% 节奏或用量过 90% 变红。非订阅账号不显示。
- CTX 上下文:窗口占用、token 数与上一轮增长;Claude 工作时有
● 0:42计时。 - Git 与 PR:分支、相对 HEAD 的增删行数、未跟踪文件、领先/落后;通过
gh查当前分支 PR 的状态、评审与 CI,CI 结束时弹提示(需已登录 GitHub CLI)。 - COST / TODAY:会话花费与每小时消耗,今天、近 7 天每日柱和本月累计。
- 点
▾ more打开详情面板:按/context分类的上下文堆叠条与距自动压缩的轮数、花费、轮次与缓存命中率、最常用的五个工具和失败的 CI 检查。 /budget设会话或每日预算,达到 80%、100% 时弹提示;/usage以文本打印全部数字。
支持 Claude Code CLI 和桌面端 Code 标签,需要 Claude Code 2.1.287 或更新版本。数字来自 Claude Code 自身的 $.session.usage(),作者说明不额外调 API、无遥测;会在会话目录运行 git status、git diff --shortstat 和 gh pr view,预算与每日累计存在插件自己的存储里。仓库另含 pi 版本,本条只收 Claude Code Mod。仓库没有 LICENSE 文件,未声明开源许可,经站长确认仍收录。本站未实测,下方预览为布局示意。
适合谁
- 想随时看到订阅限额节奏与上下文余量的人
- 需要控制会话或每日花费预算的人
- 边写代码边盯 PR 与 CI 状态的人
运行要求
- Claude Code ≥ 2.1.287
- 支持 CLI 与桌面端 Code 标签。
- PR 胶囊需要已安装并登录 GitHub CLI(gh);限额胶囊仅订阅账号显示。