GitHub 儲存庫 · 儀表板與 HUD

hud：Claude Code 狀態面板、用量預警與每日預算 — Claude Code 插件／外掛 · ClaudeMods

Name: hud：Claude Code 狀態面板、用量預警與每日預算
Author: hoobnn

在 ClaudeMods 了解這款 Claude Code 插件／外掛，查看原始來源與所需權限。將 claude-hud 0.10.0 改為 mod，把模型、Git、上下文、工具、子代理與待辦集中在輸入框旁；加入額度預警、每日預算、詳細資訊面板與 12 套主題，隨時掌握工作狀態。

hhoobnn@hoobnn

已翻譯

關於這個 mod

hud 將 claude-hud 0.10.0 改為 Claude Code mod，把模型與推理強度、專案與 Git 變更、上下文和用量進度條、執行中的工具、子代理與待辦集中在輸入框旁。可放在輸入框上方，也可放到下方原有狀態列的位置。

它在原有儀表板之外，加入可設定門檻的上下文與額度預警、額度耗盡時間估算、自動壓縮前剩餘的 token，以及未提交變更或未推送提交過多時的提醒。五小時額度預測採用最近一小時的消耗速度。花費檢視會將今天的花費與每日預算對照，並提供近七天迷你折線圖。一行任務摘要保留目前工作的重點；/hud detail 詳細資訊面板顯示工具呼叫次數與耗時、最近幾輪花費時間、費用和上下文增長，以及子代理、待辦、今日與本週花費，Claude 工作時也能開啟。長任務結束可觸發提醒，macOS 可附提示音，並顯示遠端控制的連線狀態。

12 套主題為 classic、neon、rainbow、emoji、sakura、kawaii、mecha、shonen、tokyo-night、matrix、nerd 和 powerline；後兩套需要 Nerd Font。動漫風角色會隨工作、上下文與額度狀態改變表情，可用 showMascot 關閉。/hud theme <名字> 立即切換，/hud theme 開啟選擇視窗，/hud theme next 換下一套，/hud theme reset 恢復 classic，選擇會透過 /config 的 theme 保存。/hud 切換顯示；/hud on、/hud off 直接設定，輸入框底列的 HUD 按鈕也能操作。

可以沿用 ~/.claude/plugins/claude-hud/config.json 與 ~/.claude/claude-hud.json 的既有設定，/claude-hud:configure 仍可使用。安裝指令： claude plugin marketplace add hoobnn/hoobnn-agent-mods claude plugin install hud@hoobnn-agent-mods

來源：https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/hud 原版 claude-hud：https://github.com/jarrodwatts/claude-hud

安裝

請先查看作者 README，確認 marketplace 與外掛名稱；指令可能隨儲存庫結構而變動。

claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hud

原文 / README

hud：Claude Code 状态栏 HUD

简体中文 · English

把 claude-hud 0.10.0 改成了 Claude Code mod：模型、项目、git、上下文、用量、正在跑的工具、子代理和待办，都集中在输入框旁边。可以放在输入框上方，也可以放在下方原来状态栏的位置。在 claude-hud 的基础上，还加了额度预警、用量耗尽预测、每日预算、一行任务摘要、详情面板，以及 12 套随时切换的主题。

hud：neon 主题

功能

claude-hud 原有的信息都在：模型和推理强度、项目和 git 分支及改动、上下文和用量进度条、正在跑的工具、子代理和待办。
提前预警：上下文或额度到你设定的百分比时弹提示；按当前速度估算额度何时用完（5 小时额度按最近一小时的速度算）；距自动压缩还剩多少 token；未提交的改动或未推送的提交太多时提醒。
花费：今天的花费对比每日预算，近 7 天花费的迷你折线图。
一行任务摘要，以及 /hud detail 详情面板：每个工具的调用次数和耗时、最近几轮的用时、花费和上下文增长、子代理、待办、今天和本周的花费。
12 套主题：科技霓虹、彩虹渐变、emoji、带颜文字看板娘的动漫风（樱花、猫咪、机甲、热血）、Tokyo Night、黑客帝国、Nerd Font 和 powerline。
长任务结束提醒（macOS 可加提示音），以及远程控制的连接状态。

安装

claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hud@hoobnn-agent-mods

