claude-code-usage-bar
在Claude Code状态栏实时显示API用量、模型和缓存信息
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：claude-code-usage-bar。 它的用途是：在Claude Code状态栏实时显示API用量、模型和缓存信息 完整的 Skill 内容见：https://321skill.com/skills/claude-code-usage-bar/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我重构这段遗留代码'，在长时间的对话和代码生成过程中，你无需中断思路去网页查看额度，状态栏会实时显示`5h: 85% →92%`和`cache 2m10s`，让你清楚知道剩余对话时间和缓存状态，从而合理安排工作节奏。
介绍
Claude Code本身不直接显示关键的API使用限制信息，用户需要频繁切换窗口才能查看剩余额度或重置时间。这打断了流畅的编码和对话体验。
claude-statusbar通过在Claude Code终端底部添加一个简洁的状态行，或在桌面应用上显示一个悬浮HUD，实时展示官方5小时/7天速率限制的使用进度、重置倒计时、当前模型、上下文窗口占用情况以及提示词缓存的剩余时间。它通过一个简单的安装脚本或pip命令即可完成部署，重启Claude Code后即可生效。
这个工具非常适合依赖Claude Code进行高频编码、调试或技术对话的用户，尤其是那些需要精细管理API使用配额，避免在关键时刻因额度耗尽而中断工作的开发者和技术写作者。
建议在安装后，根据个人偏好通过命令切换状态栏的样式和主题。对于macOS桌面应用用户，可以启用悬浮HUD功能以获得更直观的全局视图。注意，该工具主要服务于Claude Code环境，不适用于其他AI编码工具。
核心特点
与同类工具相比，它直接集成在Claude Code状态栏，无需离开当前工作界面；其显示的速率限制和缓存倒计时基于官方数据而非本地估算，准确性更高；同时提供终端状态行和macOS桌面悬浮HUD两种显示方式，适应性更强。
注意事项
主要针对Claude Code环境设计，不适用于其他AI编码助手或通用IDE。
常见问题
安装后状态栏没有显示怎么办？
请确保已按照指南完成安装并重启Claude Code。如果使用pip安装，请确认已运行`cs --setup`命令完成配置。
这个工具会消耗额外的API调用次数吗？
不会。它通过读取Claude Code已有的使用数据来工作，不会产生额外的API调用或费用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-code-usage-bar/raw/index.md 读取 claude-code-usage-bar 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-code-usage-bar/raw/index.md（查看排版版本）