RaDeleon/Claude-Code-Ultimate-Setup/tree/main/mods/ultimate-hud
ultimate-hud
一个 Claude Code 表情符号 HUD 外挂,在提示符上方显示模型、仓库、分支、会话时长、上下文填充、令牌数量、缓存命中/写入比例、费用和速率限制;可通过外挂 marketplace 安装,不需要 Bash 脚本或修改 settings.json。
关于这个 mod
ultimate-hud 是一个 Claude Code 外挂,会在提示符上方绘制类似仓库提示栏的表情符号状态带。它显示响应模型、工作目录和 Git 分支、会话时长、会话费用、上下文窗口填充量和令牌总数、未缓存的输入/输出令牌、缓存读取/写入总量及命中和写入百分比,以及带重置时间的 5 小时/7 天速率限制。进度条在 70% 时变黄、90% 时变红;没有数据的字段会隐藏;终端宽度小于 100 列时,进度条会缩为 10 格。设置包括 showIn,可选 everywhere、desktop 或 terminal,并可通过 /config 修改。运行 /hud 可切换状态带。使用 claude plugin marketplace add RaDeleon/Claude-Code-Ultimate-Setup 和 claude plugin install ultimate-hud@ultimate-setup 安装。需要 Claude Code 2.1.287 或更高版本。
安装
请先查看作者 README 确认 marketplace 和插件名称;命令可能随仓库结构改变。
claude plugin marketplace add RaDeleon/Claude-Code-Ultimate-Setup claude plugin install ultimate-hud
原文 / README
ultimate-hud
An emoji HUD drawn above the Claude Code prompt, in the style of this repo's statusline. It runs inside Claude Code as a mod, so it needs no bash scripts and no settings.json changes, and it works in the terminal and in the Code tab of the Claude Desktop app.
🤖 Opus 5.5 | 📁 Claude-Code-Ultimate-Setup | 🌿 main | ⏱️ 42m | 💰 $1.87
📊 Context [████░░░░░░░░░░░░░░░░] 21% | 🪙 210k/1M
⬆️ 120k | ⬇️ 8.4k | 🧊 1.2M | 🏗️ 85k | 🎯 91% hit | ✍️ 6% write
🚦 5h [██████░░░░░░░░░░░░░░] 31% 🔄 1:42pm | 🚦 7d [██░░░░░░░░░░░░░░░░░░] 12% 🔄 Mon
What each item means
| Item | Meaning |
| --- | --- |
| 🤖 | Model that answered the last turn |
| 📁 / 🌿 | Folder the session runs in, and its git branch |
| ⏱️ | Session duration |
| 💰 | Session cost, as /cost totals it |
| 📊 / 🪙 | Context window fill, and tokens used / window size |
| ⬆️ / ⬇️ | Uncached input tokens / output tokens, summed over the session |
| 🧊 / 🏗️ | Cache read tokens / cache write tokens, summed over the session |
| 🎯 hit | cache read ÷ (cache read + input) |
| ✍️ write | cache write ÷ (input + cache read + cache write) |
| 🚦 / 🔄 | 5-hour and 7-day rate limits and when they reset (subscription plans only) |
Bars are green under 70%, yellow from 70%, and red from 90%. A field with no data yet is hidden. Token totals count the main conversation only (not subagents) and start over on /clear. Bars shrink to 10 cells when the terminal is narrower than 100 columns.
Run /hud to hide or show the band.
Settings
| Setting | Values | Default |
| --- | --- | --- |
| Show HUD in (showIn) | everywhere, desktop (the Code tab of the Claude Desktop app only), terminal (the terminal only) | everywhere |
Change it in /config. Set it to desktop if you already have a terminal status line and only want the HUD in the Desktop app.
Install
claude plugin marketplace add RaDeleon/Claude-Code-Ultimate-Setup
claude plugin install ultimate-hud@ultimate-setup
Develop
claude --plugin-dir ./mods/ultimate-hud # loads it for one session, hot-reloads on save
claude plugin validate ./mods/ultimate-hud
cd mods/ultimate-hud && claude plugin test
Tested with Claude Code 2.1.288. Mods need Claude Code 2.1.287 or later.