它读取 claude-hud 自己的配置文件（~/.claude/plugins/claude-hud/config.json 和 ~/.claude/claude-hud.json），已有的 claude-hud 设置可以直接沿用，/claude-hud:configure 也照常可用。

主题

用 /hud theme <名字> 立即切换；只输入 /hud theme 会弹窗选择；/hud theme next 换下一套，/hud theme reset 回到 classic。选择会写回 /config 的 theme 选项，以后的会话也会沿用。

| 主题 | 风格 | | --- | --- | | classic | claude-hud 原样 | | neon | 赛博朋克：霓虹真彩色，⬢ ◆ ◈ ⚡，▰▱ 进度条，❯ 分隔 | | rainbow | 每个元素一种颜色，进度条和模型名是彩虹渐变 | | emoji | 🤖 📂 🌿 🧠 ⚡ 📅 ⏳ ✅ | | sakura | 樱花粉，🌸 🎀 🍡 💗，✿ 进度条，颜文字看板娘 (◕‿◕)♡ | | kawaii | 马卡龙色，「Opus」，●○ 进度条，猫咪看板娘 ฅ^•ω•^ฅ | | mecha | 紫、绿、橙，UNIT·Opus◤，SYNC / PWR 仪表，机器人看板娘 [•_•] | | shonen | 红橙金，🔥 ⭐ 🍥 💥，渐变进度条，热血看板娘 (ง •̀_•́)ง | | tokyo-night | Tokyo Night 配色，图标克制 | | matrix | 黑底绿字，▮▯ 进度条，┊ 分隔 | | nerd | Nerd Font 图标（需要 Nerd Font） | | powerline | Nerd Font 图标加 powerline 色块（需要 Nerd Font） |

同一个示例会话在 12 套主题下的样子：assets/themes/gallery.png；每套主题的单图在 assets/themes/<主题>.png。

动漫风主题的看板娘会跟着状态变脸：平时很淡定，跑工具时忙碌，上下文到 70%（或额度到 90%）开始担心，85% 慌张，用量耗尽时直接晕倒。showMascot 可以关掉它。

命令

/hud：显示或隐藏 HUD；/hud off、/hud on 直接设定（输入框底栏的 HUD 按钮也一样）。
/hud theme [名字|next|reset]：切换主题。
/hud detail：打开或关闭详情面板。Claude 工作时也能用。

选项

在 /config 里修改，或写在 ~/.claude/settings.json 的 pluginConfigs 里：

| 选项 | 作用 | 默认 | | --- | --- | --- | | visible | 显示 HUD | 开 | | footerButton | 在输入框底栏显示 HUD 开关按钮 | 开 | | position | above 放在输入框上方，below 放在下方原状态栏的位置 | above | | theme | 主题 | classic | | showMascot | 动漫风主题显示颜文字看板娘 | 开 | | contextAlerts | 上下文到这些百分比时提醒，逗号分隔，如 80,90；留空关闭 | 空 | | usageAlerts | 5 小时或 7 天额度到这些百分比时提醒；留空关闭 | 空 | | showForecast | 按当前速度会在重置前用完时，显示预计用完的时间 | 开 | | compactWarnPercent | 上下文到达自动压缩阈值的这个百分比后，显示还剩多少 token；0 关闭 | 60 | | dailyBudgetUsd | 每日预算（美元），显示今天的花费对比；0 关闭 | 0 | | showHistory | 显示近 7 天花费折线和连续使用天数 | 关 | | summaryEveryTurns | 第一轮后和每隔几轮生成一行任务摘要（复用提示词缓存）；0 关闭 | 5 | | notifyAfterSeconds | 一轮跑了这么多秒以上才在结束时提醒；0 关闭 | 0 | | notifySound | 结束提醒带提示音（macOS） | 开 | | gitDirtyWarn | 未提交的改动达到这么多个路径时提醒；0 关闭 | 20 | | gitAheadWarn | 未推送的提交达到这么多个时提醒；0 关闭 | 5 | | showAgents | 显示 claude-hud 的子代理行（Claude Code 自己已经会列出，默认关） | 关 | | extraCmd | claude-hud 的 --extra-cmd：一条 shell 命令，输出作为一个标签（需要 CLAUDE_HUD_ALLOW_EXTRA_CMD=1） | 空 | | debug | 注册 mcp__hud__hud_debug 调试工具 | 关 |

