GLM HUD用量实时显示

github地址：GitHub - MaoMiDeMao/glm-hud: Display GLM model usage (5h/7d token quota, MCP monthly) in Claude HUD status line · GitHub

claude code如果使用官方api会有个skill用例实时显示，非常方便。但是使用国产glm接入后这个功能就无法使用了。于是使用gml的api文档接口，让glm给自己做了个HUD，感觉效果还行！哈哈

在 Claude HUD 状态栏中显示 GLM 模型的 5 小时/7 天 token 用量配额和 MCP 月度使用情况。

效果预览

复制代码

[GLM-5.1] │ ConfigSettings git:(main*)
上下文 ████░░░░░░ 45% │ ⏱ 5m │ GLM 5h: █░░░░░░░░░ 8% | 7d: ████░░░░░░ 42% | MCP月: 4%
◐ Edit: file.ts | ✓ Read ×3

前提条件

使用 GLM 模型（通过 ANTHROPIC_BASE_URL 指向 open.bigmodel.cn 或 api.z.ai）
已安装 Claude HUD
已设置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 环境变量

快速安装

复制代码

# 克隆到 Claude skills 目录
git clone https://github.com/MaoMiDeMao/glm-hud ~/.claude/skills/glm-hud
chmod +x ~/.claude/skills/glm-hud/glm-usage-cache.mjs
chmod +x ~/.claude/skills/glm-hud/hud-with-glm.sh

然后在 ~/.claude/settings.json 中配置：

复制代码

{
  "statusLine": {
    "type": "command",
    "command": "bash ~/.claude/skills/glm-hud/hud-with-glm.sh"
  },
  "permissions": {
    "allow": [
      "Bash(node ~/.claude/skills/glm-hud/glm-usage-cache.mjs)"
    ]
  }
}

工作原理

复制代码

┌─────────────┐     每5分钟      ┌──────────────────┐
│  GLM Quota  │ ──────────────→  │ /tmp/glm-usage-  │
│  API        │   HTTP请求       │ hud.txt (缓存)    │
└─────────────┘                  └────────┬─────────┘
                                          │ 读取缓存
                                          ▼
                                 ┌──────────────────┐
                                 │ hud-with-glm.sh  │
                                 │ (HUD wrapper)    │
                                 └────────┬─────────┘
                                          │ 追加到上下文行
                                          ▼
                                 ┌──────────────────┐
                                 │ Claude HUD       │
                                 │ 状态栏显示       │
                                 └──────────────────┘

不消耗 Token：API 查询是普通 HTTP 请求
低频率调用：缓存 5 分钟，后台异步刷新
零侵入：包装原始 HUD 输出，不影响其他 HUD 功能

文件说明

|---------------------------|---------------------------|
| 文件 | 说明 |
| skills/glm-hud/SKILL.md | Skill 文档 |
| glm-usage-cache.mjs | GLM 用量查询 + 缓存脚本 |
| hud-with-glm.sh | HUD wrapper，追加 GLM 用量到状态栏 |

故障排查

复制代码

# 测试用量查询
node ~/.claude/skills/glm-hud/glm-usage-cache.mjs
cat /tmp/glm-usage-hud.txt

# 测试 HUD wrapper
bash ~/.claude/skills/glm-hud/hud-with-glm.sh