GitHub リポジトリ · ダッシュボード・HUD

hud：Claude Code の状態表示、使用量アラートと日次予算 — Claude Code プラグイン · ClaudeMods

Name: hud：Claude Code の状態表示、使用量アラートと日次予算
Author: hoobnn

ClaudeMods でこの Claude Code プラグインのソースと必要な権限を確認できます。 claude-hud 0.10.0 を mod 化。モデル、Git、コンテキスト、ツール、サブエージェント、ToDo を入力欄のそばに集約し、使用量アラート、日次予算、詳細パネルと 12 種のテーマを追加します。

hhoobnn@hoobnn

翻訳済み

この mod について

hud は claude-hud 0.10.0 を Claude Code mod にしたものです。モデルと推論強度、プロジェクトと Git の変更、コンテキストと使用量、実行中のツール、サブエージェント、ToDo を入力欄のそばにまとめます。表示位置は入力欄の上、または従来のステータスバーがある下側を選べます。

設定した割合でのコンテキスト・利用枠アラート、利用枠を使い切る時刻の予測、自動圧縮までの残り token、未コミットの変更や未プッシュのコミットが増えた際の通知を追加しています。5 時間枠の予測には直近 1 時間の消費速度を使います。今日の費用と日次予算の比較、直近 7 日間の小さな折れ線グラフ、1 行のタスク要約も表示します。/hud detail ではツールの回数と所要時間、最近のターンの時間・費用・コンテキスト増加、サブエージェント、ToDo、今日と今週の費用を確認でき、Claude の作業中も開けます。長いタスクの完了通知、macOS の任意の通知音、リモート制御の接続状態にも対応します。

テーマは classic、neon、rainbow、emoji、sakura、kawaii、mecha、shonen、tokyo-night、matrix、nerd、powerline の 12 種。最後の 2 種は Nerd Font が必要です。アニメ風マスコットは作業や使用量に応じて表情が変わり、showMascot で無効にできます。/hud theme <名前> で切り替え、引数なしで選択画面、next で次へ、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