语言跟随 claude-hud 配置文件里的 language（en、zh-Hans、zh-Hant、ja、ko、es、fr、de、pt-BR、ru），mod 新加的预警、面板、/hud 回复和任务摘要也一起跟随。

同系列 mod

hoobnn-agent-mods 里还有任务进度条（todo-bar）、回合回执（receipt）、运行动画和宠物（spinner）、Tailscale 节点状态（ts-band）和一言（hitokoto），可以搭配使用。

开发

和 claude-hud 的差异、mod 自行推算的字段、目录结构和从上游同步的步骤，见英文 README。

查看原始來源 ↗

權限足跡 L2

權限足跡

資料來自自動掃描，安裝前請自行查看原始碼。等級描述能力，不代表安全認證。

掃描不完整。無法解析匯入 ../types; 無法解析匯入 ../../types; 匯入的相依檔案超過掃描上限

讀取檔案
寫入檔案
執行指令
註冊工具
攔截工具呼叫
環境變數

查看命中位置（68）

讀取檔案 · 第172 行claude-code/hud/hooks/register.tsxstat: path => $.fs.stat(path, { resolve: true }),

讀取檔案 · 第173 行claude-code/hud/hooks/register.tsxread: path => $.fs.read(path),

讀取檔案 · 第174 行claude-code/hud/hooks/register.tsxlist: path => $.fs.list(path),

寫入檔案 · 第175 行claude-code/hud/hooks/register.tsxwrite: (path, text) => $.fs.write(path, text),

執行指令 · 第176 行claude-code/hud/hooks/register.tsxrun: (argv, init) => $.process.run(argv, init),

