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, 커밋하지 않은 변경이나 푸시하지 않은 커밋이 많을 때의 알림을 제공합니다. 5시간 한도 예측에는 최근 1시간의 소비 속도를 사용합니다. 오늘 지출과 일일 예산을 비교하고 최근 7일 지출을 작은 선 그래프로 보여 주며, 한 줄 작업 요약도 표시합니다. /hud detail에서는 도구 호출 횟수와 소요 시간, 최근 턴의 시간·비용·컨텍스트 증가, 하위 에이전트, 할 일, 오늘과 이번 주 지출을 볼 수 있습니다. Claude가 작업 중일 때도 열 수 있습니다. 긴 작업의 완료 알림과 macOS의 선택적 알림음, 원격 제어 연결 상태도 제공합니다.

12개 테마는 classic, neon, rainbow, emoji, sakura, kawaii, mecha, shonen, tokyo-night, matrix, nerd, powerline이며 마지막 두 개는 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