註冊工具 · 第302 行claude-code/hud/hooks/register.tsxawait $.tool.register({

攔截工具呼叫 · 第437 行claude-code/hud/hooks/register.tsxon('tool.call', { tool: /^mcp__hud__hud_debug$/ }, async () => {

攔截工具呼叫 · 第447 行claude-code/hud/hooks/register.tsxon('tool.call', async ($, e, next) => {

執行指令 · 第166 行claude-code/hud/hooks/extras.tsconst ab = /^# branch\.ab \+(\d+) -\d+/.exec(record)

執行指令 · 第21 行claude-code/hud/hooks/hud/render/ansi.tsconst match = ESCAPE_AT.exec(str);

執行指令 · 第143 行claude-code/hud/hooks/hud/render/ansi.tsconst url = /^\x1b\]8;;([^\x07\x1b]*)/.exec(token.text)?.[1];

環境變數 · 第375 行claude-code/hud/hooks/hud/config.ts.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (match, name: string) => process.env[name] ?? match)

讀取檔案 · 第500 行claude-code/hud/hooks/hud/config.tsconst content = fs.readFileSync(fd, 'utf-8');

讀取檔案 · 第90 行claude-code/hud/hooks/shims/fs.tsexport function statSync(p: PathLike, options?: { throwIfNoEntry?: boolean }): Stats {

讀取檔案 · 第105 行claude-code/hud/hooks/shims/fs.tsreturn statSync(fd)

讀取檔案 · 第120 行claude-code/hud/hooks/shims/fs.tsexport function readFileSync(p: PathLike, _options?: unknown): string {

讀取檔案 · 第124 行claude-code/hud/hooks/shims/fs.tsexport function readdirSync(p: string, options?: { withFileTypes?: boolean }): any[] {

寫入檔案 · 第150 行claude-code/hud/hooks/shims/fs.tsexport function writeFileSync(p: PathLike, data: unknown, _options?: unknown): void {

寫入檔案 · 第180 行claude-code/hud/hooks/shims/fs.tsexport function unlinkSync(p: string): void {

寫入檔案 · 第188 行claude-code/hud/hooks/shims/fs.tsexport function mkdirSync(_p: string, _options?: unknown): void {}

環境變數 · 第14 行claude-code/hud/hooks/hud/claude-config-dir.tsconst envConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim();

環境變數 · 第22 行claude-code/hud/hooks/hud/claude-config-dir.tsconst envConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim();

環境變數 · 第2 行claude-code/hud/hooks/hud/debug.tsconst enabled = process.env.DEBUG?.includes('claude-hud') || process.env.DEBUG === '*';

環境變數 · 第12 行claude-code/hud/hooks/hud/utils/terminal.tsreturn columns(process.env.COLUMNS) ?? columns(process.stdout?.columns) ?? columns(process.stderr?.columns);

執行指令 · 第136 行claude-code/hud/hooks/hud/git.tsconst sha = /^detached:([0-9a-f]+)$/.exec(ref)?.[1];

執行指令 · 第171 行claude-code/hud/hooks/hud/git.tsconst match = /^\+(\d+) -(\d+)$/.exec(record.slice('# branch.ab '.length));

環境變數 · 第10 行claude-code/hud/hooks/hud/git-runner.tsexport function createGitEnvironment(base: NodeJS.ProcessEnv = process.env): NodeJS.ProcessEnv {

執行指令 · 第17 行claude-code/hud/hooks/hud/git-runner.tsexecFile('git', [...args], {

執行指令 · 第73 行claude-code/hud/hooks/shims/child_process.tsexport function execFile(

執行指令 · 第90 行claude-code/hud/hooks/shims/child_process.tsexport function exec(command: string, options?: ExecOptions | Callback, callback?: Callback): void {

執行指令 · 第102 行claude-code/hud/hooks/shims/child_process.tsexport function execFileSync(file: string, ...rest: unknown[]): string {

執行指令 · 第111 行claude-code/hud/hooks/shims/child_process.tsexport function spawn(): never {

執行指令 · 第58 行claude-code/hud/hooks/hud/auth.tsconst match = /_(\d+x)$/i.exec(rateLimitTier);

環境變數 · 第66 行claude-code/hud/hooks/hud/auth.tsexport function deriveAuthInfo(claudeJson: unknown, env: NodeJS.ProcessEnv = process.env): AuthInfo {

環境變數 · 第109 行claude-code/hud/hooks/hud/auth.tsif (hasApiKey(process.env)) {

讀取檔案 · 第113 行claude-code/hud/hooks/hud/auth.tsreturn deriveAuthInfo(JSON.parse(fs.readFileSync(getClaudeConfigJsonPath(os.homedir()), 'utf8')));

讀取檔案 · 第66 行claude-code/hud/hooks/hud/daily-cost.tsconst value: unknown = JSON.parse(fs.readFileSync(ledgerPath, 'utf8'));

讀取檔案 · 第93 行claude-code/hud/hooks/hud/daily-cost.tsreturn now - fs.statSync(ledgerPath).mtimeMs <= DAILY_COST_WRITE_THROTTLE_MS;

寫入檔案 · 第102 行claude-code/hud/hooks/hud/daily-cost.tsfs.mkdirSync(path.dirname(ledgerPath), { recursive: true, mode: 0o700 });

寫入檔案 · 第103 行claude-code/hud/hooks/hud/daily-cost.tsfs.writeFileSync(tmpPath, `${JSON.stringify(ledger, null, 2)}\n`, { mode: 0o600, flag: 'wx' });

環境變數 · 第151 行claude-code/hud/hooks/hud/stdin.tsexport function getProviderLabel(stdin: StdinData, env: NodeJS.ProcessEnv = process.env): string | null {

執行指令 · 第70 行claude-code/hud/hooks/hud/transcript.tsconst mcpServer = (toolName: string): string | undefined => name(MCP_TOOL.exec(toolName)?.[1]);

執行指令 · 第158 行claude-code/hud/hooks/hud/transcript.tsconst effort = EFFORT_COMMAND.exec(entry.message.content);

執行指令 · 第172 行claude-code/hud/hooks/hud/transcript.tsconst toolUseId = /<tool-use-id>([^<]+)<\/tool-use-id>/.exec(entry.content)?.[1];

讀取檔案 · 第366 行claude-code/hud/hooks/hud/transcript.tsif (!transcriptPath || !fs.statSync(transcriptPath).isFile()) return emptyTranscript();

執行指令 · 第45 行claude-code/hud/hooks/stdin.tsconst match = /claude-(opus|sonnet|haiku|fable)-(\d+)(?:-(\d{1,2}))?(?:-\d{8})?$/i.exec(bare)

執行指令 · 第46 行claude-code/hud/hooks/stdin.ts?? /claude-(\d+)(?:-(\d+))?-(opus|sonnet|haiku)/i.exec(bare)

執行指令 · 第92 行claude-code/hud/hooks/stdin.tsconst match = /^(?:[a-z+]+:\/\/)?(?:[^@/]+@)?([^/:]+)[:/](?:\d+\/)?([^/]+)\/([^/]+?)(?:\.git)?\/?$/i.exec(remote.trim())

環境變數 · 第23 行claude-code/hud/hooks/hud/index.tsexport function isHudDisabled(env: NodeJS.ProcessEnv = process.env): boolean {

執行指令 · 第15 行claude-code/hud/hooks/hud/memory.tsconst pageSize = /page size of (\d+) bytes/.exec(output)?.[1];

執行指令 · 第16 行claude-code/hud/hooks/hud/memory.tsconst active = /Pages active:\s+(\d+)/.exec(output)?.[1];

執行指令 · 第17 行claude-code/hud/hooks/hud/memory.tsconst wired = /Pages wired down:\s+(\d+)/.exec(output)?.[1];

執行指令 · 第24 行claude-code/hud/hooks/hud/memory.tsconst total = /^MemTotal:\s+(\d+)\s+kB/m.exec(output)?.[1];

執行指令 · 第25 行claude-code/hud/hooks/hud/memory.tsconst available = /^MemAvailable:\s+(\d+)\s+kB/m.exec(output)?.[1];

執行指令 · 第33 行claude-code/hud/hooks/hud/memory.tsexecFile('/usr/bin/vm_stat', { encoding: 'utf8', timeout: VM_STAT_TIMEOUT_MS }, (error, stdout) => {

讀取檔案 · 第44 行claude-code/hud/hooks/hud/memory.tsreturn parseLinuxMeminfo(await readFile('/proc/meminfo', 'utf8')) ?? systemMemory();

讀取檔案 · 第4 行claude-code/hud/hooks/shims/fs_promises.tsexport async function readFile(path: string, _options?: unknown): Promise<string> {

讀取檔案 · 第80 行claude-code/hud/hooks/hud/render/vcs.tsreturn resolved ? fs.statSync(resolved).mtimeMs : 0;

讀取檔案 · 第21 行claude-code/hud/hooks/hud/config-reader.tsconst value: unknown = JSON.parse(fs.readFileSync(filePath, 'utf8'));

讀取檔案 · 第56 行claude-code/hud/hooks/hud/config-reader.tsfor (const entry of fs.readdirSync(root)) {

讀取檔案 · 第60 行claude-code/hud/hooks/hud/config-reader.tsconst stat = fs.statSync(target);

執行指令 · 第28 行claude-code/hud/hooks/hud/jj.tsexecFile(file, [...args], options, (error, stdout) => (error ? reject(error) : resolve({ stdout })));

環境變數 · 第11 行claude-code/hud/hooks/hud/extra-cmd.tsexport function isExtraCmdAllowed(env: NodeJS.ProcessEnv = process.env): boolean {

環境變數 · 第15 行claude-code/hud/hooks/hud/extra-cmd.tsexport function parseExtraCmdArg(argv: string[] = process.argv, env: NodeJS.ProcessEnv = process.env): string | null {

執行指令 · 第42 行claude-code/hud/hooks/hud/extra-cmd.tsexec(cmd, { timeout, maxBuffer: MAX_OUTPUT_BYTES, windowsHide: true }, (error, stdout) => {

讀取檔案 · 第25 行claude-code/hud/hooks/hud/speed.tsconst state = JSON.parse(fs.readFileSync(file, 'utf8')) as Partial<SpeedState>;

寫入檔案 · 第37 行claude-code/hud/hooks/hud/speed.tsfs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });

寫入檔案 · 第39 行claude-code/hud/hooks/hud/speed.tsfs.writeFileSync(tmp, JSON.stringify(state), { mode: 0o600 });

作品資訊

☆ 1 星 ·0 次瀏覽

收錄於 2026/10/3

來源更新 2026/10/4

Claude Codemod

hud：Claude Code 狀態面板、用量預警與每日預算 — Claude Code 插件／外掛 · ClaudeMods

關於這個 mod

安裝

hud：Claude Code 状态栏 HUD

功能

安装

主题

命令

选项

同系列 mod

开发

更多類似作品

cctop

agent-flow

CodeCraft：Minecraft 風格 Claude Code HUD